This documentation is for a release that is no longer maintained
See documentation for the latest supported version 3 or the latest supported version 4.11.3. Troubleshooting common issues with installing on Red Hat Virtualization (RHV)
Here are some common issues you might encounter, along with proposed causes and solutions.
-
Symptom: CPU load increases significantly and nodes start going into a
Not Ready
state. - Cause: The storage domain latency might be too high, especially for master nodes.
Solution:
Make the nodes ready again by restarting the kubelet service. Enter:
systemctl restart kubelet
$ systemctl restart kubelet
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Inspect the OpenShift Container Platform metrics service, which automatically gathers and reports on some valuable data such as the etcd disk sync duration. If the cluster is operational, use this data to help determine whether storage latency or throughput is the root issue. If so, consider using a storage resource that has lower latency and higher throughput.
To get raw metrics, enter the following command as kubeadmin or user with cluster-admin privileges:
oc get --insecure-skip-tls-verify --server=https://localhost:<port> --raw=/metrics`
$ oc get --insecure-skip-tls-verify --server=https://localhost:<port> --raw=/metrics`
Copy to Clipboard Copied! Toggle word wrap Toggle overflow To learn more, see Exploring Application Endpoints for the purposes of Debugging with OpenShift 4.x
Symptom: The installation program completes but the OpenShift Container Platform cluster API is not available. The bootstrap virtual machine remains up after the bootstrap process is complete. When you enter the following command, the response will time out.
oc login -u kubeadmin -p *** <apiurl>
$ oc login -u kubeadmin -p *** <apiurl>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Cause: The bootstrap VM was not deleted by the installation program and has not released the cluster’s API IP address.
Solution: Use the
wait-for
subcommand to be notified when the bootstrap process is complete:./openshift-install wait-for bootstrap-complete
$ ./openshift-install wait-for bootstrap-complete
Copy to Clipboard Copied! Toggle word wrap Toggle overflow When the bootstrap process is complete, delete the bootstrap virtual machine:
./openshift-install destroy bootstrap
$ ./openshift-install destroy bootstrap
Copy to Clipboard Copied! Toggle word wrap Toggle overflow