Specifying Configuration Parameters for the Zone Boot Resource

Language:

HA for Solaris Zones provides the script sczbt_register, which automates the process of configuring the zone boot resource. By default this script obtains configuration parameters from the sczbt_config file in the /opt/SUNWsczone/sczbt/util directory. To specify configuration parameters for the zone boot resource, copy the sczbt_config file to a different filename and amend it as described below. It is recommended to keep this file as a future reference. The register script provides –f option to specify the fully qualified filename to the copied configuration file.

Each configuration parameter in the sczbt_config file is defined as a keyword-value pair. The sczbt_config file already contains the required keywords and equals signs. For more information, see Listing of sczbt_config. When you edit the sczbt_config file, add the required value to each keyword.

For more information, see How to Create and Enable Resources for the Zone Boot Component.

The keyword-value pairs in the sczbt_config file are as follows:

RS=sczbt-rs
RG=sczbt-rg
PARAMETERDIR=
SC_NETWORK=true|false
SC_LH=sczbt-lh-rs
FAILOVER=true|false
HAS_RS=sczbt-has-rs
Zonename=zone-name
Zonebrand=zone-brand-type
Zonebootopt=zone-boot-options
Milestone=zone-boot-milestone
LXrunlevel=linux-runlevel
SLrunlevel=solaris-legacy-runlevel
Mounts=list-of-mountpoints
Migrationtype=cold|warm|live

The meaning and permitted values of the keywords in the sczbt_config file are as follows:

RS=sczbt-rs

Specifies the name that you are assigning to the zone boot resource. You must specify a value for this keyword.

RG=sczbt-rg

Specifies the name of the resource group the zone boot resource will reside in. You must specify a value for this keyword.

PARAMETERDIR=

This keyword is deprecated. Leave the value empty for this keyword.

SC_NETWORK=true|false

Specifies whether the zone boot resource is network aware with a SUNW.LogicalHostName resource. You must specify a value for this keyword.

If HA for the zone's addresses is not required, then configure the zone`s addresses by using the zonecfg utility.
```
SC_NETWORK=false
SC_LH=
```
If only HA using a public network management (PNM) object is required, then configure the zone's addresses by using the zonecfg utility and then place the zone's addresses on a PNM object.
```
SC_NETWORK=false
SC_LH=
```
If HA using a PNM object and protection against the failure of all physical interfaces by triggering a failover is required, choose one option from the following list:
- If you require the SUNW.LogicalHostName resource type to manage one or a subset of the zone's addresses, configure a SUNW.LogicalHostName resource for those zone's addresses and not by using the zonecfg utility. Use the zonecfg utility to configure only the zone's addresses that are not to be under the control of the SUNW.LogicalHostName resource.
```
SC_NETWORK=true
SC_LH=Name of the SUNW.LogicalHostName resource
```
- If you require the SUNW.LogicalHostName resource type to manage all the zone's addresses, configure a SUNW.LogicalHostName resource with a list of the zone's addresses and do not configure them by using the zonecfg utility.
```
SC_NETWORK=true
SC_LH=Name of the SUNW.LogicalHostName resources
```
- Otherwise, configure the zone's addresses by using the zonecfg utility and configure a separate redundant IP address for use by a SUNW.LogicalHostName resource, which must not be configured using the zonecfg utility.
```
SC_NETWORK=false
SC_LH=Name of the SUNW.LogicalHostName resource
```

SC_LH=sczbt-lh-rs

Specifies the name of the SUNW.LogicalHostName resource for the zone boot resource. Refer to Requirements and Restrictions for Zone Network Addresses for a description of when to set this variable. This name must be the SUNW.LogicalHostname resource name you assigned when you created the resource in Step 4.

FAILOVER=true|false

Specifies whether the zone's zone path is on a highly available file system.

HAS_RS=sczbt-has-rs

Specifies the name of the SUNW.HAStoragePlus resource or any other cluster resource that provides highly available storage used by the zone. This name must be the resource name you assigned when you created the resource in How to Enable a Zone to Run in a Failover Configuration. You must specify a value for this keyword if FAILOVER=true is set. This will cause the scbzt_register script to define a Resource_dependencies_offline_restart resource dependency from the zone boot resource to the specified SUNW.HAStoragePlus resource.

The sczbt_register script defines a resource dependency of type Resource_dependencies_offline_restart as follows:

If you set the SC_LH variable within the sczbt_config file, then the Resource_dependencies_offline_restart property of the sczbt component will contain the SUNW.LogicalHostname resource name as set with the SC_LH variable.
If you set the HAS_RS variable within the sczbt_config file, then the Resource_dependencies_offline_restart property of the sczbt component will contain the storage resource name as set with the HAS_RS variable.

