CLI Guide

unmap volume
Description
Deletes explicit mappings or the default mapping for specified volumes. When an explicit mapping
between an initiator and a volume is deleted, access by that initiator to the volume is controlled
by the volume’s default mapping (described in help for create volume). When a default mapping is
deleted, access by initiators to the volume is controlled by any explicit mappings of those initiators to
the volume. If neither mapping exists, the volume is unavailable to initiators.
If you want to mask access for a specific initiator to a specific volume, use the map volume command
and set the access parameter to no-access.
CAUTION: When a volume is unmapped from an initiator, the initiator will no longer be
able to access the volume’s data.
Minimum role manage
Syntax To delete explicit mappings:
unmap volume
[host hosts]
initiator initiators|hosts|host-groups
volumes|volume-groups
To delete the default mapping:
unmap volume
volumes|volume-groups
Parameters
host hosts
Deprecated—use the initiator parameter instead.
initiator initiators|hosts|host-groups
A comma-separated list of initiators, hosts, or host groups for which to delete explicit mappings. For
initiator, host, and host-group syntax, see Command syntax
volumes|volume-groups
A comma-separated list of volumes or volume groups to unmap. For a volume, specify its name or
serial number. For a volume group, specify the name as volume-group.*. A name that includes a
space must be enclosed in double quotes.
Examples Delete explicit mappings for Host1 to volumes vol1 and vol3 (leaving the default mappings, if
any, unchanged).
# unmap volume initiator Host1.* vol1,vol3
Delete volume vol2’s default mapping (leaving explicit mappings, if any, unchanged).
# unmap volume vol2
Delete explicit mappings for initiator FC-port1 to volume group MyVolumes (leaving the default
mappings, if any, unchanged).
# unmap volume initiator FC-port1 MyVolumes.*.*
See also
map volume
show initiators
show maps
show volumes
280 Alphabetical list of commands