Sun Cluster 3.1/3.1_x86: HA for Solaris Containers |
Status: RELEASED
Patch Id: 120590-06
***********************************************************************
READ THE TERMS OF THE AGREEMENT ("AGREEMENT") IN THE LEGAL_LICENSE.TXT
FILE CAREFULLY BEFORE USING THIS SOFTWARE. BY USING THE SOFTWARE, YOU
AGREE TO THE TERMS OF THIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE
TERMS, PROMPTLY DESTROY THE UNUSED SOFTWARE.
***********************************************************************Summary: Sun Cluster 3.1/3.1_x86: HA for Solaris Containers
Date: Oct/19/2007
Installation Requirements:
See Special Install Instructions
Solaris Release: 10 10_x86
Sun OS Release: 5.10 5.10_x86
Unbundled Product: Sun Cluster
Unbundled Release: 3.1/3.1_x86
Xref:
Topic:
Sun Cluster 3.1/3.1_x86: HA for Solaris Containers
Relevant Architecture: all
BugId's fixed with this patch:
6297356 6297393 6297413 6297427 6301780 6326810 6332943 6332947 6338986 6339440 6372853 6384190 6388906 6425175 6425845 6488338 6554262 6604747
Changes incorporated in this version:
6604747
Patches accumulated and obsoleted by this patch:
Patches which conflict with this patch:
Required Patches:
Obsoleted by:
Files Included in this Patch:
/opt/SUNWsczone/lib/functions
/opt/SUNWsczone/lib/functions_common
/opt/SUNWsczone/sczbt/bin/clear_zone
/opt/SUNWsczone/sczbt/bin/functions
/opt/SUNWsczone/sczbt/bin/probe_sczbt
/opt/SUNWsczone/sczbt/bin/start_sczbt
/opt/SUNWsczone/sczbt/bin/stop_sczbt
/opt/SUNWsczone/sczbt/bin/validate_sczbt
/opt/SUNWsczone/sczbt/util/sczbt_config
/opt/SUNWsczone/sczbt/util/sczbt_register
/opt/SUNWsczone/sczsh/bin/functions
/opt/SUNWsczone/sczsh/bin/probe_sczsh
/opt/SUNWsczone/sczsh/bin/start_sczsh
/opt/SUNWsczone/sczsh/bin/stop_sczsh
/opt/SUNWsczone/sczsh/bin/validate_sczsh
/opt/SUNWsczone/sczsh/util/sczsh_register
/opt/SUNWsczone/sczsmf/bin/functions
/opt/SUNWsczone/sczsmf/bin/probe_sczsmf
/opt/SUNWsczone/sczsmf/bin/start_sczsmf
/opt/SUNWsczone/sczsmf/bin/stop_sczsmf
/opt/SUNWsczone/sczsmf/bin/validate_sczsmf
/opt/SUNWsczone/sczsmf/util/sczsmf_register
Problem Description:
6604747 HA Container agent should support solaris8 zones on sparc
(from 120590-05)
6488338 HA Container agent should support BrandZ lx zones with Solaris 10 Update 4
6554262 validate() for sczbt should check ip-type=exclusive and then only allow SC_NETWORK=false
(from 120590-04)
6425175 enabling of container/smf resource reports online before start script is finished
6425845 clear_zone() needs timelimit to let stop_sczbt() return before 80% GDS Stop_timeout is reached
(from 120590-03)
6388906 sczsmf component needs to support a transient service
6384190 MOUNTS entry in sczbt_config should allow different mappings from global zone to local zone
6372853 sczsmf: svcs: Pattern '<sczsmf res name>' doesn't match any instances
(from 120590-02)
6339440 sczsmf component produces too much output and validates at every probe
6338986 sczsmf component needs to percolate an SMF restart back to RGM
6332947 zone boot component does not add logical hosts to zone if locale is Japanese
6332943 zone boot component should be capable of separate lofs mounts
6326810 SC LogicalHostname not being set within non-global failover zone for sczbt resource
(from 120590-01)
6297427 SUNWsczone/scz{bt,sh,smf}/util/scz{bt,sh,smf}_register should support user defined configfilename
6297413 SUNWsczone/scz{bt,sh,smf}/bin/probe_scz{bt,sh,smf} should not use scha_resource_setstatus
6297393 start_sczbt script uses ${MYDIR} instead of ${MYNAME} for debug messages
6297356 clear_zone() should call mount/fuser with absolute path, stop_sczbt needs to call validate
6301780 sczsmf probe needs to be able to handle FMRI instance in transitionRevision History:
120590-04 120590-02 120590-05 120590-03 120590-01
Patch Installation Instructions:
--------------------------------
There are three (3) possible procedures for installing patches on
Sun Cluster 3.1. The proper method to use and any additional
instructions for this patch are specified below in the "Special
Install Instructions" section.
Refer to the chapter entitled "Patching Sun Cluster Software and
Firmware" in the "Sun Cluster 3.1 System Administration Guide" for a
description of the different install processes and instructions on how
to install Sun Cluster 3.1 patches.
Refer to the man pages for instructions on using 'patchadd' and
'patchrm' scripts provided with Solaris, to install and remove patches.
Special Install Instructions:
-----------------------------
NOTE 1: This patch must be applied to the global zone only by using the -G
option for patchadd, e.g.
<global zone># patchadd -G 120590-06
If you need to backout the patch, you must also use the -G option
for patchrm, e.g.
<global zone># patchrm -G 120590-06
NOTE 2: The implementation for RFE 6384190 enhances the "Mounts" variable in
the configfile. With this enhancement it is now possible to specify
different mount points for the global zone and local zone.
The format of the "Mounts" variable is now:
Mounts="/<global zone directory>:/<local zone directory>:<mount options>"
The following are valid examples for the "Mounts" variable:
Mounts="/globalzone-dir1:/localzone-dir1:rw"
Mounts="/globalzone-dir1:/localzone-dir1:rw /globalzone-dir2:rw"
The only required entry is the /<global zone directory>.
The /<local zone directory> and <mount options> can be omitted.
Omitting /<local zone directory> will make the global and local zone
mounts the same.
Omitting <mount options> will not provide any mount options; expect
the default options from the mount command.
NOTE 3: The implementation for RFE 6297427 introduces the "-f <configfile>"
option to the register script for each component within the Sun
Cluster HA for Solaris Containers data service.
So it is now also possible to call the component's register script
with a config file residing at a user defined location, e.g.
# /opt/SUNWsczone/scz<component>/util/scz<component>_register \
-f <mypath>/<mycomponentconfigfile>
where <component> must either consist of "bt", "sh" or "smf".
The user-defined config file must contain the proper variable
setting as documented in the component's default config file.
If no "-f <configfile>" option is used, the default config file will be
sourced, ie. /opt/SUNWsczone/scz<component>/util/scz<component>_config.
NOTE 4: The implementation for RFE 6332943 introduces the "Mounts" variable
in the configfile. This variable contains a space separated list of
directories in the global zone that will be automatically mounted
via lofs mounts into the non-global zone.
The format for the "Mounts" variable is <directory>:<list of options>.
The directory is separated from the list of options by a ":" and the
options are separated by a ",". The non-global zone must contain
the same mount point, as specified in the "Mounts" variable,
as the global zone, e.g.
Mounts="/source1:rw /source2:ro /source3"
To use the "Mounts" variable in an already running non-global zone,
you must either re-register the SC sczbt resource or add the "Mounts"
variable to the parameter file sczbt_<resource name> and
disable/enable the SC sczbt resource.
The parameter file is located in the parameter directory of the
SC sczbt resource.
If the file system of the source mount point is mounted via a
HAStoragePlus or a HAStorage resource, a strong dependency needs
to exist from the SC sczbt resource to this resource.
NOTE 5: The implementation for RFE 6488338 introduces the possibility to
handle non-global zones of brand type lx with the sczbt component.
The sczbt_config file contains two new variables:
Zonebrand - Brand of the zone. Current supported options are
"native" (default) or "lx"
LXrunlevel - Runlevel which needs to get reached before the zone is
considered booted. This option is only used for the "lx"
Zonebrand.
The sczsh component can also be combined with the sczbt component
configured for a non-global zone of brand type lx.
The sczsmf component can NOT be configured in combination with a
sczbt component configured for a non-global zone of brand type lx.
NOTE 6: The implementation for CR 6554262 allows the use of
ip-type=exclusive in the zone configuration for the configured
sczbt resource. In that case the SC_NETWORK variable in the
sczbt_config configuration file must be set to "false" to
successfully register the sczbt resource.
A resource dependency on a SUNW.LogicalHostname resource from the
sczbt resource must not be configured, if ip-type=exclusive is
set for that non-global zone.
NOTE 7: The implementation for RFE 6604747 introduces the possibility to
handle non-global zones of brand type solaris8 on sparc with the sczbt
component. The sczbt_config file contains a new variable:
SLrunlevel=solaris-legacy-runlevel
Specifies the legacy runlevel which needs to get reached before the
zone is considered booted. This option is only used for the
"solaris8" brand type. You must specify a value for this keyword if
you set Zonebrand=solaris8.
The Zonebrand variable can now also be set to "solaris8".
The sczsh component can also be combined with the sczbt component
configured for a non-global zone of brand type solaris8.
The sczsmf component can NOT be configured in combination with a
sczbt component configured for a non-global zone of brand type
solaris8.
README -- Last modified date: Friday, October 19, 2007