/
Intercax License Server (ILS) Automated Deployment

Intercax License Server (ILS) Automated Deployment

This content is archived.
Content and incoming (draft) links moved to old parent page https://intercax.atlassian.net/wiki/spaces/SYN36/pages/3330198762/Linux+-+Intercax+License+Server+Installation+and+Setup
Learn more
  • Verified

    • 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 https://intercax.atlassian.net/wiki/spaces/SYN36/pages/3330187755

    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:

    ~/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 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:

    HOST myLicenseServerHost.mydomain.com ANY 5053 ISV intercax

    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