Troubleshooting OpenShift Container Platform 4.x: Upgrade Issues

Updated

To debug an OpenShift upgrade issue, you will want to start by looking at the Cluster Version Operator (or CVO) to see how it is progressing the upgrade, and/or how different components are reacting to being asked to upgrade.

Always start by gathering information on the cluster version:

$ oc get clusterversion
$ oc get clusterversion -o yaml
  • The yaml output will show status messages about your upgrade.

Review the logs from the CVO, as it should tell you how it's progressing; in more detail than the events and or status updates seen by the clusterversion object.

$ oc logs $(oc get pod -n openshift-cluster-version -l k8s-app=cluster-version-operator -oname) -n openshift-cluster-version

Upgrades can fail for a variety of reasons a list of known upgrade issues can be found here:

SBR
Category
Components
Article Type