NAME¶

dbginfo.sh - collect runtime, configuration and trace information for debugging Linux on IBM Z

SYNOPSIS¶

dbginfo.sh [OPTIONS]
dbginfo.sh {-h|-c|-v}

DESCRIPTION¶

This script collects runtime, configuration and trace information that can be used to debug a Linux on IBM Z instance. For Linux on z/VM, the script also traces information about the z/VM system. Virtualization platform data is collected on a host serving this.

The debug information is written to a file /<DIRECTORY>/DBGINFO-<date>-<time>-<hostname>-<processorid>.tgz where [date] and [time] are the date and time when the debug data was collected. [hostname] indicates the hostname of the system the data was collected from. The [processorid] is taken from the processor 0 and indicates the processor identification.

OPTIONS¶

-h, --help

Print usage information, then exit.

-v, --version

Print version information, then exit.

-d <DIRECTORY>, --directory <DIRECTORY>

Specify the DIRECTORY where the data collection stores the temporary data and the final archive. The specified directory must already exist. If this parameter is not specified, /tmp is used by default.

-c, --check

Print online quick check (not saving any data) - can be combined with a preceding -d option.

FILES¶

A .tgz file of the form

    DBGINFO-<year>-<month>-<day>-<hours>-<minutes>-<seconds>-<hostname>-<processorid>.tgz

EXAMPLE¶

Sample invocation:

[root@host]# dbginfo.sh -d /data-collection
dbginfo.sh: Debug information script version %S390_TOOLS_VERSION%
Copyright IBM Corp. 2002, 2024

Hardware platform = s390x
Runtime environment = z/VM - DPM: NO
Kernel version = 5.14.0 (5.14.0-427.13.1.el9_4.s390x)
OS version / distro = Red Hat Enterprise Linux 9.4 (Plow)
Date and time of info = 2024-07-11-11-11-11

1 of 20: Collecting sysfs

2 of 20: Collecting procfs

3 of 20: Collecting config files

4 of 20: Collecting initrd config files

5 of 20: Collecting command output

6 of 20: Collecting hyptop for z/VM - 5s output

7 of 20: Collecting z/VM output

8 of 20: Collecting network output

9 of 20: Collecting osa oat output

10 of 20: Collecting ethtool output

11 of 20: Collecting Traffic Control output

12 of 20: Collecting bridge output

13 of 20: Skip OpenVSwitch: ovs-vsctl not available

14 of 20: Skip KVM: no virsh command

15 of 20: Collecting container host output

Kubernetes ...
16 of 20: Collecting NVME storage output

17 of 20: Collecting DASD storage output

18 of 20: Collecting log files

0 logfiles over 50 MB

19 of 20: Postprocessing

20 of 20: Finalizing: Creating archive with collected data

Collected data was saved to:
>> /data-collection/DBGINFO-2024-07-11-11-11-11-host-012345.tgz <<
Please review all collected data before sending to your service organization.

HINTS¶

Run the script with root authority.
For Linux on z/VM, only z/VM guest virtual machines with class B privileges yield the complete debug information.