HP LTO 4 FC Providing pass-through mode, Requirements for drivers and logical device managers

Page 90

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 one and discard the old cartridge.

The ‘Clean’ LED is cleared by a cleaning cycle.

Providing pass-through mode

It is important for Drivers and Logical Device Managers to provide a pass-throughmode that can return information or commands specific to a vendor’s product. The need for this is two-fold:

Systems must support a great variety of new devices.

All tape drives are similar to a degree; Drivers and Logical Device Managers tend to provide connectivity based on the assumption that 80% of all SCSI tape drives behave identically.

Pass-through mode offers the following advantages:

Peripheral manufacturer can provide value-added diagnostics and support applications over and above those that may be shipped with a system or application.

System supervisors and operators can take advantage of specific product features otherwise excluded because the driver or manager only caters for 80% of SCSI drives.

Technical support people have access to low-level device-specific information likely to be unavailable otherwise.

Requirements for drivers and logical device managers

Drivers and Logical Device Managers must allow the user to do the following:

1.Create either a 6-byte, 10-byte, 12-byte or 16-byte SCSI Command Descriptor Block.

2.Allocate a write buffer or file for any data associated with the SCSI command that will be sent to the drive.

or

Allocate a read buffer or file for any data associated with the SCSI command that will be returned by the drive.

3.Link the command and data buffers.

4.Launch the command.

5.The driver should use its standard CHECK CONDITION and REQUEST SENSE routines to report whether the command completed successfully or not. The caller must have access to the raw

REQUEST SENSE data.

6.View any returned data.

90 Exception handling

HP restricted

