License Setup

M-Star Pre-Processor and Solver use RLM as the software licensing control mechanism. To determine your license type, please refer to your system admin or contract to determine your license type.

Temporary License

Short term license file issued by M-Star for testing and troubleshooting. Not locked to a specific machine.

Standard License

A license locked to specific computer(s). Sharing of licenses is not permitted.

  1. Request a standard license file by sending your MAC address of the form 00:00:00:a1:2b:cc to M-Star support.

  2. Receive the license file and do one of the following to install it

Option 1) Copy to install folder

  • Simply copy the license file to the application install folder. This will be c:\program files\M-Star on windows. On Linux, copy to the install folder , “bin” sub-directory.

Option 2) Environment variable

  • Place the license file wherever you like, eg. c:\licenses\mstar.lic .

  • Set the environment variable mstar_LICENSE=c:\licenses\mstar.lic .

Floating License

Important

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

End User Setup

To connect over the network to the license server, set the environment variable with the format, mstar_LICENSE=PORT@HOST . Refer to your operating system documentation for setting environment variables or consult your administrator.

mstar_LICENSE

Variable name

PORT

Port number. 5053 by default. Configured in license server file.

HOST

Host name of license server

Tip

For linux hosts: Add one of these statements to your $HOME/.bashrc file:

# Set to a license file
export mstar_LICENSE=/share/licenses/mstar.lic

# Set to a directory containing the file
export mstar_LICENSE=/share/licenses

# Set to a license server (PORT@HOST)
export mstar_LICENSE=5053@license-server.company

Server set-up

Download the license server for your platform

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.

Obtain MAC address and send to M-Star support

To initialize a license server, you will need find the host ID of the machine so a license file may be generated for you. Send the host ID (MAC address) to M-Star support to receive the license file used for the server.

Configure the license file with your RLM server

Once you receive the license file, you should configure the host name in the license file as follows. Open the license file in a text editor and change the localhost entry to the hostname or IP address of the license server. You may also change the license server port number at this time.:

HOST localhost bc5f54ac312a 5053
ISV mstar
.. more text below defining the license

Tip

Changing the hostname and port in a floating server license file will not invalidate the license or require M-Star to re-sign it.

Windows

Important

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

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

  2. Copy the license file to the install directory

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

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

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

Important

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

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

  2. Copy the license file to the install directory

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

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

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
Using the RLM web server

Open a browser and point it to http://localhost:5054 , replacing localhost with the host name of your license server if connecting remotely. You will be able to manage and monitor the license server.

Host Firewall (Optional)

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.

  • 5054 (TCP) : Default license server web management portal. If you wish to use the web management portal, you should verify this port is open.

Important

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:

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

Here the ISV port is specified as 6000. The server firewall would then be updated to allow traffic on this port.

For more information, see ` this article by RLM <http://www.reprisesoftware.com/blog/2012/10/using-rlm-across-a-firewall/>`__

Change license server port number (Optional)

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
.. more text below defining the 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.

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