Installation and User s Guide

Transcription

1 IBM Ultrium Deice Driers Installation and User s Guide GA

2

3 IBM Ultrium Deice Driers Installation and User s Guide GA

4 Note! Before using this information and the product that it supports, be sure to read the general information under Appendix D, Notices, on page 259. Eleenth Edition (October 2003) This edition of the IBM Ultrium Deice Driers Installation and User s Guide, GA obsoletes and replaces GA Changes or additions are indicated by a ertical line in the left margin. Copyright International Business Machines Corporation 2000, All rights resered. US Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Figures ix Tables xi Preface xiii Related Information xiii IBM TotalStorage Ultrium External Tape Drie xiii IBM TotalStorage Ultrium Tape Autoloader 3581 xiii IBM TotalStorage Ultrium Tape Library xiii IBM TotalStorage Ultrium Scalable Tape Library xiii IBM TotalStorage UltraScalable Tape Library xiii Other Publications xiii Additional Information xiii How to Send Your Comments x Summary of Changes xii Eleenth Edition (October 2003) xii Tenth Edition (June 2003) xii Ninth Edition (April 2003) xii Eight Edition (January 2003) xii Fifth Edition (March 2002) xii Fourth Edition (September 2001) xii Third Edition (July 2001) xii Second Edition (March 2001) xiii Part 1. Introduction to IBM Ultrium Deice Driers Chapter 1. Ultrium Deice Driers Purpose Platform Support Introduction IBM TotalStorage Ultrium External Tape Drie IBM TotalStorage Ultrium Tape Autoloader IBM TotalStorage Ultrium Tape Library IBM TotalStorage Ultrium Scalable Tape Library IBM TotalStorage UltraScalable Tape Library StorageSmart by IBM Ultrium Products....7 Part 2. AIX Tape and Medium Changer Deice Drier Chapter 2. Introduction and Product Requirements Purpose Data Flow Product Requirements Software Requirements Library Control Path Failoer Support Hardware Requirements Chapter 3. Tape Drie, Media, and Deice Drier Parameters Configuration Parameters Autoloading Block Size Compression Logging Maximum Size of the Log File Record Space Mode Rewind Immediate Trailer Labels Media Parameter Chapter 4. Installation and Configuration Instructions Installation Procedure Preinstallation Considerations Installation Procedure Configuring Tape and Medium Changer Deices..19 Deconfiguring Tape Deices Deconfiguring Medium Changer Deices Uninstallation Procedure Chapter 5. Special Files Special Files for Tape Deices Special Files for Medium Changer Deices Chapter 6. Alternate Pathing Support for Library Control Path Failoer Configuring and Unconfiguring Alternate Pathing Support Primary and Alternate Paths Querying Primary and Alternate Path Configuration 26 Configuring and Unconfiguring Primary and Alternate Deices Chapter 7. Alternate Pathing Support for Tape Dries Automatic Failoer Dynamic Load Balancing Configuring and Unconfiguring Alternate Pathing Support Primary and Alternate Paths Querying Primary and Alternate Path Configuration 32 Configuring and Unconfiguring Primary and Alternate Deices Chapter 8. Using the Dump Support.. 33 Copyright IBM Corp. 2000, 2003 iii

6 Chapter 9. Tape Utility Program (tapeutil) Interactie Interface Command-Line Interface General Subcommands Medium Changer Subcommands Tape Subcommands Serice Aid Subcommands Block Size and SCSI Transfer Size Configuration Parameters Resere and Release Commands Tape Drie Serice Aids Volume ID for Logging Chapter 10. Tape Drie Serice Aids.. 47 Details of Tape Serice Aids Force Microcode Dump Read Dump Microcode Load Error Log Analysis Reset Drie Chapter 11. Performance Considerations Data Path Common AIX Utilities Before Calling Support Chapter 12. Deice and Volume Information Logging Log File Tape Log Utility Chapter 13. Problem Determination.. 55 Error Logging Error Log Templates Error Labels Detail Data Automatic Dump Facility for the IBM 3580 Ultrium Tape Drie Trace Facility ATRC Utility Part 3. Compaq Tru64 Tape and Medium Changer Deice Drier Chapter 14. Introduction and Product Requirements Purpose Product Requirements Hardware Requirements Software Requirements Setting Up the Enironment Chapter 15. RAS Utility Program For Compaq Tru64 System (IBMrasutil).. 63 Installation Procedure from the Deice Drier CD 63 Installation Procedure from the Deice Drier ftp Site Uninstalling Update Procedure Query Procedure Verify Procedure Interactie Mode Command-Line Mode Command-Line Options Part 4. HP-UX Tape and Medium Changer Deice Drier Chapter 16. Introduction and Product Requirements Purpose Product Requirements ATDD Implementation Hardware Requirements Software Requirements Data Flow Software Interface to the Deice Drier Chapter 17. Install, Uninstall, and Configure Create the Drie Configuration File (Optional)...76 Determine the Drie Hardware Path for IBM 3580 Ultrium Tape Drie, 3581 Tape Autoloader with SCSI Attachment Determine the Drie Hardware Paths for IBM Ultrium Tape Libraries with SCSI Attachment..77 Determine the Drie Hardware Paths for IBM 3580 Ultrium Tape Drie, IBM Ultrium Tape Libraries with Fibre Channel Attachment...77 Create the Hardware Path Entry Create the Deice Specific Configuration Entries (Optional) Power Off the Tape Dries Install the Drier Using the CD Installation Script 78 Install Driers Manually Copy the Software to the Software Depot...79 Reiew the atdd README File Install ATDD Post-Configuration of IBM Medium Changer Deices Adding an IBM Ultrium Deice Using the Currently Installed ATTD Uninstalling the Software Other Administratie Tasks Chapter 18. Special Files Chapter 19. Supported Configurations 89 Modifying Configuration Parameters Chapter 20. Configuration Parameter Definitions Deice-Specific Parameters i IBM Ultrium Tape Deice Driers: Installation and User s Guide

