Patch-ID# 113056-06 Keywords: pit iiadm iiboot bitmaps offline, master, shadow Synopsis: Availability Suite 3.1 II: Patch Date: Nov/05/2003 Install Requirements: Install in Single User Mode Reboot after installation Solaris Release: 2.6 7 8 9 SunOS Release: 5.6 5.7 5.8 5.9 Unbundled Product: Sun StorEdge Availability Suite Unbundled Release: 3.1 Xref: Topic: Relevant Architectures: sparc NOTE: The Availability Suite products contain common core components. The patch id for these core components are: 113054 It is highly recommended that these patches be installed in addition to any Availability Suite product patches. *** NOTE *** Please read the following carefully as it contains important information regarding the operational procedure to follow when one or more volumes associated with an II set are in the offline state. Note: That the following procedure has NOT changed from documented procedures covered in the Instant Image Configuration and/or Administration manuals. It is that as a result of applying this patch, an offline line condition that was not propagated across system shutdown or SunCluster switchover, has been corrected. To recover the II sets, that have bitmaps which are OFFLINE, the II set needs to be RESET using the following commands. iiadm -R The purpose of this patch is to propagate II volume set status, when its bitmap volume is offline, across system reboot or SunCluster switchover. Scenario #1 ============ Standalone system ------------------ The disk that contains the bitmap volume for an II set becomes inaccessible prior to the reboot of the system. The disk then becomes accessible before or during the rebooting of the system. Scenario #2 =========== SunCluster configuration ------------------------ The disk that contains the bitmap volume for an II set becomes inaccessible prior to the disk group failover, whether induced by the issuing of an scswitch command or a reboot. The disk then becomes accessible before or during the rebooting of the system, or the Suncluster scswitch processing. *** NOTE *** To provide the highest level of data availability, it is high recommended to place the bitmap volume (and other II associated volumes) on redundant storage, RAID-1 for example. - Data Services patch 113054-06 needs to be installed prior to the installation of this patch to ensure functionality. It is also required to always shutdown and reboot the system using the /etc/shutdown command. EX: To reboot: /etc/shutdown -y -g0 -i6 This is necessary because all the appropriate shutdown scripts need to run. If they do not run, (as is the case when a simple reboot is issued), the patch fixes may be bypassed and there would still be the possibility of data corruption. If a volume manager is in use, additional steps to recover the disks and volumes may be necessary. BugId's fixed with this patch: 4437084 4438291 4487382 4507340 4587468 4670807 4679363 4682325 4683290 4699588 4700366 4714962 4725371 4738864 4747183 4747704 4747983 4764358 4768017 4771129 4775537 4812715 4815509 4827583 4830588 4859669 Changes incorporated in this version: 4859669 Patches accumulated and obsoleted by this patch: Patches which conflict with this patch: Patches required with this patch: 113054-06 or greater Obsoleted by: Files included with this patch: /usr/kernel/drv/ii /usr/kernel/drv/ii-5.6 /usr/kernel/drv/sparcv9/ii /usr/opt/SUNWesm/SUNWii/bin/iiadm /usr/opt/SUNWesm/SUNWii/bin/iiboot /usr/opt/SUNWesm/SUNWii/man/man1ii/iiadm.1m Problem Description: 4859669 Disabling II master which is also SNDR primary intermittently breaks replication (from 113056-05) 4812715 iiboot -h incorrectly returns exit status of 1 when it succeeds 4815509 II 3.1 puts both master and shadow offline if shadow volume fails 4827583 ii error creating set - volume not found 4830588 ii allows block device for bitmap volume (from 113056-04) 4437084 The values from overflow volume status can be easily corrupted. 4764358 ii: panic on boot 4771129 ii local sets displayed inconsistently in cluster 4775537 iiboot needs to updated with code review results (from 113056-03) 4768017 iiboot segmentation fault - core dumping 4747983 attempts to write to compact dep shadow consistently panics cluster node 4747704 Reading from shadow of a compact dependent set causes panic if bmp is offline 4747183 panic writing to bitmap of compact dependent set if bitmap volume is offline 4738864 Incorrect iiadm error message for local volumes in disk group on a SunCluster 4587468 iiadm show bitmap 106% full (from 113056-02) 4725371 ii kstats panic after used overflow freed 4714962 DSWIOC_SEGMENT ioctl incorrectly returns DSW_EMISMATCH 4699588 II 3.0.1 Offline/Online of bitmap volume can cause data corruption (from 113056-01) 4700366 iiboot does not handle failed fork() calls properly 4683290 Some overflow i/o kstats are being recorded as shadow i/o 4682325 iiadm brief help text still lists -o, -r, and -s options 4679363 iiadm -P logs copy parameters incorrectly to ds.log 4670807 Session hangs while disabling cache of C-Dependent volume with Overflow volumes 4507340 iiadm man pages should list the value ranges for the iiadm -P command 4487382 iiadm man page does not specify return value / exit status 4438291 iiadm -i reports a negative value for the percent of bitmap set Patch Installation Instructions: -------------------------------- For Solaris 7-8 releases, refer to the man pages for instructions on using 'patchadd' and 'patchrm' scripts provided with Solaris. Any other special or non-generic installation instructions should be described below as special instructions. The following example installs a patch to a standalone machine: example# patchadd /var/spool/patch/104945-02 The following example removes a patch from a standalone system: example# patchrm 104945-02 For additional examples please see the appropriate man pages. Special Install Instructions: ----------------------------- Since this patch updates modules that live in the kernel, it is necessary for the user to boot the system up in single user mode to apply the patch and then reboot the system. README -- Last modified date: Wednesday, November 5, 2003