Sentinel Environment Variables

Home | Previous | Next

License Administration > Sentinel Environment Variables Expand All | Collapse All

 

If you have other products licensed using Sentinel technology on the machine where you have installed your Team-GIS product you may find that you need to configure some environment variables in order for the products to co-exist.

 

       LSERVRC

 

The Team-GIS License Manager adds licenses to a Sentinel license file, the location of which is specified by the system environment variable LSERVRC.  Note than on installation Team-GIS will not change the value of LSERVRC if it is already set, but if no pre-existing Sentinel license file is found then the LSERVRC environment variable is set as follows:

 

32 bit machine: “<install drive>:\Program Files\Common Files\Exprodat\Team-GIS\Lic\lservrc”
64 bit machine: “<install drive>:\Program Files (x86)\Common Files\Exprodat\Team-GIS\Lic\lservrc”

 

Note that LSERVRC will affect all products licensed using Sentinel on the same machine (including non-Exprodat products), and in order for all Sentinel licensed products to co-exist all Sentinel application licenses should be combined in the single Sentinel license file specified by LSERVRC.  To do this open each product's Sentinel license file in a text editor and copy the data to the file specified by LSERVRC ensuring that there is only one license per line of the file.  You should restart the license service to implement any such edits.

 

       LSHOST

 

With LSHOST you can tell the client to look at multiple license servers. If the required license is not found on the first license server then the next defined license server will be checked. If none of the specified license servers are found, then a broadcast is done in an attempt to get a license from any available license server.

 

Note that Team-GIS licensing is not affected by the LSHOST environment variable. However, LSHOST is required when other vendor applications employing Sentinel licensing need to coexist with Team-GIS products.

 

LSHOST has the following behaviour:

 

If LSHOST is present but the value is missing, then Sentinel protected applications will search the entire network for a license server that is able to allocate the required license, although this search adds a significant performance overhead.
If LSHOST is present and set to a list of license servers, then the application will traverse the list until it finds a license server that is able to allocate the required license.  The license server host names specified in LSHOST should be separated with a colon (:) e.g. "SERVER1:SERVER2". Note that if the applications being licensed have a mixture of Standalone and Network licensing types then you must specify "no-net" as one of the server values for licensing to function correctly, e.g. "SERVER1:SERVER2:no-net".

 

       LSFORCEHOST

 

The LSFORCEHOST environment variable selects a single license server. This forces all Sentinel protected applications (including Team-GIS applications) to look for the specified   license server on the network, which eliminates time delays in finding the correct license server when compared with using LSHOST. However, with LSFORCEHOST no network broadcast is ever performed, so if the license server specified in LSFORCEHOST is not found, then the search stops and an error is returned.

 

A pre-existing LSFORCEHOST environment variable will most likely stop all Team-GIS products from being able to find the licenses they require, and in turn produce the error  'E0002 -- Could not get a license/Unable to contact any servers', examples of which are shown in the licensing FAQ's.

 

In general terms the best way to resolve such issues is to remove the LSFORCEHOST environment variable altogether (see the section below), although there may be instances when this is not an appropriate solution.  If in doubt please contact Exprodat support.

 

Note that during installation of Team-GIS products (version 200 and above) a check is performed to see whether the LSFORCEHOST environment variable is present, and if it is you are presented with the option to change it to LSHOST, as this will not prevent Team-GIS products from being licensed and will additionally be benign in terms of any third party Sentinel protected applications.

 

       Removing LSFORCEHOST

 

In order to remove the LSFORCEHOST environment variable please follow the process below:

 

Go to 'Control Panel > System > Advanced > Environment Variables'.
Highlight the LSFORCEHOST environment variable.
Click 'Delete'.
Click OK.

 

       Changing LSFORCEHOST to LSHOST

 

In order to change the LSFORCEHOST to LSHOST such that the pre-existing third party applications and any Team-GIS applications can co-exist please follow the process below:

 

Go to 'Control Panel > System > Advanced > Environment Variables'.
Highlight the environment variable you wish to edit, e.g. LSFORCEHOST.
Click 'Edit' in the frame marked 'System Variables' and enter a new value for the 'Variable Name', e.g. LSHOST.
Click OK, and OK again.
  
© 2011 Exprodat Consulting Ltd.