Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Step 10: Standardize terminology to avoid confusion

You will be given a zipped folder contain the floating license server and a license file. Follow the steps below to setup your floating license server on a new machine.  

  1. Deploy a new standard RHEL/CentOS7, headless image on a physical or virtual machine (VM) or install from a Kixstart script or install from media manually.

  2. Setup forward & reverse DNS records on your DNS server (consult your IT admin/sysadmin if required) and set the hostname and primary DNS suffix on the machine itself if necessary.  
    (info) Note: If required by your IT department, perform any other standard configuration (ie: create separate admin account, set timezone, date & time or set it to synchronize with an NTP server, etc.)

  3. If using a firewall, ensure the following ports are accessible (consult your local network admin if required): TCP ports 5053, 5054, 5055 (or the alternates you selected, see Pre-reqs Required to Generate a License, step #3 for more details). 

  4. Unzip the license server zip file into an applications directory.
    1.  create a new rlm/Intercax_License_Server_Lin64 directory off /opt, ie:  sudo mkdir -p /opt/rlm/Intercax_License_Server_Lin64
    2. unzip the contents of the zip to it, ieex:  sudo unzip Intercax_License_Server_Lin64.zip -d /opt/Intercax_License_Server_Lin64rlm

      (info) Note, if you have a newer version of RLM, specify the appropriate version in the filename.  

      Code Block
      languagebash
      themeRDark
      titleSample Output
      rlmadmin@rlm-server:/opt/rlm$ sudo unzip Intercax_License_Server_Lin64.zip -d /opt/rlm/Intercax_License_Server_Lin64
      Archive:  Intercax_License_Server_Lin64.zip
        inflating: /opt/rlm/Intercax_License_Server_Lin64/intercax 
        inflating: /opt/rlm/Intercax_License_Server_Lin64/FloatingTemplate.lic  
        inflating: /opt/rlm/Intercax_License_Server_Lin64/intercax.set   
        inflating: /opt/rlm/Intercax_License_Server_Lin64/rlm
        inflating: /opt/rlm/Intercax_License_Server_Lin64/rlmutil  
      rlmadmin@rlm-server:/opt/rlm$ 

      (warning) Note, you may wish to either delete or suffix (rename) FloatingTemplate.lic to FloatingTemplate.lic.disabled to prevent rlm from parsing this during startup since this is just an example template for the client-side, ie:  sudo mv FloatingTemplate.lic{,.disabled} -OR- sudo rm FloatingTemplate.lic

  5. Copy the floating license file you obtained from Intercax to the directory Intercax_License_Server_Lin64.
  6. Edit the license file received by changing "localhost" to the hostname of your RLM License Server (LS):  
    (info) If specifying different ports, you will need to set those here too, ie:  replace <RLM_port> and <ISV_Intercax_port> with the alternate port(s) you have selected ( (warning) Do NOT edit anything else or it will invalidate the license):  

    Code Block
    languagebash
    themeRDark
    linenumberstrue
    HOST localhost <MAC_address> <RLM_port>
    ISV intercax port=<ISV_Intercax_port>


  7. Change the file modes of rlm and rlmutil to executable (if not already).
    1. $ cd Intercax_License_Server_Lin64/
    2. $ sudo chmod 550 rlm
    3. $ sudo chmod 550 rlmutil
    4. $ sudo chmod 550 intercax
  8. Start the license server with the following command
    1. $ cd Intercax_License_Server_Lin64/
    2. $ sudo nohup ./rlm -ws 5054 -dlog rlm.log &
      (info)  To stop the license sever, find and kill the rlm + intercax process ids (PID)s
      1. $ ps -ef|grep rlm
      2. $ ps -ef|grep intercax
      3. $ sudo kill -9 ${rlm_pid}
      4. $ sudo kill -9 ${intercax_pid}

  9. Optional and Recommended: adding a Restart-on-Boot script for your Intercax Reprise License Server
    1. Having the OS restart your license server automatically is convenient
    2. See https://reprisesoftware.com/wp-content/uploads/2023/v15-1/RLM_License_Administration.pdf
    3. Search for "Starting the rim server at system boot"...
    4. Follow the instructions provided by Reprise for your choice of host OS.

  10. Now go back to Users' Workstations and Floating Licenses and make sure all user workstations have a copy of the Client License Pointer File.