Floating License Server Setup

The license server uses two ports for license checkout. To avoid firewall issues, it is recommended to specify both the ports in the license file. See the RLM and ISV port configuration guides below.

A license is locked to a specific license server. The floating server controls the number of open instances of Pre-Processors and Solvers on the network. For instance if you have 2 pre-processor and 5 solver floating licenses, you would be able to have 2 open instances of the GUI and 5 active simulations running at the same time. The floating server enforces a maximum concurrency on the license.

Please refer to the RLM’s support and documentation website for additional detail and troubleshooting tips. RLM License Administration

Windows Installation

Download the license server

Alternatively, you may download the Reprise RLM Administration Bundle directly from Reprise

  1. Download and extract the license server executables into an installation directory.

  2. Request a license file by sending the MAC address of the license server to M-Star support

  3. Copy the license file to the install directory

  4. Configure RLM and ISV ports (See instructions below)

  5. Start the server by executing the rlm exe from the command line.

  6. To configure the license server as a Windows service, follow the next steps

  7. Configure firewall to allow traffic on configured ports

The license server can be installed as a Windows service so that it will start up automatically at boot up time, and run in the background. Follow these steps to set that up.

Verify the user you want to run the service has the proper security settings. Refer to https://blogs.msdn.microsoft.com/ablock/2008/09/18/setting-the-properties-log-on-as-a-service-and-allow-log-on-locally/

  1. Make a directory at C:\logs to house log files for the license server.

  2. Start a command window with administrator priveliges (Right click cmd.exe, Run As Administrator)

  3. Change the directory to the RLM install location.

  4. Execute the following command. Change the c:\licenses input to point to the directory containing your floating server license file:

    rlm -install_service -service_name rlm-mstar -dlog c:\logs\rlmmstar.log -c c:\licenses
    

Linux Installation

Important

Please refer to the RLM’s support and documentation website for additional detail and troubleshooting tips. RLM License Administration

Alternatively, you may download the Reprise RLM Administration Bundle directly from Reprise

  1. Download and extract the license server executables into an installation directory.

  2. Request a license file by sending the MAC address of the license server to M-Star support

  3. Copy the license file to the install directory

  4. Configure RLM and ISV ports (See instructions below)

  5. Start the server by executing the rlm exe from the command line

  6. To configure the license server as a startup process, refer to your operating system instructions.

  7. Configure firewall to allow traffic on configured ports

Refer to your operating system documentation for the correct procedure for adding a program to the boot up sequence. You may be able to simply use crontab to accomplish this, with something like:

crontab -e

# Add the following line to your crontab with paths modified to your machine
@reboot cd ~/rlm-mstar; ./rlm > log.txt 2>&1

License Server Configuration

Specify the RLM Port

This is an optional task in case you need to change the port the license server uses. Edit your license file, the first few 2 lines will be something like:

HOST user-pc bc5f54ac312a 5053
ISV mstar
LICENSE ......
  1. Change the port number 5053 to the port you want to use

  2. Save the file

  3. Restart RLM or have it reread licenses

Further Information Please refer to the RLM License Administration Manual, which provides in depth explanation of the license server - RLM License Administration PDF

Tip

Check that your license server firewall has the configured port open. Some systems also require that the HOST name be set to the IP address or actual host name of the server.

Specify the ISV Port

Some systems require that an RLM ISV port be specified. Under default operation, the ISV port is randomly chosen at execution time, which may cause the RLM ISV port to be blocked if it is unknown to the firewall.

To address this issue, the ISV port can be specified in the license file using the port=XXXXX configuration option in the ISV line:

HOST localhost xxxxxxxxxxx 5053
ISV mstar port=6000
LICENSE ......

Here the ISV port is specified as 6000. The server connection port is 5053. The server firewall should then be updated to allow TCP traffic on these ports.

Host Firewall Setup

Some hosts will require the firewall open up the license server port. Refer to your operating system documentation or administrator to open the necessary ports:

  • 5053 (TCP) (UDP optional): Default license server port, RLM will contact license server on this port to obtain a license. Change this port by editting the license file as described in the below section. UDP may optionally be enabled to allow automatic RLM server discovery.

  • Random high port (default) or the ISV port you have specified (TCP) : This is the so-called ISV port. You may specify port as shown below.

License Server Troubleshooting

Important

Please refer to the RLM’s support and documentation website for additional detail and troubleshooting tips. RLM License Administration

  • After starting the license server. Review the RLM server output and/or logs. Look for any messages that might indicate the license is invalid, server unable to start, etc.

  • Verify port on license server is open on the server’s firewall

  • Verify port on end user machines is open

  • Be aware of any other firewalls in between the license server and clients to allow RLM traffic through

  • Refer to the RLM Administrator Documentation