Guides

Configure License on Linux

Installing license driver

Notes:

1. The Linux operating system supports both software license and hardware license, which must install drivers. All the verifications of licenses are communicated in the mode of driver.
2. The following processes should be performed as root.

In the %SuperMap iManager_HOME%/support/SuperMap_License/Support directory to extract the driver installation package *.tar, install the driver;

The unzipping commands as follows:

tar -xvf *.tar

Navigate into the decompression of the file, execute the following command to install the driver:

./dinst

or

sh dinst

You can get a 90-day trial license to use SuperMap GIS 10i after installing the driver. If dinst has no executable permissions, please grant permissions to execute the following commands:

chmod +x dinst

When an “The 32bit support is missing …” error happens on a Linux 64-bit OS, you need to reload the installation disc to manually install a support library of 32-bit OS or download it from SuperMap official website.

Refer to the following list of support libraries that need to be installed.

• Libc6-i386 and ia32-libs (Ubuntu)
• Libstdc ++ - devel.i686, glibc.i686, libgcc.i686, libstdc ++. I686, glibc-devel.i686 (RHEL, CentOS, OpenSUSE, SLES, and OES)
• Glibc-32bit (OpenSUSE, SLES and OES)

Configuring license

Configuring software license

Unlike the GUI configuration on Windows, the Linux platform configures the software license in the way of commands with /licensetool.sh command.

Enter the root directory of the package, execute the following command, you can view the command to configure the soft license:

./licensetool.sh

Enter the root directory of the package, use the “software activation” way to configure the license, the steps are as follows:

