You are here: About the Environment Variables > Client - Commonly Used Variables

Client - Commonly Used Variables

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

Note: 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 server.

The RMS license server can serve both types of clients—communicating through IPv4 and IPv6. A client can contact a server using any one of the protocols.

LSHOST - Set the License Server Name

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

When this variable is not set then the application will perform a broadcast for any license server that can authorize the application to run.

When the variable is set, the application will send directed call to the servers that are in the LSHOST list along with broadcast to the network. The application will traverse the list of responded license servers beginning at the first license server in the list and moving down the list. If none of the specified license servers is found, then the application will pick the first license server that responded to broadcast. The wait for server response time when LSHOST is set is same as broadcast interval.

Separate license server host names with a colon (:). For example, use the following command:

SET LSHOST=ACCT_SERVER:FINANCE_SRV

LSFORCEHOST - Select a Single License Server

You can use the LSFORCEHOST environment variable to force the application to look for only one license server computer. If the license server 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 subnetwork called ACCT_SERVER and no other license server, use the following command:

SET LSFORCEHOST=ACCT_SERVER