Collecting support information about the cluster

You can use the MustGather tool to collect information about your cluster. IBM® Support uses the collected information to help you troubleshoot and fix problems.

Run the Red Hat® OpenShift® must-gather and describe commands before you contact IBM Support to save time.

Procedure

  1. Open a command-line interface at the directory where you want to store the MustGather data.
  2. Log in to your Red Hat OpenShift cluster. The username must have cluster-admin permissions.
    oc login https://your_cluster_hostname -u username -p password
  3. Run the Red Hat OpenShift must-gather command.

    Replace instance_namespace and operator_namespace with the namespace values of your installation.

    oc adm must-gather --image=quay.io/opencloudio/must-gather:4.5.4 -- gather -n instance_namespace,operator_namespace -m failure,overview,cloudpak

    The command compresses the collected data into a .tgz output file and stores it in ./must-gather.local.random_number.

  4. Run Red Hat OpenShift describe commands to gather data about the state of your WebSphereSecure and WebSphereAutomation instances.

    The MustGather tool does not gather data about custom resources. Use the describe command to gather data about instances. Replace the instance_namespace variables with the namespace values for your instances.

    oc describe webspheresecure -n WebSphereSecure_instance_namespace > webspheresecure.txt
    oc describe websphereautomation -n WebSphereAutomation_instance_namespace > websphereautomation.txt
    oc describe webspherehealth -n WebSphereHealth_instance_namespace > webspherehealth.txt
  5. Open a Support Ticket with IBM Support.
    1. Click Open a case on the WebSphere Automation support or Let's troubleshoot page.
    2. Add information that can help IBM Support determine the cause of the error.

      In the ticket, describe the error. If the error is difficult to describe, then provide a screen capture of the error. Also, provide pertinent information, such as a description of your cluster configuration and the component that is failing or having issues.

    3. Attach the MustGather .tgz output file and the .txt files that have data about your WebSphereSecure and WebSphereAutomation instances.