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.

VRGS also accepts VRGS_LICENSE_FILE, set to host:port, port@host or the path of a license file. If both variables are set, VRGEOSCI_LICENSE is used. Either variable makes VRGS ignore a VRGS_LICENSE_KEY on the same machine; Licence environment variables has the full table.

What your license includes

Every RLM license includes virtual reality, CT handling, remote collaboration, data mining and integrations. Optional modules are listed in the options field on the LICENSE line of your license file, using the feature codes CHAT, DFN, SFM, SEISMIC, CTIMAGE and GEOMECH. For example:

options="DFN,SFM,GEOMECH"

The same field can hold NOCLOUD, which turns off crash reporting and the network download of datum grids on every workstation that uses the license.

The options are part of the license signature, so they cannot be edited. To change them, contact us for a new license file, replace the old one on the server and reread it from the web interface. Workstations pick up the change the next time VRGS starts.

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. Crash reporting and the network download of datum grids stay off in this state, because VRGS cannot read the license to see what it allows. Restart VRGS to try again.
• Home ribbon → Update → License Status reports Using on Premises Server and lists the modules your license holds. 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.