Skip to main content

Server management

Adding a server​

If you have hardware access:

  1. Hardware -> Add Server.
  2. In the modal, pick a Server Configuration preset (for example local-dummy), then fill in Hostname, optional IP Address, optional Bootstrap Script Filename (default agent-bootstrap.sh), and a Bootstrap Comment.
  3. Click Generate Bootstrap Script.
  4. Run the displayed bootstrap script on the GPU host as a sudoer.

The server appears in the Servers table on the Infrastructure page within ~30 seconds.

Hosted v4.0 note: some hosted Metrum deployments return 404 PGRST202 from POST https://bench.metrum.ai/api/rpc/create_server_config_instance when Generate Bootstrap Script runs. If your deployment shows this error, register servers via the API or via the bootstrap helper described in the Admin Guide.

For the full operational walkthrough (including troubleshooting agent connectivity) see Admin Guide - Registering a server.

Server states​

StateMeaning
onlineAgent has reported a heartbeat within the last 2 minutes
staleNo heartbeat in 2-10 minutes
offlineNo heartbeat in 10+ minutes
requires_reonboardingRegistered under v3.x; needs the v4 bootstrap run

Jobs queued for a stale or offline server remain queued until it returns. Use the planned Monitoring -> Cancel Stale Jobs action (currently API only) if you need to clear them.