SANtricity 11.8 Commands ( CA08871-194 ~ 196 )
Remove volume LUN mapping
The remove lunMapping
command removes the logical unit number (LUN) or namespace ID (NSID) mapping from one or more volumes.
Supported Series
This command applies to any individual storage system, including the HB2100/HB2200/HB2300, HB5100/HB5200, AB6100 and AB3100 series, as long as all SMcli packages are installed.
Roles
To execute this command on an HB2100/HB2200/HB2300, HB5100/HB5200, AB6100, or AB3100 storage system, you must have the Storage Admin role.
Syntax
remove (volume ["volumeName"] | accessVolume) lunMapping (host="hostName" | hostGroup=("hostGroupName" | defaultGroup)
Syntax for removing LUN or NSID mapping from more than one volume LUN or NSID mapping
remove (allVolumes | volumes [volumeName1 ... volumeNameN]) lunMapping
Parameters
Parameter | Description |
---|---|
|
The name of a volume from which you are removing the LUN or NSID mapping. Enclose the volume name double quotation marks (" ") inside square brackets ([ ]). |
|
This parameter removes the access volume. |
|
This parameter removes the LUN mapping from all of the volumes. |
|
The names of several volumes from which you are removing the LUN or NSID mapping. Enter the names of the volumes using these rules:
If the volume names have special characters or consist only of numbers, enter the names using these rules:
|
|
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 or NSID mapping from one volume. |
|
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 This parameter works only when you are removing LUN or NSID 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 system controller. The access volume uses a LUN or NSID 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 systems.
Removing an access volume can damage your configuration — The agent uses the access volumes to communicate with a storage system. If you remove an access volume mapping for a storage system from a host that has an agent running on it, the storage management software is no longer able to manage the storage system 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.