# CLUSTER_README

NAME: Solaris 8_x86 Sun Alert Patch Cluster
DATE: Dec 6,2006

########################################################################

This patch cluster is intended to provide a selected set of patches for
the designated Solaris release level.  This is a bundled set of patches
conveniently wrapped for one-step installation.  Only install this
cluster on the appropriate Solaris system.  Carefully read all important
notes and install instructions provided in this README file before
installing the cluster.  A cluster grouping does not necessarily imply
that additional compatibility testing has occurred since the individual
patches were released.

WARNING!! IT IS HIGHLY RECOMMENDED that the installation of this patch 
cluster be performed in single-user mode (Run Level S). 

########################################################################

CLUSTER DESCRIPTION
-------------------

This cluster contains the minimum set of Sun Alert patches that contribute
to the concerned Solaris Release. It also contains all the required dependency
patches, which may or may not be Sun Alert patches. These Sun Alert Solaris
patches are considered the most important and highly recommended patches that
avoid the most critical system, user, or security related bugs which have been
reported and fixed to date. In particular, Sun Alert patches are to resolve
issues regarding to Data Loss, Availability and Security.

This cluster is updated whenever there are new Sun Alert patches or any
updates to existing member patches. This cluster may contain obsoleted 
patches. 

For more information about corresponding Sun Alert notification, please 
reference the Sun Alert Patch Report at 

http://sunsolve.sun.com/pub-cgi/show.pl?target=sunalert_patches
 

PATCHES INCLUDED:
-----------------

