FastX 4 Licensing Debugging

When experiencing FastX licensing issues, please do the following checks to verify that FastX is properly licensed.

Prerequisite

  • FastX installed
  • A registered license file and is placed in the proper location

Licensing Set-Up

Single System Licensing

  • Verify License Location and Permissions
    • License file must end in .lic
    • License file must be readable by all

chmod a+r license.lic

    • FastX License Location

ls -al /var/fastx/license

  • Verify the license has the correct HostID – The HostID in the license file must match the FastX host machine

To check the HostID of the host, run the following command:

/usr/lib/fastx/4/rlm/rlmutil rlmhostid

  • Verify rlm service is running

ps -ef | grep rlm

  • Check license availability
    • Check must be done as nonroot
    • Go to the following directory

/var/fastx/license

    • Run following command to check licenses in use

/usr/lib/fastx/4/rlm/rlmutil rlmstat -a -c /var/fastx/license/

Centralized System Licensing

Use the same checks as the Single System Licensing

For FastX nodes connecting to the centralized license server

  • License File Check for FastX Servers connecting to the Centralized license server
    • License file should point to the hostname or IP of the centralized license server

License file example (the zeros are required):

HOST license_server.example.com 00000000

Additional Information

License server Web interface

After the license server service fastx4-rlm is installed and running, it will listen for HTTPS connections on port 5054. To get access, either open port 5054/tcp in your firewall, or run a browser on the FastX server itself and connect to https://localhost:5054/. The initial install will use a self-signed certificate, so you’ll need to add an exception in your browser when it asks.

When first installed, the RLM License Server “admin” account will have the default password of “admin”. An the first login, the password must be changed before any operations can be done.

Note: You may notice that the “in-use” count may be less than the actual number of rows in the list of checkouts. This is because most FastX licenses have “Share” set to “User&Host”. This means that multiple checkouts with the same user and host share the checkout, and thus is counted as 1 “in-use”.

Note: License activation is disabled in the RLM web interface.  Please DO NOT use the “Activate” menu to register in the RLM web interface.

Restart License Server

service rlm restart

Advanced information for the RLM license server

https://reprisesoftware.com/docs/admin/basics-admin.html