mkimagevolume

Use the mkimagevolume command to create an image mode volume by importing (preserving) data on a managed disk from another storage system.

Syntax

Read syntax diagramSkip visual syntax diagram mkimagevolume namenamesizedisk_size-unitbkbmbgbtbpb-thin-compressed-iogrpiogroup_idiogroup_name -mdisk mdisk_idmdisk_name -pool storage_pool_idstorage_pool_name -cachenonereadonlyreadwrite-warningwarning_capacitywarning_percentage%-volumegroupvolumegroup_namevolumegroup_id

Parameters

-name name
(Optional) Specifies the name that is used for the volume that is created. This value must be an alphanumeric string 1 - 63 characters.
-size disk_size
(Required if -thin or -compressed is specified) Specifies the capacity of the volume, which is used with the value of the unit. The default capacity is in MB. When the unit of bytes is used, all capacities must be in multiples of 512 bytes. An entire extent is reserved even if it is only partially used.
Note: This parameter is optional if -thin or -compressed are not specified. If this parameter is not specified, the volume is fully-provisioned.
For thin and compressed volumes, the real capacity is set from the MDisk size.
-unit b | kb | mb | gb | tb | pb
(Optional) Specifies the data units to use with the capacity that is specified by the -size parameter. The default unit type is mb.
-thin
(Optional) Specifies that the volume is to be created with thin provisioning. You cannot specify this parameter with -compressed. If you do not specify -thin or -compressed, the volume that is created is fully-provisioned.
-compressed
(Optional) Specifies that the volume is to be created compressed. If the -iogrp parameter is not specified, the least used I/O group is used for compressed copies (considering the subset of I/O groups that support compression).

You cannot specify this parameter with -thin. If you do not specify -thin or -compressed, the volume that is created is fully-provisioned.

Remember: This command fails if no I/O groups support compression.
-iogrp iogroup_id | iogroup_name
(Optional) Specifies the I/O group that the new volume is cached in.
-mdisk mdisk_idmdisk_name
(Required) Specifies which currently unused MDisk to use to create the image mode volume.
-pool storage_pool_id | storage_pool_name
(Required) Specifies the storage pool in which to create the new volume.
-cache none | readonly | readwrite
(Optional) Specifies the caching options for the volume. Valid entries are:
  • readwrite enables the cache for the volume (default)
  • readonly disables write caching but allows read caching for the volume
  • none disables caching for the volume
-warning warning_capacity | warning_percentage
(Optional) Specifies a threshold at which a warning error log is generated for volume copies. A warning is generated when the used disk capacity on the thin-provisioned volume exceeds the specified threshold. You must specify either -thin or -compressed with this parameter. The default value is 80%.
-volumegroup volumegroup_name | volumegroup_id
(Optional) Specifies the volume group that the volume should be added to.
Note: This command is not permitted for a volume group with a replication policy.

Description

Use the mkimagevolume command to create a new image mode volume. This command is used to import a volume, preserving existing data.

Note: A volume copy in a data reduction pool cannot be an image mode volume copy. The mkimagevolume command is not permitted if the pool specified is a Safeguarded backup location.

Create a fully-provisioned image mode volume in storage pool 0 with mdisk ID 2

mkimagevolume -mdisk 2 -pool 0

The resulting output:

Volume, id [0], successfully created.