IBM Ultrium Tape IUG

Download IBM Ultrium Tape IUG

Post on 04-Sep-2014

138 views

Category:

Documents

0 download

Embed Size (px)

TRANSCRIPT

IBM Ultrium Device Drivers

Installation and Users Guide

GA32-0430-13

IBM Ultrium Device Drivers

Installation and Users Guide

GA32-0430-13

Note! Before using this information and the product that it supports, be sure to read the general information under Appendix D, Notices, on page 289.

Seventeenth Edition (April 2006) This edition of the IBM Ultrium Device Drivers Installation and Users Guide, GA32-0430-13 obsoletes and replaces all earlier versions. Changes or additions are indicated by a vertical line in the left margin. Copyright International Business Machines Corporation 2000 - 2006. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

ContentsFigures . . . . . . . . . . . . . . . ix Tables . . . . . . . . . . . . . . . xi Preface . . . . . . . . . . . . . . xiiiRelated Information . . . . . . . . . . . IBM TotalStorage Ultrium External Tape Drive 3580 . . . . . . . . . . . . . . . IBM TotalStorage Ultrium Tape Autoloader 3581 IBM TotalStorage Ultrium Tape 2U Autoloader 3581 . . . . . . . . . . . . . . . IBM TotalStorage Ultrium Tape Library 3582 . . IBM TotalStorage Ultrium Scalable Tape Library 3583 . . . . . . . . . . . . . . . IBM TotalStorage UltraScalable Tape Library 3584 . . . . . . . . . . . . . . . IBM Virtualization Engine TS7510 . . . . . IBM System Storage TS3310 Tape Library . . . IBM System Storage TS3100 Tape Library . . . Other Publications . . . . . . . . . . . Additional Information . . . . . . . . . How to Send Your Comments . . . . . . . . xiii xiii xiii xiii xiii xiii xiii xiv xiv xiv xiv xiv xvi IBM TotalStorage UltraScalable Tape Library 3584 StorageSmart by IBM Ultrium Products . . . IBM Virtualization Engine TS7510 . . . . . IBM System Storage TS3310 Tape Library . . . IBM System Storage TS3100 Tape Library . . . . . . . 6 6 7 7 7

|

Part 2. AIX Tape and Medium Changer Device Driver . . . . . . . 9Chapter 2. Introduction and Product Requirements . . . . . . . . . . . . 11Purpose . . . . . . . . Data Flow . . . . . . . . Product Requirements . . . . Software Requirements . . Library Control Path and Data Support . . . . . . . Hardware Requirements . . . . . . . . . . Path . . . . . . . . . . . . . . . . Failover . . . . . . . . . . . . . . . . 11 11 11 11

|

. 12 . 12

Chapter 3. Tape Drive, Media, and Device Driver Parameters. . . . . . . 15Configuration Parameters. . . Autoloading . . . . . . Block Size . . . . . . . Compression . . . . . . Logging . . . . . . . Maximum Size of the Log File Record Space Mode . . . Rewind Immediate . . . . Trailer Labels . . . . . . Media Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 15 16 16 16 16 16 17 17 17

Summary of Changes . . . . . . . . xvii| Seventeenth Edition (April 2006) . . . . . . . xviiSixteenth Edition (December 2005) . Fifteenth Edition (May 2005) . . . Fourteenth Edition (December 2004) Thirteenth Edition (May 2004). . . Twelfth Edition (April 2004) . . . Eleventh Edition (October 2003) . . Tenth Edition (June 2003) . . . . Ninth Edition (April 2003) . . . . Eight Edition (January 2003) . . . Fifth Edition (March 2002) . . . . Fourth Edition (September 2001) . Third Edition (July 2001) . . . . Second Edition (March 2001) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii xvii xvii xvii xvii xvii xviii xviii xviii xviii xviii xviii xviii

