IBM TS2340 User Guide - Page 103

Querying Primary and Alternate Path Configuration, Disable and Enable Primary and Alternate Paths,

Page 103 highlights

HP-UX Device Driver (ATDD) # ioscan -funC tape The following is an example of the output for this command: /home/root# ioscan -funC tape Class I H/W Path Driver S/W State H/W Type Description tape 0 0/1/0/0.101.22.255.1.1.1 atdd CLAIMED DEVICE IBM ULT3580-TD3 /dev/rmt/0m tape 1 0/1/0/0.101.22.255.1.2.1 atdd CLAIMED DEVICE IBM ULT3580-TD3 /dev/rmt/1m.altpath Querying Primary and Alternate Path Configuration You can display the primary and alternate path configuration for all devices by running ioscan, as explained in section "Primary and Alternate Paths" on page 84. Note: Display the primary and alternate path configuration for any device using tape diagnostic and utility functions, refer to Chapter 10, "IBM Tape Diagnostic Tool (ITDT)," on page 259 or "HP-UX System - Tape Utility Program (tapeutil)" on page 375. Disable and Enable Primary and Alternate Paths If it is necessary to disable a path and not perform path fail over (for example due to maintenance), run commands to disable and then later enable the primary and alternate paths. The commands to enable and disable primary and alternate paths are tape diagnostic and utility functions. Note: See Chapter 10, "IBM Tape Diagnostic Tool (ITDT)," on page 259 or "HP-UX System - Tape Utility Program (tapeutil)" on page 375 Problem Determination A set of tools is provided with the device driver to determine if the device driver and the tape device are functioning correctly. Error Logging Read the system log file (typically /var/adm/syslog/syslog.log) and the ATDD log file (/var/adm/atdd/atdd_d.log) if you are having problems. The ATDD logs messages to this file which provide information regarding the problem. Reservation Conflict Logging When the device driver receives a reservation conflict during open or after the device has been opened it will log a reservation conflict in the HP-UX system log of /var/adm/syslog/syslog.log. Prior to logging the error the device driver will issue a Persistent Reserve In command to determine if a SCSI Persistent Reservation is active on the reserving host to get the reserving host initiator WWPN (World Wide Port Name) and reserve key. If successful, the device driver will log this information in the detail data below. After initially logging the reserving host WWPN, subsequent reservation conflicts from the same reserving host WWPN and reservation key will not be logged to prevent multiple entries in the system log until either the reserving host WWPN or reservation key is different than the one initially logged or the device driver has reserved the device and then another reservation conflict occurs. Here are the log examples: Chapter 4. HP-UX Tape and Medium Changer Device Driver 85

  • 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
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336
  • 337
  • 338
  • 339
  • 340
  • 341
  • 342
  • 343
  • 344
  • 345
  • 346
  • 347
  • 348
  • 349
  • 350
  • 351
  • 352
  • 353
  • 354
  • 355
  • 356
  • 357
  • 358
  • 359
  • 360
  • 361
  • 362
  • 363
  • 364
  • 365
  • 366
  • 367
  • 368
  • 369
  • 370
  • 371
  • 372
  • 373
  • 374
  • 375
  • 376
  • 377
  • 378
  • 379
  • 380
  • 381
  • 382
  • 383
  • 384
  • 385
  • 386
  • 387
  • 388
  • 389
  • 390
  • 391
  • 392
  • 393
  • 394
  • 395
  • 396
  • 397
  • 398
  • 399
  • 400
  • 401
  • 402
  • 403
  • 404
  • 405
  • 406
  • 407
  • 408
  • 409
  • 410
  • 411
  • 412
  • 413
  • 414
  • 415
  • 416
  • 417
  • 418
  • 419
  • 420
  • 421
  • 422
  • 423
  • 424
  • 425
  • 426
  • 427
  • 428
  • 429
  • 430
  • 431
  • 432
  • 433
  • 434
  • 435
  • 436
  • 437
  • 438
  • 439
  • 440
  • 441
  • 442
  • 443
  • 444
  • 445
  • 446
  • 447
  • 448
  • 449
  • 450
  • 451
  • 452
  • 453
  • 454
  • 455
  • 456
  • 457

#
ioscan -funC tape
The following is an example of the output for this command:
/home/root# ioscan -funC tape
Class
I
H/W Path
Driver S/W State
H/W Type
Description
===============================================================================
tape
0
0/1/0/0.101.22.255.1.1.1
atdd
CLAIMED
DEVICE
IBM ULT3580-TD3 /dev/rmt/0m
tape
1
0/1/0/0.101.22.255.1.2.1
atdd
CLAIMED
DEVICE
IBM ULT3580-TD3 /dev/rmt/1m.altpath
Querying Primary and Alternate Path Configuration
You can display the primary and alternate path configuration for all devices by
running
ioscan
, as explained in section “Primary and Alternate Paths” on page 84.
Note:
Display the primary and alternate path configuration for any device using
tape diagnostic and utility functions, refer to Chapter 10, “IBM Tape
Diagnostic Tool (ITDT),” on page 259 or “HP-UX System - Tape Utility
Program (tapeutil)” on page 375.
Disable and Enable Primary and Alternate Paths
If it is necessary to disable a path and not perform path fail over (for example due
to maintenance), run commands to disable and then later enable the primary and
alternate paths.
The commands to enable and disable primary and alternate paths are tape
diagnostic and utility functions.
Note:
See Chapter 10, “IBM Tape Diagnostic Tool (ITDT),” on page 259 or “HP-UX
System - Tape Utility Program (tapeutil)” on page 375
Problem Determination
A set of tools is provided with the device driver to determine if the device driver
and the tape device are functioning correctly.
Error Logging
Read the system log file (typically
/var/adm/syslog/syslog.log
) and the ATDD log file
(
/var/adm/atdd/atdd_d.log
) if you are having problems. The ATDD logs messages to
this file which provide information regarding the problem.
Reservation Conflict Logging
When the device driver receives a reservation conflict during open or after the
device has been opened it will log a reservation conflict in the HP-UX system log
of
/var/adm/syslog/syslog.log
. Prior to logging the error the device driver will issue a
Persistent Reserve In command to determine if a SCSI Persistent Reservation is
active on the reserving host to get the reserving host initiator WWPN (World Wide
Port Name) and reserve key. If successful, the device driver will log this
information in the detail data below. After initially logging the reserving host
WWPN, subsequent reservation conflicts from the same reserving host WWPN and
reservation key will not be logged to prevent multiple entries in the system log
until either the reserving host WWPN or reservation key is different than the one
initially logged or the device driver has reserved the device and then another
reservation conflict occurs.
Here are the log examples:
HP-UX Device Driver (ATDD)
Chapter 4. HP-UX Tape and Medium Changer Device Driver
85