addvdiskcopy

Use the addvdiskcopy command to add a copy to an existing volume, which changes a nonmirrored volume into a mirrored volume. On a system with a hyperswap topology, use the addvolumecopy command to convert an existing volume to a hyperswap volume by adding a copy at a second site.

Note: The first syntax diagram depicts the addition of a sequential or striped mode volume. The second syntax diagram depicts the addition of an image mode volume.

Syntax

addvdiskcopy -mdiskgrp { mdisk_group_id_list | mdisk_group_name_list } [ -mirrorwritepriority { latency | redundancy } ] [ -vtype { seq | striped } ] [ -mdisk { mdisk_id_list | mdisk_name_list } ] [ -rsize { disk_size | disk_size_percentage% | auto } [ -warning { disk_size | disk_size_percentage% } ] [ -autoexpand ] { [ -grainsize { 32 | 64 | 128 | 256 } ] | [ -compressed ] } ] [ -fmtdisk ] [ -createsync ] [ -syncraterate ] [ -unit { b | kb | mb | gb | tb | pb } ] [ -easytier { on | off } ] { vdisk_name | vdisk_id }
addvdiskcopy [ -mirrorwritepriority { latency | redundancy } ] -mdiskgrp { mdisk_group_id_list | mdisk_group_name_list } -vtype { image } -mdisk { mdisk_id_list | mdisk_name_list } [ -rsize { disk_size | disk_size_percentage% | auto } [ -warning { disk_size | disk_size_percentage% } ] [ -autoexpand ] { [ -grainsize { 32 | 64 | 128 | 256 } ] | [ -compressed ] | [ -import ] } ] [ -fmtdisk ] [ -createsync ] [ -syncraterate ] [ -unit { b | kb | mb | gb | tb | pb } ] [ -tier { ssd | nearline | enterprise } ] [ -easytier { on | off } ] [ -autodelete ] { vdisk_name | vdisk_id }

Parameters

-mdiskgrpmdisk_group_id_list | mdisk_group_name_list
(Required) Specifies the storage pools to use to create copies for the volume. You must specify a group for each copy that is being added.
Note: If the MDisk group is from a child pool, -vtype must be striped.
-mirrorwriteprioritylatency | redundancy
(Optional) Specifies how to configure the mirror write algorithm priority.
  1. Choosing latency means a copy that is slow to respond to a write input/output (I/O) becomes unsynchronized, and the write I/O completes if the other copy successfully writes the data.
  2. Choosing redundancy means a copy that is slow to respond to a write I/O synchronizes completion of the write I/O with the completion of the slower I/O in order to maintain synchronization.
  3. If not specified, the current value is unchanged.
-vtypeseq | striped | image
(Optional) Specifies the virtualization type for the copy: sequential, striped, or image. The type can be different than the virtualization types for other copies on the volume. The default virtualization type is striped.
Note: You can not create an image or sequential mode volume from a child pool.
-mdiskmdisk_id_list | mdisk_name_list
(Optional) Specifies one or more managed disks (MDisks). For sequential and image mode copies, you must specify a single MDisk that has sufficient free extents. For image mode copies, the MDisk must be in unmanaged mode. For sequential mode copies the MDisk must be in the managed mode.
-syncraterate
(Optional) Specifies the copy synchronization rate. A value of zero (0) prevents synchronization. For the supported -syncrate values and their corresponding rates, see Table 2.

If not specified, the current value is unchanged.

-createsync
(Optional) Suppresses the synchronization of the new volume copy with the primary copy. Using this parameter can cause data corruption if the primary copy fails and leaves an unsynchronized secondary copy to provide data. Using this parameter can cause loss of read stability in unwritten areas if the primary copy fails, data is read from the primary copy, and then different data is read from the secondary copy. To avoid data loss or read stability loss, use this parameter only for a primary copy that has been formatted and not written to, and with the -fmtdisk parameter.
Note: You cannot specify -createsync for a volume that is fast formatting.
-fmtdisk
(Optional) Formats a sequential or striped mode copy. You must also specify the -createsync parameter, which labels the formatted copy as identical to the primary copy. The -fmtdisk parameter causes the volume to go offline until new volume copy formatting completes. To query the formatting progress, use the lsvdiskprogress command.
-rsizedisk_size | disk_size_percentage% | auto
(Optional) Makes the copy thin-provisioned and specifies the real size of the copy. Specify the disk_size | disk_size_percentage value using an integer, or an integer immediately followed by the percent character (%). The default units for disk_size are megabytes (MB); to specify different units, use the -unit parameter. The auto option creates a volume copy that uses the entire size of the MDisk; if you specify the -rsize auto option, you must also specify the -vtype image option.
-compressed
(Optional) Adds exactly one copy to an existing volume that already has (only) one copy a volume, and enables compression. Requires the -rsize parameter also be specified.
Remember:
  • You cannot specify this parameter with the -grainsize parameter.
  • When you specify this parameter with the -import parameter, you must specify -rsize auto.
