Installation Guide
RLM 16.1 for Tecplot Products

Uninstalling the older version of RLM deletes your existing license and settings files, so before uninstalling, copy these files to a safe place (for example, make a new folder on your desktop and put them there). The main license file is named tecplotlm.lic but other .lic files may also exist and should also be copied. If you have changed any of the .opt files, copy them, too.

After copying the files, uninstall the older version of RLM through the Windows Control Panel. Then install RLM 16.1 as described in the next section.

After installing RLM 16.1, copy the saved tecplotlm.lic back to the RLM installation directory, replacing the existing file. Also copy any other license files you saved.

If you added any commands to the .opt files, use a text editor (such as Notepad) to copy these commands from the saved files to the corresponding .opt files that were installed with RLM 16.1. Do not copy the entire file, just any lines you added.

In a web browser, go to https://localhost:5054 and click the Reread/Restart Servers button (in the upper right). In the page that appears next, click REREAD/RESTART (in the center of the page).

Your Tecplot licenses should now be available again.

Install RLM 16.1 as described in the next section. RLM 16.1 installs in a separate directory from the older RLM version.

Copy the tecplotlm.lic license file from the older RLM installation directory and paste it into the RLM 16.1 directory, replacing the existing file. If there are any other .lic files in the RLM directory, these are also license files and should be copied as well.

If you added any commands to the .opt files, use a text editor to copy these commands from the older RLM installation to the corresponding .opt files that were installed with RLM 16.1. Do not copy the entire file, just any lines you added.

From the terminal, use the cd command to navigate to the RLM 16.1 directory. Then stop the server and start it again:
./rlm_process stop
./rlm_process start

Your Tecplot licenses should now be available again. Once migrated, the older RLM installation folder can be deleted. However, you will need to update the RLM Startup configuration again.

See Configuring RLM Startup for more information.

Double-click the installer .exe file. You may be prompted for an administrator password.

Follow the on-screen instructions to complete the installation. When installation completes, the RLM server starts automatically.

The Linux installer is a self-extracting archive that must be run at the command line.

Follow the on-screen instructions to complete the installation. When installation completes, you will be asked if you want to start the RLM server.

After installation, you may need to adjust your firewall settings. Refer to Firewall Settings for Hosting the RLM Server.

The Mac installer is a self-extracting archive that must be run at the command line.

Follow the on-screen instructions to complete the installation. When installation completes, you will be asked if you want to start the RLM server.

After installation, you may need to adjust your firewall settings. Refer to Firewall Settings for Hosting the RLM Server.

A Windows service called rlm is installed that starts RLM when the host boots. No further action is required.

If you want to change the Web server administration port or disable the Web server completely, you can delete the service and create a new one by following these steps:

At the end of the installation, you are given the option to start RLM. By default, the server administration is available at https://localhost:5054 (replace localhost with the license server hostname if you’re accessing it from another computer).

To manually start or stop RLM, do the following:

Once you have decided on the desired startup options, you should add that command to the operating system’s startup script so that RLM starts when the system boots. The output of sh ./rlm_process may list a recommended startup script for your system, if it can be found. We have provided some hints below for popular operating systems.

In general, you should use a startup script that runs as late as possible in the boot process to make sure network services are available.

Once you have added the RLM startup command to a startup script, reboot the server and verify that RLM starts up.

Because the RLM server administration interface is Web-based, you can administer your license server from any platform with a Web browser. The Web browser runs on port 5054.

If accessing the server on the computer on which it is running, you can access the RLM server at https://localhost:5054. If accessing the server from a different host on your network, replace “localhost” with the hostname or IP address of the RLM server.

When accessing the RLM web server, it will prompt for a username and password. The default username is "admin" and the default password is "password" when logging in for the first time. You will then be prompted to set a unique password for the admin user. For more information about managing permissions, users, and access to the RLM web server click on the Documentation button at the top of the interface to open the web-based RLM End-User Manual, or view it online at this address: RLM administration basics.

Using the buttons on the left side of the license administration web page, you can control several functions of the license manager, including the following.

For further information about the RLM web server, click on the Documentation button at the top of the interface to open the web-based RLM End-User Manual, or view it online at this address: RLM administration basics.

To run rlmutil, follow these platform-specific instructions.

Linux/Mac Platforms:
On Linux or Mac platforms, navigate to the RLM installation folder and run rlmutil from a system startup script (type ./rlmutil in the terminal or script window).

Windows Platforms:
On Windows, navigate to the RLM installation folder, and type rlmutil into the command prompt window.

The rlmutil executable contains instructions for controlling RLM using the rlmutil commands. For further instruction, read the following section.

After rlmutil is running, follow the instructions included in rlmutil to execute commands. The following table lists the available license administration utilities accessible in the executable. For a more comprehensive explanation, refer to the RLM End-User Manual online at RLM administration basics

Refer to the platform-specific instructions on administering RLM for the best method of how to restart RLM after shutting it down.

If you now open the RLM administration interface in your Web browser, you should see the new RLM version number on the main page.

If you now open the RLM administration interface in your Web browser, you should see the new RLM version number on the main page.

The Reprise License Manager runs as a daemon (background application) called rlm on the network host. This daemon manages the allocation of keys to users of Tecplot products. During the time that a local machine has been allocated a license, the Tecplot product running on that machine regularly sends a signal (heartbeat) to the server.

If the RLM daemon does not get an expected heartbeat signal, the server assumes that the software has been exited or has quit unexpectedly and, after a period of time, frees up the license and no longer associates it with that instance of the product.

From the other end, if the heartbeat check fails, the Tecplot product will no longer allow the user to use most features of the product, but will allow the user to save the current session (for example, to a layout file) to avoid losing work. The user must check out a new license from RLM, usually by exiting and re-launching the product, to regain full use of the software.

The system that runs the Reprise License Manager daemon must have a license key file installed to enable network licensing of Tecplot products. If you do not have a license key file, see Installing Tecplot Licenses.

Tecplot products released in May 2015 and later support roaming: borrowing network licenses for a period of time when you expect to be disconnected from the network (for example, while traveling). To manage roaming, use Help > License Roaming in your Tecplot product.

An error message appears if the product installation folder does not contain the tecplotlm.lic file, or if that file does not contain a valid license key (for a Single-User license) or license server address (for a Network license) from which a valid license can be obtained. Users may enter new license information when they do not have a valid license.

For Network licenses, make sure users have specified the correct address of the license server when activating their licensing, that a valid license key is installed on the server for the product being used, that the license server daemon is running, and that enough licenses are available on the server. Also, make sure that the license server host can be reached from the workstation in question (for example, using ping), and that the workstation’s firewall is not denying outbound access to the license server port (typically port 27100). Finally, make sure the host name used for the license server resolves to the correct IP address, or use the IP address.