Title
Create new category
Edit page index title
Edit category
Edit link
lbcli list upgrade-status
Lists upgrade-status. Provides detailed information on the upgrade operations running over the cluster’s servers.
Examples:
Flag | Short | Type | Default | Description |
|---|---|---|---|---|
--name | String | List information only for servers identified by server name. | ||
--riskOfServiceLossState | String | “None” | (Optional) List information only for servers in a state of RiskOfServiceLoss. | |
--uuid | String | List information only for servers identified by server UUID. | ||
--help | -h | Bool | Help for upgrade-status. |
This command returns both the upgrade status at the cluster level and a list of servers with their individual upgrade status and progress.
Note that the short notation of this command (the human-readable format) is targeted at extracting and highlighting the upgrade specific information. The long notation (-o json/yaml) will return identical information to invoking both get cluster and list servers.
Cluster Level
Field | Type | Description |
|---|---|---|
UUID | string | The cluster UUID. |
Min Version | string | The minimum version used by one of the servers in the cluster. |
Upgrade Status | string | The current status of the cluster upgrade. The possible valuables are:
|
Target Version | string | The Lightbits version the server is being upgraded to. |
Start Time | timestamp | The start time of the upgrade on this cluster. |
End Time | timestamp | The end time of the upgrade on this cluster. |
Error Message | string | Detailed error message if the upgrade operation failed (at the cluster level). |
Server Level
Field | Type | Description |
|---|---|---|
Name | string | The server name. |
UUID | string | The server UUID. |
Current Version | string | The current Lightbits version. |
LastUpgrade/Status | string | The current status of the upgrade. The possible values are:
For a healthy upgrade flow, the upgrade should cycle through these statuses: None > Upgrading > Rebooting > Recovering > None |
LastUpgrade/TargetVersion | string | The Lightbits version the server is being upgraded to. |
LastUpgrade/StartTime | timestamp | The start time of the upgrade on this server. |
LastUpgrade/ProgressStep/Total | int | Shows the current progress of the upgrade operation. In json/yaml format, they are returned in separate fields. In human-readable format, progress is shown as the current steps executed/total steps required to complete the upgrade. |
LastUpgrade/EndTime | Timestamp | The end time of the upgrade on this server. |
ErrorMessage | string | Detailed error message if the upgrade operation failed (at the server level). Note that ErrorMessage is limited to 40 characters in table display, so in some cases long error messages will be concatenated. In other output formats such as -o json or yaml, the entire error message is visible, |
All upgrade information is structured into LastUpgrade. This will return either the information for a current ongoing upgrade, or if not, the upgrade in process will return information for the last upgrade that was run over this server.
© 2026 Lightbits Labs™