HP LTO 4 SCSI - Manual

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 9 HP restricted Maintenance and troubleshooting Dealing with errors Implementation 3 Host Interface: ch. 1 Interpreting sense data 2 SW Integration: ch. 3 Messages 3 Host Interface: ch. 2 Mode pages —see the MODE SENS...

10 HP restricted LTO Ultrium features General documents and standardization See http://www.t10.org/t10_main.htm for INCITS SCSI Primary Commands—3 (SPC-3), SCSI Streaming Commands (SSC-3) and other specificationsCopies of documents of other standards bodies can be obtained from: FC Drives SCSI Drive...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 11 HP restricted 1 Designing backup applications In today’s computer market, software applications that use tape drives to copy the information from a computer’s hard disk for safe keeping are readily available for ma...

Designing backup applications 12 HP restricted NOTE: Using immediate mode with other commands does not improve performance and can cause problems when writing a driver. The SCSI specification requires that if a command is issued with the IMMEDIATE bit set to 0, the drive must flush its data buffer b...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 13 HP restricted See “Tape Capacity Log Page” under the LOG SENSE command in Chapter 3 of The SCSI Interface, Volume 3 of the HP LTO Ultrium Technical Reference Manual for more information.While the reliability of tap...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 15 HP restricted 2 Configuration and initialization This section covers the following topics: • Operating System drivers • Inquiry string recovery, finding information about the drive through the INQUIRY command • Add...

Configuration and initialization 16 HP restricted Product ID, first 8 bytes Product ID, last 8 bytes Product Revision Level Example If new drive families or variants support features that are not available in previous generation products, you can detect the existence of these features through the SC...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 17 HP restricted Since LTO 4 drives cannot write to Ultrium-2 media, the WRTOK bit will be clear for this media type. Support for additional LUN Enabling additional LUN support When enabled by an internally-connected ...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 19 HP restricted 3 Use of tapes HP Ultrium user documentation and “Cartridges”, Chapter 9 of the Hardware Integration Guide , Volume 1 of the HP LTO Ultrium Technical Reference Manual, also contain information on cart...

Use of tapes 20 HP restricted Tape status and capacity Following autoload or a LOAD command, the software can determine the state of the tape and its capacity from the Cartridge Memory and the Tape Capacity Log pages retrieved through the LOG SENSE command. The information can also be invoked as a c...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 21 HP restricted Capacity calculations are based on estimates; reported values can be subject to error in two ways: • Random errors caused by tolerances in tape length, hub diameter, and so on. • Systematic errors cau...

Use of tapes 22 HP restricted The following table gives the minimum acceptable Capacity Proportion Values and the approximate capacity they will give: NOTE: Capacities are approximate and can be affected by defects that reduce the actual capacity of the tape. Other factors, such as compression and b...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 23 HP restricted TapeAlert flags: • 3Bh (WORM medium—integrity check failed) • 3Ch (WORM medium—overwrite attempted) Error Usage page For WORM cartridges, the Wrap Number fields in the Error Usage page are replaced by...

Use of tapes 24 HP restricted application to locate the tape in preparation for subsequent writing or reading operations. At the start of an appending archive or backup session, it is common for the application to locate the tape to a logical position immediately preceding the second filemark and to...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 25 HP restricted Barcode support Ultrium barcode support is required for WORM media so that the application and tape library can distinguish WORM media from normal RW media or cleaning cartridges.HP recommends the use...

Use of tapes 26 HP restricted RWW retry counts Data is read immediately after being written to tape to establish that it has been written correctly. Increases in RWW retries can be due to four factors: • Deterioration in the media • Dirty heads • Drive malfunction • The operating environment Correct...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 27 HP restricted 4 Factors affecting performance This chapter contains techniques and information to help you design software applications so that they use the tape drive’s potential as efficiently as possible. • Ways...

Factors affecting performance 28 HP restricted absolute block size, performance should not suffer, but do ensure that the transfer size is at least 256 KB . Maximum block size The READ BLOCK LIMITS command indicates that block sizes and variable length transfer sizes are supported for values between...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 29 HP restricted • All of these values may be subject to change. • There is no retension facility. Recommended support of log pages Some of the media-related data items on the log pages are duplicates of data that is ...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 31 HP restricted Drive-related factors Recommendation: • Try not to put Ethernet in the way of data transfer unless staging technology is being used; aggregation of multiple Ethernet clients remains a good strategy to...

