On Premises Server Setup

VRGS uses the Reprise License Manager (RLM) to serve floating licenses on your own network. The RLM server runs on one machine and provides licenses to VRGS workstations as they start, so a group of users can share a pool of licenses without activating each installation individually.

What you will need

When you are ready to set up your license server, we will supply you with:

• rlm.exe, the RLM server
• vrgeosci.exe, the VRGS ISV (vendor) server
• Your VRGS license file (.lic)

Set up the server

1. Create a folder for the server, for example C:\RLM, and copy the three files into it.

2. Open a Command Prompt as administrator and move to that folder:

   cd C:\RLM

3. Install RLM as a Windows service, then start it. The log path should match your folder:

   rlm -install_service -dlog +C:\RLM\server.log
   sc start rlm

For more detail, including startup options and running on other platforms, see the official RLM Server Setup Guide.

Open the firewall

Open these TCP ports inbound on the server:

Port	Used by
5053	The RLM server. VRGS workstations connect here.
5054	The web interface. Only machines that administer the server need this.
ISV port	The vrgeosci server, which VRGS workstations also connect to. It is dynamic by default, so if your firewall needs a rule for it, set a fixed port on the ISV line of the license file.

Check the server in the web interface

Once the server is running, you can use RLM's built-in web interface to monitor license status, check usage and manage the server. It is available at:

https://<server-hostname>:5054

The default username and password are both admin, and you will be asked to change the password the first time you log in. The interface lets you reread license files, view active users and confirm that your VRGS licenses are being served correctly.

Connect VRGS workstations

On each workstation, set a system environment variable that names the server:

Variable	Value
VRGEOSCI_LICENSE	5053@<server-hostname>

For example, from a Command Prompt running as administrator, for a server called licserver:

setx VRGEOSCI_LICENSE 5053@licserver /M

Then start VRGS. Workstations do not need a license key or activation: when this variable is set, VRGS asks the RLM server for a license and does not show the Add License Key dialog.

If a workstation already holds a node-locked license, deactivate it before you set the variable (Home ribbon → Update → License Status → Deactivate), so that the seat is returned.

How VRGS uses the server

• VRGS takes a license when it starts and returns it when it closes.
• If the server cannot be reached, or all licenses are in use, VRGS opens in viewer mode and the messages panel shows the reason. Restart VRGS to try again.
• Home ribbon → Update → License Status reports Using on Premises Server. There is nothing to activate or deactivate on the workstation, because licenses are managed on the server.

If VRGS opens in viewer mode

1. Open a new Command Prompt on the workstation and run echo %VRGEOSCI_LICENSE% to confirm the variable is set. VRGS only sees the variable if it was set before VRGS started.
2. In the web interface, confirm that the vrgeosci server is running and that the vrgs product has free licenses.
3. Confirm the workstation can reach the server on port 5053 and on the ISV port.
4. If it still fails, set the RLM_DIAGNOSTICS environment variable to a file path such as C:\Temp\rlm-diagnostics.txt, start VRGS, and send that file to VRGeoscience support.