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.

Go to license.starnet.com/activate to begin your activation.

Step 1: Enter your floating license activation key

Click Next

Step 2: 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

Click Next

Step 3: Enter the number of seats you wish to activate

You can activate up to and including the number of seats available Next

Step 4: Confirm your selection

Click Submit

Step 5: Download the license

Save the license file. The license server will read all licenses that end in .lic

Step 6: Install the License File

Drop the *.lic file into the RLM server directory (eg. C:\RLM, /opt/rlm etc) and restart the server to install the license.

Files and Reference