CLI Guide

Arguments
Required arguments
[-d|--device]
context-path or device-
name
* Name or context path of the device from which to detach the mirror. Does not have to be a
top-level device. If the device name is used, verify that the name is unique throughout the system,
including local devices on other clusters.
Optional arguments
[-m|--mirror]
context-name or mirror-
name
* Name or context path of the mirror to detach. Does not have to be a top-level device. If the
device name is used, verify that the name is unique throughout the metro node, including local
devices on other clusters.
[-s|--slot] slot-
number
Slot number of the mirror to be discarded. Applicable only when the --discard argument is used.
[-i|--discard]
When specified, discards the detached mirror. The data is not discarded.
[-f|--force]
Force the mirror to be discarded. Must be used when --discard argument is used. The --force
argument is set for detaching an unhealthy
mirror it is discarded even if --discard flag is not set.
* - argument is positional.
Description
Use this command to detach a mirror leg from a RAID 1 device.
Figure 1. RAID device and virtual volume: before detach mirror
If the RAID device supports a virtual volume, and you don't use the --discard argument the command:
● Removes the mirror (child device) from the RAID 1 parent device.
● Makes the detached child a top-level device.
● Creates a new virtual volume on top the new device and prefixes the name of the new device with the name of the original
device.
112
Commands