-warningdisk_size | disk_size_percentage%
(Optional) Requires that the -rsize parameter also be specified. Generates a warning when the used disk capacity on the thin-provisioned copy first exceeds the specified threshold. You can specify a disk_size integer, which defaults to megabytes (MB) unless the -unit parameter is specified; or you can specify a disk_size%, which is a percentage of the volume size. If -autoexpand is enabled, the default value for -warning is 80% of the volume capacity. If -autoexpand is not enabled, the default value for warning is 80% of the real capacity. To disable warnings, specify 0.
-autoexpand
(Optional) Requires that the -rsize parameter also be specified. Specifies that thin-provisioned copies automatically expand their real capacities by allocating new extents from their storage pool. If the -autoexpand parameter is specified, the -rsize parameter specifies a capacity that is reserved by the copy. This protects the copy from going offline when its storage pool runs out of space by allowing it to consume this reserved space first.
-grainsize32 | 64 | 128 | 256
(Optional) Requires that the -rsize parameter also be specified. Sets the grain size (KB) for a thin-provisioned volume copy. The grain size value must be 32, 64, 128, or 256 KB. The default is 256 KB.
-unitb | kb | mb | gb | tb | pb
(Optional) Specifies the data units for the -rsize and -warning parameters.
-import
(Optional) Imports an image mode disk that contains a thin-provisioned volume into the clustered system (system). Requires that the -rsize and -vtypeimage parameters also be specified.
-tierssd | nearline | enterprise
(Optional) Specifies the MDisk tier when an image mode copy is added.
ssd
Specifies an SSD (or flash drive) hard disk drive or an external MDisk for the newly discovered or external volume.
nearline
Specifies an nearline hard disk drive or an external MDisk for the newly discovered or external volume.
enterprise
Specifies an enterprise hard disk drive or an external MDisk for the newly discovered or external volume.
-easytieron | off
(Optional) Determines if the Easy Tier ® function is allowed to move extents for this volume. If a volume copy is striped and not being migrated the following table applies:
Table 1. Storage pool Easy Tier settings
Storage pool Easy Tier setting Number of tiers in the storage pool Volume copy Easy Tier setting Volume copy Easy Tier status
Off One Off inactive (see note 2)
Off One On inactive (see note 2)
Off Two Off inactive (see note 2)
Off Two On inactive (see note 2)
  Measure   One Off measured (see note 3)
Measure One On measured (see note 3)
Measure Two Off measured (see note 3)
Measure Two On measured (see note 3)
Auto (see note 6) One Off measured (see note 3)
Auto (see note 6) One On measured (see note 3)
Auto (see note 6) Two Off balanced (see note 4)
Auto (see note 6) Two On active (see note 1)
On (see note 6) One Off measured (see note 3)
On (see note 6) One On balanced (see note 4)
On (see note 6) Two Off measured (see note 3)
On (see note 6) Two On active (see note 1)
Note:
  1. If the volume copy is in image or sequential mode or is being migrated then the volume copy Easy Tier(tm) status is measured instead of active.
  2. When the volume copy status is inactive, no Easy Tier(tm) functions are enabled for that volume copy.
  3. When the volume copy status is measured, the Easy Tier(tm) function collects usage statistics for the volume but automatic data placement is not active.
  4. When the volume copy status is balanced, the Easy Tier(tm) function enables performance-based pool balancing for that volume copy.
  5. When the volume copy status is active, the Easy Tier(tm) function operates in automatic data placement mode for that volume.
  6. The default Easy Tier(tm) setting for a storage pool is auto, and the default Easy Tier(tm) setting for a volume copy is on. This means that Easy Tier(tm) functions except pool performance balancing are disabled for storage pools with a single tier, and that automatic data placement mode are enabled for all striped volume copies in a storage pool with two or more tiers.
-autodelete
(Optional) Specifies the primary copy is deleted once the secondary copy is synchronized.
jvdisk_name | vdisk_id
(Required) Specifies the volume to add the volume copy to, either by ID or by name.

Description

