/
Intercax License Server (ILS) Automated Deployment
  • Verified

    • Intercax License Server (ILS) Automated Deployment

    Owned by Brian Miller
    Last updated: May 05, 2025

    Overview

    The Intercax License Server (LS) is used to host any floating licenses issued to you or your organizational group. This section describes how to install the RLM Intercax License Server (LS) on Linux.

    If you have purchased server node-locked license(s), you do not need to do anything here and can proceed straight to Automated Deployment: Linux

    Pre-requisites

    Hardware

    Note, please deploy this on a separate server.

    • CPU: 1 core (unless you’re expecting massive # of CCUs)

    • RAM: 4GB RAM

    • Disk space: 100MB (for software)

    Software

    • Intercax License Server (LS) media file .ZIP downloaded : Download the following zip from the password-protected link provided in the Intercax helpdesk request where you requested Syndeia downloads and license.

      1. intercax_license_server_v15.1BL1_install.zip

    • Intercax issued floating license(s): Download the license file (.lic) attachment(s) from the Intercax Helpdesk request where you originally received your Syndeia Cloud license.

    Steps

    Install Intercax License Server (ILS)

    Intercax LS requires a valid license before running the installation script.

    1. Upload the intercax_license_server_v15.1BL1_install.zip and your .lic license file(s) to a new directory named ~/LS_license on your machine that will run the License Server (LS).

    2. Unzip intercax_license_server_v15.1BL1_install.zip, ie:

      unzip intercax_license_server_v15.1BL1_install.zip

    3. Run the extracted Intercax_License_Server_setup.bash shell script . If you need to know what the script does before it is run, see the expandable section below:

    cd ~/intercax_license_server_v15.1BL1_install/bin ./Intercax_License_Server_setup.bash

    You should see the sample output as shown in the expandable section below:

    Verification

    The script will automatically check to ensure your installed Intercax LS is up and functioning with a valid and available license by running rlmutil (bundled with intercax_license_server_v15.1BL1_install.zip). You should get output similar to the following:

    Thu Apr 17 16:03:17 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Checking license details for 'syndeia v >= 3.6' on 5053@mySCserver.domain.tld... Thu Apr 17 16:03:17 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - License details retrieved successfully: Thu Apr 17 16:03:17 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: Total Licenses: 20, In Use: 0, Available: 20 Thu Apr 17 16:03:17 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Success: 20 license(s) available.

    If for whatever reason your LS and/or your license(s) are not valid, the setup script will exit with an appropriate error message. Please correct any indicated issues and restart the RLM LS service, ie:

    sudo systemctl restart rlm

    Setup License Pointer File

    1. Once the LS has been set up successfully, you will need to create a License Pointer File text file to instruct machines on where to contact to check out a license, ie: Syndeia Cloud (SC) server or client(s). It must have an .lic extension!

    Note, we recommend naming the file after the FQDN of your license server to avoid confusion, ex: myLS.domain.tld.lic

    1. For the SC client, you will need to create it and install it on each client workstation’s ~/.syndeia folder, under their home directory
      For the SC server, you have a choice of either:

      - creating this and uploading it to your home directory for the SC setup script to pick up automatically OR

      - specify the parameters interactively during setup.

      If you create it, the syntax of this file is shown below:

      HOST [license server name or ip address] ANY [5053 (default) or designated RLM port] ISV intercax [port=5055 (default) or designated vendor service port

      … along with an example:

    How to Manage Service & Check Logs

    Service Management

    Services are all managed using systemd’s systemctl command with a verb, ie: status, start, stop, restart, followed the service name, ie: rlm. For more information run systemctl --help and/or man systemctl .

    Example usage follows:

    • To check the summary status:

      sudo systemctl status rlm

    • To start the service:

      sudo systemctl start rlm

    • To stop the service:

      sudo systemctl stop rlm

    • To restart the service:

      sudo systemctl restart rlm

    Logs & Monitoring

    Logs on Linux can be viewed using the journalctl command, ex: sudo journalctl -xeu service-name, ie: rlm

    To tail a particular service’s logs add the f switch to the journalctl command, ie: sudo journalctl -xfeu service-name, or use the sudo tail -f /path/to/service.log command.

    Raw log files are located in the following location:

    RLM Setup

    ~/intercax_license_server_v15.1BL1_install/bin/Intercax_License_Server_setup.log

    RLM Service

    How to view the RLM service journal:

    sudo journalctl -xeu rlm # add `f` to `xeu` to follow / tail the journal

    Raw log file location:

    /opt/Reprise/RLM/current/rlm.log