InfoServer Document patches/103351

, 2462994 bytes]
Patch-ID# 103351-02
Keywords: pln pln.conf soc ssafirmware SSA SUNWssaop SUNWssadv
Synopsis: SPARCstorage Array 1.0, 2.0, 2.1, 2.1.1: Jumbo patch for Solaris 2.3 
Date: May/15/96

Solaris Release: 2.3

SunOS Release: 5.3

Unbundled Product: SPARCstorage Array

Unbundled Release: 1.0, 2.0, 2.1, 2.1.1

Relevant Architectures: sparc

BugId's fixed with this patch: 1189610 1191184 1188369 1197175 1201147 1201916
                               1205374 1199867 1201909 1194007 1207531 1198022
                               1207426 1213545 1208492 1215956 1215898 1215177
                               1210487 1210459 1221633 1222772 1218134 1225980
                               1221891 1220077 1219355 1229005 1223482 1219952
                               1222661 1220380 1226481 1193331 1233881 1232080
                               1199767  1232506 1201365 1230526 1223384 1237625
                               1231771 1233108 1189480 1229048 1242923 1220754

Changes incorporated in this version:  1201147 1201916 1205374 1199867 1201909
                                       1194007 1207531 1198022 1207426 1213545
                                       1215177 1210487 1210459 1225980 1221891
                                       1220077 1219355 1229005 1223482 1219952
                                       1222661 1220380 1226481 1233881 1232080
                                       1199767  1232506 1201365 1230526 1223384
                                       1237625 1231771 1233108 1189480 1229048
                                       1242923 1220754

Patches accumulated and obsoleted by this patch: 102408-05, 102400-05,
                                                 102465-02

Patches which conflict with this patch: 

Patches required with this patch: 

Obsoleted by: 

Files included with this patch: 
kernel/drv/pln
kernel/drv/pln.conf
kernel/drv/soc
opt/SUNWssa/lib/3.6/ssafirmware
opt/SUNWssa/bin/ssacli 
opt/SUNWssa/bin/ssaadm
		
NOTE: opt/SUNWssa/lib/3.6/ssafirmware is Version 3.6

Problem Description:

This patch is applicable to Solaris 2.3 with unbundled SSA. 

*******************************************************************
*******************************************************************
IMPORTANT NOTICE::::
*******************************************************************
*******************************************************************

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

Problem Description:
 
1229048: pln: High load on 2 SSAs on a single SOCHA  leads to performance
degred
ation.
1220754: SSA Firmware: missing cmds when using suspend/resume.
1242923: Stale SDS data read out of NVRAM.
1223384: soc, soc_ucode.c: SSA  "Timeout recovery being invoked" 
OFFLINE/ONLINE.
1232080: pln_ctlr: pdb system paniced with a data fault.
1199767: pln_ctlr doesn't check for root when running a USCSI command.
1232506: ssaadm/ssacli display of a SSA210 module appears as a SSA100 module.
1201365: On dual-ported SSA, IO from one host can prevent access by other host.
1230526: SSA lcd icons go to sleep under certain circumstances.
1237625: pln soc: Add code for Cray Research suspend/resume functionality +
bug fixes.
1231771: ssaadm/ssacli: solaris 2.4, VM2.1, hotspare replace worked but error
messages continue.
1233108: soc login logic is faulty.
1189480: if sparc storage array present wants it to pause during boot til ssa
is ready.
1222661 ssaadm, ssd: display controllerNumber fails if other host has disk(s)
reserved
1220380 ssaadm does not report clearly whether or not NVRAM is enabled.
1226481 SSA: Need new ssaadm/ssacli for pluto 2 and fast_write capability.
1233881: SSA firmware 3.3 sometimes restarts during poweron sequence
1219952: SSA: 3.1 fw causes recursive condition on pluto 200
1220077: Heavy I/O causes pluto2 to panic
1219355: SSA: P200 needs to support 7 disk targets
1229005: SSA V3.x is needed for Pluto2 (aka SSA11x or SSA21x)
1225980: pln: there should be retries for both read/write in case of media/hw
error
1221891 pln: Set up and pass Task Attribute values based on tagged queuing
flags.
1223482 ssa firmware: ESC: data corrupt when doing many SYBASE inserts on SSA
1210487 pln enters invalid state after reset recovery.
1210459: pln enters reset recovery before link is taken offline.
1215177 Energizer found callback thread problem under Fault Injection testing.
1213545 SSA and ODS together hangs on a disk failure
1207426 ss2000 running 2.4 panics with soc_callback  and pln_cmd_callback
routines 
1198022 script to flush NVRAM on shutdown
1207531:SSA soc driver timeout, offlines SSA on PDB SERVER
1194007 soc: messages are displayed indicating timeouts and offline/online
of the fiber link
1201909 pln:  DKIOCGVTOC of slice opened O_NDELAY on OFFLINE SSA very slow
1199867 clustmon fibre channel connections don't connect to real pluto port
1205374 pln: pln enters "Timeout recovery being invoked..." loop after
tray is pulled
Cycling power on the SSA during NVRAM testing caused a watchdog reset.
1201916 pluto recursively panics on power cycle
1201147 pln: watchdog reset cycling power on SSA
 
In order to work with the newer host adapter FCode (1.33) we changed the
names in pln.conf to SUNW,pln and SUNW,soc. This caused pln to be 'init'ed
twice per SSA so we added a check in soc to return (DDI_FAILURE) for the
second init. We do this because there may be entries generated by both the
OBP-built device tree and from the .conf file. 


(from 102408-05/102400-05/102465-02)

1208492 disk drive in array offline hangs array and system hangs on reboot
1215956 Duplicate of 1208492
1215898 Disks do not spin up after a tray is pulled out and pushed
back in a SSA.
1218134 ssa F/W downgrade compatibility
1221633 ISP DMA failure transferring data during reads while testing with
the scsirw_test.
1222772 Downloading SSA FW and Resetting SSA has created some
malfunctioning controllers.

(from 102408-05 and 102400-05)

1189610 System gets a Watchdog Reset when SPARCstorage array is powered
off.
1188369 - Duplicate of 1189610
        pln: Watchdog Reset then accessing SSA with power-failure
1191184 pln: sytem hangs for 20 minutes when one mirrored storage array is
turne
d off
1193331 soc: pln.conf: meiko fix, multiple INITCHILD's
1197175 Incorrect depend & copyright files used on -01 & -02 patches.


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
    in your SPARCstorage Array:

# 	/opt/SUNWssa/bin/ssacli 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 ssacli.1m man page.

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

Firmware Rev: 3.4

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

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

4. Download the SPARCstorage Array firmware to your SPARCstorage Array. 
   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:
#	/opt/SUNWssa/bin/ssacli 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 ssacli download command to download the new firmware:
#/opt/SUNWssa/bin/ssacli  -s -f /opt/SUNWssa/lib/3.6/ssafirmware download
<contr
oller> 
        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) 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.

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.

5. The firmware download is now complete. I/O activity on the SPARCstorage
   Array can be restarted.