Redshift: Connecting a Client Machine

Workstations and render nodes are referred to as clients for the purposes of licensing. You must configure each client machine so that it can find the license server and checkout licenses.

Option 1 - Environment Variables

You can configure your client machines to find the license server by defining an environment variable redshift_LICENSE (note that the lowercase 'redshift' is important). This environment variable will specify the hostname or ip address of the license server as well as the port number using the syntax port@hostname or port@ip-address. The default port for the RLM server is 5053, but can be customized if necessary (for example to prevent conflicts with other RLM license servers running on the same machine). See Customizing the license server port above for more details.

Option 2 - Client License File

An alternative to the environment variable method above is to use a client license file.  The license file is a simple text file named redshift.lic containing a single line of the form:

where <hostname> is the hostname or ip address of the license server and <port> is the RLM license server port.

For example, if your license server hostname is myrlmserver and you are using the default port 5053, your client license file would look like:

The license file should be placed in the License Path on each client machine.  By default this is C:\ProgramData\Redshift\ on Windows and ~/redshift/ on Linux and macOS.