HP EVA P6550 HP P6300/P6500 EVA User Guide (5697-2486, September 2013) - Page 113

Target bindings, maps to the SCSI CD-ROM device node, if any, for the LUN

Page 113 highlights

applications or operating system utilities to use the standard SCSI device nodes to access iSCSI devices can result in sending SCSI commands to the wrong target or logical unit. To provide consistent naming, the iSCSI driver scans the system to determine the mapping from SCSI device nodes to iSCSI targets. The iSCSI driver creates a tree of directories and symbolic links under /dev/iscsi to make it easier to use a particular iSCSI target's logical unit. The directory tree under /dev/iscsi contains subdirectories for each iSCSI bus number, each target id number on the bus, and each logical unit number for each target. For example, the whole disk device for bus 0, target ID 0, and LUN 0 would be /dev/iscsi/bus0/target0/LUN0/disk. In each logical unit directory there is a symbolic link for each SCSI device node that can be connected to that particular logical unit. These symbolic links are modeled after the Linux devfs naming convention: • The symbolic link disk maps to the whole-disk SCSI device node such as /dev/sda or /dev/sdb. • The symbolic links part1 through part15 maps to each partition of that SCSI disk. For example, a symbolic link can map to partitions /dev/sda1, dev/sda15, or to as many partitions as necessary. NOTE: These symbolic links exist regardless of the number of disk partitions. Opening the partition devices results in an error if the partition does not actually exist on the disk. • The symbolic link mt maps to the auto-rewind SCSI tape device node for the LUN /dev/st0, for example. Additional links for mtl, mtm, and mta map to the other auto-rewind devices /dev/st0l, /dev/st0m, /dev/st0a, regardless of whether these device nodes actually exist or could be opened. • The symbolic link mtn maps to the no-rewind SCSI tape device node, if any. For example, this LUN maps to /dev/nst0. Additional links formtln, mtmn, and mtan map to the other no-rewind devices such as /dev/nst0l, /dev/nst0m, /dev/nst0a, regardless of whether those device nodes actually exist or could be opened. • The symbolic link cd maps to the SCSI CD-ROM device node, if any, for the LUN /dev/scd0 for example. • The symbolic link generic maps to the SCSI generic device node, if any, for the LUN /dev/sg0. Because the symlink creation process must open all of the SCSI device nodes in /dev in order to determine which nodes map to iSCSI devices, you may see many modprobe messages logged to syslog indicating that modprobe could not find a driver for a particular combination of major and minor numbers. This message can be ignored. The messages occur when Linux is unable to find a driver to associate with a SCSI device node that the iSCSI daemon is opening as part of its symlink creation process. To prevent these messages from occurring, remove the SCSI device nodes that do not contain an associated high-level SCSI driver. Target bindings The iSCSI driver automatically maintains a bindings file, /var/iscsi/bindings. This file contains persistent bindings to ensure that the same iSCSI bus and target ID number are used for every iSCSI session with a particular iSCSI TargetName, even when the driver is repeatedly restarted. This feature ensures that the SCSI number in the device symlinks (described in "Assigning device names" (page 112)) always map to the same iSCSI target. Set up the iSCSI Initiator 113

  • 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
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316

applications or operating system utilities to use the standard SCSI device nodes to access iSCSI
devices can result in sending SCSI commands to the wrong target or logical unit.
To provide consistent naming, the iSCSI driver scans the system to determine the mapping from
SCSI device nodes to iSCSI targets. The iSCSI driver creates a tree of directories and symbolic
links under
/dev/iscsi
to make it easier to use a particular iSCSI target's logical unit.
The directory tree under
/dev/iscsi
contains subdirectories for each iSCSI bus number, each
target id number on the bus, and each logical unit number for each target. For example, the whole
disk device for
bus 0
,
target ID 0
, and
LUN 0
would be
/dev/iscsi/bus0/target0/LUN0/disk
.
In each logical unit directory there is a symbolic link for each SCSI device node that can be
connected to that particular logical unit. These symbolic links are modeled after the Linux
devfs
naming convention:
The symbolic link
disk
maps to the whole-disk SCSI device node such as
/dev/sda
or
/dev/sdb
.
The symbolic links
part1
through
part15
maps to each partition of that SCSI disk. For
example, a symbolic link can map to partitions
/dev/sda1
,
dev/sda15
, or to as many
partitions as necessary.
NOTE:
These symbolic links exist regardless of the number of disk partitions. Opening the
partition devices results in an error if the partition does not actually exist on the disk.
The symbolic link
mt
maps to the auto-rewind SCSI tape device node for the LUN
/dev/st0
,
for example. Additional links for
mtl
,
mtm
, and
mta
map to the other auto-rewind devices
/dev/st0l, /dev/st0m, /dev/st0a
, regardless of whether these device nodes actually
exist or could be opened.
The symbolic link
mtn
maps to the no-rewind SCSI tape device node, if any. For example,
this LUN maps to
/dev/nst0
. Additional links
formtln
,
mtmn
, and
mtan
map to the other
no-rewind devices such as
/dev/nst0l, /dev/nst0m, /dev/nst0a
, regardless of
whether those device nodes actually exist or could be opened.
The symbolic link
cd
maps to the SCSI CD-ROM device node, if any, for the LUN
/dev/scd0
for example.
The symbolic link
generic
maps to the SCSI generic device node, if any, for the LUN
/dev/sg0
.
Because the symlink creation process must open all of the SCSI device nodes in
/dev
in order to
determine which nodes map to iSCSI devices, you may see many
modprobe
messages logged
to
syslog
indicating that
modprobe
could not find a driver for a particular combination of major
and minor numbers. This message can be ignored. The messages occur when Linux is unable to
find a driver to associate with a SCSI device node that the iSCSI daemon is opening as part of its
symlink
creation process. To prevent these messages from occurring, remove the SCSI device
nodes that do not contain an associated high-level SCSI driver.
Target bindings
The iSCSI driver automatically maintains a bindings file,
/var/iscsi/bindings
. This file
contains persistent bindings to ensure that the same iSCSI bus and target ID number are used for
every iSCSI session with a particular iSCSI
TargetName
, even when the driver is repeatedly
restarted.
This feature ensures that the SCSI number in the device
symlinks
(described in
“Assigning device
names” (page 112)
) always map to the same iSCSI target.
Set up the iSCSI Initiator
113