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 b) Disable the SSA fastwrite capability: # /usr/sbin/ssaadm fast_write -sd 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 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 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.