/
Linux - Intercax License Server Installation and Setup

Linux - Intercax License Server Installation and Setup

Overview

The Intercax License Server (ILS) is used to host any floating licenses issued to you or your organizational group. This section describes how to install ILS 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 (ILS) 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.

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

ILS requires a valid license before running the installation script.

  1. Upload the intercax_license_server_v15.1BL1_install.zip to your home folder and your .lic license file(s) to a new directory named ~/LS_license (ie: under your home folder) to the machine that will run the ILS.

  2. If you have not provided us with a ILS hostname during your initial license request, carefully edit the file to replace:

    1. localhost with your LS name and

    2. RLM port (if not using the default of 5053)

    3. ISV port (if not using the default of 5055)

      HOST localhost abcdef123456 <RLM_port> ISV intercax port=<ISV_Intercax_port>

      IMPORTANT: DO NOT EDIT ANY OTHER FIELD AS THAT WILL INVALIDATE YOUR LICENSE!

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

    unzip intercax_license_server_v15.1BL1_install.zip

  4. 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:

~/intercax_license_server_v15.1BL1_install/bin$ ./Intercax_License_Server_setup.bash Thu Apr 17 16:03:13 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Starting Syndeia RLM setup... Thu Apr 17 16:03:13 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - RLM not found. Setting upgrade=false and proceeding with fresh installation... Thu Apr 17 16:03:13 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Creating necessary directories... Thu Apr 17 16:03:13 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Creating RLM system user + group, if non-existent... Thu Apr 17 16:03:13 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Successfully created user 'rlm' and group 'rlm'. Thu Apr 17 16:03:13 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Installing RLM folder to /opt/Reprise/RLM/v15.1BL1... Thu Apr 17 16:03:13 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Creating/upgrading symlink for current version... Thu Apr 17 16:03:13 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Setting permissions for executables to ug+x (just in case)... Thu Apr 17 16:03:13 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Installing new license files... Thu Apr 17 16:03:13 EDT 2025 [warn] ./Intercax_License_Server_setup.bash, PID=44953: ! No license files found in /home/jdoe/intercax_license_server_v15.1BL1_install/license. Searching /home/jdoe/LS_license too... Thu Apr 17 16:03:13 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Successfully found license files in /home/jdoe/LS_license, copying to /opt/Reprise/RLM/current... Thu Apr 17 16:03:13 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Setting ownership to rlm:rlm for /opt/Reprise/RLM/v15.1BL1... Thu Apr 17 16:03:14 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Check if firewall-cmd exists (i.e. if firewalld is installed and likely running)... Thu Apr 17 16:03:14 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - firewalld is installed. Creating firewalld service definition for RLM... Thu Apr 17 16:03:14 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Reloading firewalld... success Thu Apr 17 16:03:14 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Install firewalld service definition for RLM... success Thu Apr 17 16:03:15 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Successfully added RLM service to firewalld. success Thu Apr 17 16:03:15 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Successfully reloaded firewalld to apply changes. Thu Apr 17 16:03:15 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Creating systemd service file... Thu Apr 17 16:03:15 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Set systemd .service file ownership and permissions... Thu Apr 17 16:03:15 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Reloading systemd daemon and enabling RLM service... Thu Apr 17 16:03:16 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Enabling RLM service to start on boot... Thu Apr 17 16:03:16 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Make sure at least 1 license file exists in /opt/Reprise/RLM/current before starting rlm.service... Thu Apr 17 16:03:16 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Starting RLM service... Thu Apr 17 16:03:16 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - RLM service start message sent successfully. Thu Apr 17 16:03:16 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - RLM service is active. Thu Apr 17 16:03:16 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Check status of RLM service (make sure the below doesn't have any errors)... ● rlm.service - Reprise License Manager Loaded: loaded (/etc/systemd/system/rlm.service; enabled; vendor preset: disabled) Active: active (running) since Thu 2025-04-17 16:03:16 EDT; 55ms ago Main PID: 45137 (rlm) Tasks: 2 (limit: 102192) Memory: 708.0K CGroup: /system.slice/rlm.service └─45137 /opt/Reprise/RLM/current/rlm -c /opt/Reprise/RLM/current -ws 5054 -dlog /opt/Reprise/RLM/current/rlm.log Apr 17 16:03:16 mySCserver.domain.tld systemd[1]: Started Reprise License Manager. 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. Thu Apr 17 16:03:17 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Syndeia RLM setup completed successfully! Thu Apr 17 16:03:17 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - You can access the RLM admin interface at http://mySCserver.domain.tld:5054 Thu Apr 17 16:03:17 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: (The default username & password for the RLM admin interface is 'admin' / 'syn45ia') Thu Apr 17 16:03:17 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - IMPORTANT!: PLEASE CHANGE THE DEFAULT PASSWORD FOR THE RLM ADMIN INTERFACE UPON LOGIN Thu Apr 17 16:03:17 EDT 2025 [info] ./Intercax_License_Server_setup.bash, PID=44953: - Done.

  1. Install/upgrade an Intercax License Server (ILS) instance to be compliant with this version of Syndeia (Cloud).

  2. Install any uploaded .lic license file(s)

  3. Create an rlm:rlm system user + group and set it to be the owner of #1-2

  4. Create a symlink to the currently installed version at /opt/Reprise/RLM/v Version (ex: 15.1BL1) as /opt/Reprise/RLM/current

  5. Create a systemd service definition, ie: /etc/systemd/system/rlm.service

  6. Create a firewalld service definition (/etc/firewalld/services/rlm.xml) to open the default ports (5053~5055).
    Note, while this can be customized / overridden at runtime by export-ing environment variables for the below, we recommend keeping them at the default for ease of troubleshooting:

    1. LS_host_port (default=5053)

    2. LS_host_webadmin_port (default=5054)

    3. LS_host_ISV_port (default=5055)

  7. Enable rlm.service to start on boot

  8. Start rlm.service

  9. Check the status of rlm.service

  10. Verify compatible licenses are available for this version of Syndeia (Cloud)

  11. Provide initial login credentials for the web administration portal

Verification

The script will automatically check to ensure your installed ILS 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 ILS 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-based ILS service, ie:

sudo systemctl restart rlm

Setup License Pointer File

  1. Once the ILS has been set up successfully, you will need to create a License Pointer File that is used by Syndeia software (e.g. Syndeia Cloud and Syndeia Clients) to find the network location of the ILS for checking out floating licenses. Please refer to the following page for creating the License Pointer File : License Pointer File Creation.

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