Troubleshooting
Problem
This technote provides the steps necessary to collect data and logs for IBM Cloud Pak for AIOps.
Environment
| AIOPS MustGather Version | AIOPS Product Version |
|---|---|
| 1.30.0 or newer | 4.12.0 |
| 1.29.7 or newer | 4.11.1 |
| 1.29.0 or newer | 4.11.0 |
| 1.28.11 or newer | 4.10.1 |
| 1.28.0 or newer | 4.10.0 |
| 1.27.6 or newer | 4.9.1 |
| 1.27.0 or newer | 4.9.0 |
| 1.26.19 or newer | 4.8.1 |
| 1.26.0 or newer | 4.8.0 |
| 1.25.3 or newer | 4.7.1 |
| 1.23.0 or newer | 4.7.0 |
| 1.22.10 or newer | 4.6.1 |
| 1.22.0 or newer | 4.6.0 |
| 1.21.4 or newer | 4.5.1 |
| 1.21.0 or newer | 4.5.0 |
| 1.20.11 or newer | 4.4.1 |
| 1.20.0 or newer | 4.4.0 |
| 1.18.0 or newer | 4.3.0 |
| 1.17.4 or newer | 4.2.1 |
| 1.16.0 or newer | 4.2.0 |
| 1.14.3 or newer | 4.1.2 |
| 1.12.11 or newer | 4.1.1 |
| 1.11.0 or newer | 4.1.0 |
| 1.10.6 or newer | 3.7.2 |
| 1.10.0 or newer | 3.7.1 |
| 1.9.3 or newer | 3.7.0 |
Diagnosing The Problem
For installation-related problems, we recommend you use the command:
waiops-mustgather.sh -O installFor general problems (unsure about the root cause), we recommend you use the command:
waiops-mustgather.sh -O generalFor "AI Manager" related problems, we recommend you use the command:
waiops-mustgather.sh -O aimgrIf you want to know more about all the aliases available, you can use the command:
waiops-mustgather.sh -O .listaliasIMPORTANT: The ALIAS mode (-O xxx) is used to expand an alias into a pre-defined command. If there is a need to change or add any option, you need to revert to the conventional way of running the MustGather tool by providing all the options or flags manually. For example, if secret YAML is needed, you need to execute "-cypDfS" (plus any other options or flags).
If you want to know more about the MustGather tool and its advanced options, you can use the 'help' command:
waiops-mustgather.sh -hOnce the MustGather tool is executed successfully, upload output data file under the "/tmp/mg" (or directory of your choice through the "-o" option) directory to IBM Support website.
IMPORTANT: Make sure to uncompress the downloaded WAIOPS MustGather package in its own directory (not sharing with any other files or directories).
If you use a terminal for download, the command is:
wget https://www.ibm.com/support/pages/system/files/inline-files/waiops-mustgather-v1.30.0.tar.gzIf you want to download an older version of the MustGather tool, the command is:
wget https://www.ibm.com/support/pages/system/files/inline-files/waiops-mustgather-v<VERSION>.tar.gz
NOTE: Download the attached script to any machine that has valid access to the target cluster (able to run 'oc' command successfully).
To upgrade the MustGather tool to its latest version:
waiops-mustgather.sh -UDDocument Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSRS1M","label":"IBM Cloud Pak for Watson AIOps"},"ARM Category":[{"code":"a8m0z0000001jFJAAY","label":"Watson AIOps"}],"ARM Case Number":"","Platform":[{"code":"PF016","label":"Linux"}],"Version":"3.1.0;and future releases"}]
Was this topic helpful?
Document Information
Modified date:
29 May 2025
UID
ibm17022441