IBM Support

Mustgather: Collecting data to diagnose issues with IBM Cloud Pak for Business Automation



This document describes the general information and diagnostic data needed to start troubleshooting issues related to container components included in IBM Cloud Pak for Business Automation (CP4BA). When you open a case for the Cloud Pak for Business Automation, include the diagnostics retrieved from using this document.
Note: Previously called Cloud Pak for Automation

Resolving The Problem

When you contact support for assistance with a Cloud Pak for Business Automation issue, collect the following troubleshooting data.

General Diagnostic Information
These items are the general diagnostics, which are useful in most situations regardless of component.  When you run the diagnostic commands, run them from an empty collection directory to make it easy to package the files. Run the commands from the project or namespace containing Cloud Pak for Business Automation or use the -n <namespace> flag with all oc commands.
Note: oc commands are interchangeable with kubectl.

1: Provide a detailed description of the problem and your environment

  • Provided a detailed description of your issue. Include screen captures and re-create steps if possible.
    Is it an intermittent or recreatable issue? Has this problem always been an issue or is it an issue that started only after a change occurred?
    What is the business impact? Do we need to be aware of any deadlines impacted by the issue?
    Provide details on which component of the Cloud Pak has issues.
  • Provide a reference to the documentation being followed for the failing operation.
  • Is this environment development, test, or production?
  • Which platform setup are you using (OpenShift, OpenShift on IBM Cloud Public, other Kubernetes platform)?
  • What is the database type and version?

2: Gather configuration information

  • Provide the OpenShift and Kubernetes version information:
    oc version > version.txt
    kubectl version >> version.txt
  • Provide the operator version information:
    oc get csv > operatorInfo.txt
    oc get csv -n ibm-common-services >> operatorInfo.txt
  • Provide the Custom Resource(CR) .yaml file used by the operator to configure the environment
    oc get icp4acluster -o yaml > config.yaml
  • If you have the needed permissions, collection information about the nodes.
    oc get nodes -o wide > nodes.txt
    oc get mcp > mcp.txt
  • Collect information about the pod statuses
    oc get pods > pods.txt
  • Collect information about the pod containers
    oc get pods -o jsonpath="{..image}" > containerInfo.txt
  • On OpenShift gather route configuration
    oc get route > routes.txt
    Note: If needed, more detailed route config information can be gotten with -o yaml option
  • Collect the defined secrets
    oc get secrets > secrets.txt
  • Collect the defined persistent volume claims
    oc get pvc > pvcs.txt
  • For installation or upgrade problems, get the job information:
    oc get jobs > jobs.txt
  • Collect the description and log of any pod you are having issues with:
    oc describe pod <pod-name> > describe-<podname>.txt
    oc logs <podname> > log-<podname>.log

3: Collect Operator logs

If you are having issues during the deployment by the operator, then collect the operator logs described in the installation troubleshooting page.

4: Collect Browser data for UI issues

For console or web application usage issues, capture the following browser data:

Component-Specific Diagnostics
For issues related to a particular Cloud Pak container component, we recommend reviewing the MustGather or troubleshooting page for that component.

What to do next

  1. Review the diagnostic at the time of the problem to try to determine the source of the problem.
  2. Check these locations for known issues:
  3. Once you complete gathering all the needed information and diagnostics, you can add them to your case. Alternatively, you can upload files to ECURep. For more information, see Enhanced Customer Data Repository (ECuRep) - Overview.

Document Location


[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS7JTW","label":"IBM Digital Business Automation"},"Component":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
18 October 2021