HP MSA2324sa HP StorageWorks 2300 Family Modular Smart Array CLI reference gui - Page 69

map volume, Optional. For FC and SAS, the host's nickname or 16-hex-digit WWPN. For iSCSI

Page 69 highlights

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 [access read-write|rw|read-only|ro|no-access] [mapping ports.LUN] [lun LUN] [ports ports] [host host] volume Parameters 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 Optional. The ports and LUN to use for the mapping; any unspecified ports become unmapped. Ignored if access is set to no-access. lun LUN Optional. 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 Optional. 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 Optional. For FC and SAS, the host's nickname or 16-hex-digit WWPN. For iSCSI, the initiator's node name (typically the IQN) or nickname. For nickname syntax, see Command syntax. If this parameter is omitted, the mapping applies to all hosts that are not explicitly mapped. volume Name or serial number of the volume to map. For syntax, see Command syntax. 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 access ro mapping a1.301 host Host1 v2 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 access rw ports a1,b1 lun 302 host Host2 v2 Success: Command completed successfully. - The volume was mapped successfully. HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 69

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196

HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide
69
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
[access read-write|rw|read-only|ro|no-access]
[mapping
ports
.
LUN
]
[lun
LUN
]
[ports
ports
]
[host
host
]
volume
Parameters
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
Optional. The ports and LUN to use for the mapping; any unspecified ports become unmapped.
Ignored if access is set to
no-access
.
lun
LUN
Optional. 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
Optional. 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
Optional. For FC and SAS, the host's nickname or 16-hex-digit WWPN. For iSCSI, the initiator's
node name (typically the IQN) or nickname. For nickname syntax, see
Command syntax
. If this
parameter is omitted, the mapping applies to all hosts that are not explicitly mapped.
volume
Name or serial number of the volume to map. For syntax, see
Command syntax
.
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 access ro mapping a1.301 host Host1 v2
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 access rw ports a1,b1 lun 302 host Host2 v2
Success: Command completed successfully. - The volume was mapped successfully.