7 Drier-Specific Parameters Chapter 21. Troubleshooting Error Logging Support_info Script Tracing Facility Atdd_d Log Daemon Problems and Solutions Chapter 22. Tape Utility Program (tapeutil) Command Sequence Information Product Requirements Tapeutil Implementation Hardware Requirements Install tapeutil Using the CD Installation Script..98 Install tapeutil Manually Copy the Software to the Software Depot Reiew the tapeutil README File Install tapeutil Uninstalling tapeutil Other Administratie Tasks Using the tapeutil Program Interactie Mode Command-Line Interface Serice Commands Basic SCSI Commands Medium Changer Commands Tape Drie Commands Flag Description Part 5. Linux Tape and Medium Changer Deice Drier Chapter 23. Introduction and Product Requirements Purpose Data Flow Product Requirements Hardware Requirements for Intel Processors 112 Hardware Requirements for IBM ERserer pseries Models Hardware Requirements for IBM ERserer zseries Models Library Control Path Failoer Support Software Requirements for Intel Processors..113 Software Requirements for IBM pseries Models 113 Software Requirements for IBM zseries Models 113 Maximum Block Size Minimum Block Size Medium Type Read SILI Bit Record Space Mode Volume ID for Logging Write Protect Changeable Parameters: Block Size Buffered Mode Compression Disable Auto Drie Dump Disable SIM Logging Logging (Volume Logging) Maximum SCSI Transfer Length Read Past Filemark Rewind Immediate Trace Trailer Labels Chapter 25. Installation and Configuration Instructions Conentions Used Components Created During Installation Installation Procedure Updating Procedure Querying Installed Package Verifying Installation/Updating Configuring Tape and Medium Changer Deices on Intel-Compatible Systems Configuring Tape and Medium Changer Deices on IBM ERserer pseries Models Configuring Tape and Medium Changer Deices on IBM ERserer zseries Models Use /etc/zfcp.conf File Modify the /etc/modules.conf File Dynamically Attaching a Tape Deice Uninstall Procedure Chapter 26. Configure and Run IBMtaped Daemon Install IBMtaped Configure IBMtaped Tracing Error Logging Volume Logging Automatically Retriee a Drie Dump Selectie Tracing Run IBMtaped Chapter 24. Tape Drie, Media, and Deice Drier Parameters Configuration Parameters Nonchangeable Parameters: Autoloading Capacity Scaling Density Code Emulate Autoloader Hook Word Logical Write Protect Chapter 27. Special Files Special Files for the Tape Deice Special Files for the Medium Changer Deice Chapter 28. Alternate Pathing Support for Library Control Path Failoer Configuring and Unconfiguring Alternate Pathing Support Primary and Alternate Paths Contents