Factors affecting performance 32 HP restricted Format-related factors Recommendation: A good transfer size to aim at is 256 KB (128 KB minimum). For an application that uses 512-byte records, each fixed-mode transfer should transfer 512 records. Higher transfer sizes are also recommended for higher ...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 35 HP restricted 5 Supporting Ultrium features This section covers the following features of HP Ultrium drives: • LTO Cartridge Memory page 35 • Automation and drive interface (ACI and ADI) page 35 • Cleaning page 50 ...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 37 HP restricted Automation Control Interface (ACI) The Automation Control Interface (ACI) protocol allows the activities of the drive to be coordinated within a library. The protocol has been designed so that it can ...

Supporting Ultrium features 38 HP restricted cartridge at the moment that the drive starts to pull it into the drive, if it is configured for that type of operation.This degree of control over synchronization cannot be achieved though the host’s backup software; it must be controlled directly by the...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 39 HP restricted • Send SCSI with the following opcodes: New features in ACI 4.3 The following sections describe the differences between revision 4.2 of the ACI specification, used in HP LTO Ultrium 3 drives, and revi...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 41 HP restricted When the drive has completed the second step of initialization, it will respond normally to all supported commands, and it will report the correct Manufacturing Date Code and Serial Number in the corr...

Supporting Ultrium features 42 HP restricted The Encryption Status bits indicate the current encryption/decryption status of the SSC device server: Further details For more information about ACI, see the ACI Specification supplied by HP. Supporting the ACI protocol Software vendors implementing supp...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 43 HP restricted Table 1 Non-queued ACI commands Table 2 Queued ACI commands Treatment of reserved fields To ensure forwards compatibility with future versions of the ACI, automation controller firmware should set any...

Supporting Ultrium features 44 HP restricted During the second step of the power-up sequence, the tape drive will respond with BUSY status to all ACI commands except Get Drive Info and Get Error Info. The amount of time taken by this second step will vary widely depending on three factors: • The pre...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 45 HP restricted HP recommends configuration of the upgrade protect features to enabled. (the Upgrade Protect bit of the Set Drive Configuration command is set to 1). This will ensure that if a firmware upgrade cartri...

Supporting Ultrium features 46 HP restricted process and that the normal power-up ACI command sequence is followed to ensure that the drive is configured correctly and to verify the firmware version and ACI version. Firmware upgrade via the primary host interface The library controller will not have...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 47 HP restricted Cleaning cartridge (HP-configured or Universal) When a valid cleaning cartridge (one that has not expired) is loaded, behavior depends on the Clean Protect bit of the Set Drive Configuration command. ...

Supporting Ultrium features 48 HP restricted Data cartridge with unreadable CM If the Cartridge Memory cannot be read, the drive assumes that the cartridge is not supported. If the cartridge is loaded into the drive, it will be placed at the ready-to-eject point with the Cartridge Present, Write Pro...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 49 HP restricted Invalid firmware upgrade cartridge If a firmware upgrade cartridge with an invalid firmware image is loaded, and neither the library controller nor the host knows that the cartridge is a firmware upgr...

