TANDBERG LTO-7 HH User guide

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.

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.

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

|

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:

[email protected]

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

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

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

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

Page is loading ...

TANDBERG LTO-7 HH User guide

This manual is also suitable for

TANDBERG LTO-7 HH User guide

Related papers

Other documents