Patch-ID# 106817-02
Keywords: ST39173W 9GB disk firmware
Synopsis: Hardware 9GB Disks: Download program and ST39173W 2815 firmware
Date: Apr/05/00

Solaris Release: 2.5.1 2.6 7

SunOS Release: 5.5.1 5.6 5.7

Unbundled Product: Hardware/Disk

Unbundled Release: Seagate ST39173W 9GB disks

Relevant Architectures: sparc

BugId's fixed with this patch: 4328053 4175983

Changes incorporated in this version: 4328053 4175983

Patches accumulated and obsoleted by this patch:

Patches which conflict with this patch: 

Patches required with this patch: 
	NOTE: Solaris 2.6     105580-08 or higher  (for Ultra-30/60)


Obsoleted by: 

Files included with this patch: README, download, download32, download64,
                                .download, and ST39173.2815.fw

Problem Description: 

[ 106817-02 upgrades rev. 7063 drive firmware ]
Enables SMART error reporting.
Fixes LED activity light signaling.


[ 106817-01 upgrades rev. 5084 drive firmware ]
Fixes ISP timeouts and subsequent register dump with Raid RM6 software
and Seagate ST39173 disks.  This is caused by the disk incorrectly
asserting the SCSI I/O control line if the lun address is invalid.



**************************************************************************
**************************************************************************
**WARNING:****WARNING:****WARNING:****WARNING:****WARNING:****WARNING:**

1. The system MUST BE IDLE during the download process!  No other
   programs should be running while using this utility is being
   used.  Failure to do so may cause the devices being upgraded
   to fail or the system to crash.
 
   Volume managers such as Veritas, SDS, Arraymon, and Vold must
   be idle and any disks unconfigured.  Note, due to an open/close
   accounting bug (see bug 4129295) in sd and ssd drivers, you must
   reboot the system after unconfiguring any disks used by them.
   Note, Arraymon will be disabled during downloadd startup and
   enabled on exit.  The accounting bug prevents the upgrade utility
   from acquiring sole ownnership of the disk so it will not be
   eligible for upgrade.

   Any other computers sharing the same I/O bus as the host system
   must be either disconnected or offline.

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 files:
   "./download.log" or "/var/tmp/download.log", "/var/adm/messages",
   and an explorer dump.  Please forward these files to your service
   provider for analysis. 
 
3. This package will only upgrade the identified Sun disks.

4. If the High Availability kernel device polling is running, it will
   be disabled.  It will not be re-enabled.

5. If using Veritas, "deport" the volume to release the volume from
   Veritas control.  Do not "remove" the volume as this will erase
   the data stored on the Volume.

6. If you have reconfigured A1000/3000 SCSI systems, the /dev
   directories may become corrupted.  Download will detect this problem
   and ask for permission to repair the problem.  If not repaired,
   affected devices will not be eligable for upgrade.

7. If you have dual-active A1000/3000 controllers and one of the 
   controllers has no luns, they will not be eligable for upgrade.
   This is because an access path is only provided if a controller
   has luns.  Without an access path, the controller cannot be accessed
   and both controllers are required for upgrade operations.

8. Follow the instructions given below.  You may program one drive,
   a range of drives, or all drives at once with this tool.



************************************************************************** 
**************************************************************************


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

1. General guidelines for upgrading: 

	BACK UP ALL FILESYSTEMS.

        STOP ALL APPLICATIONS. The system must be idle during the
        firmware upgrade process.

	UNMOUNT all file systems on the drives to be upgrade.
        Disks with mounted file systems are not eligible for
        upgrade.

	UNCONFIGURE devices from volume manager.

	REBOOT THE SYSTEM if you unconfigured any disks from
	volume manager (e.g. Veritas).  Otherwise, you will
	not be able to upgrade any previously configured disks.

	UPGRADE the disks.  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 disk becomes non-functional.  In this event,
        it will be necessary to swap out the disk. 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 disk.

**NOTE**    If you cannot upgrade devices due to volume manager
            interference,  try booting of the Solaris 2.7 or 2.6
            release CD.
 
**NOTE**    If a system disk is to be upgraded, the upgrade utility will
            allow it to be upgraded if the system is in single-user mode
            (e.g. "boot -s").  Otherwise, the system disk will not be
            eligible for upgrade.

	RECONFIGURE devices to volume manager.

**NOTE**    As Download disables kernel high availability device polling,
            it may be necessary to reboot the system to restart it.



2. Procedure: 

The procedure to be used for upgrading the drive firmware is
explained below. Upgrade time will be approximately 2 minutes
for the system.

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:
	% su root
	# cd <patchdir>
	# tar xf <patch tar file>
 
b) In the patch directory, as root, type the "download" command:
	# ./download

c). Select the devices to be upgraded (see example below).

**NOTE**    Any device that is in-use by another application will not
            be upgraded.  The following warning message will be
            issued:   c1t3d0s0: Open failed, you must be the sole user!

**NOTE**    This upgrade can result in error messages in the console 
            window and/or the terminal "download" window.  It is
            normal for the FC-AL link to go offline for a few
            seconds and then return to the online state.  The disk
            mode pages will also be restored to the default values.

d). After the devices have been upgraded, the displayed device
    list will be refreshed.  Devices remaining to be upgraded or
    failed devices will be displayed.  Failed devices will be
    marked with a "****" in the rev field.

**NOTE**    If all devices have been upgraded, the following
            message will be displayed:   No devices found to upgrade!

