Notice: Our URL has changed! Please update your bookmarks. Dismiss

OCP Troubleshooting

This OpenShift troubleshooting guide is designed to provide you with links to resources for resolutions and issue on Container & PaaS technologies.

OpenShift Troubleshooting Guidance

The following troubleshooting guides are directly from the field as well as the official OpenShift documentation.

Official OCP Troubleshooting docs

Red Hat Customer Portal Solutions

Official Red Hat verified solutions and knowledge base articles with many helpful tips, tricks, instructions on how-to, and troubleshooting OpenShift. These solutions and articles will require a redhat.com username and password. If you do not have a redhat.com user account, you may register for free.

Troubleshooting

  • Common issues on OpenShift Container Platform 3 article contains a list of links to other resolutions for various issues with OpenShift, including installation, persistent volumes, registry, router, http proxies, subnets, CLI, routes, DNS, builds/deployments, SCCs, API, secrets, quotas/limits, CI/CD and Fluentd, environment issues and log files, and much more.

  • Troubleshooting OpenShift Container Platform: Basics article shares how to gather environment and debugging information, set log levels, CLI troubleshooting, registry issues, network issues, routing issues, control loop debugging, image builds (S2I / STI), and installer issues.

  • Troubleshooting OpenShift Container Platform: Middleware Containers article describes how to gather a JBoss Diagnostics Report (JDR), HEAP dump(s), thread dump(s), Garbage Collection (GC) logs, retrieve the standalone-openshift.xml, and the Dockerfiles from a running container.

  • Troubleshooting OpenShift Container Platform: OpenShift Ansible Playbooks article provides diagnostic steps for running OpenShift Ansible and logging a support case.

  • Troubleshooting OpenShift Container Platform: DNS article about DNS in OpenShift 3.6, OpenShift 3.2 - 3.5, OpenShift 3.1 - 3.0, DNS on an OpenShift Master and Node, and DNS troubleshooting.

  • Troubleshooting OpenShift Container Platform: Etcd article discusses getting started ETCD, ETCD v2, ETCD v3, and how to set debug logging.

  • Troubleshooting OpenShift Container Platform: Integrated Container Registry article contains steps for health checking and testing the registry, links to registry solutions, and information for opening a support ticket for the registry.

  • Troubleshooting OpenShift Container Platform: Aggregating Container Logging article shares several different types of aggregate logging issues that can fail due to a number of different reasons, such as ElasticSearch health, troubleshoot unassigned shards, ElasticSearch is out of disk, debugging FluentD, debugging Kibana, debugging ElasticSearch, SearchGuard, Kibana related solutions, FluentD related solutions, ElasticSearch related solutions, and an aggregated logging dump tool.

  • Troubleshooting OpenShift Container Platform: Cluster Metrics article provides solutions for various metric deployer issues, metrics cannot attach and/or mount the intended storage, metrics fails to deploy with persistent storage when PVC is self-created, pods failing to start, metrics from some nodes, checking the version of metrics images, do not use the latest tag for the metrics image version, metrics shows empty charts, after a few minutes, metrics charts show small gaps in the metrics, updating from previous versions of OpenShift, heapster "cannot find a node", metrics public URL is accessible but metrics tab says metrics are not available and 504 gateway timeout, heapster - increase application verbosity, and checking the health of the cassandra cluster.

  • Troubleshooting an applications (images) on OpenShift article describes troubleshooting application (or images) and can be broken up into 3 different areas: build errors, deployment errors, and applications errors including specific OpenShift image troubleshooting examples.

  • Troubleshoot HTTP readinessProbe in Openshift web applications article shares diagnostic steps for troubleshooting the HTTP readiness probe.

  • OpenShift Container Platform: internal networking issue article discusses internal OpenShift network issues for when target pod is not running, OVS SDN errors, hostsubnets has outdated IP address, master(s) running other DNS service than OpenShift internal SkyDNS, and includes a openshift-sdn debug script.

How To’s

Official Red Hat verified solutions and knowledge base how-to articles on specific use cases and troubleshooting OpenShift. These how-to articles will require a redhat.com username and password. If you do not have a redhat.com user account, you may register for free.

OpenShift Cheat Sheet (PDF)

Commands to manage an application’s lifecycle including resource management, cluster management, operational commands and more.

OCP Release Notes Known Issues

The following release notes for each verion of OpenShift Container Platform summarizes all new features, major corrections from the previous version, and any known bugs upon general availability.

  • OCP 3.7 Known Issues, new features, changes, and bug fixes that pertain to OpenShift Container Platform 3.7 are included in this topic.

  • OCP 3.6 Known Issues, new features, changes, and bug fixes that pertain to OpenShift Container Platform 3.6 are included in this topic.

  • OCP 3.5 Known Issues, new features, changes, and bug fixes that pertain to OpenShift Container Platform 3.5 are included in this topic.

  • OCP 3.4 Known Issues, new features, changes, and bug fixes that pertain to OpenShift Container Platform 3.4 are included in this topic.

  • OCP 3.3 Known Issues, new features, changes, and bug fixes that pertain to OpenShift Container Platform 3.3 are included in this topic.

  • OCP 3.2 Known Issues, new features, changes, and bug fixes that pertain to OpenShift Container Platform 3.2 are included in this topic.

  • OCP 3.1 Known Issues, new features, changes, and bug fixes that pertain to OpenShift Container Platform 3.1 are included in this topic.

  • OCP 3.0 Known Issues, new features, changes, and bug fixes that pertain to OpenShift Container Platform 3.0 are included in this topic.