112397-03 SunOS 5.8_x86: /usr/bin/fgrep patch
111112-05 Obsoleted by: 111112-06 SunOS 5.8_x86: /usr/bin/nawk patch
110663-16 Obsoleted by: 110663-17 SunOS 5.8_x86: ksh patch
110403-04 Obsoleted by: 110403-05 SunOS 5.8_x86: ufssnapshots support, libadm patch
110935-23 Obsoleted by: 110935-24 SunOS 5.8_x86: package utilites patch
108988-12 Obsoleted by: 108988-13 SunOS 5.8_x86: Patch for patchadd and patchrm
111307-03 Obsoleted by: 111307-04 SunOS 5.8_x86: boot.bin, bootconf.exe, bootenv.rc and nbp patch
111311-01 SunOS 5.8_x86: /usr/lib/libdhcpagent.so.1 patch
108529-29 SunOS 5.8_x86: kernel update and Apache patch
110459-01 Obsoleted by: 110459-02 SunOS 5.8_x86: libcurses patch
109471-02 CDE 1.4_x86: Actions Patch
111072-01 SunOS 5.8_x86: cu patch
111233-01 SunOS 5.8_x86: patch in.fingerd
111235-01 SunOS 5.8_x86: patch finger
111334-01 SunOS 5.8_x86: /kernel/drv/adp patch
110940-01 SunOS 5.8_x86: /usr/lib/acct/closewtmp patch
111326-02 SunOS 5.8_x86: /usr/lib/saf/ttymon patch
110944-04 SunOS 5.8_x86: /usr/bin/tcsh patch
109784-02 Obsoleted by: 109784-03 SunOS 5.8_x86: /usr/lib/nfs/nfsd and /usr/lib/nfs/lockd patch
110323-01 Obsoleted by: 110323-02 SunOS 5.8_x86: /usr/lib/netsvc/yp/ypbind patch
111549-01 SunOS 5.8_x86: catman, man, whatis, apropos and makewhatis patch
110454-04 SunOS 5.8_x86: admintool Patch
111505-01 SunOS 5.8_x86: /usr/bin/tip patch
111607-06 SunOS 5.8_x86: /usr/sbin/in.ftpd patch
111827-01 SunOS 5.8_x86: /usr/sbin/i86/whodo patch
108990-02 SunOS 5.8_x86: acctctl & exacctsys patch
110400-01 Obsoleted by: 110400-03 SunOS 5.8_x86: RBAC Feature Patch
111024-03 SunOS 5.8_x86: /kernel/fs/mntfs patch
111318-05 Obsoleted by: 111318-06 SunOS 5.8_x86: /sbin/init and /usr/sbin/init patch
113649-03 Obsoleted by: 113649-04 SunOS 5.8_x86: /usr/sbin/mount patch
115828-01 SunOS 5.8_x86: /sbin/sulogin and /sbin/netstrategy patch
116603-01 SunOS 5.8_x86: /sbin/uadmin and /sbin/hostconfig patch
108994-52 Obsoleted by: 108994-53 SunOS 5.8_x86: LDAP2 client, libc, libthread and libnsl libraries patch
111597-02 Obsoleted by: 111597-03 SunOS 5.8_x86: /usr/lib/netsvc/yp/rpc.yppasswdd patch
110904-07 SunOS 5.8_x86: edit, ex, vedit, vi and view patch
109239-02 SunOS 5.8_x86: /usr/bin/i86/ipcs patch
109668-04 Obsoleted by: 109668-05 SunOS 5.8_x86: /usr/lib/inet/xntpd and /usr/sbin/ntpdate patch
109401-07 Obsoleted by: 109401-09 SunOS 5.8_x86: Updated video drivers and fixes
110958-02 SunOS 5.8_x86: /usr/bin/mailx patch
112326-01 SunOS 5.8_x86: /kernel/fs/udfs patch
112460-01 SunOS 5.8_x86: /usr/lib/pt_chmod patch
112612-02 SunOS 5.8_x86: /usr/lib/libz.so.1 patch
111959-02 Obsoleted by: 111959-03 SunOS 5.8_x86: /usr/lib/nfs/statd patch
109148-40 SunOS 5.8_x86: linker patch
119068-04 Obsoleted by: 119068-05 X11 6.4.1_x86: Xsun patch
112797-01 SunOS 5.8_x86: /usr/sbin/in.talkd patch
112847-01 SunOS 5.8_x86: /usr/lib/netsvc/rwall/rpc.rwalld patch
109327-18 SunOS 5.8_x86: libresolv.so.2 and in.named patch
113793-01 OpenWindows 3.6.2_x86: mailtool patch
109863-03 X11 6.4.1_x86: Font Server patch
109224-08 SunOS 5.8_x86: kpasswd, libgss.so.1 and libkadm5clnt.so.1 patch
113651-01 Obsoleted by: 113651-02 SunOS 5.8_x86: /usr/lib/utmp_update patch
108900-04 SunOS 5.8_x86: /usr/bin/ftp patch
110897-02 Obsoleted by: 110897-03 SunOS 5.8_x86: cachefs/mount patch
109355-18 Obsoleted by: 109355-22 CDE 1.4_x86: dtsession patch
114674-01 SunOS 5.8_x86: /usr/sbin/wall patch
114617-01 SunOS 5.8_x86: /usr/ucblib/libdbm.a and /usr/ucblib/libdbm.so.1 patch
114163-01 SunOS 5.8_x86: /kernel/drv/lofi drivers and /usr/sbin/lofiadm patch
114985-01 SunOS 5.8_x86: /usr/kernel/fs/namefs patch
110336-03 CDE 1.4_x86: dtprintinfo patch
108978-02 Obsoleted by: 108978-03 SunOS 5.8_x86: libsmedia patch
108969-07 Obsoleted by: 108969-08 SunOS 5.8_x86: vol/vold/rmmount patch
117050-02 CDE 1.4_x86: sdtwebclient patch
116611-01 SunOS 5.8_x86: audit_warn uses /usr/ucb/mail and writes to the console
117001-05 SunOS 5.8_x86: Kernel Patch
116442-01 SunOS 5.8_x86: Solaris sadmind default security level
111401-03 SunOS 5.8_x86: kcms_server and kcms_configure security fixes
111845-03 X11 6.4.1_x86: xdm patch
116987-02 SunOS 5.8_x86: /usr/sbin/ping patch
116985-01 SunOS 5.8_x86: in.rwhod Patch
113750-02 SunOS 5.8_x86: User Manager CLI Patch
116994-01 SunOS 5.8_x86: /usr/bin/newgrp patch
110669-05 SunOS 5.8_x86: telnet patch
108950-08 Obsoleted by: 108950-09 CDE 1.4_x86: litDtHelp/libDtSvc patch
116998-01 SunOS 5.8_x86: Federated Naming Service (FNS) X500 patch
109932-10 CDE 1.4_x86: sdtimage Patch
111303-01 Obsoleted by: 111303-03 SunOS 5.8_x86: EDHCP libraries patch
109078-10 Obsoleted by: 109078-12 SunOS 5.8_x86: dhcp server and admin patch
111627-03 OpenWindows 3.6.2_x86: Xview Patch
109614-07 CDE 1.4_x86: dtmail patch
112669-03 SunOS 5.8_x86: gzip patch
110287-10 Obsoleted by: 110287-11 OpenWindows 3.6.2_x86: Tooltalk patch
111571-04 SunOS 5.8_x86: uucp patch
112238-12 Obsoleted by: 112238-13 SunOS 5.8_x86: mech_krb5.so.1 patch
112240-10 Obsoleted by: 112240-11 SunOS 5.8_x86: Supplemental Encryption Kerberos V5: mech_krb5.so.1 patch
109008-18 Obsoleted by: 109008-19 SunOS 5.8_x86: at/atrm/batch/cron patch
111314-03 Obsoleted by: 111314-04 SunOS 5.8_x86: Viper Library Patch
109024-05 SunOS 5.8_x86: ps cmd patch
110899-02 Obsoleted by: 110899-04 SunOS 5.8_x86: csh/pfcsh patch
122092-01 SunOS 5.8_x86: perl patch
109765-06 SunOS 5.8_x86: /kernel/fs/hsfs patch
110956-06 SunOS 5.8_x86: /kernel/strmod/timod patch
109325-09 SunOS 5.8_x86: sh/jsh/rsh/pfsh patch
111322-03 Obsoleted by: 111322-04 SunOS 5.8_x86: klmmod and klmops patch
117351-41 Obsoleted by: 117351-43 SunOS 5.8_x86: kernel patch
109644-11 Obsoleted by: 109644-12 SunOS 5.8_x86: /kernel/drv/sd patch
109092-06 Obsoleted by: 109092-07 SunOS 5.8_x86: /usr/lib/fs/ufs/ufsrestore patch
108870-17 Obsoleted by: 108870-18 SunOS 5.8_x86: snmpdx/mibiisa/libssasnmp/snmplib patch
109319-07 Obsoleted by: 109319-08 SunOS 5.8_x86: Admin/Install patch
109135-31 Obsoleted by: 109135-32 SunOS 5.8_x86: WBEM patch ltiple Synopsis: lines in patch README can cause CIM_ERR_FAILED
108920-21 Obsoleted by: 108920-22 CDE 1.4_x86: dtlogin patch
111875-06 Obsoleted by: 111875-07 SunOS 5.8_x86: usr/bin/mail patch
109329-06 SunOS 5.8_x86: ypserv, ypxfr and ypxfrd patch
124271-01 SunOS 5.8_x86: PatchPro Core Functionality Patch
116960-15 SunOS 5.8_x86: nfs and rpcmod patch
110616-16 SunOS 5.8_x86: sendmail patch
108976-10 SunOS 5.8_x86: /usr/bin/rmformat and /usr/sbin/format patch
109321-17 Obsoleted by: 109321-18 SunOS 5.8_x86: LP Patch
109455-05 SunOS 5.8_x86: /kernel/fs/fifofs patch
110911-03 Obsoleted by: 110911-05 SunOS 5.8_x86: /usr/lib/fs/ufs/fsck patch
116951-05 Obsoleted by: 116951-06 SunOS 5.8_x86: ufs patch
108726-13 Obsoleted by: 108726-14 SunOS 5.8_x86: st driver patch
116966-21 Obsoleted by: 116966-22 SunOS 5.8_x86: ip/arp/tcp/udp/tun patch
110946-08 Obsoleted by: 110946-09 SunOS 5.8_x86: /usr/sbin/syslogd patch
116974-04 Obsoleted by: 116974-05 SunOS 5.8_x86: Apache Patch
109810-02 Obsoleted by: 109810-03 SunOS 5.8_x86: timezone data patch

