Try our new documentation site (beta).
Client Commands
Once you have set up your client license file and started an Instant Cloud instance, you can use grbcluster to list the nodes in your cluster or issue other client commands. Instances can be started by submitting a job through the gurobi_cl command-line tool, through the Gurobi programming language APIs, or manually through the Instant Cloud Manager website.
If you try to run grbcluster without first starting an instance, you will get the following error:
fatal : Instant Cloud pool default has no machines
If your instance is in the process of starting, you will get the following error:
fatal : Instant Cloud pool default is not ready
If your instance is up and running, grbcluster will list the nodes in your cluster:
> grbcluster nodes ADDRESS STATUS TYPE GRP LICENSE #Q #R JL IDLE %MEM %CPU ip-172-31-31-180 ALIVE COMPUTE m-HkQmbubhWH1g7m VALID 0 0 2 12m0s 27.08 1.98 ip-172-31-62-109 ALIVE COMPUTE m-HJSXmb_-2WBkLX VALID 0 0 2 12m0s 27.49 0.00
To obtain additional details (about the license file, the cloud pool, or the name of the server), you can use the verbose mode with the -v flag:
> grbcluster -v nodes verb : Reading license file /licenses/gurobi.lic verb : Accessing Instant Cloud pool 999999-pool5 verb : Using remote services on node ip-172-31-31-180 ADDRESS STATUS TYPE GRP LICENSE #Q #R JL IDLE %MEM %CPU ip-172-31-31-180 ALIVE COMPUTE m-HkQmbubhWH1g7m VALID 0 0 2 12m0s 27.08 1.98 ip-172-31-62-109 ALIVE COMPUTE m-HJSXmb_-2WBkLX VALID 0 0 2 12m0s 27.49 0.00
You can use grbcluster to perform most of the same client commands on an Instant Cloud cluster that you'd perform on a cluster running locally. You can monitor running and recently processed jobs, access log files, view parameters, etc.
However, you will not be able to execute administrative commands such as aborting a job, or changing the configuration of a node. To do so, please use the Instant Cloud Manager or the Instant Cloud REST API instead.
