If you have purchased one or more Gurobi Compute Server licenses, you'll need to perform a few setup steps in order to start your Compute Server(s). Once the server is started, client machines will be able to offload the work of solving an optimization model onto these servers. The clients and the Compute Servers can run any mix of supported operating systems. Thus, for example, multiple Linux machines could submit jobs to a pair of Compute Servers, one running Windows and the other running Linux. Any machine that can reach the Compute Server(s) over your network can be a client (including the Compute Servers themselves).
There are a few steps involved in setting up such licenses. The first is to retrieve your Compute Server license. The key should be installed on a machine that will act as a Compute Server. Once you have your key, you will need to start Remote Services. Finally, client machines will need a Compute Server client license in order to find and use the Compute Server(s).
Note that if you are setting up a machine as a client of an existing Compute Server, you just need to create a Compute Server client license.
Retrieving your Compute Server license
Once you've chosen a machine to act as a Compute Server (or a node in a Compute Server cluster), you'll need to run the grbgetkey command on your machine to retrieve your Gurobi license key. Note that the machine must be connected to the Internet in order to run this command. An Internet connection is not required after you have obtained your license key.
The exact grbgetkey command to run for a specific license is indicated in the popup window after you select the license from the table of licenses (e.g., grbgetkey 253e22f3-...). We recommend that you use copy-paste to copy the entire grbgetkey command from our website and paste it into a shell window.
The grbgetkey program passes identifying information about your machine back to our website, and the website responds with your license key. Once this exchange has occurred, grbgetkey will ask for the name of the directory in which to store your license key file (gurobi.lic). You should see a prompt that looks like this:
info : grbgetkey version 10.0.2, build v10.0.2rc0
info : Contacting Gurobi license server...
info : License file for license ID 146542 was successfully retrieved
info : License expires at the end of the day on 2024-02-15
info : Saving license file...
In which directory would you like to store the Gurobi license key file?
[hit Enter to store it in /opt/gurobi]:
info : License 146542 written to file /opt/gurobi/gurobi.lic
You can store the license key file anywhere, but we strongly recommend that you accept the default location for your system by hitting Enter. Setting up a non-default location is error-prone and a frequent source of trouble. If you do need to store the license file somewhere other than the default location, please see Where do I place the Gurobi license file (gurobi.lic)? for important details.
Your next steps would be to:
Instructions for computers without an internet connection
If your computer isn't connected to the Internet or if your network security system does not allow the command below to function, we also offer a manual license key process. Please refer to How do I use grbgetkey on a machine different from the one where Gurobi will be used?