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

Read syntax diagramSkip visual syntax diagram
>>- 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

-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.
Note: If you do not specify either -thin or -compressed the volume copy is created as one that is fully-allocated.
-compressed
(Optional) Specifies that the volume copy is to be created compressed. You cannot specify this parameter with -thin.
-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.
-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.
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.

-unit b | kb | mb | gb | tb | pb
(Optional) Specifies the data units for the -buffersize 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.

-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.

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