Installing the dump tool for list-directed dump

Edit online

The list-directed DASD dump tool must be installed on a partition of a disk formatted with the compatible-disk layout.

Before you begin

You need the s390-tools package with the ngdump dracut module.
The dump partition needs enough free space (memory size + 10 MB) to hold the system memory.

About this task

A partition on an DASD is used as a dump partition.

The following examples assume that the DASD partition used is /dev/disk/by-path/ccw-0.0.1004-part1.

Procedure

Prepare the partition.

For example issue these commands:

Create the partition with fdasd using the configuration file:

# fdasd /dev/disk/by-path/ccw-0.0.1004 -c dasd.conf
For a single partition matching DASD size, the dasd.conf file's contents is as follows:
[first,last,native]

Optionally confirm that the partition was created:
```
# ls -l /dev/disk/by-path/ccw-0.0.1004-part1
```

Build and install the dump tool for list-directed dumps by using the zipl command. Use --ldipl-dump command option to indicate a list-directed ECKD dump-tool installation.

Specify the dump partition on the command line.

For example:

# zipl --ldipl-dump -d /dev/disk/by-path/ccw-0.0.1004-part1
run /lib/s390-tools/zipl_helper.prepare-ngdump /dev/disk/by-path/ccw-0.0.1004-part1 0
mke2fs 1.46.5 (<date>)
Building bootmap in ’/tmp/zipl-dump-mount-point-fNoO9a’
Adding dump section
  initial ramdisk...: /tmp/tmp.MJ1kv9t9uV
  kernel image......: /boot/vmlinuz-<version>
  kernel parmline...: ’reset_devices cgroup_disable=memory nokaslr numa=off irqpoll nr_cpus=component address:
    internal loader.: 0x0000a000-0x0000dfff
    parameters......: 0x00009000-0x00009fff
    kernel image....: 0x00010000-0x009d0fff
    parmline........: 0x009d2000-0x009d2fff
    initial ramdisk.: 0x009f0000-0x01f8ffff
Preparing boot device for LD-dump: dasda (1004).
Done.
#

Results

When you perform an IPL from device 1004, the memory dump is written directly to /dev/disk/by-path/ccw-0.0.1004-part1.