Select Your Language

Infrastructure and Management

Cloud Computing

Storage

Runtimes

Integration and Automation

Troubleshooting OpenShift Container Platform 4.x: Operator Lifecycle Manager (OLM)

Updated on

Request a new translation or translation update

A translation for your language preference does not exist. Click below to request a translation for your selected language.

Submit request

Information Gathering

Its always a good idea to capture a standard OpenShift Must Gather in addition to information below.

An improvement is pending for the OpenShift Must Gather to capture all OLM details: https://github.com/openshift/must-gather/pull/182/files.

Get Everything

The following command results in a very large amount of data and can be unwieldy for troubleshooting:

# oc adm inspect -A olm

Specific Namespace

If your issue is isolated to installing into a specific namespace try:

# oc adm inspect olm -n <NAMESPACE>

Troubleshooting a Hanging Installation

General Guidance

If an operator isn't installing, the first thing to do generally is look at the status of the various install objects. First look at Subscription, then InstallPlan, and finally ClusterServiceVersion. Review the status section of each resource for errors or warnings.

It's also helpful to look at the logs of the catalog-operator pod in the openshift-operator-lifecycle-manager namespace. There should be a message indicating an error or warning that is preventing installation.

There's no general troubleshooting path for all types of failing installations but this article will be updated and link to other knowledge-base entries for specific types of failures. However, most solutions will start with looking at the various OLM resources like above.

Common Mistake with Manual Approval InstallPlans

If you have an InstallPlan requiring manual approval to upgrade, this will cause all other InstallPlans in the same Namespace or Project to also require manual approval. This behaviour is expected and exists so that all dependencies for installed or upgrading Operators can be checked properly.

Note that https://issues.redhat.com/browse/RFE-1282 was created to try and reflect this behaviour better in the OpenShift Web Console.

Specific Operator Install and Upgrade Issues

This solution is part of Red Hat's fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.

Red Hat LinkedIn YouTube Facebook X, formerly Twitter

Quick Links

Help

Site Info

Related Sites

© 2026 Red Hat