Documentation

Installation


Installation

The first step in installing Gurobi Remote Services is to download the installer from our download page. You'll need to find your platform and choose the corresponding file to download.

Image download
Make a note of the name and location of the downloaded file.

Your next step will depend on your platform:

Linux installation

On Linux, your next step is to choose a destination directory. We recommend /opt for a shared installation (you may need administrator priviledges), but other directories will work as well. Copy the Remote Services distribution to the destination directory and extract the contents. Extraction is done with the following command:

tar xvfz gurobi_server8.1.1_linux64.tar.gz

This command will create a sub-directory gurobi_server811/linux64 that contains the complete Linux Remote Services distribution. Assuming that you extracted the Gurobi server archive in the /opt directory, your <installdir> (which we'll refer to throughout this document) will be /opt/gurobi_server811/linux64.

The Gurobi Optimizer makes use of several executable files. In order to allow these files to be found when needed, you will have to modify your search path. Specifically, your PATH environment variable should be extended to include <installdir>/bin. Users of the bash shell should add the following line to their .bashrc file:

export PATH="${PATH}:/opt/gurobi_server811/linux64/bin"

Users of the csh shell should add the following line to their .cshrc file:

setenv PATH "${PATH}:/opt/gurobi_server811/linux64/bin"

You'll need to close your current terminal window and open a new one after you have made these changes in order to pick up the new settings.

In some Linux distributions, applications launched from the Linux desktop won't read .bashrc (or .cshrc). You may need to set the Gurobi environment variables in .bash_profile or .profile instead. Unfortunately, the details of where to set these variables vary widely among different Linux distributions. We suggest that you consult the documentation for your distribution if you run into trouble.

Mac OS Installation

On Mac OS, your next step once you've downloaded the Gurobi Remote Services package from our website is to double-click on the installer (e.g., gurobi_server8.1.1_mac64.pkg for Gurobi 8.1.1) and follow the prompts. By default, the installer will place the Gurobi Remote Services 8.1.1 files in /Library/gurobi_server811/mac64 (note that this is the system /Library directory, not your personal  /Library directory). Your <installdir> (which we'll refer to throughout this document) will be /Library/gurobi_server811/mac64.

Windows Installation

On Windows, your next step is to double-click on the Gurobi Remote Services installer that you downloaded from our website (e.g., GurobiServer-8.1.1-win64.msi for Gurobi 8.1.1).

Note: if you selected Run when downloading you've already run the installer and don't need to do it again.

By default, the installer will place the Gurobi 8.1.1 files in directory c:/gurobi_server811/win64. The installer gives you the option to change the installation target. We'll refer to the installation directory as <installdir>.