Running Must-Gather scripts

Edit online

You can run the Must-Gather script for IBM Storage Protect Server to collect diagnostic information required by IBM Support.

For more information about the script location, installation, and prerequisites, see Collecting diagnostic data using Must-Gather scripts.

Supported operating systems

  • Windows
  • Linux (RHEL)
  • AIX

Prerequisites

  • Perl 5.x or later must be installed on the system.
  • IBM Storage Protect Server must be installed for server-side data collection.
  • IBM Storage Protect BA Client must be installed.
  • IBM Storage Protect Server administrative credentials are required to perform server queries using dsmadmc.

How to run the Must-Gather script

  1. Open a terminal and navigate to the must-gather script directory.

    cd <must-gather-script-directory>

  2. Run the following command:

    perl mustgather.pl --product sp-server --output-dir <target_path> --adminid <id> --password <pwd> -m <modules>

Server data collection areas (modules)

Module Description
Config Collects Storage Protect configuration files and key command outputs such as dsmserv.opt, dsmffdc, query actlog, query system, query node f=d.
Tape Collects tape-related logs including query library, query drive, query path, show slots, and other tape diagnostic commands.
Replication Collects replication-related diagnostic logs including query replserver, query replrule, query replfailure, and query replnode.
stgpool Collects storage pool-related logs for analysis of backup, migration, reclamation, and container issues.

Output summary

At the end of execution, the script automatically creates a zip file:

mustgather_<product_name>_<timestamp>.zip

####### Starting Collection of sp-server diagnostic information ##############

Enter sudo password (if required): Admin! 0987654321

=== Must-Gather Collection Summary ===
Product                : IBM Storage Protect Server
Version                : Version 8.2.0.000
Platform               : Linux/x86_64
Server Name            : Server
Modules                            : Status
------------------------------------------------------------
1.	config                       : PARTIAL
2.	network                      : SUCCESS
3.	replication                  : SUCCESS
4.	server                       : PARTIAL
5.	stgpool                      :  SUCCESS
6.	system                       : SUCCESS
7.	tape                         : PARTIAL

Check script.log inside each module folder for detailed failures.

Output : /<target_directory>/mustgather_sp-server_20251119_003510.zip

This file can be sent to IBM Support team for analysis.

The .zip file contains the diagnostic data for each module.