Chapter 4. Installation and Configuration Instructions . . . . . . 19Installation Procedure . . . . . . . . . . Preinstallation Considerations . . . . . . Installation Procedure . . . . . . . . . Configuring Tape and Medium Changer Devices . Deconfiguring Tape Devices . . . . . . . . Deconfiguring Medium Changer Devices . . . Uninstallation Procedure . . . . . . . . . . . . . . . . 19 19 20 20 21 21 21

Part 1. Introduction to IBM Ultrium Device Drivers . . . . . . . . . . . 1Chapter 1. Ultrium Device Drivers. . . . 3Purpose . . . . Platform Support . Introduction . . IBM TotalStorage 3580 . . . . IBM TotalStorage IBM TotalStorage 3581 . . . . IBM TotalStorage IBM TotalStorage 3583 . . . . . . . . . . . . . Ultrium . . . Ultrium Ultrium . . . Ultrium Ultrium . . . . . . . . . . . . . . . . . . . . . . . . . . . External Tape Drive . . . . . . . . Tape Autoloader 3581 Tape 2U Autoloader . . . . . . . . Tape Library 3582 . . Scalable Tape Library . . . . . . . . . 3 . 3 . 4 . 5 . 5 . 5 . 6 . 6

Chapter 5. Special Files . . . . . . . 23Special Files for Tape Devices . . . . . Special Files for Medium Changer Devices . . . . . . 23 . 25

Chapter 6. Control Path Failover for Libraries . . . . . . . . . . . . . . 27Configuring and Unconfiguring Alternate Pathing Support . . . . . . . . . . . . . . . 28 Primary and Alternate Paths . . . . . . . . . 28 Querying Primary and Alternate Path Configuration 28

Copyright IBM Corp. 2000 - 2006

iii

Configuring and Unconfiguring Primary and Alternate Devices . . . . . . . . . .

.

. 29

Trace Facility . ATRC Utility .

. .

. .

. .

. .

. .

. .

. .

. .

. .

. .

. .

. .

. 57 . 57

Chapter 7. Data Path Failover and Load Balancing for Tape Drives . . . . . . 31Automatic Failover . . . . . . . . . . . . Dynamic Load Balancing . . . . . . . . . . Installing Feature Code 1681 Data Path Failover License Key . . . . . . . . . . . . . . Configuring and Unconfiguring Alternate Pathing Support . . . . . . . . . . . . . . . Primary and Alternate Paths . . . . . . . . . Querying Primary and Alternate Path Configuration Configuring and Unconfiguring Primary and Alternate Devices . . . . . . . . . . . . 31 32 32 33 33 34 34

Part 3. Compaq Tru64 Tape and Medium Changer Device Driver . . . 59Chapter 14. Introduction and Product Requirements . . . . . . . . . . . . 61Purpose . . . . . . . . Product Requirements . . . . Hardware Requirements . . Software Requirements . . Setting Up the Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 61 61 61 61

Chapter 8. Using the Dump Support . . 35 Chapter 9. Tape Utility Program (tapeutil) . . . . . . . . . . . . . . 37Interactive Interface . . . . . Command-Line Interface . . . . General Subcommands . . . Medium Changer Subcommands Tape Subcommands . . . . Service Aid Subcommands . . Block Size and SCSI Transfer Size . Configuration Parameters. . . . Reserve and Release Commands . Tape Drive Service Aids . . . . Volume ID for Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 37 38 40 41 45 45 45 46 46 46

Chapter 15. RAS Utility Program For Compaq Tru64 System (IBMrasutil) . . 63Installation Procedure from and SMI-S Agent CD . . Installation Procedure from Site . . . . . . . . Uninstalling . . . . . Update Procedure . . . Query Procedure . . . Verify Procedure . . . . Interactive Mode . . . Command-Line Mode . . Command-Line Options the Tape Device Drivers . . . . . . . . . the Device Driver FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 63 64 64 64 64 64 64 65

