Server management
Adding a server
If you have hardware access:
- Hardware -> Add Server.
- In the modal, pick a Server Configuration preset (for example
local-dummy), then fill in Hostname, optional IP Address, optional Bootstrap Script Filename (defaultagent-bootstrap.sh), and a Bootstrap Comment. - Click Generate Bootstrap Script.
- 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 PGRST202fromPOSThttps://bench.metrum.ai/api/rpc/create_server_config_instancewhen 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
| State | Meaning |
|---|---|
online | Agent has reported a heartbeat within the last 2 minutes |
stale | No heartbeat in 2-10 minutes |
offline | No heartbeat in 10+ minutes |
requires_reonboarding | Registered 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.