Open the Table of Contents

You are here: About the Environment Variables > For Clients

# Environment Variables for Clients

The following environment variables are commonly used on client computers connected to the network.

In case of stand-alone 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 - Set the License Manager Name

The LSHOST environment variable is used on a computer that is running a protected application. It tells the application one or more License Manager computers to contact.

When this variable is not set then the application will perform a broadcast for any License Manager that 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 responded License Managers beginning at 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 responded to broadcast. The wait for License Manager response time when LSHOST is set is same as broadcast interval.

Separate License Manager host names with a tilde (~). A colon (:) was used to separate License Manager host names up to RMS v8.2.x. For example, use the following command:

SET LSHOST=ACCT_SERVER~FINANCE_SRV

LSFORCEHOST - Select a Single License Manager

You can use the LSFORCEHOST environment variable to force the application to look for only one License Manager computer. If the License Manager listed in the variable cannot be found, the application stops broadcasting and returns an error. LSFORCEHOST overrides a LSHOST environment variable or LSHOST/lshost file, and prevents a network broadcast from being done.

For example:

To tell licensed applications running on a Windows computer to send license requests to a computer on the same subnet called ACCT_SERVER and no other License Manager, use the following command:

SET LSFORCEHOST=ACCT_SERVER