8 Querying Primary and Alternate Path Configuration Disable and Enable Primary and Alternate Paths 139 Chapter 29. Tape Utility Program (IBMtapeutil) Interactie Mode Command-Line Mode General Subcommands disablepath primary number enablepath primary number inquiry [Page] logpage Page modepage Page path print Text qrypath qryersion release reqsense resere tur Tape Subcommands allow append asf [Count] bsf [Count] bsfm [Count] bsr [Count] compress and nocompress density display Message eof [Count] and weof [Count] erase fsf [Count] fsfm [Count] fsr [Count] list load lock mtdeice offline, rewoffl, and unload parms preent qryinquiry qrypos qrysense read -d Destination [-c Count] rewind and retension rtest [-b Blocksize] [-c Count] [-r Repetition] rwtest [-b Blocksize] [-c Count] [-r Repetition] 147 seek [Count] seod setblk [Block Size] setpos [Blockid] status sync tell unlock write -s Source wtest [-b Blocksize] [-c Count] [-r Repetition] 148 i IBM Ultrium Tape Deice Driers: Installation and User s Guide Medium Changer Subcommands allow audit [Address [Count] deids elementinfo exchange Source Dest1 Dest inentory mount [Slot] moe Source Destination position Destination preent unmount [Slot] Serice Aid Subcommands dump [Filename] forcedump resetdrie ucode [Filename] Automatic Cartridge Facility Mode Block Size and SCSI Transfer Size Configuration Parameters Capacity Scaling Logical Write Protect Resere and Release Commands Serice Aids Commands Create Special Files Chapter 30. Tape Drie Serice Aids 153 Details of Tape Drie Serice Aids Force Drie Dump Read Dump Load Microcode Reset Drie Part 6. Solaris Tape and Medium Changer Deice Drier Chapter 31. Introduction and Product Requirements Purpose Product Requirements and Compatibility Hardware Requirements Software Requirements Software Compatibility Data Flow Software Interface to the Deice Drier Chapter 32. Installation, Remoal, and Configuration Preenting Conflicts with Other Deice Driers 161 Installing or Updating IBMtape Installation Steps Remoing IBMtape Configuration Parameters Adding or Remoing Deices Chapter 33. Special Files

9 Chapter 34. Serice and Diagnostic Aids Functional Verification Problem Determination Downloading Deice Microcode Forcing and Storing Deice Diagnostic Dump Tracing Facility Setting the IBM_trace Leel Running the Diags_info Script Tape and Medium Changer Utility Program Serice Commands Basic SCSI Commands Medium Changer Commands Tape Drie Commands Flag Description Part 7. Microsoft Windows Tape Deice Driers Chapter 35. Introduction and Product Requirements Windows NT Hardware Requirements Software Requirements Installation Notes Windows 2000 and Windows Serer Hardware Requirements Software Requirements Installation Notes Chapter 36. Windows NT Deice Drier Management Installation Oeriew Installation Procedure Remoal Procedure Manual Starting and Stopping Procedures Chapter 37. Windows 2000 and Windows Serer 2003 Deice Drier Management Installation Oeriew Installation Procedures Deice Remoal or Disable Procedure Uninstalling the Deice Driers Chapter 38. Windows Utility Program (ntutil) Calling ntutil Interactie Mode Batch Mode Comments Command Statements set type pause delay system symbols exit Symbolic Values Deice Drier Diagnosis Information (for Microsoft Windows NT) Deice Drier Diagnosis Information (for Microsoft Windows 200x) Using the Debug Version Restoring the Non-Debug Version Part 8. Appendixes Appendix A. Accessing Documentation and Software Online. 245 Appendix B. Verifying Proper Attachment of Your Deices AIX System Tape Deice Attachment Test Medium Changer Deice Attachment Test Compaq Tru64 System Tape Deice Attachment Test Medium Changer Deice Attachment Test HP-UX System Tape Deice Attachment Test Autochanger Deice Attachment Test Linux System Tape Deice Attachment Test Medium Changer Deice Attachment Test Solaris System Tape Deice Attachment Test Autochanger Deice Attachment Test Microsoft Windows System Tape Deice Attachment Test Autochanger Deice Attachment Test - Windows NT only Appendix C. Managing the Microcode on the IBM Tape Drie AIX System Compaq Tru64 System HP-UX System Linux System Sun Solaris System Microsoft Windows System Appendix D. Notices Trademarks Index Contents ii

10 iii IBM Ultrium Tape Deice Driers: Installation and User s Guide

11 Figures 1. Attachment Array Example of an Ultrium Enironment Data Flow Process Data Path Data Flow TAPEUTIL Program Menu for the tape drie on HP-UX and 11i PCI Bus Systems TAPEUTIL Program Menu for the medium changer on HP-UX and 11i PCI Bus Systems Data Flow Process Data Flow TAPEUTIL Program Menu for the Tape Drie TAPEUTIL Program Menu for the Medium Changer Select Components Menu Start Menu Start Drier List Rescan for Tape Deice Install Drier Menu Select Cancel Tape Deices Menu Hae Disk Menu Install Drier Menu Windows NT Statement Remoe Drier Menu Control Panel Selection Add/Remoe Properties Drie Remoal Menu Manual Starting and Stopping Menu Computer Management Console Computer Management Console with Ultrium Deice Selected Deice Drier Properties with Reinstall Drier... Selected Install Hardware Deice Driers Dialog Locate Drier Files Screen with Specify a Location Selected Specifying the Location of the Drier Files Needed Menu ibmchgr.sys Drier Files Search Results Completing the Upgrade Deice Drier Wizard Verifying the Ultrium Deice Was Installed Correctly Hardware Update Wizard Welcome Screen Search and Installation Options Windows Logo Testing Screen Completing the Hardware Update Wizard Base Mode Library Mode Symbolic Values Copyright IBM Corp. 2000, 2003 ix

12 x IBM Ultrium Tape Deice Driers: Installation and User s Guide

13 Tables 1. Ultrium Product Comparison Special Files for IBM 3580 Tape Deice Special Files Error Description IBM Tape and Medium Changer Driers for HP-UX (ATDD) and HP-UX System Special Files Deice-Specific Parameter Definitions Drier-Specific Parameter Definitions Problems and Solutions Components Created During IBMtape Installation Components Created During IBMtapeutil Installation Special Files for IBM Ultrium Tape Deices IBMtape Components IBMtape Install or Update Equipment Listing Equipment Listing Equipment Listing Sample Equipment Listing IBM SCSI Tape/Medium Changer Special Files for Solaris Tracing Facility Copyright IBM Corp. 2000, 2003 xi

14 xii IBM Ultrium Tape Deice Driers: Installation and User s Guide

15 Preface Related Information This publication proides programming reference information for IBM Ultrium tape drie, medium changer, and library deice driers. The following sections contain lists of sources that you may need for information related to the IBM Ultrium tape drie, medium changer, and library deice driers. IBM TotalStorage Ultrium External Tape Drie 3580 The following publications relate to the IBM TotalStorage Ultrium External Tape Drie 3580 : IBM 3580 Ultrium Tape Drie Setup, Operator, and Serice Guide, GA IBM TotalStorage Ultrium Tape Autoloader 3581 The following publication relates to the IBM TotalStorage Ultrium Tape Autoloader 3581: IBM 3581 Ultrium Tape Autoloader Setup, Operator, and Serice Guide, GA IBM TotalStorage Ultrium Tape Library 3582 The following publications relate to the IBM TotalStorage Ultrium Tape Library 3582: IBM TotalStorage Ultrium Tape Library 3582 Setup, Operator, and Serice Guide, GA IBM TotalStorage Ultrium Scalable Tape Library 3583 The following publications relate to the IBM TotalStorage Ultrium Scalable Tape Library 3583: IBM 3583 Ultrium Scalable Tape Library Setup and Operator Guide, GA IBM 3583 Ultrium Scalable Tape Library Serice Guide, GA IBM Storage Area Network Data Gateway Module Setup, Operator, and Serice Guide, GA IBM TotalStorage UltraScalable Tape Library 3584 The following publications relate to the IBM TotalStorage UltraScalable Tape Library 3584: IBM 3584 UltraScalable Tape Library Planning and Operator Guide, GA IBM 3584 UltraScalable Tape Library Maintenance Information, 19P2440 Other Publications IBM Storage Area Network Data Gateway Installation and User s Guide, SC Additional Information Special Printing Instructions: Copyright IBM Corp. 2000, 2003 xiii

16 This SCSI Deice Drier Manual contains different sections for each type of operating platform, for example, AIX, HP-UX, Linux, Sun Solaris, and Windows. Note: When selecting the page range for the section you wish 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 wish to print one or more separate sections of the manual, follow these steps: 1. Naigate to the beginning of the section and note the page number. 2. Naigate 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 will print. 4. Repeat these steps to print additional sections. 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. Attention: There is only one Table of Contents and one Index for this entire book. If you wish to print those items, you must repeat the process aboe, entering the page range of the Table of Contents and the Index page range, respectiely. The following publications contain additional information that to relates to the IBM Ultrium tape drie, medium changer, and library deice driers: IBM Ultrium Deice Driers: Programming Reference, GC American National Standards Institute Small Computer System Interface X3T9.2/ X3.180, X3B5/91-173C, X3B5/91-305, X X Reision 10H, and X3T9.9/91-11 Reision 1 xi IBM Ultrium Tape Deice Driers: Installation and User s Guide

17 How to Send Your Comments Your feedback is important in helping to proide the most accurate and highest quality information. If you hae comments or suggestions for improing this publication, you can send us comments electronically using these addresses: Internet: (or STARPUBS at us.ibm.com) IBMLink from U.S.A.: STARPUBS at SJEVM5 IBMLink from Canada: STARPUBS at TORIBM IBM Mail Exchange: USIB3VVD at IBMMAIL Preface x

18 xi IBM Ultrium Tape Deice Driers: Installation and User s Guide

19 Summary of Changes This summary of changes includes specific release updates to this publication. Eleenth Edition (October 2003) This release includes the following new information: Library Path Failoer information for Linux Information regarding IBM Eserer pseries serer support Tenth Edition (June 2003) Ninth Edition (April 2003) This release includes the following new information: Data Path Failoer information Eight Edition (January 2003) Fifth Edition (March 2002) This release includes the following new information: IBM TotalStorage Ultrium Tape Library 3582 This release includes the following new information: IBM TotalStorage UltraScalable Tape Library 3584 medium changer AIX failoer Ultrium Generation 2 support This release includes the following new information: Support for Linux operating systems. Fourth Edition (September 2001) Third Edition (July 2001) Support for new host bus adapter cards, operating system releases, and enhancements to the deice driers. This release also includes changes to correct errors or omissions in the preious editions. This release includes the following new information: Support for Linux operating systems. Support for new host bus adapter cards, operating system releases, and enhancements to the deice driers. This release also includes changes to correct errors or omissions in the preious editions. This release includes the following new information: Support for new host bus adapter cards, operating system releases, and enhancements to the deice driers. Copyright IBM Corp. 2000, 2003 xii

20 Second Edition (March 2001) This release also includes changes to correct errors or omissions in the preious editions. This release includes support for IBM ERserer pseries. xiii IBM Ultrium Tape Deice Driers: Installation and User s Guide

21 Part 1. Introduction to IBM Ultrium Deice Driers Copyright IBM Corp. 2000,

22 2 IBM Ultrium Tape Deice Driers: Installation and User s Guide

23 Chapter 1. Ultrium Deice Driers Purpose Platform Support This publication describes the IBM Tape and Medium Changer Deice Driers for the following deices: IBM TotalStorage Ultrium External Tape Drie 3580 on page 6 IBM TotalStorage Ultrium Tape Autoloader 3581 on page 6 IBM TotalStorage Ultrium Tape Library 3582 on page 6 IBM TotalStorage Ultrium Scalable Tape Library 3583 on page 6 IBM TotalStorage UltraScalable Tape Library 3584 on page 7 StorageSmart by IBM Ultrium Products on page 7 On AIX, HP-UX, Linux, Solaris, and Windows operating systems. The IBM Ultrium tape and medium changer deice driers are designed specifically to take adantage of the features proided by the IBM Ultrium tape dries and medium changer deices. The goal is to gie applications access to the functions required for basic tape functions (such as backup and restore) and medium changer operations (such as cartridge mount and demount), as well as to the adanced functions needed by full tape management systems. Wheneer possible, the drier is designed to take adantage of the deice features transparent to the application. Part 2, AIX Tape and Medium Changer Deice Drier, on page 9 describes the installation and configuration of the AIX Enhanced Tape and Medium Changer Deice Drier for IBM Ultrium products. Part 4, HP-UX Tape and Medium Changer Deice Drier, on page 67 describes the installation and configuration of the HP Enhanced Tape and Medium Changer Deice Drier for IBM Ultrium products. Part 5, Linux Tape and Medium Changer Deice Drier, on page 109 describes the installation and configuration of the Linux Enhanced Tape and Medium Changer Deice Drier for IBM Ultrium products. Part 6, Solaris Tape and Medium Changer Deice Drier, on page 155 describes the installation and configuration of the Solaris Tape and Medium Changer Deice Drier for IBM Ultrium products, also known as IBMtape. Part 7, Microsoft Windows Tape Deice Driers, on page 191 describes the installation and configuration of Microsoft Windows-based Tape and Medium Changer Deice Driers for IBM Ultrium products. Information in the Appendixes coers accessing updated driers, microcode, and documentation online. It also addresses attachment testing of IBM Ultrium deices to the host computer. Copyright IBM Corp. 2000,

24 Ultrium Deice Drier Introduction The IBM Ultrium product family proides an excellent solution for customers with small to large storage and performance requirements. Figure 1 on page 5 illustrates the attachment of arious Ultrium products to an open systems serer. 4 IBM Ultrium Tape Deice Driers: Installation and User s Guide

25 Ultrium Deice Drier a Figure 1. Attachment Array The following are the Ultrium Deice Drier attachments: 1 Open Systems Serer 2 IBM TotalStorage Ultrium External Tape Drie 3580 Chapter 1. Ultrium Deice Driers 5

26 Ultrium Deice Drier 3 IBM TotalStorage Ultrium Tape Autoloader IBM TotalStorage Ultrium Tape Library IBM TotalStorage Ultrium Scalable Tape Library IBM TotalStorage UltraScalable Tape Library 3584 Figure 2 illustrates an Ultrium enironment that could include an IBM 3583 Ultrium Scalable Tape Library and an IBM 3584 UltraScalable Tape Library. Figure 2. Example of an Ultrium Enironment IBM TotalStorage Ultrium External Tape Drie 3580 The IBM TotalStorage Ultrium External Tape Drie 3580 is a stand alone, large capacity, high performance tape drie that adheres to the Linear Tape-Open (LTO) specifications and supports the IBM Ultrium format tape. The drie supports natie tape capacities of up to 200 GB with uncompressed data transfer rates of up to 35 MB per second. With both Low Voltage Differential (LVD) Ultra-2 SCSI and High Voltage Differential (HVD) Ultra SCSI attachments, this deice is suitable for a ariety of sae, restore and archiing requirements for PC and Open Systems platforms. IBM TotalStorage Ultrium Tape Autoloader 3581 The IBM TotalStorage Ultrium Tape Autoloader 3581 is an external, stand alone or rack-mounted tape autoloader that incorporates one IBM Ultrium Tape Drie. The autoloader has seen storage slots giing the autoloader up to 1,400 GB of uncompressed data storage. The autoloader can be used with compatible software applications to automate backup/recoery or other data storage actiities. IBM TotalStorage Ultrium Tape Library 3582 The IBM TotalStorage Ultrium Tape Library 3582 is an entry tape library incorporating high-performance IBM TotalStorage Ultrium generation 2 Tape Dries for the midrange open systems enironment. It can accomodate one or two Ultrium generation 2 Tape Dries and comes standard with a one-cartridge I/O station and 23 data cartridge slots giing a natie library capacity of 4.8 TB uncompressed natie storage. IBM TotalStorage Ultrium Scalable Tape Library 3583 The IBM TotalStorage Ultrium Scalable Tape Library 3583 is an automated tape library that incorporates IBM Ultrium tape dries in either a stand alone or optional rack mount configuration. Three different library models are aailable with storage capacities of 18 through 72 slots and one to six Ultrium tape dries. 6 IBM Ultrium Tape Deice Driers: Installation and User s Guide

27 Ultrium Deice Drier The IBM TotalStorage Ultrium Scalable Tape Library 3583 can be used for sae, restore and mass storage archies where multiterrabyte capacities are required. IBM TotalStorage UltraScalable Tape Library 3584 The IBM TotalStorage UltraScalable Tape Library 3584 proides a highly scalable midrange tape library that supports logical partitioning (multipath architecture) and can house up to 192 IBM Ultrium tape dries. With scalability of one to sixteeen frames, this library proides natie storage capacity from 28 TB to 1,376 TB with a wide range of host attachment configurations. StorageSmart by IBM Ultrium Products The StorageSmart by IBM Ultrium family of products is compatible with the IBM branded ersions of the Ultrium family products. In this manual, where there is no specific mention of the StorageSmart by IBM Ultrium branded set of products, the documentation pertaining to the IBM branded family of products should be used. The following table cross references the StorageSmart by IBM Ultrium product set to the IBM Ultrium product set. Table 1. Ultrium Product Comparison StorageSmart by IBM Ultrium StorageSmart by IBM Ultrium External Tape Drie TX200 StorageSmart by Ultrium Tape Autoloader SL7 StorageSmart by Ultrium Scalable Tape Library SL72 No equialent in the IBM Ultrium product set IBM Version of Ultrium IBM TotalStorage Ultrium External Tape Drie 3580 IBM TotalStorage Ultrium Tape Autoloader 3581 IBM TotalStorage Ultrium Scalable Tape Library 3583 IBM TotalStorage UltraScalable Tape Library 3584 Chapter 1. Ultrium Deice Driers 7

28 Ultrium Deice Drier 8 IBM Ultrium Tape Deice Driers: Installation and User s Guide

29 Part 2. AIX Tape and Medium Changer Deice Drier Copyright IBM Corp. 2000,

30 10 IBM Ultrium Tape Deice Driers: Installation and User s Guide

31 Chapter 2. Introduction and Product Requirements Purpose Data Flow This chapter describes the IBM AIX Enhanced Tape and Medium Changer Deice Drier for the following Ultrium products: IBM TotalStorage Ultrium External Tape Drie 3580 IBM TotalStorage Ultrium Tape Autoloader 3581 IBM TotalStorage Ultrium Tape Library 3582 IBM TotalStorage Ultrium Scalable Tape Library 3583 IBM TotalStorage UltraScalable Tape Library 3584 The IBM AIX Enhanced Tape and Medium Changer Deice Drier is designed specifically to take adantage of the features proided by the IBM Ultrium tape dries and medium changer deices. The goal is to gie applications access to the functions required for basic tape operations, such as backup and restore, and medium changer operations, such as mount and demount the cartridges, as well as to the adanced functions needed by full tape management systems. Wheneer possible, the drier is designed to take adantage of the deice features transparent to the application. The software described in this chapter coers the AIX Enhanced Deice Drier (Atape deice drier) and the interface between the application and the tape deice. Figure 3 illustrates a typical Ultrium data flow process. Product Requirements Figure 3. Data Flow Process The following software and hardware components are required to use the tape deice drier. Software Requirements The AIX Enhanced Deice Drier (Atape deice drier) supports the following AIX operating system leels for operation of IBM Ultrium tape dries and automation products: AIX (dependent on the host bus adapter being used). AIX requires AIX APAR IY See Hardware Requirements on page 12. AIX 5L Versions 5.1 and 5.2 on POWER-based serers Note: The Atape deice drier supports AIX Version (and later releases) in an MP Safe (multiprocessing) mode. Copyright IBM Corp. 2000,

32 AIX Deice Drier (Atape) Library Control Path Failoer Support In order to use alternate pathing support, the following feature codes are required for the associated machine type: Table 2. Machine Type Feature Code 3582 FC FC FC 1680 Hardware Requirements The Atape deice drier supports the following IBM Ultrium tape dries and automation products: One or more of the following IBM Ultrium tape deices: IBM TotalStorage Ultrium External Tape Drie 3580 IBM TotalStorage Ultrium Tape Autoloader 3581 IBM TotalStorage Ultrium Tape Library 3582 IBM TotalStorage Ultrium Scalable Tape Library 3583 IBM TotalStorage UltraScalable Tape Library 3584 One or more of the following IBM RS/6000 or pseries SCSI host bus adapters: PCI Dual Channel Ultra-3 SCSI Adapter (LVD) (RS/6000 or pseries FC 6203), AIX and later. PCI Differential Ultra SCSI Adapter (HVD) (RS/6000 or pseries FC 6207) PCI Uniersal Differential Ultra SCSI Adapter (HVD) (RS/6000 or pseries FC 6204), AIX and later Integrated LVD port - RS/6000 or pseries 7044 Models 170 and 270, AIX and later, IBM 3580, 3581, and 3583 only PCI Dual Channel Ultra-2 SCSI Adapter (LVD) (RS/6000 or pseries FC 6205), AIX and later One or more of the following IBM RS/6000 or pseries FC-AL host bus adapters: Gigabit Fibre Channel Adapter (PCI) (RS/6000 or pseries FC 6227) The Gigabit Fibre Channel Adapter for 64 bit PCI bus (RS/6000 or pseries FC 6228) The IBM 2108 G07 (IBM SAN Data Gateway) and IBM 2108 R03 (IBM SAN Data Gateway Router) can be used to attach SCSI models of the IBM Ultrium family of products with any of the supported FC AL host bus adapters. Attention: Using a single Fibre Channel host bus adapter (HBA) for concurrent tape and disk operations is not recommended. Tape and disk deices require incompatible HBA settings for reliable operation and optimal performance characteristics. Under stress conditions (high I/O rates for tape, disk, or both) where disk and tape subsystems share a common HBA, stability problems hae been obsered. These issues are resoled by separating disk and tape I/O streams onto separate HBAs and using SAN zoning to minimize contention. IBM is focused on assuring serer and storage configuration interoperability. It strongly recommends that your implementation plan includes proisions for separating disk and tape workloads. 12 IBM Ultrium Tape Deice Driers: Installation and User s Guide

33 Chapter 3. Tape Drie, Media, and Deice Drier Parameters Configuration Parameters This chapter describes the parameters that control the operating modes of the tape drie, media, and deice drier. The operating parameters for the tape drie and deice drier can be set and changed by the configuration procedures. The installation defaults are proided for all parameters initially. The AIX smit command can be used to set these parameters when configuring a deice or to change these parameters. The AIX chde command can also be used to change the configuration parameters. The configuration parameters are used to set the operating mode of the tape drie and deice drier when a deice is opened. These parameters can be queried by an application. Some parameters can be changed temporarily during the open subroutine by an application, but they are always restored to the configuration alues when a deice is closed. The configuration parameters are: Autoloading Block size Compression Logging Maximum size of the log file Record space mode Rewind immediate Trailer labels Autoloading This parameter enables the autoloading feature of the deice drier. It can be used when one IBM 3580 Ultrium Tape Drie is installed in an IBM 3581 Ultrium Tape Autoloader or an IBM 3583 Ultrium Scalable Tape Library. This feature allows multiolume backups (with commands such as tar) without prompting for a olume change. Note: The autoloading feature is not supported on the IBM 3584 UltraScalable Tape Library and the IBM 3583 Ultrium Scalable Tape Library with more than one IBM 3580 Ultrium Tape Drie installed. Do not enable autoloading if one of the following conditions is true: The deice is used by an application that proides library medium changer support for the IBM 3581 or IBM The application is MKSYSB. The tapes being read were not written using the autoloading feature. If the parameter is set to On, the tapes in the attached medium changer slots act as one large irtual tape. During a read, write, or forward space file operation, no end of tape is detected by the application. When the end of tape is reached, the deice Copyright IBM Corp. 2000,

34 AIX Deice Drier (Atape) drier automatically rewinds and unloads the tape, moes the tape back into the library, loads the next tape from the library, then continues reading or writing the next tape. The following conditions are required to use autoloading: The autoloading parameter must be set to On. The library must be loaded with one or more tapes. The library mode must be set to Random mode. The installation default is Off (no autoloading). Block Size This parameter specifies the block size used for read and write operations. A alue of 0 is the ariable block size. Any other alue is a fixed block size. The installation default is 0 (use ariable length). Compression Hardware compression is implemented in the deice hardware. This parameter turns the compression feature On and Off. If compression is enabled, the effectie performance can increase based on the compressibility of the data. The installation default is On (use compression). Logging This parameter turns the olume information logging On and Off. If logging is set to On, the statistical information about the deice and media is saed in a log file when a tape is unloaded. If logging is set to Off, the information is not saed. This parameter has no effect on error logging because error logging is always enabled. For more information, see Chapter 12, Deice and Volume Information Logging, on page 53. The installation default is Off (no logging). Maximum Size of the Log File This parameter specifies the number of entries made before the log file starts to wrap. Each entry is approximately 2 KB (2048 bytes). After the log file starts to wrap, the number of entries remains constant. Each time a new entry is made, the oldest entry is oerlaid. For more information, see Chapter 12, Deice and Volume Information Logging, on page 53. The installation default is 500. Record Space Mode This parameter specifies how the deice drier operates when a forward or backward space record operation encounters a filemark. The two modes of operation are SCSI and AIX. The SCSI mode is the default mode of operation. When a forward or backward space record operation is issued to the drier and a filemark is encountered, the deice drier returns -1 and the errno ariable is set to input/output error (EIO). 14 IBM Ultrium Tape Deice Driers: Installation and User s Guide

35 AIX Deice Drier (Atape) Media Parameter The tape is left-positioned after the filemark (the end-of-tape side of the filemark on the forward space and the beginning-of-tape side of the filemark on the backward space). The AIX mode returns the same EIO errno alue as the SCSI mode when a filemark is encountered, except that the tape is left-positioned before the filemark (the beginning-of-tape side of the filemark on the forward space and the end-of-tape side of the filemark on the backward space). The installation default is SCSI mode. Rewind Immediate This parameter turns the immediate bit On and Off in rewind commands. If it is set to On, the rewind tape operation executes faster, but the next command takes a long time to finish unless the rewind operation is physically complete. Setting this parameter reduces the amount of time that it takes to close a deice for a Rewind on Close special file. The installation default is Off (no rewind immediate). Trailer Labels If this parameter is set to On, writing a record past the early warning mark on the tape is allowed. The first write operation to detect end of mark (EOM) fails and the errno ariable is set to ENOSPC. No data is written during the operation. All subsequent write operations are allowed to continue until the physical end of the olume is reached and EIO is returned. This parameter can also be selected using one of three deice special files that allow trailer label processing. The special files are rmtx.40, rmtx.41, and rmtx.60, where x is the name of the deice (for example, rmt0.40). The installation default is Off (no trailer labels). The media parameter can be queried and set by the tapeutil application using the Query/Set Parameters option on the menu. This parameter cannot be set or changed by the configuration procedures. The media parameter is: Volume ID for logging This parameter is the olume ID of the currently loaded tape. It is used in the log file entry (if olume logging is actie) to identify the entry with a particular olume. The deice drier sets the olume ID to UNKNOWN initially and when the tape is unloaded. Chapter 3. Tape Drie, Media, and Deice Drier Parameters 15

36 16 IBM Ultrium Tape Deice Driers: Installation and User s Guide

37 Chapter 4. Installation and Configuration Instructions Installation Procedure The recommended procedure for installing and configuring the deice drier is to use the installation script proided on the Open Systems Deice Drier CD. Howeer, before this is done, you need to physically attach the deice to the serer. Consult the appropriate manuals for instructions on physically attaching the tape deice to the serer. Instructions for uninstalling the deice drier are outlined below in Uninstallation Procedure on page 20. Attention: At the end of the installation procedure, the installp facility will automatically run the AIX bosboot command to update the boot record with the newly installed Atape files. When the bosboot command completes, the following messages will be displayed: This update will not fully take effect until after a system reboot. installp: bosboot process completed. This message is referring to the updates to the boot record only. If the installation summary shows that the Atape drier was installed successfully, it is not necessary to reboot the machine at this time. If the installation summary shows that the install failed, you should reboot the machine and attempt to install the Atape drier a second time. For information on obtaining the latest ersion of deice driers and the latest documentation, see Appendix A, Accessing Documentation and Software Online, on page 245. Preinstallation Considerations Before proceeding with the installation, make sure of the following items: 1. The tape deice is properly functioning, properly attached to the serer, and is powered up. 2. You hae logged onto the serer on an account which has root authority. 3. You hae a command shell window open on the serer to perform the installation procedure. 4. Make sure the current path is defined in the command shell PATH ariable. This can be accomplished in the korn shell using the following command: EXPORT PATH=.:$PATH 5. If the tape deice was configured preiously by another deice drier (not Atape), remoe any existing deice definitions for it. For example, rmde -l rmt1 -d. Copyright IBM Corp. 2000,

38 AIX Deice Drier (Atape) Installation Procedure Enter the following command to list the currently installed Atape.drier ersion: lslpp -l Atape.drier If you hae the IBM Ultrium Deice Driers CD, use the following instructions to install and configure the deice drier: 1. For an installed Atape deice drier, deconfigure all existing tape deices that use the Atape drier by following the instructions shown in Deconfiguring Tape Deices on page 19 or Deconfiguring Medium Changer Deices on page Place the CD into the CD-ROM drie on your AIX system. 3. Mount the CD oer an empty directory. For example, if your CD-ROM drie is defined at /de/cd0 and you hae an empty directory at /cdrom, issue the following command to mount the CD: mount -fr cdrfs /de/cd0 /cdrom You can create an empty directory using the mkdir command, for example: mkdir /cdrom Subsequent instructions assume that you mounted the CD at mount point /cdrom. 4. Enter the following command: cd /cdrom/aix 5. Consult the Atape.Readme file on the CD for any important information pertaining to the deice drier. Information in this file takes precedence oer information in the manual. 6. Execute the install_atape script. This script uninstalls any preious ersions of Atape, installs and commits the latest ersion of Atape, then runs cfgmgr to define your deices. 7. Enter the following commands: cd / unmount /cdrom 8. Remoe the CD from the CD-ROM drie and store it in a safe place. If you hae the Atape deice drier on a diskette, use the following instructions to install and configure the deice drier: 1. For an installed Atape deice drier, deconfigure all defined deices by following the instructions in Deconfiguring Tape Deices on page 19 or Deconfiguring Medium Changer Deices on page 20 and uninstall the Atape drier. Uninstall the Atape drier by following the instructions shown in Uninstallation Procedure on page Place the diskette into the diskette drie on your AIX system. The following steps assume that your diskette drie is defined as /de/rfd0. 3. Enter the following command: installp -acxd /de/rfd0 Atape.drier This installs and commits the Atape drier on your system. 4. Remoe the diskette from the diskette drie and store it in a safe place. 5. Follow the instructions in Configuring Tape and Medium Changer Deices on page IBM Ultrium Tape Deice Driers: Installation and User s Guide

39 AIX Deice Drier (Atape) Configuring Tape and Medium Changer Deices After the drier software is installed and a tape deice is connected to the adapter, the deice can be configured and made aailable for use. Access to the deice is not proided until the deice is configured. Note: If the tape deice was configured preiously by another SCSI deice drier, such as OST (Other SCSI Tape), issue the following command to remoe the deice definition before performing the following steps: rmde -l [deice] Configure a tape deice using one of the following procedures: Enter the following command with no parameters: cfgmgr The command configures all deices automatically (including any new tape or medium changer deices). or Power Off your subsystem and reboot the system to configure it automatically and make aailable any new tape or medium changer deices on the system. Deconfiguring Tape Deices In the following examples, replace the letter n with the appropriate number for the chosen deice. Deconfigure the tape deice using one of the following procedures: The first method leaes the tape deice defined in the configuration database. It is similar to bringing the deice Offline (not in use). Enter the following command to bring the /de/rmtn tape deice Offline but leae it defined in the deice database: rmde -l rmtn or The second method brings the tape deice Offline and remoes its definition from the deice database. Enter the following command: rmde -l rmtn -d The deice drier is not unloaded from the kernel until the last deice is deconfigured. Chapter 4. Installation and Configuration Instructions 19