The addvdiskcopy command adds a copy to an existing volume , which changes a nonmirrored volume into a mirrored volume. Use the mkdiskgrp parameter to specify the storage pool that provide storage for the copy; the lsmdiskgrp command lists the available storage pools and the amount of available storage in each group.

The addvdiskcopy command can be specified with a file system volume, but must be used with the same storage pool for that volume.
Remember: Only compressed copies are allowed to be added to file system volumes.
The addvdiskcopy command adds a different volume copy, such as a copy created from a uncompressed to compressed conversion or a compressed to uncompressed conversion.

An encryption key cannot be used when adding an image mode MDisk. To use encryption (when the MDisk has an encryption key), the MDisk must be self-encrypting.

Remember: You cannot add a volume copy if the volume to be copied is being formatted.
The virtualization types are defined as follows:
sequential (seq)
This policy requires the -mdisk parameter with a single managed disk as its argument. This MDisk must be in the managed mode.

It creates the volume using extents from the given managed disk (assuming there are enough free extents on the managed disk).

striped
This is the default policy. If the -vtype parameter is not specified, this policy is used in its default form. That is, all managed disks in the storage pool are used to create the volume. The striping is at an extent level; one extent from each managed disk in the group is used. For example, a storage pool with 10 managed disks uses one extent from each managed disk, then it uses the 11th extent from the first managed disk, and so on.

If the -mdisk parameter is also specified, you can supply a list of managed disks to use as the stripe set. This can be two or more managed disks from the same storage pool. The same circular algorithm is used across the striped set. However, a single managed disk can be specified more than once in the list. For example, if you enter -m 0:1:2:1, the extents are from the following managed disks: 0, 1, 2, 1, 0, 1, 2, and so forth. All MDisks that are specified in the -mdisk parameter must be in managed mode.

image
This policy allows image mode volumes to be created when a managed disk already has data on it, perhaps from a previrtualized subsystem. When an image mode volume is created, it directly corresponds to the (previously unmanaged) managed disk that it was created from; therefore, volume logical block address (LBA) x equals managed disk LBA i. You can use this command to bring a nonvirtualized disk under the control of the system. After it is under the control of the system, you can migrate the volume from the single managed disk. When it is migrated, the volume is no longer an image mode volume.

You can add image mode volumes to an already populated storage pool with other types of volumes, such as a striped or sequential.

Note: An image mode copy must be at least as large as the volume that it is being added to, but any capacity beyond the size of the volume is not accessible.
The command returns the ID of the newly created volume copy.

Create the first compressed volume copy for an I/O group to activate compression. You cannot create or move a compressed volume copy to an I/O group that contains (at least) one node that does not support compressed volumes. You must use another I/O group, but note that this does not affect moving to the recovery I/O group.

Important:
  • If the volume (or volume copy) is a target of a FlashCopy mapping with a source volume in an active-active relationship the new managed disk group must be in the same site as the source volume.
  • If this command is used for a volume that is a master volume, an auxiliary volume, or a change volume of an active-active relationship, the new copy must be created in a storage pool of the same site as the existing volume copy.
  • When adding an image mode copy, the site information for the MDisk being added must be well-defined and match the site information for any other MDisks in the storage pool.

This table provides the relationship of the rate value to the data copied per second.

Table 2. Relationship between the rate value and the data copied per second
User-specified rate attribute value Data copied/second
1 - 10 128 KB
11 - 20 256 KB
21 - 30 512 KB
31 - 40 1 MB
41 - 50 2 MB
51 - 60 4 MB
61 - 70 8 MB
71 - 80 16 MB
81 - 90 32 MB
91 - 100 64 MB

An invocation example

addvdiskcopy -mdiskgrp 0 -easytier off vdisk8

The resulting output:

Vdisk [8] copy [1] successfully created

An invocation example for specifying storage pools

addvdiskcopy -mdiskgrp 0 -vtype image -mdisk 13 -tier  generic_ssd -easytier off vdisk9

The resulting output:

Vdisk [9] copy [1] successfully created

An invocation example for configuring a mirror write algorithm priority

addvdiskcopy -mdiskgrp 0 -mirrorwritepriority latency vdisk9

The resulting output:

Vdisk [9] copy [1] successfully created

An invocation example for adding a compressed volume copy

addvdiskcopy -mdiskgrp 1 -rsize 10% -compressed vdisk2

The resulting output:

Vdisk [2] copy [1] successfully created

An invocation example for adding a compressed volume copy

addvdiskcopy -mdiskgrp 0 -vtype image -mdisk 13 -tier nearline vdisk9

The resulting output:

Vdisk [9] copy [1] successfully created