Installing the SCSI disk dump tool

You install the SCSI disk stand-alone dump tool with the zipl command.

Before you begin

The dump partition needs enough free space (memory size + 10 MB) to hold the system memory.

The following examples assume that a SCSI dump disk is accessed through the partition device node on a device mapper multipath device /dev/mapper/36005076303ffd40100000000000020c0-part1 and is IPLed with the following parameters:

devno: 0.0.4711
wwpn: 0x4712076300ce93a7
lun: 0x4712000000000000

Example

A partition on a SCSI disk is used as dump partition.

This example assumes that /dev/mapper/36005076303ffd40100000000000020c0 is the dump device, and that you want to dump to the first partition, /dev/mapper/36005076303ffd40100000000000020c0-part1. Always use multipath devices instead of single path SCSI disk device nodes, if possible.

Create a partition with fdisk or parted, using the PC-BIOS or GPT layout.
For example:
```
# fdisk /dev/mapper/36005076303ffd40100000000000020c0
```
Install the dump tool by using the zipl command. You can specify the dump device on the command line or use a configuration file.
Command line example:
```
# zipl -d /dev/mapper/36005076303ffd40100000000000020c0-part1 
```
Configuration file example:
1. Edit /etc/zipl.conf to add the following lines:
```
[scsidump]
dumpto=/dev/mapper/36005076303ffd40100000000000020c0-part1
```
2. Issue zipl:
```
# zipl scsidump
```

When you perform an IPL from /dev/mapper/36005076303ffd40100000000000020c0 by using boot program selector 1 or 0 (default), the memory dump is written directly to partition 1 of /dev/mapper/36005076303ffd40100000000000020c0. The boot program selector is located on the load panel, see Figure 2 for an example.