splitvg Command

Purpose

Splits a single mirror copy of a fully mirrored volume group.

Syntax

splitvg  [-y SnapVGname] [-c  Copy | -p mirrorpool] [-k] [-f] [-i] VGname

Description

The splitvg command splits a single mirror copy of a fully mirrored volume group into a snapshot volume group. The original volume group VGname will stop using the disks that are now part of the snapshot volume group SnapVGname. Both volume groups will keep track of the writes within the volume group so that when the snapshot volume group is rejoined with the original volume group consistent data is maintained across the rejoined mirrors copies.

Note:

To split a volume group, all logical volumes in the volume group must have the target mirror copy and the mirror must exist on a disk or set of disks. Only the target mirror copy must exist on the target disk or disks.
The splitvg command will fail if any of the disks to be split are not active within the original volume group.
In the unlikely event of a system crash or loss of quorum while running this command, the joinvg command must be run to rejoin the disks back to the original volume group.
New logical volumes and file system mount points will be created in the snapshot volume group.
When the splitvg command targets a concurrent-capable volume group which is varied on in non-concurrent mode, the new volume group that is created will not be varied on when the splitvg command completes. The new volume group must be varied on manually.
You cannot add or remove an authentication method of an encrypted logical volume in primary or snapshot volume group.
The primary and the snapshot volume group can use the same authentication method.

Flags

Item	Description
-c Copy	Specifies the mirror copy that must be split. Valid values are 1, 2, or 3. The default is the second copy.
-f	Force splits even if the mirror copy specified to create the snapshot volume group has stale partitions.
-i	Splits the mirror copy of a volume group into a new volume group that cannot be rejoined into the original. Note: Copies the passphrase authentication methods from the original encrypted logical volume to the new encrypted logical volume. If the original logical volume has PKS method, new PKS method are added in the new encrypted logical volume if PKS key slots are available. Deletes the key server method in new encrypted logical volume. Use the -k flag to copy the key server method from the original encrypted logical volume. Deletes the key file authentication method in the new encrypted logical volume.
-k	Copies the key server method from the original encrypted logical volume to the new logical volume in the new volume group. Note: Both original and new encrypted logical volumes share the same key server authentication method. If you remove the key server authentication method from one logical volume, the other logical volume cannot access the key server authentication method as well.
-p mirrorpool	Specifies the mirror pool that must be split. The default is the second copy.
-y SnapVGname	Allows the volume group name to be specified rather than having the name generated automatically. Volume group names must be unique across the system and can range from 1 to 15 characters. The name cannot begin with a prefix already defined in the PdDv class in the Device Configuration database for other devices. The new volume group name is sent to standard output.

Security

Access Control: You must have root authority to run this command.

Examples

To split a volume group, enter the following command:
```
splitvg testvg
```
The second mirror copy of the volume group testvg is split into new volume group with an automatically generated name, which will be displayed.
To split first mirror copy of the volume group with the name snapvg, enter the following command:
```
splitvg -y snapvg -c 1 testvg
```
To split the mp1 mirror pool in the vg00 volume group to a snapvg snapshot volume group, enter the following command:
```
splitvg  -y snapvg -p mp1 vg00
```

Files

Item	Description
/usr/sbin	Directory where the splitvg command resides.