Patch-ID# 112094-01
Keywords: DDS-4, 4mm, Tape Drive, Firmware
Synopsis: Hardware, DDS-4 4mm Tape Drive, Firmware Download Program C005
Date: Nov/01/2001

Solaris Release: 

SunOS Release: 

Unbundled Product: DDS Series DDS-4

Unbundled Release: HP DDS-4 4mm Tape Drive C5683A
NOTE: HP DDS-4 4mm Tape Drive C5683A

Xref: 

Topic: 

Relevant Architectures: 

BugId's fixed with this patch: 

Changes incorporated in this version: 

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: 

C005.fw
tload_3.2

Problem Description:

This firmware release is intended to allow Sun to maintain synchronicity
with the supplier partner of this device, HP.  There are some changes to
the code which are anticipated to make an insignificant improvement in AFR
and reliability.  However, there are no bugs or escalations specifically 
addressed with this revision change.
 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Contents
--------    
A.0  Firmware File Names & Utility Descriptions
B.O  Precautionary Statements
C.O  Patch Installation and Utility Usage Intructions
 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
A.0  Firmware File Names & Utility Descriptions
-----------------------------------------------
 A.1 C005.fw		--> This file contains the binary C005 firmware for
			    the DDS4 tape drive (338,944 bytes)
 A.2 tload_3.2		--> The firmware download utility (47,012 bytes)
 A.3 README.112094-01	--> This file (11,973 bytes)
 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
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 C5683A DDS-4 Tape Drives.
 
B.4 Please READ instructions below completely BEFORE starting download 
    procedure.  Follow the procedures carefully.  You may ONLY program 
    ONE drive at a time.
 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
C.O  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, say <patchdir>.
    (Note, if the patch ends in a ".Z" suffix, you will need to first
    uncompress it.)  So, you would type:
        # cd <patchdir>
        # tar xf <patch tar file>
 
b). In the patch directory, as root, type the "tload_3.2" command:
        # ./tload_3.2 C005.fw
 
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_3.2" 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, "C005", 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_3.2" program by typing '-1' (see example below).
 
**************************************************************************
 
C.3  EXAMPLE
 
#
#########################################
#
# Launch Tape Firmware Download Utility:
#
#########################################
#
# ./tload_2.3 C005.fw
 
 
AVAILABLE SCSI TAPE DEVICES:
 
                Supplier        Product                 Rev     Serial Number
 
0:/dev/rmt/0ln  ARCHIVE         Python 03551-XXX        1.85      62~??y
1:/dev/rmt/1ln  HP              C5683A                  C911      62~??y
2:/dev/rmt/2ln  HP              C5683A                  C911      62~??y
 
Select Tape Device (-1 to quit) [0 - 1]: 1
 
/dev/rmt/1ln    HP              C5683A                  C911      62~??y
 
Do you want to download firmware to this tape device [N]? y 
#
#########################################
#
# System will appear to pause for 3-5
# minutes here.  Do not worry.  Do not
# attempt to abort else device damage
# may occur.  Loss of of power or
# disconnecting data cable during this
# part of the download will definitely
# damage the device being upgraded.
#
#########################################
#
 
#
#########################################
# 
# The following message will appear, the
# device's LED's should come on, and
# both LED's should blink very quickly.
# The device will then reset and, audibly
# the drum will spin up.  LED's will then
# go off.
#
#########################################
#
 
Download Successful; Allowing 45 second recovery time...
 
Press <Enter> to Continue
 
#
#########################################
#
# After pressing <Enter>, the available
# tape devices menu reappears.
#
#########################################
#
 
AVAILABLE SCSI TAPE DEVICES:
 
                Supplier        Product                 Rev     Serial Number
 
0:/dev/rmt/0ln  ARCHIVE         Python 03551-XXX        1.85      62~??y
1:/dev/rmt/1ln  HP              C5683A                  C005      62~??y
2:/dev/rmt/2ln  HP              C5683A                  C911      62~??y
 
 
Select Tape Device (-1 to quit) [0 - 1]: 2
 
#
#########################################
#
# Upgrade the next tape device, so we
# select '2' which still has the old C911
# firmware (we have assured ourselves
# that the upgraded is indeed upgraded
# as the 'Rev' field is now C005).
#
#########################################
#
 
#
#########################################
#
# Following the same steps as before...
#
#########################################
#
 
/dev/rmt/2ln    HP              C5683A                  C911      62~??y
 
Do you want to download firmware to this tape device [N]? y
Download Successful; Allowing 45 second recovery time...
 
Press <Enter> to Continue
 
 
AVAILABLE SCSI TAPE DEVICES:
 
                Supplier        Product                 Rev     Serial Number
 
0:/dev/rmt/0ln  ARCHIVE         Python 03551-XXX        1.85      62~??y
1:/dev/rmt/1ln  HP              C5683A                  C005      62~??y
2:/dev/rmt/2ln  HP              C5683A                  C005      62~??y
 
 
Select Tape Device (-1 to quit) [0 - 1]:
 
#
#########################################
#
# Both tape devices should be upgraded
# and indeed they are as the Rev is now
# reported as C005 for both of them.
#
#########################################
#
 
#
#########################################
#
# To Quit, enter '-1'.  System prompt
# will return.
#
#########################################
#
 
Select Tape Device (-1 to quit) [0 - 1]: -1
#
 
************************************************************************** 
**************************************************************************
C.4  tload_2.3 (ABOUT THE UTILITY):
 
 
   tload_2.3 - Firmware Download utility for tape drives.
 
SYNOPSIS
 
   tload_2.3 [ firmware_file ]
 
DESCRIPTION
 
   tload_2.3 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. Only One Tape 
   Device may be upgraded at a time.
 
   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.
 
   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) it is bundled with in 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, version 2.3 (tload_2.3).
 
   Use of tload_2.3 to load non-Sun supported tape devices is at
   the user's own risk, and is not supported.
 
   Use of tload_2.3 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

Patch Installation Instructions:
----------------------------

None.

Special Install Instructions:
----------------------------------------------------

None.

README -- Last modified date:  Thursday, November 1, 2001