IMPORTANT NOTES AND WARNINGS:
-----------------------------

SYSTEMS WITH LIMITED DISK SPACE SHOULD *NOT* INSTALL PATCHES:  With or
without using the save option, the patch installation process will
still require some amount of disk space for installation and
administrative tasks in the /, /usr, /var, or /opt directories where
patches are typically installed.  The exact amount of space will depend
on the machine's architecture, software packages already installed, and
the difference in the patched objects size.  To be safe, it is not
recommended that a patch cluster be installed on a system with less
than 100 MBytes of available space in each of these directories. Running
out of disk space during installation may result in only partially
loaded patches.  Be sure a recent full system backup is available in
case a problem occurs, and check to be sure adequate disk space is
available before installing the patch cluster.

SAVE AND BACKOUT OPTIONS:
By default, the cluster installation procedure uses the patchadd
command save feature to save the base objects being patched.  Prior to
installing the patches the cluster installation script will first
determine if enough system disk space is available in /var/sadm/patch
to save the base objects and will terminate if not.  Patches can only
be individually backed out with the original object restored if the
save option was used when installing this cluster.  Please later refer
to the patchrm command manual page for instructions and more
information.  It is possible to override the save feature by using the
[-nosave] option when executing the cluster installation script.  Using
the nosave option, however, means that you will not be able to backout
individual patches if the need arises.

