Installing the NVMe disk dump tool

You install the NVMe disk dump tool with the zipl command.

Before you begin

You need the s390utils RPM with the ngdump dracut module.
The dump partition needs enough free space (memory size + 10 MB) to hold the system memory.
Depending on your HMC version, you might have to install the NVMe dump tool on a partition in name space 1 to be able to trigger an LPAR dump from the HMC GUI.

About this task

A partition on an NVMe disk is used as a dump partition.

The following example assumes that the device node for this partition is /dev/nvme0n1p1. In the node name, n1 denotes name space 1 and p1 partition 1 on that name space.

Procedure

Create the partition with sfdisk, using the GPT or MBR layout.
For example issue these commands:
```
# echo "label: gpt" | sfdisk /dev/nvme0n1
# echo ";" | sfdisk /dev/nvme0n1
```
You can confirm that the partition has been created by issuing ls -l /dev/nvme0n1p1.
Install the dump tool by using the zipl command.
Specify the dump partition on the command line:
For example:
```
# zipl -d /dev/nvme0n1p1
```
Optional: Confirm that name space 1 of your NVMe disk is a valid dump device.
For example:
```
# zgetdump -d /dev/nvme0n1
```
See also, Checking whether an NVMe disk contains a valid dump record.

Results

When you perform an IPL from /dev/nvme0n1 by using boot program selector 1 or 0 (default), the memory dump is written directly to /dev/nvme0n1p1. The boot program selector is located on the load panel.