CLI Guide

Table Of Contents
Description
This command supports building local or distributed (i.e., distributed RAID 1 based) virtual volumes with RAID 0, RAID 1, or RAID
C local devices. It does not support creating multi-device storage hierarchies (such as a RAID 1 on RAID 0s on RAID Cs).
For RAID 1 local devices, a maximum of eight legs may be specified.
If the new virtual volumes global geometry is not compatible with the specified consistency group or storage views, the virtual
volume will not be created. However, failure to add the new virtual volume to the specified consistency group or storage views
does not constitute an overall failure to create the storage and will not be reported as such.
NOTE: In the event of an error, the command will not attempt to perform a roll-back and destroy any intermediate storage
objects it has created. If cleanup is necessary, use the show-use-hierarchy command on each storage volume to
identify all residual objects and delete each one manually.
The --stop-at option imposes the following constraints on other options:
If --stop-at=virtual-volume, only the --consistency-group and --storage-views options can be specified.
If --stop-at=local-device, storage-volumes from only one cluster can be specified.
If--stop-at=distributed-device, storage-volumes from at least two clusters must be specified.
Example
Create a thin-capable virtual volume with RAID 0 local devices and specified storage volumes:
VPlexcli:/clusters/cluster-1/virtual-volumes> storage-tool compose --name myVolume --
storage-volumes thin_capable_sv_1
--thin --geometry raid-0
Successfully created /clusters/cluster-1/virtual-volumes/myVolume.
VPlexcli:/clusters/cluster-1/virtual-volumes> ll myVolume/
/clusters/cluster-1/virtual-volumes/myVolume:
Name Value
-------------------------- ----------------------------------------
block-count 2621440
block-size 4K
cache-mode synchronous
capacity 10G
consistency-group -
expandable true
expandable-capacity 0B
expansion-method storage-volume
expansion-status -
health-indications []
health-state ok
locality local
operational-status ok
recoverpoint-protection-at []
recoverpoint-usage -
scsi-release-delay 0
service-status unexported
storage-tier -
supporting-device device_myVolume_c1
system-id myVolume
thin-capable true
thin-enabled true
volume-type virtual-volume
vpd-id VPD83T3:6000144000000010e018b6fbc02ab396
VPlexcli:/clusters/cluster-1/virtual-volumes>
298
Commands