mkimagevolume

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

Syntax

 mkimagevolume    [  name  name  ]   [  size  disk_size  ]   [  -unit  {  b  |  kb  |  mb  |  gb  |  tb  |  pb  } ]   [ {  -thin  |  -compressed  } ]   [  -iogrp  {  iogroup_id  |  iogroup_name  } ]    -mdisk  {  mdisk_id  |  mdisk_name  }    -pool  {  storage_pool_id  |  storage_pool_name  }   [  -cache  {  none  |  readonly  |  readwrite  } ]   [  -warning  {  warning_capacity  |  warning_percentage%  } ]   [  -udid  udid  ]  -volumegroup  {  volumegroup_name  |  volumegroup_id  }

Parameters

-namename
(Optional) Specifies the name that is used for the volume that is created. This value must be an alphanumeric string 1 - 63 characters.
Remember: If you do not specify -name, a unique default name such as volume1 is used.
-sizedisk_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.
Remember: This parameter is optional if -thin or -compressed are not specified. If this parameter is not specified the volume is fully allocated.
For thin and compressed volumes, the real capacity is set from the MDisk size.
-unitb | 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 allocated.
-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).
Remember: This command fails if no I/O groups support compression.

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

-iogrpiogroup_id | iogroup_name
(Optional) Specifies the I/O group that the new volume is cached in.
-mdisk mdisk_id  mdisk_name 
(Required) Specifies which currently unused MDisk to use to create the image mode volume.
-poolstorage_pool_id | storage_pool_name
(Required) Specifies the storage pool in which to create the new volume. The value for storage_pool_id must be a numerical value.
-cachenone | 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 a volume
  • none disables the cache mode for the volume
-warningwarning_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%.
-udidudid
(Optional) Specifies the unit number udid for the disk. The udid is an identifier that is required to support OpenVMS hosts; no other systems use this parameter. Valid options are a decimal number from 0 through 32767, or a hexadecimal number from 0 through 0x7FFF. A hexadecimal number must be preceded by 0x (for example, 0x1234).
Remember: When you create a HyperSwap® volume, this value is set only on the master volume.
-volumegroupvolumegroup_name | volumegroup_id
(Optional) Specifies the volume group that a volume image belongs to. The value must be an alphanumeric string for the volume group name and the value must be a number for the volume group ID.

Description

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

Import a fully allocated image mode volume into storage pool 0 with MDisk 2 at full capacity

mkimagevolume -mdisk 2 -pool 0

The detailed resulting output:

Volume, id [0], successfully created.

Import a thin-provisioned image mode volume (with virtual capacity 25GB) into storage pool 1 with MDisk 7

mkimagevolume -mdisk 7 -pool 1 -thin -size 25 -unit gb

The detailed resulting output:

Volume, id [2], successfully created.