Part 4. HP-UX Tape and Medium Changer Device Driver . . . . . . . 67Chapter 16. Introduction and Product Requirements . . . . . . . . . . . . 69Purpose . . . . . . . . . . Product Requirements . . . . . . ATDD Implementation . . . . Hardware Requirements . . . . Software Requirements . . . . Data Flow . . . . . . . . . . Software Interface to the Device Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 69 69 69 72 73 74

Chapter 10. Tape Drive Service Aids . . 47Details of Tape Service Aids . Force Microcode Dump . Read Dump . . . . . Microcode Load . . . . Error Log Analysis . . . Reset Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 47 48 48 49 49

Chapter 11. Performance Considerations . . . . . . . . . . . 51Data Path . . . . . Common AIX Utilities . Before Calling Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 . 51 . 52

Chapter 17. Install, Uninstall, and Configure the DLKM Version of ATDD . 75Create the Drive Configuration File (Optional) . . Determine the Drive Hardware Path for IBM 3580 Ultrium Tape Drive, 3581 Tape Autoloader with SCSI Attachment . . . . . . . . . Determine the Drive Hardware Paths for IBM Ultrium Tape Libraries with SCSI Attachment . Determine the Drive Hardware Paths for IBM 3580 Ultrium Tape Drive, IBM Ultrium Tape Libraries with Fibre Channel Attachment . . Create the Hardware Path Entry . . . . . Create the Device Specific Configuration Entries (Optional) . . . . . . . . . . . . . Power Off the Tape Drives . . . . . . . . Install the Driver Using the CD Installation Script Install Drivers Manually . . . . . . . . . . 76

Chapter 12. Device and Volume Information Logging . . . . . . . . . 53Log File . . . Tape Log Utility . . . . . . . . . . . . . . . . . . . . . . . . 53 . 53

. 76 . 77

Chapter 13. Problem Determination . . 55Error Logging . . . . . . Error Log Templates . . . Error Labels . . . . . . Detail Data . . . . . . Automatic Dump Facility for the Tape Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IBM 3580 Ultrium . . . . . . . . . . 55 55 55 55

. 77 . 77 . 78 . 78 78 . 79

. 57

iv

IBM Ultrium Tape Device Drivers: Installation and Users Guide

Copy the Software to the Software Depot . . Review the ATDD README File . . . . . Install ATDD . . . . . . . . . . . . Configure all IBM Tape Drives/Media Changers with ATDD/ACDD . . . . . . . . . . Configure Selected IBM Tape Devices with ATDD/ACDD . . . . . . . . . . . Uninstalling the software . . . . . . . . Other Administrative Tasks . . . . . . .

. 79 . 80 . 81 . 82 . 82 . 83 . 83

Atdd_d Log Daemon . . Problems and Solutions .

. .

. .

. .

. .

. .

. .

. .

. .

. 108 . 110

Chapter 24. Tape Utility Program (tapeutil) . . . . . . . . . . . . . 113Command Sequence Information . . . . . Product Requirements . . . . . . . . Tapeutil Implementation . . . . . . . Hardware Requirements . . . . . . . Install tapeutil Using the CD Installation Script Install tapeutil Manually . . . . . . . . Copy the Software to the Software Depot . . Review the tapeutil README File . . . . Install tapeutil . . . . . . . . . . . Uninstalling tapeutil . . . . . . . . . Other Administrative Tasks . . . . . . . Using the tapeutil Program . . . . . . . Interactive Mode . . . . . . . . . . Command-Line Interface . . . . . . . Service Commands . . . . . . . . Basic SCSI Commands . . . . . . . Medium Changer Commands . . . . . CPF Commands . . . . . . . . . Tape Drive Commands . . . . . . . Flag Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 113 113 113 114 114 114 115 115 116 116 116 117 119 119 119 120 120 120 122

