Oracle® Solaris Cluster Data Service for Oracle Solaris Zones Guide

Exit Print View

Updated: July 2014, E39657-01
 
 

Files for Configuring HA for Solaris Zones Resources

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

Listing of sczbt_config

#
# Copyright (c) 2006, 2014, Oracle and/or its affiliates. All rights reserved.
#
#
# ident	"@(#)sczbt_config	1.12	14/04/09"
#
# 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 sczbt resource
#               RG - Name of the resource group containing the sczbt resource RS
#     PARAMETERDIR - Name of the parameter file directory - this variable is
#                    now deprecated and no longer used.
#       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" or if the zone is a kernel zone, only
#		      "false" is allowed for SC_NETWORK.
#
#	If the ip-type keyword for the non-global zone is set to "shared",
#         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=
#
#	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=
#
#	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 SUNW.LogicalHostname 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 SUNW.LogicalHostname 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 SUNW.LogicalHostname resource. If set, the
#                    sczbt_register script will list the SUNW.LogicalHostname
#                    resource within the Resource_dependencies_offline_restart
#                    property of the sczbt 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 SUNW.HAStoragePlus resource (or any other
#                    cluster resource providing HA storage used by the zone).
#                    If set, the sczbt_register script will list the 
#                    resource within the Resource_dependencies_offline_restart
#                    property of the sczbt 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", "solaris9", "solaris10",
#              "solaris" or "solaris-kz".
# 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", "solaris10", "solaris" or "solaris-kz" Zonebrand.
# LXrunlevel   Runlevel which needs to get reached before the zone is
#		      considered booted. This option is only used for the "lx"
#		      Zonebrand.
# SLrunlevel   Oracle 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.
#
#		This option cannot be used with the "solaris-kz" Zonebrand.
#
#		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 and the
#		/local zone directory. The mount options entry 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 Oracle Solaris
#		      Cluster.
#
# Migrationtype Defines the type of migration that should be used for the configured
#               Oracle Solaris kernel zone. Values for Migrationtype can be "cold" and
#               "warm". With Migrationtype=cold the Oracle Solaris kernel zone is
#               shutdown on the current running node and freshly booted on the
#               new node, when the resource group performs a failover.
#               With Migrationtype=warm the Oracle Solaris kernel zone is suspended
#               on the current running node and booted from the suspended image
#               on the new node, when the resource group performs a failover.
#               This option is only used with the "solaris-kz" Zonebrand.
#

Zonename=""
Zonebrand="native"
Zonebootopt=""
Milestone="svc:/milestone/multi-user-server"
LXrunlevel="3"
SLrunlevel="3"
Mounts=""
Migrationtype="cold"

Listing of sczsh_config

#
# Copyright (c) 2006, 2014, Oracle and/or its affiliates. All rights reserved.
#
# ident	"@(#)sczsh_config	1.5	14/04/09"
# 
# 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 - this variable is
#                       now deprecated and no longer used.
#            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 parameter file:
#
Zonename=""
ServiceStartCommand=""
ServiceStopCommand=""
ServiceProbeCommand=""

Listing of sczsmf_config

#
# Copyright (c) 2006, 2014, Oracle and/or its affiliates. All rights reserved.
#
# ident	"@(#)sczsmf_config	1.5	14/04/09"
#
# 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=""