addvolumecopy

Use the addvolumecopy command to add a copy to an existing volume.

Syntax

Read syntax diagramSkip visual syntax diagram addvolumecopy -pool storage_pool_idstorage_pool_name -imagemdisk_idmdisk_name-thin-compressed-buffersizebuffer_sizebuffer_percentage%-unitmbbkbgbtbpb-warningwarning_capacitywarning_percentage%-autodelete-noautoexpand-grainsize3264128256 volume_idvolume_name

Parameters

-pool storage_pool_id | storage_pool_name
(Required) Specifies the storage pool in which to create the new volume copy.
-image mdisk_id | mdisk_name
(Optional) Specifies that the volume copy is to be created (on any topology) in image mode and it specifies which currently unused MDisk to use.
-thin
(Optional) Specifies that the volume copy is to be created with thin provisioning. You cannot specify this parameter with -compressed. If you are adding a volume to a pool that uses a provisioning policy, this parameter is not enabled.
-compressed
(Optional) Specifies that the volume copy is to be created compressed. You cannot specify this parameter with -thin. If you are adding a volume to a pool that uses a provisioning policy, this value is disabled.
-buffersize buffer_size | buffer_percentage%
(Optional) Specifies the pool capacity the volume attempts to reserve as a buffer for thin-provisioned and compressed volumes. You must specify either -thin or -compressed with this parameter. If you are adding a volume to a pool that uses a provisioning policy, this parameter uses the default value of 2%.
-warning warning_capacity | warning_percentage%
(Optional) Specifies a threshold at which a warning error log is generated for the volume copy. A warning is generated when the used disk capacity on the thin-provisioned or compressed copy exceeds the specified threshold. You can specify the threshold by using warning_capacity to specify a size, which defaults to MB unless the -unit parameter is specified.If you are adding a volume to a pool that uses a provisioning policy, this parameter uses the default value of 80%.
Important: You can also specify a warning_percentage% to use a percentage of the volume size. If you do not specify a warning threshold, a default value of 80% is used. To disable warnings, specify 0.

You must specify either -thin or -compressed with this parameter.

-unit b | kb | mb | gb | tb | pb
(Optional) Specifies the data units for the buffer_size and -warning parameters.
-noautoexpand
(Optional) Specifies that the volume copy not automatically expand as it is written to; the available buffer capacity decreases as the used capacity increases. The copy goes offline if the buffer capacity is consumed.

The buffer capacity can be increased by specifying expandvdisksize -rsize. You must specify either -thin or -compressed with this parameter. If you do not specify this keyword, the copy automatically expands as it is written to.

If you are adding a volume to a pool that uses a provisioning policy, the volume automatically expands as it is written to.
-autodelete
(Optional) Specifies that the source volume is deleted after the new volume copy is synchronized.
-grainsize 32 | 64 | 128 | 256
(Optional) Sets the grain size (KB) for a thin-provisioned volume. If you are using the thin-provisioned volume in a FlashCopy® map, use the same grain size as the map grain size for best performance. If you are using the thin-provisioned volume directly with a host system, use a small grain size. The grain size value must be 32, 64, 128, or 256 KB. The default is 256 KB.
volume_id | volume_name
(Required) Specifies the volume to add the volume copy to.

Description

Use the addvolumecopy command to add a copy to an existing volume. The new volume copy is synchronized with the current copy.

You can also use the addvolumecopy command to add a volume copy to an existing volume that has snapshots provided all the snapshots are mirrored. The parent pool of at least one volume copy of each snapshot must be in the same parent pool as the copy being added. You must use the addvdiskcopy command to add a copy to a VDisk that maintains snapshots.

When you create a volume copy in a storage pool with a provisioning policy, some parameters use default settings or the settings from the provisioning policy.

The -autodelete parameter deletes the source volume when the new volume copy is synchronized.

You cannot specify buffer_size if the volume copy is created in a data reduction storage pool. Specify -thin or -compressed to enable thin provisioning or compression.

You cannot specify -noautoexpand when you create thin-provisioned or compressed volume copies from a data reduction storage pool.

You cannot create a volume copy that is a thin-provisioned or compressed volume in a data reduction storage pool, and the volume caching mode is none or readonly. You must specify chvdisk to change the volume caching mode to readwrite.

You cannot specify -warning for a thin-provisioned or compressed volume copy in a data reduction storage pool.

You cannot specify grain_size for thin-provisioned and compressed volume copies in data reduction storage pools. This type of volume copy is created with a size of 8 KB.

Thin-provisioned or compressed volume copies in data reduction pools cannot be created if the data reduction storage pool is offline and requires recovery. If the recovery still in progress, you must wait until the recovery is complete,theis and pool is in online state.

Add a volume copy to an existing volume

addvolumecopy -pool 2 volume5

The detailed resulting output:

No feedback