Storage Foundation 8.0 Administrator's Guide - Windows

vxdg split

vxdg -g<SourceDynamicDiskGroupName> -n<TargetDynamicDiskGroupName>

[-i] [-f] [-s|-d] [-y] [-v] split [<Object>...]

Splits a dynamic disk group into two dynamic disk groups. The disks and volumes that are in the split-off disk group must be healthy. Also, the volumes that are in the new disk group must be complete for the command to succeed.

Microsoft Disk Management Disk Groups do not support the vxdg split command.

If you have dynamic disk groups created in an early release of Volume Manager, you need to upgrade them to be compatible with Storage Foundation for Windows dynamic disk groups before you can use the vxdg split and join commands. To do this you use the vxdg upgrade command.

By default, the new dynamic disk group is in the Deported state after the split. You can use the -i option to have it be in the Imported state. The source dynamic disk group remains in the Imported state.

With the VEA GUI split command, if the source disk group is a cluster disk group or a disk group with private dynamic disk group protection, the resulting target disk group is of the same disk group type. With a CLI split command for either of these two disk group types, you must use the -i switch. In a CLI split operation with either of these disk group types, the target disk group does not assume the disk group type of the source disk group until after the target disk group is imported.

Before using dynamic disk group split and join commands with a cluster on shared storage, you should review the considerations for doing so.

Examples

vxdg -gDynDskGrp1 -y -nDynDskGrp2 split Harddisk5 Harddisk7

This command makes a query to determine whether Harddisk5 and Harddisk7 in a dynamic disk group named "DynDskGrp1" comprise the total disks that are needed to have a dynamic disk group split where all the volumes in the split-off dynamic disk group are complete. Here is the output from the command:

Following is the Closure for the requested Splitoperation.
Names of the Disks are....
Harddisk7
Harddisk5
Harddisk6
Names of the Volumes are....
\Device\HarddiskDmVolumes\DynDskGrp1\Volume1
\Device\HarddiskDmVolumes\DynDskGrp1\Stripe1

The output indicates that to have a successful split, or what is called "split closure," Harddisk6 must be added. The example of the command to perform the actual split is as follows:

vxdg -gDynDskGrp1 -i -nDynDskGrp2 split Harddisk5 Harddisk6 Harddisk7

This command results in successfully splitting the dynamic disk group DynDskGrp1 with the target dynamic disk group DynDskGrp2 in the Imported state. The new dynamic disk group has the disks Harddisk5, Harddisk6, and Harddisk7.

The example that follows designates the volumes to be included in a new target disk group. Note the path name that is needed for volumes.

vxdg -gDynDskGrp1 -i -nDynDskGrp2 split
\Device\HarddiskDmVolumes\DynDskGrp1\mirrorvol1
\Device\HarddiskDmVolumes\DynDskGrp1\mirrorvol2

This command results in successfully splitting the dynamic disk group DynDskGrp1 with the target dynamic disk group DynDskGrp2 in the Imported state. The new dynamic disk group contains the volumes \Device\HarddiskDmVolumes

\DynDskGrp2\mirrorvol1 and \Device\HarddiskDmVolumes

\DynDskGrp2\mirrorvol2.

vxdg -gtest -nnew split p1c0t1l0 p1c0t2l0

This command performs the split operation. The name of the new disk group is "new." This command shows an example of the use of the p#c#t#l# with the <Object> parameter.

vxdg -gtest -nnew split Disk1 Disk2

This command performs the split operation. This example shows the use of the internal disk name with the <Object> parameter.

vxdg -gtest -nnew split Volume1 Volume2

This command performs the split operation. This example shows the use of the internal volume name with the <Object> parameter.

vxdg -gtest -nnew split L:\Folder

This command performs the split operation. This example shows the use of <DrivePath> with the <Object> parameter.

vxdg -gtest -nnew split Volume1 Volume2 -f

This command performs the split operation. This example shows the use of the -f force option.