repairvdiskcopy

The repairvdiskcopy command detects and optionally, corrects any VDisk copies that are not identical.

Syntax


>>-svctask-- --repairvdiskcopy-- --+------------+-- ------------>
                                   +- -medium---+      
                                   +- -resync---+      
                                   '- -validate-'      

>--+--------------------+--+-vdisk_name-+----------------------><
   '- -startlba -- lba -'  '-vdisk_id---'

Parameters

-medium: (Optional) Converts sectors that contain different contents into virtual medium errors on the specified VDisk. This parameter cannot be used with the -validate and -resync parameters; you must enter one of the three parameters.
-resync: (Optional) Corrects sectors that contain different contents by copying contents from the primary VDisk copy to other copies on the specified VDisk. This parameter cannot be used with the -medium and -resync parameters; you must enter one of the three parameters.
-validate: (Optional) Reports the first difference found on synchronized online copies of the specified VDisk, 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.
-startlba lba: (Optional) Specifies a starting Logical Block Address (LBA) on which to begin the command.
vdisk_name | vdisk_id: (Required) Specifies the virtual disk to repair. You must specify this parameter last on the command line.

Description

The repairvdiskcopy command detects and optionally, corrects any VDisk copies that are not identical. The results are logged to the SAN Volume Controller error log. The -validate parameter compares synchronized online copies of the specified VDisk. 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 VDisk copies. You must specify only one of the three parameters.

Attention:

Before you run the repairvdiskcopy command, ensure that all VDisk copies are synchronized.
Only one repairvdiskcopy command can run on a VDisk at a time. You must wait for the repairvdiskcopy command to complete processing before running the command again.
Once you start the repairvdiskcopy command, you cannot use the command to stop processing.
The primary copy of a mirrored VDisk 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 - 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 VDisk copies are not identical.

During repairvdiskcopy command operation, the VDisk 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 VDisk that is being repaired. To suspend the repair process, set the synchronization rate of the VDisk to 0 using the chvdisk command.

An invocation example

svctask repairvdiskcopy -resync vdisk8

The resulting output

No feedback