CLI Guide
Table Of Contents
- Dell EMC Storage Systems CLI Guide for the metro node appliance
- Contents
- Introduction
- Using the VPlexcli
- Commands
- advadm dismantle
- alias
- array claim
- array forget
- array re-discover
- array used-by
- back-end degraded list
- back-end degraded recover
- batch-migrate cancel
- batch-migrate check-plan
- batch-migrate clean
- batch-migrate commit
- batch-migrate create-plan
- batch-migrate pause
- batch-migrate remove
- batch-migrate resume
- batch-migrate start
- batch-migrate summary
- capture begin
- capture end
- capture pause
- capture replay
- capture resume
- cd
- cluster add
- cluster configdump
- cluster expel
- cluster forget
- cluster show-remote-devices
- cluster shutdown
- cluster status
- cluster summary
- cluster unexpel
- collect-diagnostics
- configuration get-product-type
- configuration join-clusters
- configuration metadata-backup
- configuration show-meta-volume-candidates
- configuration upgrade-meta-slot-count
- connectivity director
- connectivity list all
- connectivity list directors
- connectivity list initiators
- connectivity list storage-volumes
- connectivity show
- connectivity validate-be
- connectivity validate-local-com
- consistency-group add-virtual-volumes
- consistency-group choose-winner
- consistency-group convert-to-local
- consistency-group create
- consistency-group destroy
- consistency-group list-eligible-virtual-volumes
- consistency-group remove-virtual-volumes
- consistency-group resolve-conflicting-detach
- consistency-group resume-at-loser
- consistency-group set-detach-rule no-automatic-winner
- consistency-group set-detach-rule winner
- consistency-group summary
- date
- describe
- device attach-mirror
- device collapse
- device detach-mirror
- device mirror-isolation auto-unisolation disable
- device mirror-isolation auto-unisolation enable
- device mirror-isolation disable
- device mirror-isolation enable
- device mirror-isolation show
- device resume-link-down
- device resume-link-up
- device resurrect-dead-storage-volumes
- director commission
- director decommission
- director fc-port-stats
- director firmware show-banks
- director forget
- director passwd
- director ping
- director shutdown
- director tracepath
- director uptime
- dirs
- disconnect
- dm migration cancel
- dm migration clean
- dm migration commit
- dm migration pause
- dm migration remove
- dm migration resume
- dm migration start
- drill-down
- ds dd convert-to-local
- ds dd create
- ds dd declare-winner
- ds dd destroy
- ds dd remove-all-rules
- ds dd set-log
- ds rule destroy
- ds rule island-containing
- ds rule-set copy
- ds rule-set create
- ds rule-set destroy
- ds rule-set what-if
- ds summary
- exec
- exit
- export initiator-port discovery
- export initiator-port register
- export initiator-port register-host
- export initiator-port show-logins
- export initiator-port unregister
- export port summary
- export storage-view addinitiatorport
- export storage-view addport
- export storage-view addvirtualvolume
- export storage-view checkconfig
- export storage-view create
- export storage-view destroy
- export storage-view find
- export storage-view find-unmapped-volumes
- export storage-view map
- export storage-view removeinitiatorport
- export storage-view removeport
- export storage-view removevirtualvolume
- export storage-view show-powerpath-interfaces
- export storage-view summary
- export target-port renamewwns
- extent create
- extent destroy
- extent summary
- find
- front-end-performance-stats start
- front-end-performance-stats status
- front-end-performance-stats stop
- getsysinfo
- health-check
- help
- history
- local-device create
- local-device destroy
- local-device summary
- log filter create
- log filter destroy
- log filter list
- log source create
- log source destroy
- log source list
- logging-volume add-mirror
- logging-volume create
- logging-volume detach-mirror
- logging-volume destroy
- logical-unit forget
- ls
- meta-volume attach-mirror
- meta-volume backup
- meta-volume create
- meta-volume destroy
- meta-volume detach-mirror
- meta-volume move
- meta-volume verify-on-disk-consistency
- monitor add-console-sink
- monitor add-file-sink
- monitor collect
- monitor create
- monitor destroy
- monitor get-stats
- monitor remove-sink
- monitor stat-list
- ndu pre-check
- ndu pre-config-upgrade
- ndu recover
- ndu start
- ndu status
- plugin addurl
- plugin listurl
- plugin register
- popd
- pushd
- rebuild set-transfer-size
- rebuild show-transfer-size
- rebuild status
- report capacity-clusters
- report capacity-hosts
- rm
- schedule add
- schedule list
- schedule modify
- schedule remove
- scheduleSYR add
- scheduleSYR list
- scheduleSYR remove
- script
- sessions
- set
- set topology
- show-use-hierarchy
- sms dump
- source
- storage-tool dismantle
- storage-tool compose
- storage-volume auto-unbanish-interval
- storage-volume claim
- storage-volume claimingwizard
- storage-volume find-array
- storage-volume forget
- storage-volume list-banished
- storage-volume list-thin-capable
- storage-volume resurrect
- storage-volume summary
- storage-volume unbanish
- storage-volume unclaim
- storage-volume used-by
- syrcollect
- tree
- unalias
- validate-system-configuration
- version
- virtual-volume create
- virtual-volume destroy
- virtual-volume expand
- virtual-volume list-thin
- virtual-volume re-initialize
- virtual-volume set-thin-enabled
- virtual-volume summary
- wait
- webserver
- Index
[-f|--force]
The meaning of this argument varies, depending on whether the --extent argument is used (expansion
method = concatenation) or not used (expansion-method = storage-volume)
● For storage-volume expansion, the --force argument skips the confirmation message.
● For concatenation expansion, the --force argument expands a virtual volume built on a RAID 1 device
using a target that is not a RAID 1 or that is not as redundant as the device supporting the virtual
volume.
* - argument is positional.
Description
This command expands the specified virtual volume using one of two methods; storage-volume or concatenation.
The ll command output shows whether the volume is expandable, the expandable capacity (if any), and the expansion method
available for the volume. For example:
VPlexcli:> ll /clusters/cluster-1/virtual-volumes/ Test_volume
Name Value
------------------- --------------
.
.
.
capacity 0.5G
consistency-group -
expandable true
expandable-capacity 4.5G
expansion-method storage-volume
expansion-status -
.
.
.
There are two methods to expand a virtual volume; storage-volume and concatenation.
● storage-volume - If the virtual volume has a non-zero expandable-capacity, this command will expand the capacity of the
virtual volume by it's full expandable-capacity.
To use the storage-volume method of expansion, use this command without the --extent argument. The storage-volume
method of expansion adds the entire amount of the expandable-capacity to the volume’s configured capacity.
● concatenation - (also known as RAID C expansion) Expand the virtual volume by adding the specified extents or devices.
The concatenation method does not support non-disruptive expansion of DR1 devices.
Use this command with the --extent argument to expand a virtual volume using the concatenation method of expansion.
NOTE: You cannot expand a virtual volume if the initialization status of the virtual volume is failed or in-progress.
Before expanding a storage volume, understand the limitations of the function and the prerequisites required for volumes to be
expanded. See the Dell EMC Administration Guide for metro node for more information on how expansion works. For procedure
to expand virtual volumes, see the metro node procedures in the SolVe Desktop.
Examples
Expand a volume using the storage-volume method:
● The ll clusters/cluster-1/virtual-volumes command displays virtual volumes, and whether the volumes are
expandable, and the expandable capacity, if any (not all columns are shown in example).
● The ll clusters/cluster-1/virtual-volumes/virtual-volume command displays the method (storage-volume) of
expansion applicable to the volume.
● The expand command starts the expansion of the specified virtual volume.
● The ll clusters/cluster-1/virtual-volumes command displays the expanded volume:
VPlexcli:/clusters/cluster-1/virtual-volumes> ll /clusters/cluster-1/virtual-volumes
/clusters/cluster-1/virtual-volumes:
Commands
321