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