CLI Guide

All contexts.
Syntax
storage-volume unbanish
[-n|--directors] path[, path...]
[-d|--storage-volume] path
Arguments
Required arguments
[-n|--directors] path[,
path,]...
* The context path of the directors to unbanish the given storage volume on.
Optional arguments
[-d|--storage-volume]
path
The context path of the storage volume to unbanish.
This argument is not required if the current context is a storage-volume or below. If the
current context is a storage-volume or below, it operates on that storage volume.
* - argument is positional.
Description
Metro node examines path state information for LUNs on arrays. If the path state information is inconsistent, metro node
banishes the LUN, and makes it inaccessible.
Use this command to unbanish a banished LUN (storage volume).
Banished storage volumes (LUNs)
LUNs (storage volumes) are banished when metro node detects an unexpected configuration of array controllers or paths to
arrays. Under normal active/passive operation, one controller for any given LUN is active, the other is passive.
If the path to the active controller fails, the passive path transitions to active. The transition must wait for the failed active
controller to drain its pending I/Os. This transient state may be seen during disk replacement, hot sparing, and disk failure.
If the system detects a LUN in this state, it waits 20 seconds for the LUN to return to normal. If the LUN does not return to the
expected state, the system banishes the LUN.
Example
In the following example:
● The list-banished command shows a volume is banished from director 1-1-A
● The unbanish command unbanishes the volume.
● The list-banished command shows the change:
VPlexcli:/> storage-volume list-banished --director director-1-1-A
There is 1 banished storage-volume on director 'director-1-1-A':
Symm0487_0C1B
VPlexcli:/clusters/cluster-1/storage-elements/storage-volumes/Symm0487_0C1B> storage-
volume unbanish --director director-1-1-A
director-1-1-A Unbanished.
VPlexcli:/clusters/cluster-1/storage-elements/storage-volumes/Symm0487_0C1B> storage-
316
Commands