1. Get the machine information. Execute the following command, and specify the path where the generated local information file is stored, then a * .c2v file in the specified path will be generated.

   ./licensetool.sh -create/pathname/*.c2v

2. Submit the local information to the Beijing SuperMap Software Co., Ltd.

   Submit the local information file—(* .c2v) generated by the above steps to Beijing Hypergraph Software Co., Ltd., we will generate *. V2c official license file based on it and return to you, through which you configure the official license.

3. Make the license effective. Place your *. V2c official license file into a specified location, execute the following order:

   ./licensetool.sh -update/pathname/*.v2c

Configuring hardware key

Ensure that you have obtained a legal license from SuperMap Software Co., Ltd. before configuring license. If the license server is configured on the same network segment, the license is automatically configured and does not need to be configured manually. If there is a hardware key available in the current network environment (other network segments), follow the steps below to configure the license:

1. Open the browser, visit http://localhost:1947 or http://local IP:1947.
2. In the left Options, select Configuration.
3. On the right, select the Access to Remote License Managers tab.
4. In the Specify Search Parameters fill in the other network segment of the license server IP, click Submit.

5. Wait a few minutes in the left Options in the Sentinel Keys option to see the server’s encryption lock.

   You also can view the license status by executing the following command in the supermap_iserver_*_linux64 root directory:

   ./licensetool.sh -s

Applying for a trial license

Apply Online

Apply online means log in SuperMap Oline account in the product to achieve the trial license, you do not need to do any configuration.

The product versions need to higher or equal to SuperMap GIS 8C(2017) if you apply online.

You need to apply the SuperMap Online account by your phone number, so that you can get the trial license.

Apply Address: https://sso.supermap.com/register

Apply Steps: https://doc.supermapol.com/zh/license/onlinetrial.html

Notes:
iManager For Kubernetes does not support to apply the trial license by the steps above. Please apply the trial license on https://www.supermapol.com/web/pricing/triallicense.

Apply Offline

1. Generating a run report

   Execute the following command in the root directory of the package and specify the path to the running report:

   ./licensetool.sh -report / pathname /*.report

   After executing the command, a * .report file will be generated under the specified path.

2. Applying for a trial license

   You can directly apply for a trial license in the Beijing SuperMap Software Co., Ltd. official website , “SuperMap Technology Resource Center” section. After the application you will receive :

   • If you are requesting license from the SuperMap GIS 7C series, you will receive a * .lic7c format license file
   • If you are applying for the SuperMap GIS 8C series, you will receive a * .lic format license file
   • If you are applying for the SuperMap GIS 9D series, you will receive a * .lic9d format license file

3. Making the trial license effective

   You can apply the trial license in one of two ways:

   • Method 1: Place the trial license file in the opt directory of your OS, specifically: /opt/SuperMap/License/. Please note that the directory is granted read and write access. The system will automatically use the directory of the license file, no other configuration.
   • Method 2: Enter the supermap_iserver_ * _linux64 root directory, place your trial license file you’ve got to the specified file location, execute the following command:

   ./licensetool.sh -update/pathname/*.lic

   or

   ./licensetool.sh -update/pathname/*.lic7c

   or

   ./licensetool.sh -update /pathname/*.lic9d

Managing license information

With License Management, you can view licensing status, update licenses, borrow /lend license, return license, and so on.

Checking the license status

License status query can be done by executing the following command in the product root directory:

./licensetool.sh  -s

The license status information is listed as the product ID, the module ID, the product name, the license type (both the official version and the trial version), the number of licenses, and the license expiration time.

Updating license

Place the *.v2c official license file to the specified location, execute the following command:

/licensetool.sh -update/pathname/*.v2c

The following different kinds of files are supported updating. They have different purpose:

• License activation file (*.v2c), used to activate the purchased official license on the current computer. You need to acquire the local information to generate the license activation file firstly.
• File license for 7C (*.lic7c), used to update the trial license of 7C series products on the current computer. You need to generate the running report of the computer firstly.
• File license for 8C (*.lic), used to update the trial license of 8C series products on the current computer. You need to generate the running report of the computer firstly.
• File license for 9D (*.lic9d), used to update the trial license of 9D series products on the current computer. You need to generate the running report of the computer firstly.
• Certificate for lending license (*.h2r), used to lend a license of the network software license to the current computer.
• Certificate for returning license (*.r2h), used to return a lent license to the license server, which is generated by the computer who borrows the license.

Borrowing/Lending license

1. Generate borrowed information file (*.id)

   Run the following command on the server that needs to borrow the license to generate the borrow information file (* .id) for the machine:

   ./licensetool.sh –id *.id

2. Enable the setting for lending license

   Allow permission to lend on the license-borrowed server:

   • Open the browser, visit http://localhost:1947 or http://local IP:1947
   • In the left Options click on the Configuration, enter the configuration page
   • Click the Detachable License at the top right of the page to open the lend configuration file
   • Check the Enable Detaching of Licenses to allow the license to lend
   • You can also set the lending restrictions according to the actual situation, such as Max. Detach Duration, etc.

3. Generate license file for lending

   Run the following command on the server that lends the license to generate the loan document:

   ./licensetool.sh -detach  [daycount] [productid] [idfile] [h2rfile]

   Example: (lend for 2 days, the product ID is 1, server1.id is the information file of the server who lends the license, mylicense.h2r is the certificate file for lending)

   ./licensetool.sh -detach 2 1 server1.id mylicense.h2r

   Where:

   • daycount, the number of days that need to be lent, and can not exceed the maximum lent time
   • productid, the product ID of the loan, you can view the product ID by http://localhost:1947 on the Products page.

   

   • idfile, the information file (* .id) of the server that needs to borrow the license.
   • h2rfile, certificate file for lending (*.h2r)

4. Configure the borrowicense

   After obtaining the loan document (* .h2r), you need to execute the command to update the license:

   ./licensetool.sh –u *.h2r

Returning license

Run the following command on the borrowed server to get the certificate file for returning (*.r2h):

./licensetool.sh –cd KeyID canceldetachfile

KeyID can be obtained by executing infofile command which will generate a license information file. You need to specify the output path for the license information file:

./licensetool.sh –infofile /pathName/

After executing the above command, a license information file with the suffix .xml is generated in the specified directory, where <attach> true </ attached> indicates whether it can be returned

Run the license update command on the license server to complete the license return.

./licensetool.sh –update *.r2h

You can see that the total number of licenses is automatically incremented by checking the license status command.

./licensetool.sh –status