Supporting Ultrium features 50 HP restricted Resetting drives The tape drive can be reset by the automation controller via the ACI Reset command or, in ACI mode, by pulling the ACI_RST_L line low (see “Rear Panel and Connectors”, Chapter 7 of the Hardware Integration Guide , Volume 1 of the HP LTO U...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 51 HP restricted Controlling data compression The data compression hardware in HP Ultrium drives can detect whether incoming data is already compressed and will not attempt to compress it again. The drive can switch d...

Supporting Ultrium features 52 HP restricted Write delay time The Write Delay Time field (bytes 6–7) on the Device Configuration mode page (10h) specifies the inactivity delay before the drive will automatically flush its data buffer. A value of 0 is an infinite delay; any other value is the delay i...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 53 HP restricted 6 Sense keys and codes Sense keys—actions to take Ultrium drives follow the ANSI definition of sense keys. The following table explains how the drives interpret sense key descriptions.As sense keys an...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 57 HP restricted Additional sense codes—actions to take These tables provide information about sense data, so that software can know which additional sense codes can be reported under which sense keys. It is important...

Sense keys and codes 58 HP restricted 0h—NO SENSE The following action applies to most additional sense codes in this group: Action: For all additional sense codes except 82 82h, the action of the software depends on the current I/O and what the operating system has been expecting. Recovery depends ...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 59 HP restricted 1h—RECOVERED ERROR NOTE: Reporting of recovered errors defaults to OFF. 2h—NOT READY Action: In all cases, action depends on the device class and operating system. Code Meaning Comments 37 00 Rounded ...

Sense keys and codes 62 HP restricted 3h—MEDIUM ERROR Code Meaning Comments 00 02 End of Tape detected A READ , SPACE , WRITE or WRITE FILEMARKS command found EOT unexpectedly. This typically occurs when a drive cannot locate the target object on tape because the block count is too great.The EOM fla...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 67 HP restricted 4h—HW ERROR The following actions apply to most additional sense codes for HW ERROR sense key: 53 00 Media load or eject failed A load or eject has failed. Action: 1. Terminate the current I/O and ret...

Sense keys and codes 68 HP restricted 5h—ILLEGAL REQUEST The following actions apply to all additional sense codes in this group: 53 01 Unload tape failure The tape unload failed because it cannot be physically completed at this point in time. Action: see above 82 83 Bad microcode detected The data ...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 69 HP restricted 6h—UNIT ATTENTION 26 04 Invalid release of persistent reservation The Persistent Reservation holder has tried to release the persistent reservation using the PERSISTENT RESERVE OUT command, but the Sc...

Sense keys and codes 72 HP restricted 7h—DATA PROTECTION Code Meaning Comments 26 10 Data decryption key fail limit reached A SECURITY PROTOCOL OUT command has failed because an incorrect key has been sent to the drive followed by a read, and this has happened ten times consecutively. Action: Furthe...

Sense keys and codes 74 HP restricted 8h—BLANK CHECK 74 03 Incorrect data encryption key The drive read into a block of data which could not be decrypted with the current decryption key. Action: 1. Send a SECURITY PROTOCOL IN with the page set to Next Block Encryption Status to obtain information ab...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 75 HP restricted Bh—ABORTED COMMAND The following action applies to all codes in this group: 14 03 End of Data not found A read-type operation failed because a format violation related to a missing EOD data set. The m...

Sense keys and codes 76 HP restricted Dh—VOLUME OVERFLOW NOTE: When the sense, additional sense and qualifying sense keys are listed, the software may look at all three keys to determine action. The drive should use that exact combination to report that particular error.For example, a drive will rep...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 77 HP restricted 7 Exception handling These pages cover methods of dealing with certain error conditions and exceptional circumstances. They include the following: • A suggested Escalation Procedure to follow when exc...

Exception handling 78 HP restricted 5. Parallel SCSI only: Allow the System Supervisor or support person to perform a controlled hard SCSI Bus Reset. If the LOGICAL UNIT RESET Task Management function fails to clear the problem, the System Supervisor or technical support person should be able to per...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 79 HP restricted Flags The following table lists the flags that could potentially be supported in tape drives. Of these, flags 3,4,5,6,20,22 and 31 are mandatory for drives such as Ultrium drives that support cleaning...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 87 HP restricted NOTE: Once cleared, a flag cannot be set again until the specified clearing conditions are met. So, for example, if the cartridge in the drive is not of data grade, once flag 8 has been cleared, it ca...

Exception handling 88 HP restricted In addition, the application can determine which TapeAlert flags are supported by the device server through the TapeAlert supported flags VPD page (B2h). TapeAlert polling usage model In this model, the application configures the device server by setting the TASER...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 89 HP restricted 5. Optionally, automate the recommended recovery actions if there are multiple tape drives or autoloaders present.For example, the application could perform a cleaning cycle in response to flags 20 (C...

Exception handling 90 HP restricted 1. Clean the heads and try the operation again. 2. If the ‘Clean’ LED is lit again, repeat the operation with another tape cartridge. If this clears the ‘Clean’ LED, it indicates that the original cartridge is at fault. Copy the data from the cartridge onto a new ...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 91 HP restricted Glossary ANSI American National Standards Institute, which sets standards for, amongst other things, SCSI and the safety of electrical devices. BOM Beginning Of Media. The first point on the tape that...

HP LTO Ultrium 4 drives technical reference manual, volume 2: software integration 93 HP restricted Index A ACI 17 , 35 , 37 cleaning 49 command set 38 commands that affect streaming 38 firmware upgrade 46 protocol communications retry 45 reserved fields 43 resetting drives 50 supporting 42 ACI 4.3,...