Replacing operational or failed storage devices on IBM Z or LinuxONE infrastructure

Use this information to replace operational or failed storage devices on IBM Z or LinuxONE infrastructure.

Before you begin

IBM recommends that replacement devices are configured with similar infrastructure and resources to the device being replaced.
Ensure that the data is resilient.
In the OpenShift Web Console, click Storage > Data Foundation.
Click the Storage Systems tab, and then click ocs-storagecluster-storagesystem.
In the Status card of Block and File dashboard, under the Overview tab, verify that Data Resiliency has a green tick mark.

About this task

You can replace operational or failed storage devices on IBM Z or LinuxONE infrastructure with new Small Computer System Interface (SCSI) disks.

IBM Z or LinuxONE supports SCSI FCP disk logical units (SCSI disks) as persistent storage devices from external disk storage. You can identify a SCSI disk using its FCP Device number, two target worldwide port names (WWPN1 and WWPN2), and the logical unit number (LUN). For more information, see Planning and Administration > z/VM: CP Planning and Administration > Storage Planning and Administration > Defining and Managing SCSI FCP Disks within IBM z/VM documentation.

Procedure

List all the disks.

$ lszdev

Example output:

TYPE         ID
zfcp-host    0.0.8204                                        yes  yes
zfcp-lun     0.0.8204:0x102107630b1b5060:0x4001402900000000 yes  no    sda sg0
zfcp-lun     0.0.8204:0x500407630c0b50a4:0x3002b03000000000  yes  yes   sdb sg1
qeth         0.0.bdd0:0.0.bdd1:0.0.bdd2                      yes  no    encbdd0
generic-ccw  0.0.0009                                        yes  no

A SCSI disk is represented as a zfcp-lunwith the structure <device-id>:<wwpn>:<lun-id> in the ID section. The first disk is used for the operating system. If one storage device fails, you can replace it with a new disk.

Remove the disk.
Run the following command on the disk, replacing scsi-id with the SCSI disk identifier of the disk to be replaced:
```
chzdev -d scsi-id
```
For example, the following command removes one disk with the device ID 0.0.8204, the WWPN 0x500507630a0b50a4, and the LUN 0x4002403000000000:
```
chzdev -d 0.0.8204:0x500407630c0b50a4:0x3002b03000000000
```
Append a new SCSI disk.
```
chzdev -e 0.0.8204:0x500507630b1b50a4:0x4001302a00000000
```
Note: The device ID for the new disk must be the same as the disk to be replaced. The new disk is identified with its WWPN and LUN ID.

List all the FCP devices to verify the new disk is configured.

lszdev zfcp-lun

Example output:

TYPE         ID                                              ON   PERS  NAMES
zfcp-lun     0.0.8204:0x102107630b1b5060:0x4001402900000000 yes  no    sda sg0
zfcp-lun     0.0.8204:0x500507630b1b50a4:0x4001302a00000000  yes  yes   sdb sg1