IBM Cloud Docs
Viewing cluster upgrade status with the oc adm upgrade status command

Viewing cluster upgrade status with the oc adm upgrade status command

Virtual Private Cloud Classic infrastructure

For clusters that run version 4.16 or later, you can use the oc adm upgrade status command to check the update status of your cluster master during a master version update. This command provides details regarding the update status so you can determine if the update is proceeding normally or if intervention is required. If intervention is required, the command provides details of the issue as well as links to relevant documentation to help resolve the issue. For more information, see the Red Hat OpenShift documentation

The oc adm upgrade status command is available as a technology preview from Red Hat OpenShift.

Getting cluster update details

  1. Run the following command to set the OC_ENABLE_CMD_UPGRADE_STATUS environment variable to true.

    export OC_ENABLE_CMD_UPGRADE_STATUS=true

  2. Run the upgrade status command.

    oc adm upgrade status

  3. Review the output. If the output indicates any issues with the update, read the details and follow the provided links to relevant documentation to help resolve the issue.

    Example output for a master update in progress.

    An update is in progress for 1m39s: Working towards 4.16.7: 473 of 673 done (70% complete), waiting on console, csi-snapshot-controller, image-registry, ingress, insights, kube-storage-version-migrator, marketplace, monitoring, node-tuning, openshift-samples, operator-lifecycle-manager, service-ca, storage

= Control Plane =
Assessment:      Progressing
Completion:      0%
Duration:        1m38.761469s
Operator Status: 17 Total, 17 Available, 0 Progressing, 0 Degraded

    Example output if no update is in progress.

    The cluster version is not updating (Progressing=False).

Reason: <none>
Message: Cluster version is 4.16.7