Running Must-Gather scripts
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
How to run the Must-Gather script
- Open a terminal at the Must-Gather script directory.
- Run the following command. For example:
perl mustgather.pl --product sp-server --output-dir <target_path> --caseno <case_number> --adminid <id> -m <module_name> [options]
Storage Protect Server modules
| Module | Description |
|---|---|
| replication |
Collects replication configuration, rules, statuses, backlog details, and replication server information. |
| stgpool |
Retrieves detailed storage pool information, statistics, volume associations, and storage pool queries. |
| tape |
Collects tape library, drive, path definitions, volume information, and tape-related diagnostics. |
| dbbackup |
Collects database backup configuration, history, schedules, volume history, and DB backup–related diagnostics. |
| dbreorganisation |
Gathers database reorganization details, DB2 formula analysis, server reorganization information, and database statistics. |
| expiration |
Collects expiration configuration, status, schedules, inventory expiration details, and recent expiration activity. |
| tiering |
Collects data tiering configuration, policies, tiering status, storage tier definitions, and activity details. |
| librarysharing |
Collects library sharing configuration, device definitions, paths, library manager information, and sharing status. |
| lanfree |
Gathers LAN-free configuration, SAN device mappings, storage agent definitions, and related diagnostics. |
| oc |
Collects Operation Center (OC) configuration, capacity usage, and related diagnostics. |
| install-upgrade |
Collects installation and upgrade history, version details, and related logs. |
| server-crash |
Collects server crash diagnostics including logs, stack traces (if available), and crash-related information. |
| dbcorruption |
Collects diagnostics related to database corruption. |
| nas-ndmp |
Collects NAS NDMP–related diagnostics for backup or restore issues. |
| objectAgent |
Collects object agent server configuration, object client node information, protect.log, config files, and process details. |
| retentionSet |
Collects retention set configuration, retention rules, job status (active, interrupted, terminated), and retention set contents. |
Output summary
At the end of execution, the script automatically creates a zip file:
mustgather_<case_number>_<product_name>_<timestamp>.zip
=== Must-Gather Collection Summary ===
Product : <product_name>
Version : Version 8, Release 2, Level 2.0
Node Name : TEST
Server Name : server1
Modules : Status
-----------------------------
1. system : Success
2. dbbackup : Success
3. dbcorruption : Success
4. dbreorganisation: Success
5. expiration : Success
6. install-upgrade : Success
7. lanfree : Success
8. librarysharing : Success
9. nas-ndmp : Success
10. network : Success
11. oc : Success
12. replication : Success
13. server : Success
14. server-crash : Success
15. stgpool : Success
16. system : Success
17. tape : Success
18. tiering : Success
19. objectAgent : Success
20. retentionSet : Success
Check script.log inside each module folder for detailed failures.
Output : <output-dir>/mustgather_TS198234567_sp-client-ba_20251124_165659.zip
This file can be sent to IBM Support team for analysis.The .zip file contains the diagnostic data for each module.