Patch-ID# 111947-08 Keywords: sunwii ii iiadm Synopsis: Data Services 3.0 II: unit test panic/bitmap writing/kernel heap Patch Date: Feb/12/2003 Install Requirements: Install in Single User Mode Reboot after installation Solaris Release: 2.6 7 8 SunOS Release: 5.6 5.7 5.8 Unbundled Product: StorEdge Instant Image Unbundled Release: 3.0 Xref: Topic: Relevant Architectures: sparc NOTE: The Data Services products contain common core components. The patch ids for these core components are: 111945 111946 It is highly recommended that these patches be installed in addition to any Data Services 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 111945-07 (SUNWscm) 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: 4441357 4451657 4455995 4457774 4459424 4459432 4459512 4463257 4463277 4469068 4469517 4470618 4488013 4498645 4498813 4499798 4509393 4514889 4526271 4587468 4617198 4625263 4638021 4644793 4649071 4684806 4699588 4732913 4738864 4768017 4771129 Changes incorporated in this version: 4617198 4771129 Patches accumulated and obsoleted by this patch: Patches which conflict with this patch: Patches required with this patch: Obsoleted by: Files included with this patch: /usr/kernel/drv/ii /usr/kernel/drv/ii-5.6 /usr/kernel/drv/iidev /usr/kernel/drv/iidev-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: 4617198 enabling invalid raw slice bitmap volume produces un-helpful error 4771129 ii local sets displayed inconsistently in cluster (from 111947-07) 4768017 iiboot segmentation fault - core dumping 4738864 Incorrect iiadm error message for local volumes in disk group on a SunCluster 4732913 Cluster device group failover fails if "unregistered" cluster tag used in II set 4587468 iiadm show bitmap 106% full (from 111947-06) 4699588 II 3.0.1 Offline/Online of bitmap volume can cause data corruption (from 111947-05) 4684806 II dependent set goes offline when performing IO to shadow volume 4649071 Panic in nsc_free_buf() when doing II join 4526271 man pages for iiadm has errors 4638021 iiadm man pages missing -h option and explanation (from 111947-04) 4644793 II 3.0.28 Shadow Volumes placed OFFLINE during iiadm -J processsing 4469517 Syntax for II import (-I) and join (-J) incorrect in usage and man pages (from 111947-03) 4625263 spcs_s_ocopyoutf causing panic: kernel heap corruption detected 4499798 System panics while running II portition of sndr unit tests NoBugID Minor optimization to II bitmap writing (from 111947-02) 4514889 Incorrectly configured II short shadow can be written to the configuration file 4509393 enabling a master volume as a shadow in another ii pair corrupts dscfg 4498813 Panic occurs when reading and then writing data to a device (inconsistent) 4498645 system panics after data is read and immediately after written to a master 4488013 Local II shadow overflow volume can be attached to an II cluster controlled pair 4457774 II does not check if volume is in use before trying to enable it 4455995 enabling an existing pair that is in a group will remove it from its group. (from 111947-01) 4470618 misuse of iiadm -s all can lead to data corruption when master volume is mounted 4469068 iiadm -r after copy & suspend does not return shell prompt until copy completed 4463277 Status of ii sets on all nodes should be consistent. 4463257 switchover of a device group does not return until copy of master to shadow 100% 4459512 iiadm -e does not return propt w/sndr volume used as master until sndr is comple 4459432 iiadm -i reports an incorrect value for the percent of bitmap set 4459424 Enabling large, dependent II pairs does not return shell prompt until completed. 4451657 3.0 -fwcadm cache -d results in a hang if volumes used in II pairs are under FWC 4441357 Master volume can be updated by more than one volume in multi-shadow environment Patch Installation Instructions: -------------------------------- For Solaris 2.0 - 2.6 releases, refer to the Install.info file and/or the README within the patch for instructions on using the generic 'installpatch' and 'backoutpatch' scripts provided with each patch. 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: Monday, April 12, 2004