CLI Guide

Syntax
virtual-volume create
[-r|--device] context-path
[-t|--set-tier] tier
[-n | --thin]
[-i | --initialize]
[--confirm-init]
[--verbose]
Arguments
Required arguments
[-r | --device] context-path * Device on which to host the virtual volume.
Optional arguments
[-t | --set-tier] tier Set the storage-tier for the new virtual volume.
[-n | --thin]
Specifies whether to create a thin-enabled virtual volume or not.
[-i | --initialize]
Initializes the virtual volume by erasing 10 MB of the initial storage blocks. This prevents
the virtual volume from retaining old or stale data. This must be used along with the
confirm-init option.
[--confirm-init]
Confirms the initialization process on the virtual volume. This must be used along with the
initialize option.
* - argument is positional.
Description
A virtual volume is created on a device or a distributed device, and is presented to a host through a storage view. Virtual
volumes are created on top-level devices only, and always use the full capacity of the device or distributed device.
The underlying storage of a virtual volume may be distributed over multiple storage volumes, but appears as a single contiguous
volume.
The specified device must not already have a virtual volume and must not have a parent device.
Use the --set-tier argument to set the storage tier for the new virtual volume.
Table 16. virtual-volume field descriptions
Field Description
block count
The number of blocks in the volume.
block size
The size of a single block, in kilobytes.
cache-mode
Synchronous (write-through).
capacity
The total number of bytes in the volume. Equals the block-
size multiplied by the block-count.
NOTE: The capacity of a virtual volume on which the
initialization process has failed will be 0.
thin-capable
Determines whether the virtual volume is thin-capable or not.
thin-enabled
Determines whether the virtual volume is configured as thin-
enabled.
consistency-group
The name of the consistency group to which this volume
belongs, if any.
Commands 327