Page is loading ...
IBM Tape Device Drivers
Installation and User's Guide
GC27-2130-21
IBM
IBM Tape Device Drivers
Installation and User's Guide
GC27-2130-21
IBM
ii IBM Tape Device Drivers: Installation and User's Guide
Twenty-second Edition (November 2015)
This twenty-second edition of the IBM Tape Device Drivers Installation and User's
Guide, GC27-2130-21, replaces and makes obsolete the following manual: IBM Tape
Device Drivers Installation and User's Guide, GC27-2130-20.
© Copyright IBM Corp. 2007, 2015 iii
iv IBM Tape Device Drivers: Installation and User's Guide
Read this first
Accessing online technical support
For online technical support for your Library, visit:
v www.ibm.com/support.
Registering for My Notification
My Notification registration provides email notification when firmware levels have
been updated and are available for download and installation. To register for My
Notification:
1. Visit the web at http://www-01.ibm.com/software/support/einfo.html.
2. Click My Notifications.
Note: Library firmware and tape drive firmware are verified and released together.
When updating to the latest firmware, verify that all installed components such as
tape drives, and library are at the latest levels noted on the Support website.
Mixing different levels of library and tape drive firmware is not supported and can
cause unpredictable results.
Contacting IBM technical support
In the USA: Call 1-800-IBM_SERV (1-800-426-7378).
All other Countries/Regions: Visit www.ibm.com/support
To open a Service Request online: Under Support & downloads, click Open a
service request.
© Copyright IBM Corp. 2007, 2015 v
vi IBM Tape Device Drivers: Installation and User's Guide
Preface
These publications and URLs provide user information and installation assistance
for IBM
®
tape drive, medium changer, and library device drivers.
Related information
Reference material, including the Adobe PDF version of this publication, is
available at the following url: http://www-01.ibm.com/support/
docview.wss?uid=ssg1S7002972.
A companion publication that covers programming aspects for the device drivers
is: IBM Tape Device Drivers: Programming Reference, GA32-0566.
IBM tape products
IBM tape product publications
v IBM TS1120, TS1130, TS1140, and TS1150 Tape Drives and TS1120 Controller
Introduction and Planning Guide
v IBM TS1120 Tape Drive and Controller Operator Guide, GA32-0556
v IBM TS3500 Tape Library Operator Guide, GA32-0560
v IBM TS3500 Tape Library Introduction and Planning Guide, GA32-0559
v IBM TS4500 Tape Library Introduction and Planning Guide, SC27-5990
v IBM 3953 Library Manager Model L05 Operator Guide, GA32-0558
v IBM 3953 Tape System Introduction and Planning Guide, GA32-0557
v IBM Tape Drive 3592 SCSI Reference, GA32-0570
v IBM Introduction and Planning Guide 3592 Models J1A, E05, E06, EU6, E07, E08,
and J70, C06, C07 Controllers, GA32-0555
v IBM Operator Guide 3592 Models J1A, E05, E06, EU6, E07, E08, J70 and C06,
GA32-0556
v IBM LTO Ultrium 3-H Tape Drive Setup, Operator, and Service Guide, SC23-5231
v IBM TS2230 Tape Drive Setup, Operator, and Service Guide, GC27-2099
v IBM TS2230 Tape Drive Installation Quick Reference, GC27-2100
v IBM TS2240 Tape Drive Setup, Operator, and Service Guide, GC27-2151
v IBM TS2240 Tape Drive Installation Quick Reference, GC27-2167
v IBM TS2250 Tape Drive Setup, Operator, and Service Guide, GC27-2275
v IBM TS2250 Tape Drive Installation Quick Reference, GC27-2276
v IBM TS2260 Tape Drive Setup, Operator, and Service Guide, GC27-2226
v IBM TS2260 Tape Drive Installation Quick Reference, GC27-2226
v IBM TS2270 Tape Drive Setup, Operator, and Service Guide, SC27-8519
v IBM TS2270 Tape Drive Installation Quick Reference, GC27-2276
v IBM 3580 Tape Drive Models L33/L3H Setup, Operator, and Service Guide, GC26-7708
v IBM 3580 Tape Drive Models L33/L3H Quick Reference, GC26-7709
v IBM TS2340 Tape Drive Models L43/S43 Setup, Operator, and Service Guide,
GC27-2103
v IBM TS2340 Tape Drive Models L43/S43 Quick Reference Card, GC27-2104
© Copyright IBM Corp. 2007, 2015 vii
|
|
v IBM TS2350 Tape Drive Setup, Operator, and Service Guide, GC27-2277
v IBM TS2350 Tape Drive Installation Quick Reference, GC27-2278
v IBM TS2360 Tape Drive Setup, Operator, and Service Guide, GC27-2228
v IBM TS2360 Tape Drive Installation Quick Reference, GC27-2278
v IBM TS3500 Tape Library Planning and Operator Guide, GA32-0408
v IBM TS3500 Tape Library Maintenance Information, 19P2440
v IBM TS3500 Tape Library with ALMS: Introduction and Planning Guide, GA32-0593
v IBM TS3500 Tape Library with ALMS: Operator's Guide, GA32-0594
v IBM TS3500 Tape Library with ALMS: Tape System Reporter User's Guide,
GA32-0589
v IBM TS3310 Tape Library Setup and Operator Guide, GA32-0477
v IBM TS3310 Tape Library Maintenance Information, GA32-0478
v IBM TS3310 Tape Library SCSI Reference, GA32-0476
v IBM TS3100 Tape Library and TS3200 Tape Library Setup, Operator, and Service
Guide, GA32-0545
v IBM TS3100 Tape Library and TS3200 Tape Library Installation Quick Reference,
GA32-0548
v IBM TS3100 Tape Library and TS3200 Tape Library SCSI Reference, GA32-0547
To access the latest documentation for your product, go to the IBM Publications
Center at http://www-05.ibm.com/e-business/linkweb/publications/servlet/
pbi.wss. Select your country, then click Search for publications to find the desired
publication. Publications can be viewed and downloaded from the website.
AIX
The following URL points to information about IBM System p (also known as
pSeries) servers: http://www-1.ibm.com/servers/eserver/pseries.
HP-UX
The following URL relates to HP HP-UX systems: http://www.hp.com.
Linux
The following URLs relate to Linux distributions: http://www.redhat.com and
http://www.suse.com.
Solaris
The following URL relates to Oracle Solaris systems: http://www.oracle.com/us/
sun/index.html .
Microsoft Windows
The following URL relates to Microsoft Windows systems: http://
www.microsoft.com .
Additional Information
The following publication contains additional information related to the IBM tape
drive, medium changer, and library device drivers: American National Standards
viii IBM Tape Device Drivers: Installation and User's Guide
Institute Small Computer System Interface X3T9.2/86-109 X3.180, X3B5/91-173C,
X3B5/91-305, X3.131-199X Revision 10H, and X3T9.9/91-11 Revision 1.
Preface ix
x IBM Tape Device Drivers: Installation and User's Guide
Sending your comments
Your feedback is important in helping us provide the most accurate and best
quality information. If you have comments or suggestions for improving this
publication, you can send us comments electronically by using these addresses.
v E-mail
Submit your comments electronically to the following e-mail address:
Be sure to include the name and order number of the book and, if applicable,
the specific location of the text you are commenting on, such as a page number
or table number.
v Mail
Fill out the Readers' Comments form (RCF) at the back of this book. Return it by
mail or give it to an IBM representative. If the RCF is removed, you can address
your comments to:
International Business Machines Corporation
RCF Processing Department GZW
9032 South Rita Road
Tucson, AZ 85775-4401
© Copyright IBM Corp. 2007, 2015 xi
xii IBM Tape Device Drivers: Installation and User's Guide
Special printing instructions
This Tape Device Drivers Installation and User's Guide contains sections for each
type of operating system/platform; for example, AIX, HP-UX, Linux, Oracle
Solaris, Windows; and a separate section on these operating systems for the 3494
Enterprise tape library.
Note: When the page range is selected for the section you want to print, note that
the print page range is based on the page controls for Adobe Acrobat, not the page
printed on the actual document. Enter the Adobe page numbers to print.
If you want to print one or more separate sections of the manual, follow these
steps:
1. Navigate to the beginning of the section and note the page number.
2. Navigate to the last page in the section and note that page number.
3. Select File > Print, then choose Pages and enter the page range for the section.
Only the page range entered prints.
4. Repeat these steps to print additional sections.
Attention: Only one Table of Contents and one Index exists for this entire book.
If you want to print those items, you must repeat the previous process, entering
the page range for the Table of Contents and the Index page range, respectively.
Importantî€ printerî€ note
Thisî€ areaî€ indicatesî€ the
pagesî€ thatî€ willî€ actually
printî€ inî€ yourî€ specified
rangeî€ ofî€ pages.
Ignore theî€ pageî€ number
appearingî€ onî€ theî€ pageî€ itself
whenî€ enteringî€ pageî€ ranges
forî€ yourî€ printer.
Figure 1. How to print Adobe pdf files
© Copyright IBM Corp. 2007, 2015 xiii
xiv IBM Tape Device Drivers: Installation and User's Guide
Contents
iii
Read this first ............ v
Preface .............. vii
Sending your comments ....... xi
Special printing instructions ..... xiii
Figures .............. xix
Tables............... xxi
Chapter 1. Introduction ........ 1
Chapter 2. Common extended features . 5
Path failover and load balancing........ 5
Automatic failover ........... 5
Dynamic load balancing ......... 9
Dynamic Runtime Attributes ........ 10
Supported devices and feature codes ...... 10
Data encryption ............. 11
Tape and library requirements ....... 11
Planning for application-managed tape
encryption.............. 14
Planning for system-managed tape encryption.. 14
Planning for library-managed tape encryption .. 17
Encryption feature codes ......... 18
Chapter 3. AIX Tape and Medium
Changer device driver ........ 19
Product requirements ........... 19
Installation and configuration instructions .... 19
Installation procedure .......... 20
Configuring Tape and Medium Changer devices 21
Configuring limitations ......... 21
Deconfiguring tape devices ........ 22
Deconfiguring Medium Changer devices ... 22
Uninstalling ............. 22
Tape drive, media, and device driver parameters .. 23
Configuration parameters......... 23
Media parameters ........... 29
Special files .............. 30
Special files for tape devices ........ 30
Special files for Medium Changer devices ... 31
Persistent Naming Support ......... 32
Changing the logical name after initial boot .. 33
Control Path failover support for tape libraries .. 34
Configuring and unconfiguring path failover
support............... 34
Primary and alternative paths ....... 34
Querying primary and alternative path
configurations ............ 35
Configuring and unconfiguring primary and
alternative devices ........... 35
Data Path failover and load balancing support for
tape drives .............. 36
Installing Data Path failover license key .... 36
Configuring and unconfiguring path failover
support............... 36
Primary and alternative paths ....... 37
Querying primary and alternative path
configuration ............. 37
Configuring and unconfiguring primary and
alternative devices ........... 38
System-managed encryption ......... 38
Device driver configuration ........ 38
Querying tape drive configuration...... 39
Testing data encryption configuration and
connectivity ............. 39
Error logging ............. 39
Field support information ........ 39
Problem determination .......... 39
Dump support ............ 39
Device and volume information logging .... 40
Log file ............... 41
Tape log utility ............ 41
Reservation conflict logging ........ 41
Error logging ............. 42
Error log templates ........... 42
Automatic dump facility ......... 44
Dynamic Runtime Attributes ....... 44
Trace facility ............. 45
Atape System Trace (ATRC) utility ..... 45
Component tracing ........... 45
Atape Component Trace (ACTRC) utility ... 46
Tape drive service aids .......... 46
Tape drive service aids details ....... 46
Performance considerations ......... 49
Data path .............. 49
Common AIX utilities .......... 49
AIX iostat utility for tape performance .... 50
Before Support is called ......... 50
Chapter 4. HP-UX Tape and Medium
Changer device driver ........ 51
Product requirements ........... 51
ATDD implementation ......... 51
Hardware requirements ......... 52
Software requirements.......... 52
Software interface to the device driver .... 52
Installation and configuration instructions .... 53
Configuration limitations ......... 53
Installing and configuring PCI drivers .... 53
Supported configuration parameters ...... 61
Configuration parameter definitions ..... 62
© Copyright IBM Corp. 2007, 2015 xv
Special files .............. 65
Persistent Naming Support ......... 67
Control Path failover support for tape libraries .. 67
Configuring and unconfiguring path failover
support............... 67
Primary and alternative paths ....... 68
Querying primary and alternative path
configurations ............ 69
Disabling and enabling primary and alternative
paths ............... 69
Data Path failover and load balancing support for
tape drives .............. 69
Configuring and unconfiguring path failover
support............... 70
Primary and alternative paths ....... 71
Querying primary and alternative path
configuration ............. 71
Disabling and enabling primary and alternative
paths ............... 72
Problem determination .......... 72
Error logging ............. 72
Sense data logging ........... 72
Support_info script ........... 72
Tracing facility ............ 73
Problems and solutions ......... 74
Chapter 5. Linux Tape and Medium
Changer device driver ........ 77
Product requirements ........... 77
Installation and Configuration instructions .... 77
Conventions used ........... 78
Configuration limitations ......... 78
Components created during installation .... 78
Installation procedure .......... 79
Updating procedure .......... 79
Querying the installed package ....... 80
Configuring Tape and Medium Changer devices
on Intel-compatible systems ........ 80
Configuring Tape and Medium Changer devices
on IBM System p models ......... 81
Configuring Tape and Medium Changer devices
on IBM System z models ......... 81
Uninstallation procedure ......... 83
Tape drive, media, and device driver parameters .. 83
Configuration parameters......... 83
Nonchangeable parameters ........ 84
Changeable parameters ......... 85
Special files .............. 89
Special files for the tape device ....... 89
Special files for the Medium Changer device .. 89
Persistent Naming Support ........ 90
Control Path failover support for tape libraries .. 92
Configuring and unconfiguring path failover
support............... 92
Enabling path failover for the sg interface ... 93
Primary and alternative paths ....... 93
Querying primary and alternative path
configuration ............. 94
Disabling and enabling primary and alternative
paths ............... 94
Data Path failover and load balancing support for
tape drives .............. 94
Enabling path failover for st and sg interface .. 95
Primary and alternative paths ....... 96
Querying primary and alternative path
configuration ............. 97
Disabling and enabling primary and alternative
paths ............... 97
Tape Reserve Type ........... 97
Open source device driver - lin_tape ...... 97
Comparing IBMtape and lin_tape ...... 97
Installation ............. 98
Driver parameters and special device files ... 98
Taking devices offline and completing
maintenance ............. 98
Path failover support .......... 99
lin_taped daemon ........... 99
System-managed encryption ......... 99
Configuring device drivers ........ 99
Querying tape drive configuration ..... 100
Problem determination .......... 101
Tracing driver modules ......... 101
Configuring and running the lin_taped daemon 101
Reservation conflict logging ....... 106
Chapter 6. Solaris Tape and Medium
Changer Device Driver ....... 107
Product requirements........... 107
Installation and configuration instructions .... 108
Preventing conflicts with other device drivers 108
Preinstallation considerations ....... 109
Installing and updating IBMtape ...... 109
Configuring IBM tape devices with Fibre
Channel and SAS HBAs ......... 115
Configuring limitations ......... 120
Solaris Zones support ......... 120
Configuration parameters ........ 123
Dynamic Runtime Attributes ....... 127
Removing IBMtape .......... 128
Adding or removing devices ....... 128
Unconfiguring tape devices........ 129
Tapelist Utility Program ......... 129
Special files .............. 131
Device behaviors ........... 132
File naming conventions......... 132
Persistent Naming Support ......... 133
Control Path failover support for libraries .... 135
Configuring and deconfiguring Path Failover
support .............. 135
Primary and alternative paths ....... 135
Querying primary and alternative path
configuration ............ 136
Disabling and enabling primary and alternative
paths ............... 136
Data Path failover and load balancing support for
tape drives .............. 136
Configuring and deconfiguring Path Failover
support .............. 136
Primary and alternative paths ....... 138
Querying primary and alternative path
configuration ............ 138
xvi IBM Tape Device Drivers: Installation and User's Guide
||
||
Disabling and enabling primary and alternative
paths ............... 139
System-managed encryption ........ 139
Device driver configuration ....... 139
Querying tape drive configuration ..... 140
Testing data encryption configuration and
connectivity ............. 140
Field support information ........ 140
Problem determination .......... 141
Functional verification ......... 141
Sense data logging .......... 141
Installation problems .......... 142
Tape monitor daemon (tmd) ....... 142
Tracing facility ............ 143
Dynamic tracing utility ......... 145
Setting the IBM_trace level for static tracing .. 145
Running the diags_info script ....... 146
iostat command ........... 146
Reservation conflict logging ....... 146
Chapter 7. Windows Tape and Medium
Changer device driver ....... 149
Product requirements........... 149
Installation and configuration instructions .... 149
Windows Server 2012 instructions ..... 150
Configuring limitations ......... 153
Persistent Naming Support on Windows Server
2012 ................ 153
Control Path failover support for tape libraries .. 154
Configuring and unconfiguring Control Path
failover support ........... 154
Querying primary and alternative path
configuration ............ 154
Checking disablement of Control Path failover
setting............... 154
Data Path failover support for tape drives.... 155
Configuring and unconfiguring Data Path
failover support ........... 155
Reserve Type if DPF is disabled ...... 155
Querying primary and alternative path
configuration ............ 155
Checking disablement of Data Path failover
setting............... 156
System-managed encryption ........ 156
Device driver configuration ....... 156
Configuration file ........... 157
Querying tape drive configuration settings .. 157
Problem determination .......... 157
Windows Server 2012 instructions ..... 157
Reservation conflict logging ....... 158
Max retry busy ............ 159
Checking if Data Path failover is enabled ... 159
Checking if Control Path failover is enabled .. 159
Old releases: V6.2.5.2 and prior releases .... 159
Chapter 8. 3494 Enterprise Tape
Library support .......... 165
MTLIB program ............ 165
Syntax and examples .......... 165
MTEVENT program ........... 175
Library driver information ......... 176
Software interface ........... 176
Library Manager event notification ..... 176
Synchronous and asynchronous operations .. 176
Operation Complete notification ...... 176
Unsolicited notification ......... 177
Driver message queue ......... 177
Volume categories ........... 177
IBM TotalStorage Virtual Tape Server subsystem
attachment ............. 178
3494 Library emulation .......... 179
Overview.............. 179
3494 Emulation design ......... 179
3494 API Emulation and MTLIB program ... 180
SMC library names .......... 180
Volume categories ........... 180
Asynchronous library operations ...... 181
Performance considerations........ 181
AIX ................ 182
Data flow ............. 182
Product requirements.......... 183
Installation instructions ......... 183
Special files ............. 189
3494 Enterprise tape library attachment test .. 189
Problem determination ......... 190
HP-UX ............... 191
Data flow ............. 191
Product requirements.......... 192
Installation instructions ......... 193
3494 Enterprise tape library attachment test .. 197
Problem determination ......... 197
Linux ................ 197
Data flow ............. 198
Product requirements.......... 198
Installation instructions ......... 199
3494 Enterprise tape library attachment test .. 202
Problem determination ......... 202
Solaris................ 203
Data flow ............. 203
Product requirements.......... 204
Installation instructions ......... 205
3494 Enterprise tape library attachment test .. 208
Problem determination ......... 208
Windows ............... 209
Data flow ............. 209
Product requirements.......... 210
Installation instructions ......... 211
3494 Enterprise tape library attachment test .. 215
Problem determination ......... 215
Chapter 9. IBM Tape Diagnostic Tool
(ITDT)............... 217
Purpose ............... 217
Accessing ITDT ............ 218
Supported systems ........... 218
Standard Edition (ITDT-SE)........ 218
Graphical Edition (ITDT-GE) ....... 219
Supported equipment .......... 220
IBM Tape Diagnostic Tool - Standard Edition ... 221
Installing ITDT - Standard Edition ..... 221
Starting ITDT - Standard Edition ...... 225
Contents xvii
||
||
||
Standard Edition - known issues and limitations 228
Standard Edition - Start menu commands ... 232
Standard Edition - Scan menu commands ... 233
Standard Edition - Tapeutil menu commands 252
Standard Edition - Program options ..... 264
Standard Edition - Tapeutil scripting commands 264
IBM Tape Diagnostic Tool - Graphical Edition .. 292
Installing ITDT - Graphical Edition ..... 292
Graphical Edition - known issues and
limitations ............. 293
ITDT-GE user interface description ..... 294
Graphical Edition - Scan menu commands .. 297
Graphical Edition - visualizing log files.... 311
Graphical Edition - Tapeutil menu commands 312
Appendix A. Accessing
documentation and software online.. 327
Appendix B. Verifying correct
attachment of your devices ..... 331
Appendix C. Managing the microcode
on the IBM tape drive ........ 333
Notices .............. 335
Index ............... 337
xviii IBM Tape Device Drivers: Installation and User's Guide
/