# CLUSTER_README

NAME: Solaris 10 Recommended Patch Cluster
DATE: Jun/28/06

########################################################################
IMPORTANT:

Patch 119254-06 was added to this cluster to address the issue of
bug 6434674. Please see SunAlert 101688 for more information.
http://sunsolve.sun.com/search/document.do?assetkey=1-26-101688-1
########################################################################

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

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 occured 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
-------------------

These Solaris Recommended 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
most cases a Solaris security patch will be included in the recommended
patch set.  It is possible, however, that a security patch may not be
included in the recommended set if it is determined to be a more obscure
application specific issue and not generally applicable.

During initial installation of the Solaris product other patches or patch
sets may be provided with the product and required with product installation.
Refer to the Solaris product installation documentation to be sure that all
the patches required at product installation are already installed.  This
patch cluster can then be used to update or augment the system with the
recommended patches included.


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

119254-06  SunOS 5.10: Install and Patch Utilities Patch
120719-01  SunOS 5.10 : gzip patch
121296-01  SunOS 5.10: fgrep Patch
118815-03  SunOS 5.10: awk patch
120900-04  SunOS 5.10: libzonecfg Patch
121133-02  SunOS 5.10: zones library and zones utility patch
119254-24  SunOS 5.10: Install and Patch Utilities Patch
118560-01  SunOS 5.10: patch usr/bin/telnet
119903-01  OpenWindows 3.7.3: Xview Patch
119317-01  SunOS 5.10: SVr4 Packaging Commands (usr) Patch
120085-01  SunOS 5.10: in.ftpd patch
119593-01  SunOS 5.10: net-svc patch
118870-01  SunOS 5.10: nss_ldap patch
120292-01  SunOS 5.10 : mysql patch
120664-01  SunOS 5.10: tl driver patch
118712-09  SunOS 5.10: Sun XVR-100 Graphics Accelerator Patch
121004-01  SunOS 5.10: sh patch
118918-17  SunOS 5.10: Solaris Crypto Framework patch
120467-04  SunOS 5.10: LP patch
119574-02  SunOS 5.10: su patch
121308-03  SunOS 5.10: Solaris Management Console Patch
121012-01  SunOS 5.10: traceroute patch
118562-09  SunOS 5.10: Solaris Data Encryption Kit Patch
121236-01  SunOS 5.10: ncp patch
121453-02  SunOS 5.10: Sun Update Connection Client Foundation
118371-07  SunOS 5.10: elfsign Patch
121265-02  SunOS 5.10: libc_psr_hwcap1.so.1 patch
119578-24  SunOS 5.10: FMA Patch
118822-30  SunOS 5.10: kernel Patch
120661-04  SunOS 5.10: rpcmod patch
120469-04  SunOS 5.10: kerberos patch
119981-09  SunOS 5.10: libc_psr patch
120329-02  SunOS 5.10: rexec patch
121229-01  SunOS 5.10: libssl patch
119985-02  SunOS 5.10: perl patch
122032-02  SunOS 5.10: Update timezones patch
120849-04  SunOS 5.10: Sun PCI-E Gigabit Ethernet Adapter Patch
122856-01  SunOS 5.10: sendmail patch
120824-04  SunOS 5.10: usr/platform/SUNW,Sun-Fire-T200/lib/libprtdiag_psr.so.1 Patch
118833-17  SunOS 5.10: kernel patch
119757-02  SunOS 5.10: Samba patch
119059-14  X11 6.6.2: Xsun patch
118959-03  SunOS 5.10: patch usr/bin/lastcomm and usr/bin/acctcom
119130-21  SunOS 5.10: Sun Fibre Channel Device Drivers


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 10 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!!


