FastX 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

Additional Information
————————————————————-

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
FastX 2 User: ls -al /usr/lib/fastx2/var/licence
FastX 3 User: ls -al /usr/lib/fastx/var/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:

FastX 2 User: /usr/lib/fastx2/rlm/rlmutil rlmhostid
FastX 3 User: /usr/lib/fastx/3/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
FastX 2 User: cd /usr/lib/fastx2/var/license
FastX 3 User: cd /usr/lib/fastx2/var/license
      • Run following command to check license availability

FastX 2 User: /usr/lib/fastx2/rlm/rlmutil rlmstatus -avail
FastX 3 User: /usr/lib/fastx/3/rlm/rlmutil rlmstatus -avail

Centralized System Licensing

    • FastX Session Server(s)
    • License File Check
      • FastX License Location
FastX 2 User: ls -al /usr/lib/fastx2/var/licence
FastX 3 User: ls -al /usr/lib/fastx/var/license
      • License file should point to the hostname or IP of the license server

License file example (the zeros are required):

HOST license_server.example.com 00000000
      • License file and directory must be readable by all
    • Check license availability
      • Check must be done as nonroot
      • Go to the following directory
FastX 2 User: cd /usr/lib/fastx2/var/license
FastX 3 User: cd /usr/lib/fastx2/var/license
      • Run following command to check license availability

FastX 2 User: /usr/lib/fastx2/rlm/rlmutil rlmstatus -avail
FastX 3 User: /usr/lib/fastx/3/rlm/rlmutil rlmstatus -avail

  • RLM service should not be running

————————————————————-

Additional Information

  • Issues with FastX that is acting as the centralized license server, please review the Single System Licensing check
  • RLM License Server is installed as a standalone centralized license server
    • License file is stored in the RLM directory
    • RLM installs with an interactive admin page, please go to URL
    http://localhost:5054
    • There are two logins: admin and user with no passwords. We recommend changing the password after logging in. After logging in, admin can check the status of the license server
  • Restart license server
service rlm restart