splitvdiskcopy

Use the splitvdiskcopy command to create a separate volume from a synchronized copy of a mirrored volume.

Syntax

Read syntax diagramSkip visual syntax diagram splitvdiskcopy -copy id -iogrpio_group_idio_group_name-accessiogrpiogrp_id_listiogrp_name_list-nodenode_idnode_name-namenew_name-cachereadwritereadonlynone-udidudid-forcevdisk_namevdisk_id

Parameters

-copy id
(Required) Specifies the ID of the copy to split.
-iogrp io_group_id | io_group_name
(Optional) Specifies the I/O group to add the new volume to. The default is the I/O group of the specified volume.
-accessiogrp iogroup_id_list | iogroup_name_list
(Optional) Specifies which I/O groups provide access to the volume. If the -accessiogrp parameter is used, the -iogrp parameter must also be specified. The specified volume access set must include the caching I/O group. If the -accessiogrp parameter is not specified, the new volume is assigned its caching I/O group as the only I/O group that provides access, where the caching I/O group is assigned by the system or by using -iogrp.
-node node_id | node_name
(Optional) Specifies the preferred node ID or the name for I/O operations to this volume. You can use the -node parameter to specify the preferred access node.
-name new_name
(Optional) Assigns a name to the new volume.
-cache readwrite | readonly | none
(Optional) Specifies the caching options for the new volume. (Optional) Specifies the caching options for the volume. Valid entries are:
  • readwrite to enable the cache for the volume
  • readonly to disable write caching while allowing read caching for a volume
  • none to disable the cache mode for the volume
The default is readwrite.
Remember: If you do not specify the -cache parameter, the default value (readwrite) is used.
-udid udid
(Optional) Specifies the udid for the new volume. The udid is a required identifier for OpenVMS hosts; no other hosts use this parameter. Supported values are a decimal number 0 - 32767, or a hexadecimal number 0 - 0x7FFF. A hexadecimal number must be preceded by 0x; for example, 0x1234. The default udid value is 0.
-force
(Optional) Allows the split to proceed even when the specified copy is not synchronized, or even when the cache flush is likely to fail. The newly created volume might not be consistent.

Description

The splitvdiskcopy command creates a new volume in the specified I/O Group from a copy of the specified volume.

For thin or compressed volumes that are in data reduction storage pools:
  • You cannot specify a cache mode of none or readonly.
  • You cannot specify an I/O group that is different from the current I/O group that is associated with the volume.

If the copy that you are splitting is not synchronized, you must use the -force parameter. The command fails if you are attempting to remove the only synchronized copy. To avoid command failure, wait for the copy to synchronize or split the unsynchronized copy from the volume by using the -force parameter. You can run the command when either volume copy is offline.

An invocation example for creating a volume with I/O groups 2 and 3 in its I/O group access set 

splitvdiskcopy -copy 1 -iogrp 2 -node 7 -accessiogrp 2:3 DB_Disk

The resulting output: 

Virtual Disk, id [X], successfully created.