Documentation

Starting a Cluster Node as a Process

Once you have installed the Remote Services package (including retrieving and installing your license file and, for Linux users, setting your PATH variable), starting grb_rs as a standard process is quite straightforward. From a terminal window with administrator privileges, simply issue the following command:

> grb_rs

If you are using a Cluster Manager and you did not set the MANAGER configuration property you can specify it on the command-line:

> grb_rs --manager=http://mymanager:61080

Both commands will start the Remote Services agent on the default port (port 80), and you should see output like the following:

info : Reading configuration file: /home/jones/gurobi_server901/linux64/bin/grb_rs.cnf
info : Gurobi Remote Services starting...
info : Platform is linux
info : Version is 9.0.1 (build v9.0.1rc0)
info : Variable GRB_LICENSE_FILE is not set
info : License file found at /home/jones/gurobi.lic
info : Node address is server1
info : Node FQN is server1
info : Node has 8 cores
info : Using data directory /home/jones/gurobi_server901/linux64/bin/data
info : Data store created
info : Available runtimes: [9.0.0 9.0.0 9.0.1]
info : Public root is /home/jones/gurobi_server901/linux64/resources/grb_rs/public
info : Starting API server (HTTP) on port 80...

If you do not have administrator privileges or if the default port is already in use, you will see an error about opening the port. For example, on Linux you might see an error like this:

fatal : Gurobi Remote Services terminated, listen tcp :80: bind: permission denied

or

fatal : Gurobi Remote Services terminated, listen tcp :80: bind: address already in use

Note that grb_rs does not have to be run with elevated privileges, but it does need elevated privileges to use the default port 80.

If you would like to run grb_rs on a non-default port, use the --port flag or set the PORT property in the configuration file. For example:

> grb_rs --manager=http://mymanager:61080 --port=61000

The Remote Services agent (grb_rs) needs a directory to store various files, including the runtimes, job metadata, job log files, etc. The default location is a directory named data, located in the same directory as the grb_rs executable (<installdir>/bin/data). If you have a directory named data in your current directory, it will use that location instead.

If starting grb_rs produces an error message that indicates that there was a problem creating the storage service (as shown below), a likely cause is that another grb_rs process is already running.

fatal : Error creating storage service: Error opening data store: timeout