Traditional license

The traditional license of SuperMap GIS series products consist of the official license and trial license, which will be introduced separately below:

Trial License

SuperMap GIS series products provide a 90-day trial license by default. You only need to install SuperMap GIS series products to view the status of the trial license of the corresponding product by deploying the SuperMap License Center on Windows or installing the license driver on Linux.

Official License

There are two forms of formal licenses: file license and hardware license. Hardware license is divided into stand-alone key and network key.

1. File License means to get the legal software license online or offline, and it will take effect when activated on this machine. File license is divided into the stand-alone file license and network file license. Activating a stand-alone file license can only provide license service for this machine, but activating a network software license can provide license service for computers on the current network. Note: the network file license cannot be transferred after activating the network file license on the license server.
2. The hardware license is to obtain a legal software operation license in the form of a hardware dongle ( "hardlock" for short). The hardlock can be divided into the following two types:

• Stand-alone key: Only one authorization license is provided, and it needs to be installed on the same computer with SuperMap GIS products. The appearance of the stand-alone key is green frosted.
• Network key: The network key can be installed on any computer in the network and can provide multiple licenses. The computer installed the network key is called the license server. Clients within the permitted range in the network can use the network key regardless of whether the driver is installed or not. The appearance of the network key is red frosted.

When using the hardlock, please note:

• Before inserting the hardlock, you need to install a dongle driver fisrt for recognizing the hardlock. If you use a stand-alone key, please install the dongle driver on the local machine; if you use a network key, you must install the dongle driver on the license server.
• After inserting the hardlock into the computer, the lighted signal indicator on the hardlock indicates it is valid.
• For the two hardlocks, the stand-alone key will be used first on the same computer.
• If you use the hardlock on the virtual machine,  you need to connect the hardlock to the virtual machine through related settings of virtual machine software.

Ways to obtain a license

Trial License

SuperMap GIS series products provide a 90-day trial license by default. You can also apply online: https://www.supermapol.com/web/pricing/triallicense.

Official License

You can contact the relevant salesman to purchase the official license.

Use license

Activate license

After obtaining the official license and trial license, you need to activate the license through the license center. For the Windows system, please refer to the configuration license information in the Windows environment. For the Linux system, please refer to the configuration license information in the Linux environment.

Enable license

After activating the license, when you start iPortal for the first time, you can configure the license through the initialization wizard, such as the license type, the product version, and the corresponding extension modules. The highest version of the activated licenses is used by default, and all activated extension module licenses are used.

Specific steps:

1. Start iPortal, enter the iPortal service address in the browser, such as http://supermapiportal:8190/iportal
2. Create an administrator account and check the system environment according to the initialization wizard
3. Enter the "Configure License" interface, which displays the activated traditional license by default.
4. Click "Next" to complete the license configuration and enter the completion page. Click the link http://supermapiportal:8190/iportal/ on the page to enter the iPortal homepage, and click the link http://supermapiportal:8190/iportal/admin-ui/home to enter the iPortal management page

Note: Licensing can also be enabled through an environment variable when there is already a license server in the network. Add the LICENSE_SERVER parameter to the environment variable and set its value to the address of the license server, for example:

        LICENSE_SERVER=192.168.17.200

View the  license information

After completing the initial configuration of iPortal, there are two ways to view the license in use:

• View through the license module in the iPortal management module
• View in the License Center (SuperMap.LicenseCenter)

Switch license types

If you have administrator rights, you can switch the traditional license to another license in two ways: through initial configuration changes and system configuration file changes.

1. Change in the initialization configuration

It is recommended that you use the initialization wizard to make visual changes. Specific steps are as follows:

1. Access the iPortal Initialization Wizard page as an administrator (http://<server>:<port>/iportal/setup)
2. Click "Next" according to the wizard
3. Go to the "Configure License" page to switch to other licenses

• Switch to another license: Select the license type you want to use in the "Select License Type" drop-down box, and configure the related items. For the configuration process, see: Using Cloud Licensing, Using Web Licensing

5. Click "Next" to complete the license change. On the completion interface, click the link http://supermapiportal:8190/iportal/ on the page to enter the iPortal homepage, and click the link http://supermapiportal:8190/iportal/admin-ui/home to enter the iPortal management page

2.Change in the system configuration file

You can also clear your current license and configure other licenses by changing the system configuration file. Stop iPortal, open [iPortal installation directory]\webapps\iportal\WEB-INF\iserver-system.xml to configure, delete the following <licenseMode> and <license> nodes, then restart iPortal to reconfigure the license you want to use.

 <licenseMode>DefaultLicense</licenseMode>  

  <license>

    <enabledmodules>

      <string>IPORTAL</string>  

      <string>IDATAINSIGHTS</string>

    </enabledmodules>

  </license>