Image 90
Contents HP LTO Ultrium tape drives technical reference manual volume 2 software integrationLTO 4 FC, SCSI and SAS drives HP restrictedLegal and notice information 2 Configuration and initialization Contents1 Designing backup applications 3 Use of tapes5 Supporting Ultrium features 4 Factors affecting performance6 Sense keys and codes 7 Exception handlingHP restricted Documents specific to HP Ultrium drives Related documentsDocumentation map Drives-generalCartridges Installation and configurationOperation InterfaceMaintenance and troubleshooting Dealing with errorsLTO Ultrium features General documents and standardizationOptimizing performance 1 Designing backup applicationsNon-immediate commands Large data transfer sizeInformation in Cartridge Memory Cleaning tape headsManaging the use of tapes Monitoring tape useTapeAlert Design goals for LTO backup applicationsDiagnostic logs Displaying drive informationInclude the capability to download firmware 2 Configuration and initialization Inquiry string recoveryOperating system drivers Example 16 Configuration and initializationSCSI protocol, regardless of transport or interface type Support for additional LUN Enabling additional LUN supportSupporting additional LUNs 18 Configuration and initialization 3 Use of tapes Using Cartridge Memory attributesUsing MODE SENSE LTO cartridge memoryTape status and capacity Finding the remaining capacityInterpreting Log Sense data Using the SET CAPACITY command Command descriptor blockCDB fields How WORM media works Changes to SCSI commandsWORM media New additional sense codes and TapeAlert flagsSET CAPACITY command Error Usage pageERASE commands rejected Re-writing media labelsUsing CM to check tape integrity Behavior with a missing or inconsistent EOD valueUnique media identifier Responding to Cartridge Memory data Load countBarcode support RWW retry counts Corrective actionDetecting the drive’s speed 4 Factors affecting performanceWays of optimizing performance Ensuring the recommended minimum transfer sizesTime-out values Using Cartridge Memory instead of tape headersUsing the Performance Log page for diagnosing problems Media type identificationRecommended support of log pages Factors affecting performanceHost-related factors where possible or a reasonably sized RAID system. More disks means ExampleRecommendation makes sense to split heavily used FC cards across separate PCI bussesDrive-related factors Do not interleave write commands with other commands, such as READFormat-related factors Page 34 Factors affecting performance Automation interface 5 Supporting Ultrium featuresCartridge Memory LTO-CM Further informationAutomation/Device Interface ADI Automation Control Interface ACI Modes of usage through ACISlave to a library controller ACI command set ACI commands that affect drive streaming performanceSCSI pass-through mode New features in ACI Backward compatibilitySCSI command Encryption support Recommended ACI time-out values Further detailsSupporting the ACI protocol 42 Supporting Ultrium featuresRecommended power-up sequence Treatment of reserved fieldsRecommended load-unload configuration ACI protocol communications retry Firmware upgrade via tapeRecommended Get Drive Status polling frequency Upgrading the drive firmwareLibrary firmware upgrade via tape Firmware upgrade via the primary host interfaceFirmware upgrade via ACI Handling irregular cartridgesNon-HP Ultrium 1 cleaning cartridge Cleaning cartridge HP-configured or UniversalExpired cleaning cartridge HP-configured or Universal Unreadable data cartridgeCartridge fails to seat or load Valid firmware upgrade cartridgeData cartridge with unreadable CM Cartridge cannot be loadedInvalid firmware upgrade cartridge Frequently asked questionsCleaning Is there separate firmware for drives intended to go into libraries?Resetting via the ACI Reset command Backup softwareResetting drives Resetting using the ACIRSTL lineOther mode page information Accessing Cartridge Memory without threading the tapeControlling data compression Buffer size at EW-EOMPartition size Rewind on resetWrite delay time 52 Supporting Ultrium featuresAction 6 Sense keys and codesSense keys-actions to take Console Messagelog the error, terminate I/O to the drive, and pass the appropriate “3h-MEDIUM ERROR” on page 62 . Also see the Media AccessFor additional sense codes, see “3h-MEDIUM ERROR” on error to the calling applicationAction ActionConsole Message Console MessageConsole Message End-of-Tape Additional sense codes-actions to takePhysical reached, unable to fit0h-NO SENSE 1h-RECOVERED ERROR 2h-NOT READYThe command cannot be executed because the specified The software must issue a LOAD before media accessLUN not accessible, port in 60 Sense keys and codesmechanism tests are being executed. When the tests are 3h-MEDIUM ERROR A READ , SPACE , WRITE or WRITE FILEMARKS command62 Sense keys and codes Send a console message that an unrecovered error on and the drive. Based on this, ask the user to clean the64 Sense keys and codes Send a message to the console indicating that there is The current command such as READ, SPACE, REWIND 66 Sense keys and codes4h-HW ERROR 5h-ILLEGAL REQUEST A MODE SELECT parameter list sent to the drive contains68 Sense keys and codes allowed to execute. In other words, some commands can 6h-UNIT ATTENTIONpersistent reservation using the PERSISTENT RESERVE OUT 32 initiators to register, using PERSISTENT RESERVE OUTAction WRITE BUFFER or MAINTENANCE OUT command service action removed all reservations and the persistentA PERSISTENT RESERVE OUT command was executed A SET DEVICE IDENTIFIER command has been successful7h-DATA PROTECTION Action 8h-BLANK CHECK Bh-ABORTED COMMAND READ BUFFER commandrelated to a missing EOD data set. The most likely cause Dh-VOLUME OVERFLOW A WRITE or WRITE FILEMARKS command has encountered76 Sense keys and codes 3. Allow the user to try recovery Typical escalation procedure1. Retrieve fault information 4. Allow the user to reset devicesMonitoring the condition of the drive and media Supporting TapeAlertFlags TypePage Page Page Page Page Page Page Designing software to use the TapeAlert log TapeAlert modelsReading the TapeAlert log TapeAlert polling usage modelTapeAlert informational exception usage model One-Button Disaster Recovery OBDR Responding to the ‘Clean’ LEDSupporting OBDR Providing pass-through mode Requirements for drivers and logical device managersGlossary see ”read-while-write” Index Page Page HP restricted