License Server Installation

Floating and Named-user licenses use the RLM license server to distribute licenses. This article explains how to create and activate a license server on your network.

Preinstallation Setup

Note to FastX Users

Note FastX ships its own license server in the installation. You only need to continue installing a license server if you want to centrally manage all licenses of FastX on one system

Before You Begin

  • Before installing, identify a server computer that will be able to host the Reprise License Manager (RLM) server.
  • Supported Platforms: Windows XP or later, Linux x86, x64 Virtual Machines are allowed
  • This computer needs to be on your internal company network where it can be reached by all the computers in your organization that may need to check out licenses.
  • The computer should not be turned off have High Availability (uptime).
  • The load imposed on the server from RLM is extremely light meaning a dedicated server is not required.
  • Once this server has been chosen it can be used by other products that use RLM as well.

Installing the RLM Server

Windows Installation

  1. Create the folder C:\RLM
  2. Download and extract the RLM Windows Server into C:\RLM
  3. Open a Command Prompt (CMD) as an Administrator
  4. At the command prompt, type: cd C:\RLM
  5. Type rlm.exe -dlog “C:\RLM\rlm.log” -install_service
  6. To start the service, at the command prompt type: net start rlm

**To disable the service Type: rlm.exe -delete_service

The RLM webserver ships with two users by default: admin and user with no passwords.

Open a browser: http://localhost:5054 log inand click Change Password to change your password

Linux Installation

The following instructions give basic information on creating and starting the license server on a linux system. Advanced users can modify the included rlm.sh file to customize their systems (change user, directory etc) as needed

  1. Create a user named rlm with home directory /opt/rlm
  2. Download and Extract the RLM Linux Server file to /opt/rlm using the command tar xvpf <file you downloaded>.
  3. Make sure the file rlm.pw is writable by the rlm user.
  4. Determine if you are on a systemd system. (Run the command “systemctl“. If it shows many lines, then your system is a systemd system.) If you are on a systemd system, run the following commands (as root):
    1. mv /opt/rlm/rlm.service /etc/systemd/system/
    2. systemctl daemon-reload
    3. systemctl enable rlm.service
    4. systemctl start rlm.service
  5. If you are not on a systemd system, run the following commands:
    1. mv /opt/rlm/rlm.init /etc/init.d/
    2. One of the following 2 lines will work on your system. (The first is for RedHat; the second is for Debian.):
      1. chkconfig --add rlm
      2. update-rc.d rlm defaults
    3. service rlm start

Your server will now start automatically on boot.

 

The RLM webserver ships with two users by default: admin and user with no passwords.

Open a browser: http://localhost:5054  log in, and click Change Password to change your password

Opening ports in your Firewall

Your firewall needs to be configured to let license server traffic from your X-Win32 users through. RLM uses 2 ports to communicate, one for the license server, and one specifically for StarNet. Additionally the web interface runs on an additional port.

Open up the following ports:
TCP: 5053 — RLM server port
TCP: 57889 — StarNet ISV port
TCP: 5054 — Web server port

Ports are specified in the license file. You can change the default listening ports by modifying the port numbers in the license file

HOST hostname 023402380fc 5053

ISV starnet port=57889

LICENSE=…

Activating the Floating License

Activating the license from the website can be done from any machine, not just the machine where the license server is located. This is useful for users who are on a closed network and do not have direct access to the internet.

Manually Registering a Floating License Steps:

  1. Go to license.starnet.com/activate to begin your activation.
  2. Enter your floating license activation key
    1. Click Next
  3. Enter in the Host ID
    • The host id can be found by going to the rlm directory and running rlmutil rlmhostid
    • For other methods of finding the hostid see finding license server hostid
    1. Click Next
  4. Enter number of licenses being activated to the RLM License Server
    1. Click Next
  5. Confirm your selection
    1. Click Submit
  6. Download and Save the license
    • The license server will read all licenses that end in .lic
  7. Install the License File
    1. Drop the *.lic file into the RLM server directory (eg. C:\RLM, /opt/rlm etc)
    2. Restart the server to install the license

Files and Reference