Linux License Server Installation and Setup

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, ie:  sudo unzip Intercax_License_Server_Lin64.zip -d /opt/rlm/Intercax_License_Server_Lin64

      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):  

    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. You may wish to configure the license server to start on boot, to do so, you will need an init script (for more information see the section "Starting the rlm server at system boot time on Unix systems" at http://www.reprisesoftware.com/RLM_Enduser.html )