After receiving the product license file(s) from Avenza Activation, extract the license file and place it in the same folder as the RLM binary files. Installing and configuring RLM will require access to the command prompt. If you have multiple license files for multiple products, place all of the license files in the same folder where the RLM binaries are stored.
Running RLM by clicking the executable
- Double-click rlm to start the license server.
- If a security warning message appears, click run to go to the next step.
- As soon as you click the run button, a new command prompt window will appear.
Using Command Prompt
- Extract Avenza_FloatingLicense_RLMv14.zip to a convenient location on your hard drive. This will be the folder from which the program will run.
- Open the Command Prompt window (Start > Run, then type CMD).
- Navigate to the directory where all the binaries and the license file are stored.
- Type rlm.
Make sure that avenza, rlm, and all of the license files are placed in the same directory.
Ensure that the license file has the .lic extension (e.g. GeographicImager.lic).
Installing RLM as a Service
Installing RLM as a service can be performed in a command window. RLM will remain running until it is explicitly deleted as a service. Installing RLM as a service does not start RLM; RLM running as a service must be started from the “Services window (Windows Services control panel)”.
To install RLM as a service, run it in the command line with specific arguments below:
rlm –install_service –dlog (path to the log file) [-service_name sname]
- (path to the log file) must be entered (e.g. c:\RLM_GeographicImager\RLM_Log.log)
- [-service_name sname] is an optional argument (e.g. –service_name RLMGeographicImager).
- If the service name is not specified, the service name will be “rlm”.
An example of the full line argument is:
This will install service with a service name “rlm” and create a log file in the directory: “c:\RLM_GeographicImager\RLM_Log.log” and the log file name is “RLM_Log.log”.
Starting the RLM Service (Windows)
After pressing the enter key at the end of the install command, nothing visible will be displayed in the command prompt window.
To start The RLM service:
- Go to Start > Control Panel > Administrative Tools > Services to open the Services dialog box.
- Find the service named rlm from the list. (If a service name was specified in the command line, find the specified service name from the list. Double-click the service name to open the Service Property dialog box.)
- If you want RLM to start whenever Windows starts, choose Automatic from the Startup type drop-down.
- To start RLM, click the Start button.
Once RLM is started as a service, RLM server will not have to be run from the command prompt again.
Troubleshooting RLM Server Setup
When setting up RLM, its behaviour may be observed from the log file if RLM is running. The following is a brief list of troubleshooting tips regarding error or warning messages that may appear in the server log.
No license file for this host (Server name); The host name in the license file(s) may be incorrect.
A possible cause of this issue is that the license file does not have the appropriate extension (.lic). Please ensure that the license file has the correct extension (.lic) at the end of the file name.
What is the appropriate version of RLM for Geographic Imager 6.x?
Geographic Imager 5.2 and newer uses RLM version 12.x. The version number can be indicated in one of the server log lines, e.g. “01/06 12:17 (rlm) RLM License Server Version 9.3BL2”
(rlm) Port 5053 in use, waiting...
This log line appears when port 5053 is used by other application. RLM version 12.x uses port 5053 (TCP/IP) by default. In order to solve this problem, a port number can be specified in the license file. Enter the port number at the end of the HOST line in the license file. As this port number is not included in the encryption code, any encryption process from Avenza Activation Department will not be required. However, please ensure that the license file has the file extension .lic after saving the file. The example below shows that the port number 5055 is specified.
(rlm) Cannot bind Web Server port 5054, existing...
A web browser is required to access the RLM administrator page (shown on page 14 “Managing the license server”). This log line appears when port 5054 is used by other application. RLM version 12.x and newer uses port 5054 for the web server port by default.
In order to solve this problem, a port number can be specified with a command prompt line when running RLM (as a service). The argument word to be used to specify the web port number is -ws <port number>; the examples below show the web server port number specified as 5555.
When running RLM
When running RLM as a service