Try our new documentation site (beta).
Machines
Machines are Gurobi compute servers or distributed workers provisioned in the Cloud. A compute server can accept new problems to solve while distributed workers are used as slaves to run distributed optimization or tuning. Machines are launched automatically as part of a pool or manually using the Instant Cloud Manager.A machine can be in one of the following states:
| launching | The machine request has been recorded, and the provisioning will start soon. |
| pending | The provisioning process has started. |
| configuring | The machine has been provisioned and the network is being configured. |
| starting | The machine has been configured and the Gurobi remote services are starting. |
| idle | The Gurobi remote services are ready to accept new optimization jobs. No optimization jobs are running. |
| running | The Gurobi remote services are ready to accept new optimization jobs. At least one optimization job is running. |
| killing | The machine termination has been recorded, and the shutdown process will start soon. |
| shutting down | The machine is shutting down. Once a machine is fully shutdown, it will be removed from the list. The machine history can be accessed to list recent terminated machines. |
| error | An error occurred while the machine was being provisioned, running or shutting down. A machine in error state will remain in the list for around 2 minutes and then will be removed. The machine history can be accessed to list recent terminated machines. |
In addition to the state name, a colored icon may be displayed:
 |
When the machine is not idle or running, a progress icon indicator is displayed. |
 |
The machine has an error, you can move the mouse over and a tooltip will display the exact reason. |
Finally, you can perform the following actions. Some actions are specific to one machine and some others can be applied to multiple machines, in this case you can toggle the selection using the checkboxes.
 |
View machine details. The machine details include the machine description, its configuration as well as its actual status. |
 |
Download the license file for compute servers only. If the compute server is part of a pool, the license file will contain the default access ID and secret key for the pool. If the machine is a one-time server, then the license file will contain the DNS name of the machine and the user password. You just have to place this file in your home directory which takes precedence, or in one of the following shared locations:
In case you previously had a license file installed, please make sure to replace it,
or set the environment variable |
 |
Terminate machines. The machines will typically auto-terminate based on the idle shutdown parameter. However, it may be useful to terminate the machines manually. If a compute server has one or more distributed workers, they will be terminated as well. |
Machine Metrics
Starting with engine 8.0.0, the machines are now reporting the current CPU and memory usage.
