Gurobi Remote Services Parameters


Gurobi Remote Services Parameters

As noted in the Quick Start Guide, you start Gurobi Remote Services by running the grb_rs program on the server machine. This starts a Windows service on Windows systems, and a daemon on Linux or Mac OS systems. When Gurobi Remote Services starts, it picks up user parameter settings from an optional grb_rs.cnf file (the file must be in the directory that contains the grb_rs executable).

To modify the default settings, you should place a list of parameter=value lines in this configuration file. Lines that begin with the # symbol are treated as comments and are ignored. Here's an example file:

# Configuration file
PASSWORD=abcd1234
ADMINPASSWORD=1234abcd
You can create this file using your favorite text editor (Notepad is a good choice on Windows).

Some Gurobi Remote Services parameters are generic, while others are specific to a particular service. The generic parameters are:

PASSWORD
The password that the client program must supply in order to submit a job. Note that all user data is passed between the client and server using 256-bit AES encryption, whether you supply a password or not. The server password simply prevents unauthorized clients from submitting jobs to the server. The default is no password.
ADMINPASSWORD
The password for performing administrative tasks. This is different from the password that client programs must provide. Administrative tasks are performed using the gurobi_cl program. Example tasks include changing the job limit and killing jobs (details will follow). Note that the administrator password must be set if you wish to enable remote administration.
THREADLIMIT
A limit on the number of threads a single job can launch on the server. By default, a job can create as many threads as it likes (although by default the Gurobi algorithms won't create more than one thread per core).

A few Gurobi Remote Services parameters are specific to Compute Server. They control the job queuing features...

JOBLIMIT
A limit on the number of client jobs that are allowed to run on the server at a time. Client requests beyond this limit are queued. The default limit is 2.
HARDJOBLIMIT
A hard limit on the number of simultaneous client jobs. Certain jobs (those with priority 100) are allowed to ignore the JOBLIMIT, but they aren't allowed to ignore this limit. Client requests beyond this limit are queued. The default hard limit is 100.
IGNOREPRIORITIES
When set to 1, the server ignores user job priorities.

The configuration file is only read once, when Gurobi Remote Services first starts. Subsequent changes to the file won't affect parameter values on a running server.