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.