SPECIAL INSTALL INSTRUCTIONS:
As with any patch individually applied, there may be additional special
installation instructions which are documented in the individual patch
README file.  It is recommended that each individual patch readme is
reviewed before installing this cluster to determine if any additional
installation steps are necessary for a patch.  Otherwise it is possible
that an individual patch may still not be completely installed in all
respects after the cluster has been installed.

DISKLESS CLIENT SYSTEMS:
On server machines that service diskless clients, a
patch is NOT applied to existing clients or to the client root template
space.  Therefore, all client machines of the server that will need
this cluster will have to individually apply this cluster.  Install
this cluster on the client machines first, then the server.

A PATCH MAY NOT BE APPLIED:
Under certain circumstances listed below, a particular patch provided in
this cluster may not be installed if:
 
- The patch applies to a package that has not originally been installed
- The same or newer revision of the patch has already been installed
- The patch was obsoleted by another patch that has already been installed
- The package database is corrupt or missing

Use the 'showrev -p' command to compare the list of patches already 
installed on the system with the patch list and revision levels provided
in this cluster.  During installation, the install process will indicate
if a patch was not applied and more detailed installation messages will
be logged to the installation log file.  The README file with each patch
also provides documentation regarding install and backout messages.

OLDER VERSIONS OF PATCHES ALREADY INSTALLED:
Backout of older versions of patches provided in the cluster is not
required in order for the newer version to be installed.  However
not backing out an older rev before installing a newer rev will
cause showrev -p to continue to show the older rev along with the
newer rev.  And, if the older rev was previously installed with
the save option, the older rev will continue to occupy disk space
in /var/sadm/patch even though it has been obsoleted by the new rev.
The patchrm command will only allow the most recently saved
objects to be restored, thus there are no serious risks associated
with leaving an older rev on the system.  It just may, however,
avoid confusion and be more economical to first backout an older
patch revision before installing a newer revision.


