repairvdiskcopy

Use the repairvdiskcopy command to detect and (optionally) correct any volume copies that are not identical.

Syntax

repairvdiskcopy   { -medium | -resync | -validate }   [  -startlba  lba  ] { vdisk_name | vdisk_id }

Parameters

-medium
(Optional) Converts sectors that contain different readable data into virtual medium errors on the specified volume. It fixes preexisting medium errors found on only one volume copy by replacing them with data from the other volume copy. This parameter cannot be used with the -validate and -resync parameters. You must specify one of the three parameters.
-resync
(Optional) Corrects sectors that contain different readable data by copying contents from the primary volume copy to other copies on the specified volume. It fixes preexisting medium errors found on only one volume by replacing them with data from the other volume. This parameter cannot be used with the -medium and -validate parameters. You must specify one of the three parameters.
-validate
(Optional) Reports the first difference in readable data found on synchronized online copies of the specified volume, on or after the specified -startlba value. This parameter cannot be used with the -medium and -resync parameters. You must enter one of the three parameters.
-startlbalba
(Optional) Specifies a starting logical block address (LBA) on which to begin the command. The LBA must be specified in hex, with a 0x prefix.
vdisk_name | vdisk_id
(Required) Specifies the volume to repair. You must specify this parameter last on the command line.

Description

The repairvdiskcopy command detects and optionally, corrects any volume copies that are not identical. For the purposes of comparison, preexisting medium errors found on only one volume are ignored and fixed by replacing them with data from the other volume copy. The results are logged to the Storwize V5000 error log. The -validate parameter compares synchronized online copies of the specified volume. The -medium parameter changes any sectors that are not identical into virtual medium errors. The -resync parameter copies any sectors that are not identical to the other volume copies. You cannot use this command with a volume that is fast formatting.

You must specify -validate, -medium, or -resync.

Attention:
  1. Before you run the repairvdiskcopy command, ensure that all volume copies are synchronized.
  2. Only one repairvdiskcopy command can run on a volume at a time. You must wait for the repairvdiskcopy command to complete processing before running the command again.
  3. Once you start the repairvdiskcopy command, you cannot use the command to stop processing.
  4. The primary copy of a mirrored volume cannot be changed while the repairvdiskcopy -resync command is running.

Use the -startlba parameter to specify a starting Logical Block Address (LBA). Enter an LBA value from 0 to full disk size minus one. The parameter logs the first error found and then stops the command. By repeating this parameter, you can collect all of the instances where the volume copies are not identical.

During repairvdiskcopy command operation, the volume remains online. The I/O and synchronization operations are allowed while the command is in progress.

The rate for the repairvdiskcopy command is controlled by the synchronization rate of the volume that is being repaired. To suspend the repair process, set the synchronization rate of the volume to 0 using the chvdisk command.

An invocation example

repairvdiskcopy -resync -startlba 0x0 vdisk8

The resulting output:

No feedback