Chapter 18. Install, Uninstall, and Configure the Static Version of ATDD . 85Create the Drive Configuration File (Optional) . . . Determine the Drive Hardware Path for IBM 3580 Ultrium Tape Drive, 3581 Tape Autoloader with SCSI Attachment . . . . . . . . . . Determine the Drive Hardware Paths for IBM Ultrium Tape Libraries with SCSI Attachment . . Determine the Drive Hardware Paths for IBM 3580 Ultrium Tape Drive, IBM Ultrium Tape Libraries with Fibre Channel Attachment . . . Create the Hardware Path Entry . . . . . . Create the Device Specific Configuration Entries (Optional) . . . . . . . . . . . . . . Power Off the Tape Drives . . . . . . . . . Install Drivers Manually . . . . . . . . . . Copy the Software to the Software Depot . . . Review the atdd README File . . . . . . . Install ATDD . . . . . . . . . . . . . Post-Configuration of IBM Medium Changer Devices . . . . . . . . . . . . . . . Adding an IBM Ultrium Device Using the Currently Installed ATDD . . . . . . . . . . . . . Uninstalling the Software . . . . . . . . . . Other Administrative Tasks . . . . . . . . . 86

86 87

87 87 88 88 88 89 90 90 91 93 94 94

Part 5. Linux Tape and Medium Changer Device Driver . . . . . . 125Chapter 25. Introduction and Product Requirements . . . . . . . . . . . 127Purpose . . . . . . . . . . . . . . Data Flow . . . . . . . . . . . . . Product Requirements . . . . . . . . . Hardware Requirements for Intel and AMD Opteron Processors . . . . . . . . . Hardware Requirements for IBM ERserver pSeries Models . . . . . . . . . . . Hardware Requirements for IBM ERserver zSeries Models . . . . . . . . . . . Library Control Path and Tape Drive Data Path Failover Support . . . . . . . . . . Software Requirements for Intel Processors . Software Requirements for IBM pSeries Models Software Requirements for IBM zSeries Models . 127 . 127 . 127 . 128 . 128 . 129 . 130 . 130 130 130

Chapter 19. Alternate Pathing Support for Library Control Path Failover . . . 97Configuring and Unconfiguring Alternate Pathing Support . . . . . . . . . . . . . . Primary and Alternate Paths . . . . . . . . Querying Primary and Alternate Path Configurations . . . . . . . . . . . . Disable and Enable Primary and Alternate Paths . . 97 . 98 . 98 . 99

Chapter 20. Special Files . . . . . . 101 Chapter 21. Supported Configurations 103Modifying Configuration Parameters . . . . . 103

Chapter 26. Tape Drive, Media, and Device Driver Parameters . . . . . . 131Configuration Parameters . Nonchangeable Parameters: Autoloading . . . . . Capacity Scaling . . . Density Code . . . . Emulate Autoloader . . Hook Word . . . . . Logical Write Protect . . Maximum Block Size . . Minimum Block Size . . Medium Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 132 132 132 132 132 132 132 132 132 132

Chapter 22. Configuration Parameter Definitions . . . . . . . . . . . . 105Device-Specific Parameters . Driver-Specific Parameters . . . . . . . . . . . . . . . . 105 . 106

Chapter 23. Troubleshooting . . . . . 107Error Logging . . . Support_info Script . Tracing Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 . 107 . 107

Contents

v

Read SILI Bit . . . . . . Record Space Mode . . . . Volume ID for Logging . . . Write Protect . . . . . . Changeable Parameters: . . . . Block Size . . . . . . . Buffered Mode . . . . . . Compression . . . . . . Disable Auto Drive Dump . . Disable SIM Logging . . . . Logging (Volume Logging) . . Maximum SCSI Transfer Length Read Past Filemark . . . . Rewind Immediate . . . . Trace . . . . . . . . . Trailer Labels . . . . . .

. . . . . . . . . . . . . . . .

....

Recommended

View more >