Environment Variables for Clients
The following environment variables are commonly used on client computers connected to the network.
NOTE In case of standalone licensing, the following environment variables are ignored.
LSTCPIPVER - Sets the Client-side IP
The LSTCPIPVER environment variable is used for setting the client's IP for communicating with the RMS License Manager.
>Specify 6 to set IPv6.
>Specify 4 to set IPv4 (this is the default setting).
The RMS License Manager can serve both types of clients—communicating through IPv4 and IPv6. A client can contact a License Manager using any one of the protocols.
LSHOST - Sets the License Manager Name
The LSHOST environment variable is used on a computer that is running a protected application. It tells the application about one or more License Managers that it can contact.
When this variable is not set then the application will perform a broadcast for any License Manager that is available and can authorize the application to run.
When the variable is set, the application will send directed call to the License Managers that are in the LSHOST list along with broadcast to the network. The application will traverse the list of License Managers that respond beginning with the first License Manager in the list and moving down the list. If none of the specified License Managers is found, then the application will pick the first License Manager that responds to the broadcast call. The wait during the License Manager response time when LSHOST is set is same as the broadcast interval.
Separate License Manager host names with a tilde (~).
NOTE A colon (:) was used to separate License Manager host names up to RMS v8.2.x (Windows) and 8.4.x (UNIX).
For example:
| Operating System | Example | Outcome |
|---|---|---|
| Windows |
SET LSHOST=ACCT_SERVER~FINANCE_SRV |
Tells licensed applications to send license requests first to ACCT_SERVER and thereafter FINANCE_SRV |
| UNIX |
export LSHOST=ACCT_SERVER~FINANCE_SRV |
LSFORCEHOST - Selects a Single License Manager
You can use the LSFORCEHOST environment variable to force the application to look for only one License Manager. If the License Manager listed in the variable cannot be found, the application stops broadcasting and returns an error. LSFORCEHOST overrides the LSHOST environment variable or LSHOST/lshost file and prevents a network broadcast from being accomplished.
For example:
| Operating System | Example | Outcome |
|---|---|---|
| Windows |
SET LSFORCEHOST=ACCT_SERVER |
Tells licensed applications to send license requests to a computer on the same subnet called ACCT_SERVER and no other License Manager |
| UNIX |
export LSFORCEHOST=ACCT_SERVER |