Troubleshooting

Known limitations for the IBM Cloud Pak for Integration (CP4I) are documented on the IBM Support site. To help IBM Support troubleshoot issues, you can run the must-gather image to collect data from your Red Hat OpenShift cluster.

Gathering logs

To help IBM Support troubleshoot any issues with your CP4I instance, use the oc adm must-gather command to capture the must gather logs. The logs are stored in a folder in the current working directory.

To gather diagnostic logs:

  1. Log in to your Red Hat OpenShift Container Platform as a Cluster Administrator using the oc CLI.

  2. Collect the logs using the oc adm must-gather command:

    oc adm must-gather --image=quay.io/opencloudio/must-gather:4.4.0 -- gather [-n <namespace>]

You can customize the data collected by selecting specific modules used to gather support data, for more information, run:

oc adm must-gather --image=quay.io/opencloudio/must-gather:4.4.0 -- gather --help

Collected data are stored in an archive file in a folder in the current working directory. For example, the must-gather archive could be located on the path:

must-gather.local.6409880158745169979/quay-io-opencloudio-must-gather-sha256-2d4271887699131170d12177b543468d3b5cd86a7bfd050c257a8e5091352dc5

You can customize the output directory and other must-gather options, for more information, run oc adm must-gather --help.