For a multi-master configuration, the HAS_RS= parameter must be empty because there is no SUNW.HAStoragePlus resource. All the zone paths are local to each node in that configuration.

Zonename=zone-name

Specifies the zone name. You must specify a value for this keyword.

Zonebrand=zone-brand-type

Specifies the brand type of the zone. The options that are currently supported are solaris, solaris10, and solaris-kz. You must specify a value for this keyword.

Zonebootopt=zone-boot-options

Specifies the zone boot option to use. Only -s is supported. Leaving this variable blank will cause the zone to boot to the multi-user-server milestone.

Milestone=zone-boot-milestone

Specifies the milestone the zone must reach to be considered successfully booted. This option is used for the solaris, solaris10, and solaris-kz brand type. You must specify a value for this keyword if you set the Zonebrand option to solaris, solaris10, or solaris-kz.

LXrunlevel=linux-runlevel

This option was used on Oracle Solaris 10 and is now deprecated. Any value for this keyword is ignored.

SLrunlevel=solaris-legacy-runlevel

This option was used on Oracle Solaris 10 and is now deprecated. Any value for this keyword is ignored.

Migrationtype=cold|warm|live

Specifies the type of migration that must be used for the configured kernel zone. Values for Migrationtype can be either cold, warm, or live. This option is only used with the solaris-kz brand of zone.

With Migrationtype=cold, when the resource group performs a failover, the kernel zone is shut down on the current running node and freshly booted on the new node.
With Migrationtype=warm, when the resource group performs a failover, the kernel zone is suspended on the current running node and booted from the suspended image on the new node.
With Migrationtype=live, when the resource group performs a switchover, the kernel zone is live migrated to the new node.

Mounts=list-of-mountpoints

Specifies a space separated list of directories with their mount options, which will automatically get lofs mounted from the global zone into the booted zone. The mount point used in the global zone can be different to the mount point in the booted zone. Specifying a value for this keyword is optional.

The Mounts keyword format is as follows:

Mounts="/global-zone-dir:/local-zone-dir:mount-options <next entry>"

While mount-options can be a comma separated list of file system mount options.

The only required entry when setting this keyword is the /global-zone-dir part of the colon separated variable. The /local-zone-dir and mount-options part can be omitted.

Omitting the /local-zone-dir part will make the zone's mount point the same as the global zone directory.

Omitting the mount-options part will not provide any mount options except the default options from the mount command.

Note - If you are omitting the /local-zone-dir or the mount-options, you must also omit the “:” as delimiter.

Note - You must manually create any mount point directories within the booted zone that will be used within the Mounts keyword, before registering this resource within Oracle Solaris Cluster.

Note - If the file system of the source mount point in the global zone is mounted by a SUNW.HAStoragePlus resource, you must specify a strong resource dependency from the sczbt resource to this SUNW.HAStoragePlus resource.

Example 1 Sample sczbt_config File

This example shows an sczbt_config file in which configuration parameters are set as follows:

The name of the zone boot resource is zone1-rs.
The name of the resource group for the zone boot resource is zone1-rg.
Indicates that the zone's address is managed by a SUNW.LogicalHostName resource and is true.
The name of the SUNW.LogicalHostName resource name for the zone boot resource is zone1-lh.
Indicates that the zone boot resource's zone path is managed by a SUNW.LogicalHostName resource and is true.
The name of the SUNW.HAStoragePlus resource name for the zone boot resource is zone1-has.
The name of the zone is zone1.
The brand type of the zone is solaris.
Indicates that the zone boot resource`s boot option is null.
Indicates that the zone boot resource`s milestone is multi-user-server.
Defines that /global/app/bin from the global zone gets mounted read-only within zone zone1 under mount point /app/bin.
Defines that /app/data from the global zone gets mounted read-write within zone zone1 under mount point /app/data.
Defines that /logs from the global zone gets mounted with default mount options within zone zone1 under mount point /logs.
Defines that cold migration is performed for the zone.

RS=zone1-rs
RG=zone1-rg
PARAMETERDIR=
SC_NETWORK=true
SC_LH=zone1-lh
FAILOVER=true
HAS_RS=zone1-has
Zonename=zone1
Zonebrand=solaris
Zonebootopt=
Milestone=multi-user-server
Mounts="/global/app/bin:/app/bin:ro /app/data:rw /logs"
Migrationtype=cold