IBM TS2340 User Guide - Page 201

Data Path Failover Support for Tape Drives, Configuring and Unconfiguring Data Path Failover Support

Page 201 highlights

Windows Device Driver Data Path Failover Support for Tape Drives To take advantage of Windows Data Path Failover (DPF) support, the appropriate feature code must be installed. Refer to "Automatic Failover" on page 12 for what feature code may be required for your machine type. Configuring and Unconfiguring Data Path Failover Support Data Path Failover support is enabled automatically when the device driver is installed. It may be disabled or reenabled for the entire set of attached drives or medium changers by modifying the registry. 1. Open the reg folder of the driver package. 2. Double click DisableDPF.reg or EnableDPF.reg. 3. Reboot the system. This is necessary for any registry modification to take effect. For LTO generation 3 or lower, for tape drives that require a data path license key on the host side to enable DPF, the device driver looks for a file called %system_root%:\IBM_DPF.txt for the key, where: %system_root% is the drive letter where Windows has been installed, typically C, (for example, C:\IBM_DPF.txt). The file should contain the key on a single line, with no spaces and no other text on the line. If multiple keys are required, place each key in the file on its own line. The driver looks for this file at initialization, and if the file contains a valid DPF license key, the DPF feature is enabled and any eligible devices have multi-path support. Note: For LTO generation 3 running the latest drive microcode, there is no longer a requirement to provide a DPF license key in IBM_DPF.txt. The microcode now handles the enablement of the DPF feature. Querying Primary and Alternate Path Configuration To check if the data path failover has been enabled in the device driver and display the primary and alternate paths you may use the tape diagnostic and utility tool. 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 "Microsoft Windows System Utility Program (ntutil)" on page 406. Checking Disablement of Data Path Failover Setting If you have disabled the data path failover in device driver's setting by double clicking the DisableDPF.reg file and reboot your system, you may go into the registry by issuing the Windows regedit command to confirm that DPF has been disabled. Look for a line like the following if your system is Windows Server 2003 or Windows Server 2008: [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ibmtp2kx] "FailoverDisabled"=dword:00000001 This indicates that DPF has been disabled in the driver. This setting only takes effect after your system is rebooted. Chapter 7. Windows Tape and Medium Changer Device Driver 183

  • 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

Data Path Failover Support for Tape Drives
To take advantage of Windows Data Path Failover (DPF) support, the appropriate
feature code must be installed. Refer to “Automatic Failover” on page 12 for what
feature code may be required for your machine type.
Configuring and Unconfiguring Data Path Failover Support
Data Path Failover support is enabled automatically when the device driver is
installed. It may be disabled or reenabled for the entire set of attached drives or
medium changers by modifying the registry.
1.
Open the
reg
folder of the driver package.
2.
Double click
DisableDPF.reg
or
EnableDPF.reg
.
3.
Reboot the system. This is necessary for any registry modification to take effect.
For LTO generation 3 or lower, for tape drives that require a data path license key
on the host side to enable DPF, the device driver looks for a file called
%system_root%:\IBM_DPF.txt for the key, where: %system_root% is the drive letter
where Windows has been installed, typically C, (for example, C:\IBM_DPF.txt).
The file should contain the key on a single line, with no spaces and no other text
on the line. If multiple keys are required, place each key in the file on its own line.
The driver looks for this file at initialization, and if the file contains a valid DPF
license key, the DPF feature is enabled and any eligible devices have multi-path
support.
Note:
For LTO generation 3 running the latest drive microcode, there is no longer
a requirement to provide a DPF license key in IBM_DPF.txt. The microcode
now handles the enablement of the DPF feature.
Querying Primary and Alternate Path Configuration
To check if the data path failover has been enabled in the device driver and
display the primary and alternate paths you may use the tape diagnostic and
utility tool.
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 “Microsoft Windows System -
Utility Program (ntutil)” on page 406.
Checking Disablement of Data Path Failover Setting
If you have disabled the data path failover in device driver’s setting by double
clicking the
DisableDPF.reg
file and reboot your system, you may go into the
registry by issuing the Windows
regedit
command to confirm that DPF has been
disabled. Look for a line like the following if your system is Windows Server 2003
or Windows Server 2008:
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ibmtp2kx]
"FailoverDisabled"=dword:00000001
This indicates that DPF has been disabled in the driver. This setting only takes
effect after your system is rebooted.
Windows Device Driver
Chapter 7. Windows Tape and Medium Changer Device Driver
183