HP StorageWorks 2300 Modular Smart Array CLI reference guide (500912-001, January 2009)

map volume

Description Maps a volume using settings that override the volume's default mapping.

When a volume is created, if no mapping settings are specified the volume is not mapped;

otherwise, those settings become its default mapping, which specifies the controller host ports and

access level that all connected hosts have to the volume, and the LUN presented to all hosts to

identify the volume. The default mapping's LUN is known as the volume's default LUN.

The map volume command creates mappings with different settings for different hosts. Optionally,

you can specify the LUN, ports, and access level for a mapping. A mapping can make a volume

accessible to hosts, or inaccessible to hosts (known as masking). For example, assume a volume's

default mapping allows read-only access using LUN 5. You can give one host read-write access

using LUN 6, and you can give a second host no access to the volume.

Syntax

map volume volume [access read-write|rw|read-only|ro|no-access]

[mapping ports.LUN] [lun LUN] [ports ports] [host host]

Parameters volume

Name or serial number of the volume to map. For syntax, see Command syntax.

access read-write|rw|read-only|ro|no-access

Optional. The access permission available to attached hosts: read-write (rw), read-only (ro), or

no-access. When a volume is mapped with no-access, the volume is masked. If this parameter is

omitted, access is set to read-write.

mapping ports.LUN

The ports and LUN to use for the mapping; any unspecified ports become unmapped. Ignored if

access is set to no-access.

lun LUN

The LUN to use for the mapping. Ignored if access is set to no-access. If this parameter is omitted,

the default LUN is presented. Do not use this parameter with the mapping parameter.

ports ports

The ports to use for the mapping; any unspecified ports become unmapped. Ignored if access is set

to no-access. If this parameter is omitted, all ports are mapped. Use this parameter with the lun

parameter but not with the mapping parameter.

host host

For FC , the host's nickname or 16-hex-digit WWPN. For nickname syntax, see Command syntax. If

this parameter is omitted, the mapping applies to all hosts that are not explicitly mapped.

Example Map volume v2 with read-only access for Host1, using port A1 and LUN 301. The volume will be

unmapped for all other hosts:

# map volume v2 access ro mapping a1.301 host Host1

Success: Command completed successfully. - The volume was mapped successfully.

Also map volume v2 with read-only access for Host2, using ports A1 and B1 and LUN 302. The

volume will be unmapped for all hosts other than Host1 and Host2:

# map volume v2 access rw ports a1,b1 lun 302 host Host2

Success: Command completed successfully. - The volume was mapped successfully.