addvolumecopy
Use the addvolumecopy command to add a copy to an existing volume. On a standard topology system, you can use this command to add a mirrored copy to an existing volume.
Syntax
>>- addvolumecopy -- -- -pool --+- storage_pool_id ---+-- -- ---> '- storage_pool_name -' >-- --+----------------------------+-- -------------------------> '- -image --+- mdisk_id ---+-' '- mdisk_name -' >--+-------------------+-- -------------------------------------> '-+- -thin -------+-' '- -compressed -' >--+-----------------------------------------+-- ---------------> '- -buffersize --+- buffer_size --------+-' '- buffer_percentage% -' >--+-------------------+-- -------------------------------------> | .- mb -. | '- -unit --+- b --+-' +- kb -+ +- gb -+ +- tb -+ '- pb -' >--+---------------------------------------+-- -----------------> '- -warning --+- warning_capacity ----+-' '- warning_percentage% -' >--+-----------------+-- --+-------------------------+-- -------> '- -noautoexpand -' '- -grainsize --+- 32 --+-' +- 64 --+ +- 128 -+ '- 256 -' >--+- volume_id ---+-- ---------------------------------------->< '- volume_name -'
Parameters
- (Required) Specifies the storage pool in which to create the new volume copy.
- (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.
- (Optional) Specifies that the volume copy is to be created with
thin-provisioning. You cannot specify this parameter with -compressed. Note: If you do not specify either -thin or -compressed the volume copy is created as one that is fully-allocated.
- (Optional) Specifies that the volume copy is to be created compressed. You cannot specify this parameter with -thin.
- (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.
- (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.Note: 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.
- (Optional) Specifies the data units for the -buffersize and -warning parameters.
- (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.
- (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.
- (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.
On a standard topology system, you can use this command to add a mirrored copy to an existing volume.
Add a volume copy to an existing volume
addvolumecopy -pool 2 volume5
The detailed resulting output:
No feedback
Add a thin volume copy to an existing volume
addvolumecopy -pool site2pool1 -thin 0
The detailed resulting output:
No feedback
Add a fully-allocated image-mode volume copy
addvolumecopy -image mdisk12 -pool 3 volume2
The detailed resulting output:
No feedback