Patch-ID# 123861-01 NOTE: *********************************************************************** READ THE TERMS OF THE AGREEMENT ("AGREEMENT") IN THE LEGAL_LICENSE.TXT FILE CAREFULLY BEFORE USING THIS SOFTWARE. BY USING THE SOFTWARE, YOU AGREE TO THE TERMS OF THIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE TERMS, PROMPTLY DESTROY THE UNUSED SOFTWARE. *********************************************************************** Keywords: lto-3, lto3, hp, c2, c4, tape drive, firmware Synopsis: Hardware, LTO-3 Tape Drive, Firmware Download Program, G56Z Date: Aug/01/2006 Install Requirements: Additional instructions may be listed below Solaris Release: SunOS Release: Unbundled Product: StorEdge HP LTO-3 Unbundled Release: N/A Xref: Topic: Relevant Architectures: BugId's fixed with this patch: 6382526 Changes incorporated in this version: 6382526 Patches accumulated and obsoleted by this patch: Patches which conflict with this patch: Patches required with this patch: Obsoleted by: Files included with this patch: G56Z.E README.123861-01 tload Problem Description: SCSI RELATED ISSUES: This code introduces an improvement in handling of Reset events in Primary Port firmware. Previously, all reset events were being treated as target resets. This would result in a Logical Unit Reset to any LUN resetting all LUNs rather than just the LUN it was intended for. This behaviour has always been present in previous code revisions and has never caused any customer issues. Since the HP LTO3 drive now is supported in a (multi LUN) ADI bridging environment, this could potentially become an issue, hence the introduction in this latest code revision. READ/SPACE ISSUES: Code introduces improvements in repositioning timing. The improvements are made for cases where drives drop out of streaming mode and have a reposition time before recommencing streaming. Those timing improvements will enhance the performance & efficiency of the drive. Spacing retries are managed with a down-counter. In very rare occasions and under specific conditions, this down-counter could be double-decremented. This code introduces a fix which ensures that this down-counter will only be decremented once for each spacing retry. Root Cause: AUTOMATION ISSUES: In previous code revisions, following a Host Initiated Unload (HIU) which was partial (the unload command ended with the cartridge in the seated position), the HIU bit in the Very High Frequency (VHF) data parameter of the ADC DT Device Status log page, would not be set. This could be observed by users that have access to the VHF data parameter in the ADC DT Device status log page (only ADI users tend to use these pages). The firmware has been changed so that the HIU bit is set if the unload command completes with the cartridge in the seated position. In the absence of a NOTIFY DATA TRANSFER DEVICE from the automation controller, to inform the drive that it is in the NOT READY state, the drive presumed the automation controller was ready. The HP ADI Integration Guide instructs the automation controller to send a NOTIFY DATA TRANSFER DEVICE, with the NRSC bit set, before enabling the primary interface if it is NOT READY. Unfortunately Quantum do not send the NOTIFY DATA TRANSFER DEVICE command until after the primary interface is enabled. This means from the time the primary interface is enabled to the time the drive receives the NOTIFY DATA TRANSFER DEVICE, with the NRSC bit set, the local SMC device server reports the remote SMC device server is ready when in fact it isn't. The local SMC device server has now been changed to presume the library is NOT READY when the SMC LUN and SMC cache are enabled for the Quantum variant only. In previous code versions, in ADI-Bridging (ADI-B) environments, if a fast host sent a SCSI command that wasn't queued when the Bridging Manager had an 'Operation In Progress', the Bridging Manager wasn't clearing the 'Operation In Progress' state until after it had received notification from the hardware that the SCSI Status had been sent to the host on the primary interface. Unfortunately this notification took a couple of milliseconds to process, which is long enough for the local SMC device server to receive a new command and respond with 'Operation In Progress', before the Bridging Manager can clear the 'Operation In Progress'. In this code version, the Bridging Manager has been modified to clear the 'Operation In Progress' state prior to sending SCSI Status and hence avoid this problem. Corrective Action: Patch Installation Instructions: ------------------------------- None. Special Install Instructions: ---------------------------- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Contents -------- A.0 Firmware File Names, Utility Descriptions, and Changes B.0 Precautionary Statements C.0 Patch Installation and Utility Usage Intructions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ A.0 Firmware File Names & Utility Descriptions ----------------------------------------------- A.1 G56Z.E --> The firmware image (853,168 bytes) A.2 tload --> The firmware download utility (57,444 bytes) A.3 README.123861-01 --> This file ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ A.4 Release Notes for revision changes from G36Z to G56Z ------------------------------------------------------ Last Release Revision: G36Z See Problem Description above. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ B.0 Precautionary Statements ----------------------------- **WARNING:****WARNING:****WARNING:****WARNING:****WARNING:****WARNING:** B.1 The system MUST BE IDLE during the firmware download process! No other programs should be running while this utility is being used. Failure to do so may cause the devices being upgraded to fail or the system to crash. Any other computers sharing the same I/O bus as the host system must be either disconnected or offline. B.2 If any upgrade failures occur, do not continue upgrading devices. For example, loss of power during download will result in damaged peripherals and require replacement. If any failures occur, please collect the following log file: "/var/adm/messages", and an explorer dump. Please forward these files to your service provider for analysis. B.3 This package will only function on HP LTO-3 SCSI Tape Drives which were shipped/used in Sun StorEdge C2 tape autoloader and C4 tape library. B.4 Please READ instructions below completely BEFORE starting download procedure. Follow the procedures carefully. You may program multiple drives at the same time, however, you may not exit the utility until all drives have completed the download process. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ C.0 Patch Installation and Utility Usage Intructions ----------------------------------------------------- C.1 General guidelines for upgrading: EJECT MEDIA FROM DEVICE TO BE UPGRADED. Download utility will eject media from the device if it is found to be loaded. Do NOT attempt to force media back into the drive. Media present in a device having firmware downloaded to the device may result in data loss from media or damage to device. STOP ALL APPLICATIONS. The system must be idle during the firmware upgrade process. DISCONNECT or take OFFLINE any other computers sharing the same I/O bus as the host. UPGRADE the tape device. Follow the given instructions in the procedure section below. In case of any disruption or unforeseen events happening on the relevant bus during the firmware download process, it may be that the upgraded device becomes non-functional. In this event, it will be necessary to replace the device. This would happen as a result of an incomplete or corrupted firmware file being downloaded. Loss of power during the upgrade process would also damage the device. **NOTE** If you cannot upgrade devices due to software application interference, try booting off of the Solaris release CD. **NOTE** After the firmware download is completed, it may be necessary to power cycle the device to ensure fully resetting the device. In turn, this may also require a successive reboot of the host system to ensure all functionality is restored. C.2 Procedure for Tape Firmware Download: The procedure to be used for upgrading the device's firmware is explained below. Upgrade time will be approximately 3-5 minutes for each device. You must have root/super-user privileges in order to perform this operation. a). Unpack the patch (through tar) into any directory, e.g. /var/spool/patch (Note, if the patch ends in a ".Z" suffix, you will need to first uncompress it.) Example: # uncompress # tar xvf b). In the patch directory, as root, type the "tload" command: # ./tload c). Select the tape device to be upgraded (see example below). **NOTE** This upgrade can result in error messages in the console window and/or the terminal "tload" window. It is normal for a SCSI bus reset message to appear in the console window for each device that is upgraded. d). Ensure that the device to be upgraded is the correct one and answer the question: Do you want to download firmware to this tape device [N]? with a 'y' for yes or anything else for no. Default answer is no. e). After each device has been upgraded, the displayed tape device list will be refreshed. Device(s) upgraded should reflect having the new code level in the "Rev" field (see example below). f). If there is an additional device to be upgraded (same device type and desire to upgrade to the latest firmware), select that device as previously done in C.2.c). & C.2.d). above. Continue in this fashion until all desired devices have been upgraded. g). Quit the "tload" program by typing '0' (see example below). ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ C.3 EXAMPLE # ######################################### # # Launch Tape Firmware Download Utility # ######################################### # # ./tload G56Z.E ATTACHED DEVICES: Device Supplier Product Rev Serial Number Device State -------------- -------- ---------------- ---- ------------- ------------- 1:2ln HP Ultrium 3-SCSI G36Z HU1050577M Available 2:c4t6d1 QUANTUM UHDL 000C 5CH30039 Available Select Device(s) (ex: 1,3-4) or 0 to quit) [1]: 1 2ln HP Ultrium 3-SCSI G36Z HU1050577M Selected Do you want to download firmware to this device [N]? y ATTACHED DEVICES: Device Supplier Product Rev Serial Number Device State -------------- -------- ---------------- ---- ------------- ------------- 1:2ln HP Ultrium 3-SCSI G36Z HU1050577M Downloading 2:c4t6d1 QUANTUM UHDL 000C 5CH30039 Available Downloading /dev/rmt/2ln... please wait. ATTACHED DEVICES: Device Supplier Product Rev Serial Number Device State -------------- -------- ---------------- ---- ------------- ------------- 1:2ln HP Ultrium 3-SCSI G36Z HU1050577M Writing Flash 2:c4t6d1 QUANTUM UHDL 000C 5CH30039 Available Select Device(s) (ex: 1,3-4) or 0 to quit) [2]: 0 One or more devices has not yet completed flash update and/or download recovery time. Devices must not be utilized until after this recovery period has expired, or permanent damage may result. This program will release all devices and terminate in 0 seconds... ATTACHED DEVICES: Device Supplier Product Rev Serial Number Device State -------------- -------- ---------------- ---- ------------- ------------- 1:2ln HP Ultrium 3-SCSI G56Z HU1050577M F/W Upgraded 2:c4t6d1 QUANTUM UHDL 000C 5CH30039 Available # # ######################################### # # The example above only upgrades one # device. You do not have to exit with # a "0" and initiate the 'tload' utility # again. You may continue instead and # directly upgrade the next tape device, # following the same steps as before # for each device until all devices # have been upgraded # ######################################### # # ######################################### # # After devices are upgraded, the Rev # will be G56Z # ######################################### # # ######################################### # # To Quit, enter '0'. System prompt # will return. # ######################################### # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ C.4 tload (ABOUT THE UTILITY): tload - Firmware Download utility for tape devices. SYNOPSIS tload [ filename ] [ -v ] filename firmware/microcode filename -v verbose output, aid for tload issue debug DESCRIPTION tload is an firmware download utility for Sun supported tape devices. If the firmware_file is specified, then it will display the list of tape devices present on the host system and asks the user to select the tape device which is to be upgraded. If the firmware_file is not specified, then it will display the list of tape devices present on the host system along with their FIRMWARE revision levels. tload will exit upon completion; please do not attempt to halt or stop prior to utility's menu exit option being presented. The command can be run only as a super-user. DISCLAIMER This utility is ONLY supported for downloading, to Sun supported tape devices, the Sun supported firmware binary (firmware_file) which has officially been released via the official Sun Patch Process. This utility is only supported with the release of firmware (binary) bundled with said patch. Do not attempt to use any other version of 'tload' that may have been acquired previously else device damage may occur. Use only the version provided with this patch. Use of tload to load non-Sun supported tape devices is at the user's own risk, and is not supported. Use of tload to load Sun supported tape devices with firmware NOT bundled with the utility in an officially released Sun Patch is at the user's own risk, and is not supported. PROBLEMS Any problems regarding this utility by the user following proper procedures should be reported to the user's service provider along with the following items: 1) /var/adm/messages file 2) explorer dump 3) tload -v (verbose output) README -- Last modified date: Tuesday, August 1, 2006