Sun Cluster Data Service for Solaris Containers Guide for Solaris OS

Files for Configuring Sun Cluster HA for Solaris Zones Resources

The /opt/SUNWsczone/zone component/util directory contains files that automate the process of configuring Sun Cluster HA for Solaris Zones resources. Listings of these files are provided in the following sections:

Listing of sczbt_config

#
# Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
# Use is subject to license terms.
#
# ident	"@(#)sczbt_config	1.5	08/04/17 SMI"
#
# This file will be sourced in by sczbt_register and the parameters
# listed below will be used.
#
# These parameters can be customized in (key=value) form
#
#               RS - Name of the resource
#               RG - Name of the resource group containing RS
#     PARAMETERDIR - Name of the parameter file direcrory
#       SC_NETWORK - Identfies if SUNW.LogicalHostname will be used
#			true = zone will use SUNW.LogicalHostname 
#	               false = zone will use it's own configuration 
#
#		NOTE: If the ip-type keyword for the non-global zone is set
#		      to "exclusive", only "false" is allowed for SC_NETWORK
#
#	The configuration of a zone's network addresses depends on
#	  whether you require IPMP protection or protection against
#	  the failure of all physical interfaces.
#
#	If you require only IPMP protection, configure the zone's 
#	  addresses by using the zonecfg utility and then place the
#	  zone's address in an IPMP group. 
#
#	  	To configure this option set 
#		  SC_NETWORK=false
#		  SC_LH=Name of the SC Logical Hostname resource
#
#	If IPMP protection is not required, just configure the 
#	  zone's addresses by using the zonecfg utility. 
#
#	  	To configure this option set 
#		  SC_NETWORK=false
#		  SC_LH=Name of the SC Logical Hostname resource
#
#	If you require protection against the failure of all physical
#	  interfaces, choose one option from the following list. 
#
#	- If you want the SUNW.LogicalHostName resource type to manage
#	    the zone's addresses, configure a SUNW.LogicalHostName
#	    resource with at least one of the zone's addresses. 
#	
#	  	To configure this option set 
#		  SC_NETWORK=true
#		  SC_LH=Name of the SC Logical Hostname resource
#
#	- Otherwise, configure the zone's addresses by using the 
#	    zonecfg utility and configure a redundant IP address
#	    for use by a SUNW.LogicalHostName resource. 
#
#	  	To configure this option set 
#		  SC_NETWORK=false
#		  SC_LH=Name of the SC Logical Hostname resource
#
#	Whichever option is chosen, multiple zone addresses can be 
# 	  used either in the zone's configuration or using several
#	  SUNW.LogicalHostname resources.
#
#	   e.g.	SC_NETWORK=true
#	  	SC_LH=zone1-lh1,zone1-lh2
#
#            SC_LH - Name of the SC Logical Hostname resource
#         FAILOVER - Identifies if the zone's zone path is on a 
#                      highly available local file system
#
#	  e.g.	FAILOVER=true - highly available local file system
#	  	FAILOVER=false - local file system
#
#           HAS_RS - Name of the HAStoragePlus SC resource
#

RS=
RG=
PARAMETERDIR=
SC_NETWORK=
SC_LH=
FAILOVER=
HAS_RS=

