Skip to main content

Set volume mapping

The set volume logicalUnitNumber command defines the logical unit number (LUN) mapping between a volume and a host or host group.

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.

Context

This command is applicable to volumes in either a volume group or disk pool.

Note
You cannot use this command for a snapshot volume that is used in online volume copy.

Syntax

set (volume [<var id="GUID-A8BAB4F4-47E6-4B46-8236-966C6CEA8423__V1683135" className="keyword varname">volumeName</var>] | volume <"<var id="GUID-A8BAB4F4-47E6-4B46-8236-966C6CEA8423__V1697340" className="keyword varname">wwID</var>"> | accessVolume) 
logicalUnitNumber=<var id="GUID-A8BAB4F4-47E6-4B46-8236-966C6CEA8423__V1683136" className="keyword varname">lun</var>
(host="<var id="GUID-A8BAB4F4-47E6-4B46-8236-966C6CEA8423__V1683137" className="keyword varname">hostName</var>" |
hostGroup=("<var id="GUID-A8BAB4F4-47E6-4B46-8236-966C6CEA8423__V1683138" className="keyword varname">hostGroupName</var>" | defaultGroup)

Parameter

ParameterDescription
volume (name)

The name of the volume for which you want to define the logical unit number. Enclose the volume name in square brackets ([ ]). If the volume name has special characters or numbers, you must enclose the volume name in double quotation marks (" ") inside square brackets.

volume (WWID)The World Wide Identifier (WWID) of the volume for which you want to define the logical unit number. Enclose the WWID in double quotation marks (" ") inside angle brackets (< >).
accessVolume

The logical unit number for the access volume. The logical unit number is the only property that you can set for the access volume.

logicalUnitNumber

The logical unit number or namespace ID that you want to use to map to a specific host. This parameter also assigns the host to a host group.

Note
The logical unit number or namespace ID you specify must not already be in use, and must be within the range supported by the host Operating System. There will be no error if you map the volume to a logical unit number or namespace ID not supported by the host, but the host won't be able to access the volume.
host

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

hostGroup

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

Notes

A host group is an optional topological element that you can define if you want to designate a collection of hosts that share access to the same volumes. The host group is a logical entity. Define a host group only if you have two or more hosts that can share access to the same volumes.

You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Names can have a maximum of 30 characters.

The access volume is the volume in a SAN environment that is used for in-band communication between the storage management software and the storage array controller. This 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. If you specify the accessVolume parameter, the only property you can set is the logicalUnitNumber parameter.