InfoServer Document patches/103766

, bytes]
OBSOLETE Patch-ID# 103766-02
Keywords: SPARCstorage Array SUNWssaop SUNWssadv
Synopsis: OBSOLETED by 104708
Date: Aug/29/96

When to apply:  this patch should be applied to Solaris 2.5.1 machines
		that have SPARCstorage Arrays attached.

Solaris Release: 2.5.1

SunOS Release: 5.5.1

Unbundled Product: 

Unbundled Release: 

Relevant Architectures: sparc

BugId's fixed with this patch: 1220596 1241003 1223884 1190977 1238425 1248015
                               1234710 1223140 1189853 1208892 1246302 1243658
                               1247175 1242298 1257125 1263860

Changes incorporated in this version: 1220596 1241003 1223884 1190977 1238425
                                      1248015 1234710 1223140 1189853 1208892
                                      1246302 1243658 1247175 1242298 1257125
                                      1263860

Patches accumulated and obsoleted by this patch:

Patches which conflict with this patch: 

Patches required with this patch: 

Obsoleted by: 104708 on Feb/23/99

Files included with this patch: 

SUNWssadv:
        /kernel/drv/pln
        /kernel/drv/ssd
        /kernel/drv/soc

SUNWssaop:
        /usr/lib/firmware/ssa/ssafirmware  (Version 3.9)
	/usr/sbin/ssaadm
	/usr/sbin/ssacli

Problem Description: 

*******************************************************************
*******************************************************************
IMPORTANT NOTICE: The ssafirmware must be downloaded into the SSA
after installing this patch. See the "Special Install Instructions:".
*******************************************************************
*******************************************************************

1263860 SSA: performance degradation with 3.8 firmware.
1257125 Patch 103766-01: download 3.7 f/w to SSA causes FW option get lost.
1220596 SSA200 needs to support RSM 8th non-disk target ES card
1241003 offline/online looping problem with 3.5 firmware
1223884 SSA resets itself when a tray is pulled under heavy load
1190977 When a disk tray is removed, the led does not note it
1238425 Pulling out a tray causes SSA to lose all disk reservations
on tray
1248015 pln driver does not report scsi errors back to the target drivers corre
ctly.
1234710 ssd/pln: attach/detach problems.
1223140 pln: pln_private() function does not return errors correctly.
1189853 pln_attach can crash system on transport error.
1208892 ssa/pln drivers display grabled messages on console.
1246302 sd,ssd: sd_uselabel() function needs to return error if disk label is b
ad.
1243658 sd/ssd drivers need to handle command timeout and abort correctly.
1247175 Bad 2.1 drive reset  entire SSA in H/A config thus all metadevices were
 hot spared.
1242298 soc: Remove segalign restriction from default_soclim.


Patch Installation Instructions: 
-------------------------------- 
Refer to the Install.info file for instructions on using the
generic 'installpatch' and 'backoutpatch' scripts provided with
each patch.  Any other special or non-generic installation
instructions should be described below as special instructions.

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

After installing the patch, here is how one goes about
upgrading the firmware:
 
1.  Enter the following command to see what the firmware level is
    for each SPARCstorage Array on your system:

# /usr/sbin/ssaadm display controller

        where controller is either the logical controller name
        (given as cX) or the physical path of the controller
        (given as
        /devices/../../SUNW,soc@3,0/SUNW,plnaxxxxxx,xxxxxxxx:ctlr).
        For more information, see the ssaadm.1m man page.

2.  Look at the output for a line similar to the following to find
    the firmware level:

Firmware Rev: 3.6

3.  Determine if you need to upgrade the firmware.
        If the firmware level produced from the ssaadm command (Step
        2) is lower than 3.9 then you must upgrade your firmware.  Go to Step
4.

        If the firmware level produced from the ssaadm command (Step
        2) is the 3.9 or higher then you do not have to read any
	further in these instructions, since your firmware is
	already at the proper level.

4.  If the firmware level produced from the ssaadm command is lower
    than 2.4 you MUST complete the following steps for those SPARCstorage
    Arrays that contain firmware revision lower than 2.4. If the
    firmware is 2.4 or higher you don't need to do step 4 so go to step 5.
  
a) Enable the SSA fastwrite capability:
#       /usr/sbin/ssaadm fast_write -se <controller>

b) Disable the SSA fastwrite capability:
#       /usr/sbin/ssaadm fast_write -sd <controller>

        where controller is either the logical controller name
        (given as cX) or the physical path of the controller
        (given as
        /devices/../../SUNW,soc@3,0/SUNW,plnaxxxxxx,xxxxxxxx:ctlr).

CAUTION: This operation may take a few minutes to complete.  Do NOT
        interrupt the operation before it is finished or the system
        may not be able to communicate with the SPARCstorage Array.

5. Download the SPARCstorage Array firmware to your SPARCstorage Array.
   If the host is booted off a SSA, the host MUST be rebooted for this
   operation. If the host is being rebooted only the steps 'e' and 'f' below
   need to be executed.
 
   The following steps must be completed on each SSA to download the firmware
   safely:

a) Stop all I/O activity on the SPARCstorage Array.

b) Perform a sync_data to the SSA:
#       /usr/sbin/ssaadm sync_cache  <controller> 

c) Unmount any filesystems residing on the SSA disks.

d) Stop all Veritas Volume manager (VxVA) volumes and/or Solistice Disk Suite
   (SDS) metadevices (if any) running on the SSA. Also insure that ownership
   of any SDS diskset metadevices have been released since an implicit I/O
   stream exists while ownership of a diskset is maintained. Please refer
   to the metaset(1M) manpage for details on taking/releasing ownership
   of disksets.

e) Execute the ssaadm download command to download the new firmware:
#/usr/sbin/ssaadm download -f /usr/lib/firmware/ssa/ssafirmware
<controller> 
        where controller is either the logical controller name
        (given as cX) or the physical path of the controller
        (given as
        /devices/../../SUNW,soc@3,0/SUNW,plnaxxxxxx,xxxxxxxx:ctlr).
 
CAUTION: This operation may take a few minutes to complete.  Do NOT
        interrupt the operation before it is finished or the system
        may not be able to communicate with the SPARCstorage Array.
 
f) The SSA(s) will now need to be reset for the changes to take effect. If the
   host is booted off an SSA then the host MUST be shutdown at this point.
 
   Reset your SSA(s) by pushing the SYS OK button in the back of the unit(s).
   This causes the SPARCstorage Array to reboot using the new revision
   of firmware.
 
   If your host boots off an SSA it can now be booted up again.
 
g) Restart the Veritas Volume manager (VxVA) and/or SDS metadevices and
   reclaim ownership of any SDS diskset metadevices that were relinquished.
 
h) Remount the filesystems that reside on the SSA disks.
 
6. The firmware download is now complete. I/O activity on the SPARCstorage
   Array can be restarted.