Skip to main content

Remove volume LUN mapping

The remove lunMapping command removes the logical unit number (LUN) mapping from one or more volumes.

Supported Arrays​

This command applies to an individual DE2000H, DE4000H, DE4000F, DE6000H, or DE6000F storage array.

Roles​

To execute this command on an storage array, you must have the Storage Admin role.

Syntax​

remove (volume ["<var id="GUID-B8C31091-E314-40CE-A51A-9368A7552755__V1111690" className="keyword varname">volumeName</var>"] | accessVolume) lunMapping 
(host="<var id="GUID-B8C31091-E314-40CE-A51A-9368A7552755__V1111693" className="keyword varname">hostName</var>" | hostGroup=("<var id="GUID-B8C31091-E314-40CE-A51A-9368A7552755__V1111694" className="keyword varname">hostGroupName</var>" | defaultGroup)

Syntax for removing LUN mapping from more than one volume LUN mapping​

remove (allVolumes | volumes [<var id="GUID-B8C31091-E314-40CE-A51A-9368A7552755__V1111691" className="keyword varname">volumeName1</var> ... <var id="GUID-B8C31091-E314-40CE-A51A-9368A7552755__V1111692" className="keyword varname">volumeNameN</var>]) 
lunMapping

Parameters​

ParameterDescription
volume

The name of a volume from which you are removing the LUN mapping. Enclose the volume name double quotation marks (" ") inside square brackets ([ ]).

accessVolume

This parameter removes the access volume.

allVolumes This parameter removes the LUN mapping from all of the volumes.
volumes

The names of several volumes from which you are removing the LUN mapping. Enter the names of the volumes using these rules:

  • Enclose all of the names in square brackets ([ ]).

  • Separate each of the names with a space.

If the volume names have special characters or consist only of numbers, enter the names using these rules:

  • Enclose all of the names in square brackets ([ ]).

  • Enclose each of the names in double quotation marks (" ").

  • Separate each of the names with a space.

host

The name of the host to which the volume is mapped. Enclose the host name in double quotation marks (" ").

This parameter works only when you are removing LUN mapping from one volume.

hostGroup

The name of the host group that contains the host to which the volume is mapped. Enclose the host group name in double quotation marks (" "). The defaultGroup value is the host group that contains the host to which the volume is mapped.

This parameter works only when you are removing LUN mapping from one volume.

Notes​

The access volume is the volume in a SAN environment that is used for communication between the storage management software and the storage array controller. The access volume uses a LUN address and consumes 20 MB of storage space that is not available for application data storage. An access volume is required only for in-band managed storage arrays.

Attention
Removing an access volume can damage your configuration – The agent uses the access volumes to communicate with a storage array. If you remove an access volume mapping for a storage array from a host that has an agent running on it, the storage management software is no longer able to manage the storage array through the agent.

You must use the host parameter and the hostGroup parameter when you specify a non-access volume or an access volume. The Script Engine ignores the host parameter or the hostGroup parameter when you use the allVolumes parameter or the volumes parameter.