#
# The following variable will be placed in the parameter file
#
# Parameters for sczbt (Zone Boot)
#
# Zonename      Name of the zone
# Zonebrand	Brand of the zone. Current supported options are
#		"native" (default), "lx", "solaris8" or "solaris9"
# Zonebootopt   Zone boot options ("-s" requires that Milestone=single-user)
# Milestone     SMF Milestone which needs to be online before the zone is
#		considered booted. This option is only used for the
#		"native" Zonebrand.
# LXrunlevel	Runlevel which needs to get reached before the zone is
#		considered booted. This option is only used for the "lx"
#		Zonebrand.
# SLrunlevel	Solaris legacy runlevel which needs to get reached before the
#		zone is considered booted. This option is only used for the
#		"solaris8" or "solaris9" Zonebrand.
# Mounts 	Mounts is a list of directories and their mount options, 
#		which are loopback mounted from the global zone into the 
#		newly booted zone. The mountpoint in the local zone can 
#		be different to the mountpoint from the global zone.
#
#		The Mounts parameter format is as follows,
#
#		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 local zone
#		mountpoint the same as the global zone directory.
#
#		Omitting mount options will not provide any mount options
#		except the default options from the mount command.
#	
#		Note: You must manually create any local zone mountpoint
#		      directories that will be used within the Mounts variable,
#		      before registering this resource within Sun Cluster.
#

Zonename=""
Zonebrand="native"
Zonebootopt=""
Milestone="multi-user-server"
LXrunlevel="3"
SLrunlevel="3"
Mounts=""

Listing of sczsh_config

#
# Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
# Use is subject to license terms.
#
# ident	"@(#)sczsh_config	1.1	06/02/22 SMI"
# 
# This file will be sourced by sczsh_register and the parameters
# listed below will be used.
#
# These parameters can be customized in (key=value) form
#
#                  RS - Name of the resource 
#                  RG - Name of the resource group containing RS
#            SCZBT_RS - Name of the SC Zone boot resource
#        PARAMETERDIR - Name of the parameter file directory
#            Zonename - Name of the zone
# ServiceStartCommand - Command including all options to start 
#                        the service in the configured zone
#  ServiceStopCommand - Command including all options to stop 
#                        the service in the configured zone
# ServiceProbeCommand - Command including all options to probe
#                        the service in the configured zone
#
RS=""
RG=""
SCZBT_RS=""
PARAMETERDIR=""
#
# The following parameters will be put in the agents parameterfile:
#
Zonename=""
ServiceStartCommand=""
ServiceStopCommand=""
ServiceProbeCommand=""

Listing of sczsmf_config

#
# Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
# Use is subject to license terms.
# 
# ident	"@(#)sczsmf_config	1.1	06/02/22 SMI"
#
# This file will be sourced in by sczsmf_register and the parameters
# listed below will be used.
#
# These parameters can be customized in (key=value) form
#
#               RS - Name of the resource
#               RG - Name of the resource group containing RS
#	  SCZBT_RS - Name of the SC Zone boot resource
#	      ZONE - Name of the Zone
#
#	For SERVICE, RECURSIVE and STATE, refer to the svcadm(1M) 
#		  man page
#	
#	   SERVICE - {FMRI | pattern}
#		FMRI - Fault management resource identifier
#		pattern - Pattern matching a service
#
#	 RECURSIVE - {false | true} 	Default: true
#		False - Just enable the service and no dependents
#		True - Enable the service and recursively enable 
#		  its dependents
#	
#		RECURSIVE=true equates to svcadm enable "-r" 
#
#	     STATE - {false | true}	Default: true
#		False - Do not wait until service state is reached
#		True - Wait until service state is reached
#
#		STATE=true equates to svcadm enable/disable "-s" 
#
#    SERVICE_PROBE - Script to check the SMF service
#
#		The optional parameter, SERVICE_PROBE, provides the 
#		  ability to check that the SMF service is working.
#		  This must be a script within the zone and must 
#		  adhere to these return codes,
#
#		  0 - The SMF service is working
#		100 - The SMF service should be restarted 
#		201 - The SMF service should initiate a failover of 
#			the Resource Group
#
#		Note: That return code 201, requires that this resource 
#		  has an appropriate extension property value for
#		  FAILOVER_MODE and FAILOVER_ENABLED=TRUE
#
#		For FAILOVER_MODE refer to the r_properties(5) man page.
#

RS=
RG=
SCZBT_RS=
ZONE=
SERVICE=
RECURSIVE=true
STATE=true
SERVICE_PROBE=""