PRIMEQUEST System Disk Mirror for Windows User's Guide V1.0

A.1 sdxsysdisk - Mirroring and unmirroring

Command name

sdxsysdisk - Mirroring and unmirroring

 

Synopsis

sdxsysdisk -A -g group -p device,... [-e delay=msec]

sdxsysdisk -M -p device[:type][,device[:type]]

sdxsysdisk -R {-g group,... | -d disk,...}

sdxsysdisk {-h | /?}

 

Description

The sdxsysdisk command sets or unsets the mirroring configuration.

To use this command, you must be a user with administrator privileges (a user of the Administrators group).

 

Primary options

-A

Adds mirror destination disks to an existing mirror group.

If a mirror disk in VALID status exists within the mirror group, synchronization copying from the VALID mirror disk to the added mirror destination disks is performed.

-M

Creates a new mirror group.

If a mirror destination disk is registered, synchronization copying from the mirror source disk to the mirror destination disk is performed.

-R

Removes mirror groups or mirror disks.

When mirror disks are removed, one or more mirror disks in VALID status must remain in the mirror group after the removal.

If a mirror group is removed, mirror disks within the mirror group are also removed. One of the disks in VALID status will then be a disk that stores data and data on the other disks will no longer be ensured.

After any mirror disk or mirror group removal, the system will be rebooted automatically.

-h

Shows the usage of the command.

/?

Shows the usage of the command.

 

Sub options

-d disk,...

Sets mirror disks that are removed from the mirror group.

For disk, specify the mirror disk name in the format of Diskn (where n is the mirror disk number).

-e delay=msec

Sets delay time of the synchronization copying process (in milliseconds). An integer in the range of 0 to 1000 (including 0 and 1000) can be set. The default delay time is 0.

If this option is set, for the mirror destination disks added to the mirror group, given quantity of copying is performed at msec millisecond intervals. With this option, the synchronization copying load imposed on the system can be reduced. Note, however, that if larger delay time is set, longer time is required to complete synchronization copying.

-g group

Sets the mirror group to which disks are added or the mirror group that is removed.

For group, specify the mirror group name in the format of Groupn (where n is the mirror group number).

-p device,... (along with -A)

Sets the disk numbers of disks added to the mirror group.

The disk numbers are displayed in Windows [Disk Management] or in the Disk ### field output by the list disk command of the diskpart command.

-p device[:type][,device[:type]] (along with -M)

Sets the disk numbers and type attributes of disks registered with the mirror group by the combination of device and type.

For type, specify either one of the following values. The keep attribute must be specified to one of the disks. The default disk type attribute is undef.

keep

Sets the disk as the mirror source disk.

undef

Sets the disk as a mirror destination disk.

 

Exit codes

0 : Normal end
1 : Abnormal end (indicating that the error is not a temporary error and the command will fail even if it is retried after a while)
2 : Abnormal end (indicating that the error is a temporary error and the command may succeed if it is retried after a while)
3 : Abnormal end (indicating that an option was specified incorrectly)

Execute the following command immediately after this command ends to get the exit code.

> echo %ERRORLEVEL%

 

Examples

1. Set up mirroring using a disk numbered 0 as the mirror source and a disk numbered 1 as the mirror destination.

   > sdxsysdisk -M -p 0:keep,1:undef

   
   

2. Remove the mirror group Group0 to unset mirroring.

   > sdxsysdisk -R -g Group0

   
   

3. Add a disk numbered 2 to the mirror group Group0.

   > sdxsysdisk -A -g Group0 -p 2

   
   

4. Remove the mirror disk Disk1 from PSDM management.

   > sdxsysdisk -R -d Disk1