Dell PowerVault ME5 Series Storage System CLI Reference Guide

PDF

map volume


Description	Maps volumes to initiators. This command can be used to modify existing mappings or create new mappings. NOTE: You cannot map a replication set’s secondary volume. Create a snapshot of the secondary volume or enable replication snapshot history and use the snapshot for mapping and accessing data. 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 attach the volume and will report an error such as "unknown partition table."
Minimum role	standard
Syntax	map volume [access read-write\|rw\|read-only\|ro\|no-access] initiator <initiators>\|<hosts>\|<host-groups> [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. no-access causes the volume to be masked from specified initiators. If the access parameter is omitted, access is set to read-write. initiator <initiators>\|<hosts>\|<host-groups> A comma-separated list of initiators, hosts, or host groups to which to map the volumes. For initiator, host, and host-group syntax, see Command syntax. NOTE:If an initiator is specified, at least one LUN must also be specified. lun <LUN> 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. 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 (FC, for example). For port syntax, see Command syntax. The ports parameter is ignored if access is set to no-access. If the ports parameter is omitted, all ports are mapped. <volumes> A comma-separated list of the names or serial numbers of the volumes to map. For volume syntax, see Command syntax.
Examples	Map volume vol2 with read-only access to initiator `Init1`, using port A1 and LUN 100. # map volume access ro ports a1 lun 100 initiator Init1 vol2 Map volumes vol2 and vol3 with read-write access for Host1., using ports A1 and B1 and LUN 101. # map volume access rw ports a1,b1 lun 101 initiator Host1. vol2,vol3 Mask volume vol4 from Init1 and Init3. # map volume vol4 access no-access lun 101 initiator Init1,Init3 Map volumes vol1 and vol2 to initiators Init1 and Init2, using ports A1 and B1 starting with LUN 6. # map volume ports a1,b1 lun 6 initiator Init1,Init2 vol1,vol2
See also	show host-groups show initiators show maps show ports show volumes unmap volume