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

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 .

Important

### 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

Tip

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

# Set to a license file

# Set to a directory containing the file

# Set to a license server (PORT@HOST)


### Server set-up¶

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.

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

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

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

@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


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

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.

Important