INSTALL INSTRUCTIONS:
---------------------

First, be sure the patch cluster has been unzipped
if the cluster was received as a .zip file, then proceed as follows:


1)      Decide on which method you wish to install the cluster:

Recommended Method Using Save Feature:
 
By default, the cluster installation procedure uses the patchadd
save feature to save the original objects being patched.  Prior
to installing the patches the cluster installation script will
first determine if enough system disk space is available in
/var/sadm/patch to save the objects and will terminate if not.
Using the default save feature is recommended. 
 
Method Using No Save Option:
 
It is possible to override the save feature by using the [-nosave]
option when executing the cluster installation script.  Using the
nosave option means that you will not be able to backout individual
patches if the need arises.
 
 
2)      Run the install_cluster script

        cd <patch cluster directory>
        ./install_cluster

By default, a message warning the user to check for minimum disk
space allowance (separate from the save feature) will appear
and allow the user to abort if inadequate space exists.  To
suppress this interactive message the "-q" (quiet) option can
be used when invoking install_cluster.
 
The progress of the script will be displayed on your terminal.
It should look something like:
 
# ./install_cluster
 
Patch cluster install script for <cluster name>
 
Determining if sufficient save space exists...
Sufficient save space exists, continuing...
Installing patches located in <patch cluster directory>
Installing <patch-id>
Installing <patch-id>
.
.
.
Installing <patch-id>
 
For more installation messages refer to the installation logfile:
   /var/sadm/install_data/<cluster name>_log
 
Use '/usr/bin/showrev -p' to verify installed patch-ids.
Refer to individual patch README files for more patch detail.
Rebooting the system is usually necessary after installation.
#
         
 
3)      Check the logfile if more detail is needed.
 
If errors are encountered during the installation of this cluster,
error messages will be displayed during installation.  More details
about the causes of failure can be found in the detail logfile:
 
        more /var/sadm/install_data/<cluster name>_log
 
If this log file previously existed the latest cluster installation
data will be concatenated to the file, so check the end of the file.
 
         
4)      THE MACHINE SHOULD BE REBOOTED FOR ALL PATCHES TO TAKE EFFECT!!



RETURN CODES:
-------------

The following are the explanation of patchdd script exit codes:

0       No error
1       Usage error
2       Attempt to apply a patch that's already been applied
3       Effective UID is not root
4       Attempt to save original files failed
5       pkgadd failed
6       Patch is obsoleted
7       Invalid package directory
8       Attempting to patch a package that is not installed
9       Cannot access /usr/sbin/pkgadd (client problem)
10      Package validation errors
11      Error adding patch to root template
12      Patch script terminated due to signal
13      Symbolic link included in patch
14      NOT USED
15      The prepatch script had a return code other than 0.
16      The postpatch script had a return code other than 0.
17      Mismatch of the -d option between a previous patch
        install and the current one.
18      Not enough space in the file systems that are targets
        of the patch.
19      $SOFTINFO/INST_RELEASE file not found
20      A direct instance patch was required but not found
21      The required patches have not been installed on the 
        manager
22      A progressive instance patch was required but not found
23      A restricted patch is already applied to the package
24      An incompatible patch is applied
25      A required patch is not applied
26      The user specified backout data can't be found
27      The relative directory supplied can't be found
28      A pkginfo file is corrupt or missing
29      Bad patch ID format
30      Dryrun failure(s)
31      Path given for -C option is invalid
32      Must be running Solaris 2.6 or greater
33      Bad formatted patch file or patch file not found
34      Incorrect patch spool directory
35      Later revision already installed
36      Cannot create safe temporary directory
37      Illegal backout directory specified
38      A prepatch, prePatch or a postpatch script could not be
        executed

