IBM Support

[CP4AIOps MustGather] How to collect data from a pre-installation CP4AIOps cluster running on Linux/k3s?

How To


Summary

Method to collect data from a pre-installation CP4AIOps cluster running on Linux/k3s.

Environment

OCP Server = 4.16.47
OC Client = 4.16.47
CP4AIOps MustGather = 1.29.1
CP4AIOps = 4.11.0
IMPORTANT: To use this feature, the node where the MustGather is running on must be able to access all the cluster nodes in a SSH passwordless way.

Steps

(1) Download the latest CP4AIOps MustGather (link).
 
OR
 
Upgrade the current CP4AIOps MustGather to the latest version:
./waiops-mustgather.sh -UD
(2) Make sure you have access to the environment variables shell script:
Eg.
# cat /tmp/a.sh
#================================================================================================================================
# IBM Cloud Pak for AIOps installation variables (Linux)
#================================================================================================================================
export TARGET_USER="root"
export ACCEPT_LICENSE=false # Set to true to agree to the license terms.

# --------------------------------------------------------------------------------------------------------------------------------
# IBM Entitled Registry
# --------------------------------------------------------------------------------------------------------------------------------
export IBM_ENTITLEMENT_KEY=abc123 # Set to the entitlement key retrieved in previous step.

# --------------------------------------------------------------------------------------------------------------------------------
# Hostnames
# `<load_balancer_hostname>` - the hostname of your load balancer
# `<control_plane_node_n>` - the FQDN or IP address of each control plane node. For example, "control_plane_node_1.example.com"
# `<worker_n>` - the FQDN or IP address of each worker node. For example, "worker_1.example.com"
# --------------------------------------------------------------------------------------------------------------------------------
export LOAD_BALANCER_HOST="testvm-20251007053028-lb.dev.mytest.com"
export CONTROL_PLANE_NODE="testvm-20251007053028-server-1.dev.mytest.com"
export ADDITIONAL_CONTROL_PLANE_NODES=(
  "testvm-20251007053028-server-2.dev.mytest.com"
  "testvm-20251007053028-server-3.dev.mytest.com"
)
export WORKER_NODES=(
  "testvm-20251007053028-agent-1.dev.mytest.com"
  "testvm-20251007053028-agent-2.dev.mytest.com"
  "testvm-20251007053028-agent-3.dev.mytest.com"
  "testvm-20251007053028-agent-4.dev.mytest.com"
  "testvm-20251007053028-agent-5.dev.mytest.com"
  "testvm-20251007053028-agent-6.dev.mytest.com"
  "testvm-20251007053028-agent-7.dev.mytest.com"
  "testvm-20251007053028-agent-8.dev.mytest.com"
)

# -----------------------------------------------------------------------------------------------------------
# Incremental adoption - set your deployment type.
# Set to `extended` to install an extended deployment with log anomaly detection and ticket analysis capabilities
# Set to `base` to install a base deployment without log anomaly detection and ticket analysis capabilities
# -----------------------------------------------------------------------------------------------------------
export DEPLOY_TYPE="base"

# -------------------------------------------------------------------------------------------------------------------------------
# Storage
# -------------------------------------------------------------------------------------------------------------------------------
export APP_STORAGE_PATH="/var/lib/aiops/storage"
export PLATFORM_STORAGE_PATH="/var/lib/aiops/platform"

(3) Execute the following command:
export NON_CLOUD=true; ./waiops-mustgather.sh -DO k3s-preinstall -W 'AIOPS_VAR_SH=<full_path_to_env_var_sh_script>'
(4) The cluster data can be found in the "2-CLUSTERNODES" directory of the output file.
In the directory, there are data files for various commands and under the "FILES" subdirectory, there are data files for "aiopsctl".

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSE9G0Q","label":"IBM Cloud Pak for AIOps"},"ARM Category":[{"code":"a8m3p000000LRdhAAG","label":"Watson AIOps-\u003EAI Manager-\u003EScripts-\u003EMustgather"}],"ARM Case Number":"","Platform":[{"code":"PF016","label":"Linux"}],"Version":"4.10.0;4.10.1;4.11.0;4.11.1;4.2.0;4.2.1;4.3.0;4.4.0;4.4.1;4.5.0;4.5.1;4.6.0;4.6.1;4.7.0;4.7.1;4.8.0;4.8.1;4.9.0;4.9.1"}]

Document Information

Modified date:
07 October 2025

UID

ibm17247326