Creating a token server client license
The purpose of a token server client license is quite simple: it tells
the client where to find the Gurobi token server. You
can create this file yourself (using a text editor
like WordPad, for example).
The client
gurobi.lic
file typically contains a single line of text:
TOKENSERVER=mymachine.mydomain.comor:
TOKENSERVER=192.168.1.100You should of course substitute the name or IP address of your token server in the example above.
If your token server was configured to use a non-default port, you'll also need a line that provides the port number:
PORT=46325
The client license file may also include a few optional lines.
A SERVERTIMEOUT
line allows you to specify the timeout (in seconds)
in case the token server is unavailable. The default value is 30 seconds.
If the client program is unable to contact the server for more
than the specified amount of time, the client will quit with a network
error.
A PASSWORD
line allows you to connect to a
password-protected token server (you'll need to get the password
from the owner of the token server).
A more complex client token file might look like this:
TOKENSERVER=192.168.1.100 SERVERTIMEOUT=10 PASSWORD=abcd1234
We strongly recommend that you place your client gurobi.lic
file in a default location for your platform (either your home directory or c:\gurobi). Setting up
a non-default location is error-prone and a frequent source of
trouble.
(If you still want to use a non-default location, please
refer to the instructions that appeared earlier in this
section).
If your client and the token server are both running on the same
machine, they can share a single gurobi.lic
file. You just
need to add the following line to the gurobi.lic
file you
obtained from our website:
TOKENSERVER=localhostThe token server will ignore this line, and the client will ignore everything but this line. Your other option when both client and server are running on the same machine is to create a separate
gurobi.lic
file for the client, and to set the
GRB_LICENSE_FILE
environment variable to point to this file
(following the earlier instructions for using a non-default
license location).
Once your client license is in place, you can test the license. If you are unable to connect to the server, you'll need to make sure the server is installed and running. Please consult the instructions for starting a token server for more information.