Summary of the content on the page No. 1
HP Ultrium tape drives
Technical reference manual
Generation 3 drives
Volume 5—Unix configuration guide
Part number: Q1538–90925 Volume 5
Edition 6.1, December 2004
Summary of the content on the page No. 2
Legal and notice information © Copyright 2004—Hewlett-Packard Development Company, L.P. The information contained in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or direct, indirect, special, incidental or consequential damages in connection
Summary of the content on the page No. 3
Contents The purpose of this manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Related documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Documents specific to HP Ultrium drives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Documentation map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 4
7 Verifying the Installation Verifying the Installation of the Drive (UNIX). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 To verify the installation:. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Example: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35 I
Summary of the content on the page No. 5
The purpose of this manual This is one of six volumes that document HP Ultrium drives. This volume provides background information for driver and application developers. The following products are covered. Capacities are when the drive is using data compression with a compression ratio of 2:1, where applicable: HP Ultrium Generation 3 Full-Height SCSI Internal Drive HP Ultrium Generation 3 Full-Height FC Internal Drive NOTE: Throughout this manual frequent reference is made to SCSI comma
Summary of the content on the page No. 6
Drives—general SCSI Drives FC Drives Connectors 1 HW Integration: ch. 7 1 HW Integration: ch. 4 Controller architecture 6 Background: ch. 4 Front Panel LEDs 1 HW Integration: ch. 6 1 HW Integration: ch. 3 Mechanism and hardware 6 Background: ch. 3 Specifications 4 Specs Installation and configuration SCSI Drives FC Drives Connectors 1 HW Integration: ch. 7 1 HW Integration: ch. 4 Determining the configuration 2 SW Integration: ch. 2 2 SW Integration: ch. 2 External drives (SCSI only) 1 HW Integ
Summary of the content on the page No. 7
SCSI Drives FC Drives Features 6 HW Integration: ch. 5 Managing the use of cartridges 2 SW Integration: ch. 1 Use of cartridges 2 SW Integration: ch. 3 Interface SCSI Drives FC Drives SCSI Guide 3 SCSI Commands 3 SCSI: ch. 4 Error codes 1 HW Integration: ch. 10 1 HW Integration: ch. 6 Implementation 3 SCSI: ch. 1 Interpreting sense data 2 SW Integration: ch. 3 Messages 3 SCSI: ch. 2 Mode pages 3 SCSI: ch. 4 —see the MODE SENSE command Pre-execution checks 3 SCSI: ch. 3 Responding to Sense Keys a
Summary of the content on the page No. 8
SCSI Drives FC Drives Handling errors 2 SW Integration: ch. 5 How error correction works 6 Background: ch. 4 Logs—see the LOG SENSE command 3 SCSI: ch. 4 Recovering from write and read errors 2 SW Integration: ch. 7 Software response to error correction 2 SW Integration: ch. 3 Software response to logs 2 SW Integration: ch. 3 TapeAlert log 2 SW Integration: ch. 7 Ultrium features SCSI Drives FC Drives Adaptive Tape Speed (ATS) 6 Background: ch. 1 Autoload 1 HW Integration: ch. 2 Automation Contr
Summary of the content on the page No. 9
Copies of General Documents can be obtained from: ANSI 11 West 42nd Street New York, NY 10036-8002 USA ISO CP 56 CH-1211 Geneva 20 Switzerland ECMA 114 Rue du Rhône Tel: +41 22 849 6000 CH-1204 Geneva Web URL: http://www.ecma.ch Switzerland Global Engineering Documents 2805 McGaw Tel: 800 854 7179 or 714 261 1455 Irvine, CA 92714 USA Related documents 9
Summary of the content on the page No. 10
10
Summary of the content on the page No. 11
1Introduction The Purpose of this Manual This manual provides basic information on configuring the drives with various operating systems. Please see the top-level release notes that accompany the drive for expected functionality and features. Ultrium drives are supported on the following platforms: HP UNIX systems (HP-UX) (Chapter 2) HP Alpha UNIX (Chapter 3) IBM (AIX) (Chapter 4) Linux (Chapter 5) Sun Systems, Solaris 8, 9, 10 (Chapter 6) For platforms not mentioned here, please con
Summary of the content on the page No. 12
described in this manual. For further information about optimizing performance and making full use of the drive’s functions, please contact the software manufacturer or HP HP-UX AIX Sun, Solaris Linux 1 HP Omniback yes yes yes yes Legato Networker yes yes yes yes 2 Veritas NetBackup yes yes yes yes 1. Cell Manager is only available on HP-UX or Windows 2. Redhat Server only (not Caldera, Suse, and so on) 12 Introduction
Summary of the content on the page No. 13
2HP-UX Systems HP Servers and Workstations—HP-UX 11.x NOTE: HP-UX 10.x is only supported by Generation 1 Ultrium drives. Introduction Before you install your tape drive log on to the HP web site, www.hp.com, and download the latest hardware enablement patch bundle for your operating system. This ensures that you will have the correct device driver for your tape drive. Determining the SCSI ID Before you configure your system to support your new HP Ultrium drive, you need to determine what SCS
Summary of the content on the page No. 14
For an HP Ultrium drive, execute the following: % /sbin/ioscan -f | grep "Ultrium" The new lines should look similar to the following, where the 4 in the I field represents the instance of the SCSI tape driver, not the SCSI ID: tape 4 2/0/1.5.0 stape CLAIMED DEVICE HP Ultrium 3-SCSI NOTE: If you are installing the drive onto a Storage Area Network (SAN), the fibre channel/ SCSI bridge will also appear in the list of attached devices. If you cannot find the Ultrium drive,
Summary of the content on the page No. 15
1. % sam This will bring up the graphical user interface for the utility. 2. Select the following: Peripheral Devices Tape Drives sam will then scan the system for any tape drives connected. When an HP Ultrium Generation 3 drive is found, it will be displayed as: Hardware Path Driver Description =========================================================== 8/0/2/0.3.0 stape HP Ultrium 3-SCSI 3. Highlight the Ultrium drive and select the following from the tool ba
Summary of the content on the page No. 16
To create device files using mksf: NOTE: This method is not recommended. 1. Run insf as follows: % /sbin/insf -C tape 2. Create the device files for the devices using the mksf command as follows: % /sbin/mksf -d stape -I [-n] [-u] /dev/rmt/X where: Argument Description -d stape Specifies the SCSI tape driver -I Specifies the tape drive’s hardware address via the instance of the SCSI tape driver. The first instance is 0, the second 1, and so on. [-n] Specifies no rewi
Summary of the content on the page No. 17
A hardware address specified by instance 5 (-I 5) No rewind (-n) Berkeley mode tape positioning on close (-u) A filename of 4mnb, where 4 is the tape device identifier (/dev/rmt/4mnb) You would execute the following: % /sbin/mksf -d stape -I 4 -n -u /dev/rmt/4mnb You can check that the appropriate device file was created using the lssf command as follows: % /sbin/lssf /dev/rmt/4mnb This should produce the following output to show that the device file now exists: stape card instance 0 SC
Summary of the content on the page No. 18
18 HP-UX Systems
Summary of the content on the page No. 19
3 HP Alpha UNIX HP Alpha UNIX 5.x x x x 1. Add the following entry to your /dev/ddr.dbase file: SCSIDEVICE Type = tape Name = “HP” “Ultrium” # PARAMETERS: TypeSubClass = lto # Linear Tape Open BlockSize = 262144 TagQueueDepth = 0 MaxTransferSize = 0xffffff # 16Mb - 1 ReadyTimeSeconds = 120 # Seconds SyncTransfers = enabled WideTransfers = enabled InquiryLength = 0x20 DENSITY: DensityNumber = 0,1,2,3,4,5,6
Summary of the content on the page No. 20
Data.UBYTE[0] = 0x3D # Vendor Unique Page Code 3D Data.UBYTE[1] = 0x02 Data.UBYTE[2] = 0x01 Data.UBYTE[3] = 0x00 2. Rebuild the kernel by running /sbin/ddr_config, then reboot the system with the tape drive attached. The device files for the Ultrium drive will be generated in /dev/tape and / dev/ntape when you reboot. 3. The names of the device files can be interpreted as follows: Devices in the /dev/ntape directory are “no-rewind” devices. Those in /dev/tape wil