e). To display the full list of devices including the upgrades ones,
    type 'inquiry' (see example below).

**NOTE**    Only the first two digits of the firmware version number
            will change.  The last two digits will not change.
            So, a disk with 0410 firmware would report revision
            1078 for example.

f). Quit the "download" program by typing 'quit' (see example below).



************************************************************************** 
**************************************************************************
EXAMPLES: 

# ./download
Firmware Download Utility, V3.35
 
**************************  WARNING  **************************
NO OTHER ACTIVITY IS ALLOWED DURING FIRMWARE UPGRADE!!!
No other programs including any volume manager (e.g. Veritas,
SDS, or Vold) should be running.  Other host systems sharing
any I/O bus with this host must either be offline or
disconnected.  Any interruption (e.g. power loss) during
upgrade can result in damage to devices being upgraded.

Any disk to be upgraded should first have it's data backed up.
***************************************************************

Searching for devices...

DISK DEVICES:
Device           Rev   Product                        
c1t8d0:          5084  SEAGATE  ST39173W -- SUN9.0G 
c1t9d0:          7063  SEAGATE  ST39173W -- SUN9.0G 
c1t10d0-c1t13d0: 5084  SEAGATE  ST39173W -- SUN9.0G 
c2t1d0-c2t2d0:   5084  SEAGATE  ST39173W -- SUN9.0G 
c2t3d0:          5084  SEAGATE  ST39173W -- SUN9.0G 
c2t4d0:          5084  SEAGATE  ST39173W -- SUN9.0G 
c2t5d0:          5084  SEAGATE  ST39173W -- SUN9.0G 
Total:  11



#
#########################################
#
# Single disk upgrade example:
#
#########################################
#
Enter command: c1t8d0
Upgrading disks...
 

c1t8d0: Successful download
c1: recovery delay, 31 sec.

DISK DEVICES:
Device           Rev   Product                        
c1t9d0:          7063  SEAGATE  ST39173W -- SUN9.0G 
c1t10d0-c1t13d0: 5084  SEAGATE  ST39173W -- SUN9.0G 
c2t1d0-c2t2d0:   5084  SEAGATE  ST39173W -- SUN9.0G 
c2t3d0:          5084  SEAGATE  ST39173W -- SUN9.0G 
c2t4d0:          5084  SEAGATE  ST39173W -- SUN9.0G 
c2t5d0:          5084  SEAGATE  ST39173W -- SUN9.0G 
Total Devices:  10



#
#########################################
#
# Single controller upgrade example:
#
#########################################
#
Enter command: c1
Upgrading disks...

c1t8d0: Successful download
c1t12d0: Successful download
c1t10d0: Successful download
c1t13d0: Successful download
c1t11d0: Successful download
c1t9d0: Successful download
c1: recovery delay, 35 sec.
  c1t11d0:  Page 28(0x1c) defaulted


DISK DEVICES:
Device           Rev   Product                        
c2t1d0-c2t2d0:   5084  SEAGATE  ST39173W -- SUN9.0G 
c2t3d0:          5084  SEAGATE  ST39173W -- SUN9.0G 
c2t4d0:          5084  SEAGATE  ST39173W -- SUN9.0G 
c2t5d0:          5084  SEAGATE  ST39173W -- SUN9.0G 
Total Devices:  5



#
#########################################
#
# Entire system upgrade example:
#
#########################################
#
Enter command: program
Upgrading disks...

c1t12d0: Successful download
c1t10d0: Successful download
c2t6d0: Successful download
c1t13d0: Successful download
c2t3d0: Successful download
c1t11d0: Successful download
c2t1d0: Successful download
c2t5d0: Successful download
c2t2d0: Successful download
c1t9d0: Successful download
c1t8d0: Successful download
c1: recovery delay, 31 sec.
c2t4d0: Successful download
c2: recovery delay, 30 sec.
  c2t1d0:  Page 28(0x1c) defaulted
  c2t2d0:  Page 28(0x1c) defaulted
  c1t11d0:  Page 28(0x1c) defaulted

DISK DEVICES:
No devices found to upgrade!



#
#########################################
#
# To view upgraded drives after upgrade:
#
#########################################
#
Enter command: inquiry

DISK DEVICES:
Device   Rev   Product                         S/N
c1t8d0:  2815  SEAGATE  ST39173W -- SUN9.0G,   007064 
c1t9d0:  2815  SEAGATE  ST39173W -- SUN9.0G,   007414 
c1t10d0: 2815  SEAGATE  ST39173W -- SUN9.0G,   359604 
c1t11d0: 2815  SEAGATE  ST39173W -- SUN9.0G,   005657 
c1t12d0: 2815  SEAGATE  ST39173W -- SUN9.0G,   359196 
c1t13d0: 2815  SEAGATE  ST39173W -- SUN9.0G,   000944 
c2t1d0:  2815  SEAGATE  ST39173W -- SUN9.0G,   005159 
c2t2d0:  2815  SEAGATE  ST39173W -- SUN9.0G,   005527 
c2t3d0:  2815  SEAGATE  ST39173W -- SUN9.0G,   359211 
c2t4d0:  2815  SEAGATE  ST39173W -- SUN9.0G,   026039 
c2t5d0:  2815  SEAGATE  ST39173W -- SUN9.0G,   359496 
c2t6d0:  2815  SEAGATE  ST39173W -- SUN9.0G,   378201 
Total Devices:  13



#
#########################################
#
# To exit:
#
#########################################
#
Enter command: quit


