map volume
63
map volume
Description
Maps specified volumes using settings that override the volumes’ 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 initiators have to the volume, and the LUN presented to all initiators 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 initiators.
Optionally, you can specify the LUN, ports, and access level for a mapping. A mapping can make a
volume accessible to initiators, or inaccessible to initiators (known as
masking
). For example, assume
a volume’s default mapping allows read-only access using LUN 5. You can give one initiator
read-write access using LUN 6, and you can give a second initiator no access to the volume.
NOTE:
When mapping a volume to an initiator using the Linux ext3 file system, specify read-write
access. Otherwise, the file system will be unable to mount/present/map the volume and will report
an error such as “unknown partition table.”
Min. role
manage
Syntax
map volume
[access read-write|rw|read-only|ro|no-access]
[host
hosts
]
initiator
initiators
[lun
LUN
]
[ports
ports
]
volumes
Parameters
access read-write|rw|read-only|ro|no-access
Optional. The access permission to use for the mapping: read-write (
rw
), read-only (
ro
), or
no-access
. If the access parameter is specified as read-write or read-only, the
lun
parameter must
be specified. For an explicit mapping,
no-access
causes the volume to be masked from specified
initiators. If the
access
parameter is omitted, access is set to
read-write
.
host
hosts
Deprecated—use the
initiator
parameter instead.
initiator
initiators
Optional. A comma-separated list of initiators to which to map the volumes. For initiator syntax, see
. If the
initiator
parameter is specified, the
lun
and
ports
parameters must be specified. If the
initiator
parameter is omitted, the mapping applies to all
initiators that are not explicitly mapped.
lun
LUN
Optional. The LUN to use for the mapping. If a single volume and multiple initiators are specified,
the same LUN is used for each initiator. If multiple volumes and a single initiator are specified, the
LUN will increment for the second and subsequent volumes. If multiple volumes and initiators are
specified, each initiator will have the same LUN for the first volume, the next LUN for the second
volume, and so on. The
lun
parameter is ignored if
access
is set to
no-access
. If the
lun
parameter is omitted, the default LUN is presented.
ports
ports
Optional. The controller host ports to use for the mapping. Any unspecified ports become
unmapped. All specified ports must be the same type. For port syntax, see
. If the
ports
parameter is specified, the
lun
parameter must also be specified. The
ports
parameter is ignored if
access
is set to
no-access
. If the
ports
parameter is omitted, all
ports are mapped.
Summary of Contents for AssuredSAN 6004
Page 11: ...Document conventions and symbols 11 TIP Provides helpful hints and shortcuts...
Page 114: ...114 Alphabetical list of commands See also set cli parameters show protocols...
Page 139: ...show controller statistics 139 See also reset all statistics reset controller statistics...
Page 162: ...162 Alphabetical list of commands See also show power supplies...