Skip to main content

On Premises Server Setup in VRGS

Configuring the on-prem server.

  1. Install Docker from the docker site: https://www.docker.com/products/docker-desktop

  2. To deploy the license server, follow the instructions on the LicenseSpring site: https://docs.licensespring.com/docs/docker

note: If you are setting up on windows, instead of $PWD/config.yaml you will need to specify the full path to the config.yaml file. This will need to be in the format of /c/temp/config.yaml where the local path on your windows machine would be c:/temp/config.yaml

  1. Once started, connect to the server through a web browser. The default port is 8080 unless you set it to a different value in the docker run command. http://licenseserverhost:8080 where licenseserverhost is the ip address of host name of your license server.

  2. Log into the server (default password is “admin”). You should now see:

  3. Select configuration and then change password. Set your own secure password first.

  4. Go to the settings tab. a. Enter the API key and the shared key in the appropriate boxes. You should have had these via email. If not then contact VRGeoscience support.

  5. Go to the “generate offline license“ page. a. Enter the product name

    vrgslm

    b. Enter the license key (sent in separate e-mail – format is XXXX-XXXX-XXXX-XXXX)

  6. Click “generate file” and download the resulting file. The file is usually called ls_activation.req 9: visit the offline licensing site at https://docs.licensespring.com/docs/offline-licensing and follow the instructions there. The activation page can be found at https://saas.licensespring.com/offline

  7. After following the instruction on the licensing site you will have a file called ls_activation.lic (or similar if you gave it a different name).

  8. Back in the license server go to the products tab Select the offline license option from the Add Product drop down menu. Click “upload license file” and add your ls_activation.lic file. Your license should now appear under the “product list” as show above. Your license server should now be ready to go!

Setting the server information using environment variables:​

You would set the environment variable (under system properties) as a system variable to: Variable: VRGS_LICENSE_KEY Value: XXXX-XXXX-XXXX-XXXX

and Variable: VRGS_LICENSE_SERVER Value: http:// licenseserverhost:PORT

where licenseserverhost is the ip address of host name of your license server, and PORT is the number of the port used for the server (default is 8080). This will be the same URL as used to connect to the license server user interface.

You can install via the MSI installer with the following command to add the license key variable automatically:

msiexec.exe /i "c:\path_to_MSI\VRGS3.msi" LICENSE_KEY=XXXX-XXXX-XXXX-XXXX LICENSE_SERVER=http:// licenseserverhost:PORT

Setting the server information using the installer:​

On a new installation: Install VRGS, then on first run you will be asked to accept the EULA, then you will see the license dialog.

Add your license key sent to you by e-mail (same key as used on the server formatted XXXXXXXX-XXXX-XXXX). Check the “Use On Premises Server” box.

Add the URL of your license server formatted

http:// licenseserverhost:PORT

where licenseserverhost is the ip address of host name of your license server, and PORT is the number of the port used for the server (default is 8080). This will be the same URL as used to connect to the license server user interface.

Click OK, then exit and re-start VRGS.

Switching from node-locked to cloud:​

Run VRGS, and from the Home ribbon bar select license status, and then de-activate. Confirm you wish to de-activate the current license and VRGS will switch back into viewer only mode. From the same license status button select “activate”. You should now see the “add license key” dialog.

Add your license key sent to you by e-mail (same key as used on the server formatted XXXXXXXX-XXXX-XXXX). Check the “Use On Premises Server” box.

Add the URL of your license server formatted http:// licenseserverhost:PORT

where licenseserverhost is the ip address of host name of your license server, and PORT is the number of the port used for the server (default is 8080). This will be the same URL as used to connect to the license server user interface.

Click OK, then exit and re-start VRGS.

* Note when switching from node locked to floating you may have to repeat the “add license key” process on re-starting. ***

Checking licenses on the server.​

Go back to your license server, select Home from the top right menu, then click the registrations button: You can now see which machines are currently connected to the server. User will be the hostname of the machine running VRG