Licensing Service and Features of Its Use

The licensing service is used in Linux OS to speed up work with the license server due to parallel license requests from BI server to the license server.

The licensing service is the licman utility with built-in support of parallel requests for the Sentinel RMS License Manager service, on which the license server is based.

NOTE. To get the licensing service, contact technical support by sending a request to support@fsight.ru or technical support services, which are available after registration at the website.

To use the licensing service:

1. If required, change field values in the settings.json file. The file is delivered together with the licensing server with default field values.

2. Start the licman utility. The utility checks if the settings.json file is present and valid:

• If the settings.json file is in the same folder with the licman utility and is valid, the specified field values are used.

• If the settings.json file is not in the same folder with the licman utility or is invalid, default field values are used.

3. Create the License section containing the Service subsection with licensing service connection parameters in the settings.xml file:

• Active. The method of communication between BI server and license server:

• True. BI server and license server communicate via the licensing service.

• False. BI server and license server communicate directly.

• Host. IP address or DNS name of licensing server. Default value: localhost

• Port. Number of the port, at which the licensing service is available. Default port: 8210.

NOTE. Licensing service port should match with value of the port field in the settings.json fiel.

The example of the License section in settings.xml:

<...>

  <Key Name="License">

    <Key Name="Service" Active="True" Host="localhost" Port="8210"/>

  </Key>
</...>

4. Restart the BI server.

After executing the operations the work with license server is executed via the licensing service.

settings.json

The default contents of the settings.json file:

{

    "server": "localhost",

    "port": 8210

}

The settings.json field consists of main and additional fields.

Main Fields

To provide licensing service work with minimum required settings, set the main fields:

server

port

Additional Fields

To extend licensing service functionality, set additional fields:

checkServerTime

logLevel

serverTimeout

workersCount

Setting Up License Server Fault Tolerance

To ensure fault tolerance of the license server, one can connect the servers that will be used as backup ones.

The licensing service addresses the main license server during the time specified in the serverTimeout field. if the specified time is out, and the licensing service did not receive response from the license server, the system connects to the backup server that follows the main one in the array of the server field. After this the current license server addresses the main server with periodicity specified in the checkServerTime field. If the main license server responds the requests, the reverse connection is executed.

Backup servers should contain a trial license that provides recovery of the main license server and support of the active user session. The license is activated at first use.

TO connect backup servers, set an array in the server field. If required, change the values of additional fields.

The example of filled fields in the settings.xml file:

{

    "server": ["localhost", "reserveServer"],

    "port": 8210,

    "checkServerTime": 15,

    "logLevel": "log",

    "serverTimeout": 10,

    "workersCount": 4

}

Setting Up Licensing Service Fault Tolerance

To ensure license service fault tolerance when a single BI server or BI servers cluster is used, set up the HAProxy balancer. For details see the Setting Up HAProxy Balancer Using Licensing Service section.