Activation

Set Up an Offline Floating Licensing Server

 

Installation Requirements

The Offline Floating Licensing Server is installed as a Linux daemon on a machine (typically virtual) that is accessible from the local area network. Currently the daemon is only supported on CentOS 7 or RHEL 7. The installation can proceed either from the VMWare/KVM disk images provided, or the machine can be provisioned from scratch. After the machine is provisioned, then the daemon is installed via two .rpm packages.

Daemon Installation

[Optional] Install the VM Disk Image

A CentOS 7 VM can be downloaded from the following links for KVM and VMware:

The user account is root and the password nalpeirondaemon. Please follow the instructions for your hypervisor to install the VM and then change the user account password.

Install the Daemon and Database

The offline floating license daemon and associated database can be downloaded from the following links:

Please download both to the machine that will serve as the host.

The daemon and database can then installed and configured with the following commands (please run them as root):

  1. yum install /path/to/nalppgsql-*.rpm
  2. yum install /path/to/*nalpdaemon*.rpm
  3. Modify the firewall to allow connections to port 16700 (for the daemon) and port 80 (for the license administration portal)
    1. firewall-cmd --permanent --add-port=16700/tcp
    2. firewall-cmd --permanent --add-port=80/tcp
  4. Disable SELINUX: edit /etc/sysconfig/selinux change SELINUX=enforcing to SELINUX=disabled
  5. Check the following values and, if needed, increase the open file limit of your system
    1. $ ulimit -aH
      core file size (blocks, -c) unlimited
      data seg size (kbytes, -d) unlimited
      scheduling priority (-e) 0
      file size (blocks, -f) unlimited
      pending signals (-i) 63684
      max locked memory (kbytes, -l) 16384
      max memory size (kbytes, -m) unlimited
      open files (-n) 8192 <———————Open file limit
      pipe size (512 bytes, -p) 8
      POSIX message queues (bytes, -q) 819200
      real-time priority (-r) 0
      stack size (kbytes, -s) unlimited
      cpu time (seconds, -t) unlimited
      max user processes (-u) 63684
      virtual memory (kbytes, -v) unlimited
      file locks (-x) unlimited
    2. If your open file limit is less thant 8192, change this value by editing /etc/security/limits.conf and adding or changing the “nofile” lines to:
      * soft nofile 8192
      * hard nofile 8192
  6. Check and, if necessary, increase the kernel’s socket backlog limit, to
    1. $ sysctl net.core.somaxconn
      net.core.somaxconn = 128
    2. Increase this value to 2048 (or higher) by editing /etc/sysctl.conf and adding or editing the “net.core.somaxconn” value:
      net.core.somaxconn = 2048
  7. Restart

Test Daemon Installation

To verify that the daemon is running, execute the following

sudo systemctl status nalpdaemon

There should be output similar to the following if the daemon is running:

To verify the postgres database is running, execute the following:

ps -elf | grep postgres

 

If postgres is running, the output should be similar to the following:

 

Enable the daemon upon restart

In the terminal, execute the following:

sudo systemctl enable nalpdaemon

Administrator Portal

In addition to marshaling license activation/deactivation, the daemon also serves an administrator portal website. To access the login page for the portal, open a webbrowser at the IP address for the host machine of the daemon. 

 

The default username and password are ‘admin’ and ‘nalpeiron’, respectively. Note that while only the admin account can log into this portal, all accounts can be used for licensing purposes. 

Daemon Status and Settings

Once logged in you will be presented with the Daemon tab of the Administrator portal:

The Daemon tab provides a simple display of the daemon’s status as well as a means to configure the daemon. If the daemon is running, then the status fields will list the daemons status (as in the image above). Otherwise they will indicate that the daemon is not running.

The daemon must be running prior to any attempts to activate a client license, which can be accomplished by pressing the ‘Start’ button. Should the need arise to change the daemon’s settings, the daemon will need to be restarted in order for the changes to be registered by pressing the ‘Stop’ button and then ‘Start’.

 

Listen Port The port on which the daemon will listen for client activation/deactivation. The default is 16700.
Max Log Size The maximum allowed log file size in bytes. This setting must be greater than zero.
logLevel This setting dictates the level of detail in the logs. A setting of 4 should be used when diagnosing issues or for sending to support. Otherwise, 1 is sufficient.
Log Queue Length The maximum queue length for logging queue.
Max Queue Length The maximum queue length for the client connection queue.
IO Min Threads / IO Max Threads / Work Min Threads / Work Max Threads The minimum and maximum number of threads, respectively, to spawn for handling the I/O and internal work. Increasing these values will allow for more tasks in a given period at the expense of putting higher strain on the host machine. The daemon will manage its thread pools within the bounds defined by these parameters.
Proxy Username / Proxy Password / Proxy IP / Proxy Port Should the daemon need to access the internet through a web proxy server, the credentials, proxy server IP address and port can be supplied here. Leave all fields blank if a web proxy server is not needed.

 

Daemon License Online Activation/Deactivation

Activation

  1. Start In the License tab of the Administrator portal and in the Master License section,

    select ‘Get License Online’ from the dropdown and click the orange arrow button.

  2. In the dialog that appears,

    enter the daemon license code and click ‘Apply’.

Deactivation

  1. Start In the License tab of the Administrator portal and in the Master License section, select ‘Return License Online’ from the dropdown and click the orange arrow button.
  2. Click ‘Ok’ in the prompt that appears.

Daemon License Offline Activation/Deactivation

Coming soon …

Imatest License Online Server-side Activation/Deactivation

Activation

  1. Start In the License tab of the Administrator portal and in the Product Licenses section, select ‘Enter Product Info’ from the dropdown and click the orange arrow button.
  2. In the dialog that appears

    enter the following data and then click ‘Accept’

    1. Customer ID: 4068
    2. Product ID: 100
  3. In the next dialog,

    enter the product license code (i.e. the Imatest license code) and click ‘Apply’.

  4. The Status for the license code will have changed to ‘Activated’

Deactivation

  1. Start In the License tab of the Administrator portal and in the Product Licenses section, select ‘Return License Online’ from the dropdown and click the orange arrow button.
  2. Click ‘OK’ in the confirmation dialog that appears.
  3. The Status for the license code will have changed to ‘License Returned to Server’

Imatest License Online Client-side Activation/Deactivation

Activation

  1. Open Imatest
  2. Click the Classic UI button
  3. In the Classic UI, go to Help:License Manager (Activate)…
  4. In the License Manager, go to Settings:Alternative Licensing Server …

  5. In the dialog that appears,

    enable the ‘Use offline licensing server’ checkbox and in the fields below, enter the server details and user account credentials.

  6. Click ‘Ok’ and follow the prompting to restart the machine.

  7. After the machine has restarted, open the License Manager again and click ‘Activate’. Note that the license number field will read ‘netseat’. 

Deactivation

  1. Open Imatest
  2. Click the Classic UI button
  3. In the Classic UI, go to Help:License Manager (Activate)…
  4. In the License Manager, go to Settings:Alternative Licensing Server …
  5. In the dialog that appears, disable the ‘Use offline licensing server’ checkbox.
  6. Click ‘Ok’ and follow the prompting to restart the machine.

Pertinent INI File Keys

The server and client credentials are stored in plain-text in two INI files on the client machine, imatest-v2.ini and license_server_settings.ini, both of which are stored in the default INI directory (macOS: ~/Library/Application Support/Imatest/, Linux: ~/.imatest, Windows: %APPDATA%\Imatest).

imatest-v2.ini

Section Key Type Description
imatest license_server_enable (int) Set to 1 to enable, 0 to disable the client authenticating via the Offline Floating Licensing Server.
imatest license_server_credential_file (string) The full file path to license_server_settings.ini. Note that backslashes in Windows paths must be escaped.
imatest licensing_server_type (string) The licensing server type identifier, which must be set to ‘Offline License Server’.

 

 

 

 

 

license_server_settings.ini

Section Key Type Description
client username (string) The client username in plain-text.
client password (string) The client password in plain-text.
client computer_name [Optional] (string) A name for the machine to be displayed in the administrator portal.
format version (float) The file format version number. Please set to 1.
server url (string) The IP address for the Offline Floating Licensing Server.imatestlicense_server_port(int) 
server port (int) The port number for the Offline Floating Licensing Server.