How to Upgrade a Failover Zone

Language:

Note - This task does not apply to solaris10 brand failover zones. To manage packages and patches in a solaris10 brand failover zone, follow normal Oracle Solaris 10 Zone procedures. See Creating and using Oracle Solaris 10 Zones .

Identify which resource groups that manage a failover zone of brand type solaris are online.
```
# clresourcegroup status
```
Make a record for later reference of the online resource groups and on which cluster node each resource group is online.

Identify the resource name for the sczbt components that manage the failover zone.
Do this for each resource group that you identified in Step 1.
```
# clresource status -g resource-group
```
Make a record for later reference of the resource names.
Suspend each online resource group that manages a failover zone of brand type solaris.
```
# clresourcegroup suspend resource-group
```
The resource groups remain online but they are prevented from failing the zones over during upgrade. While in this state, the resource groups are also prevented from automatically rebooting the zones when the nodes are rebooted after upgrade. The failover zone will be upgraded together with the node on which it is currently online.

Perform the standard or rolling upgrade on the nodes.
Perform all steps, including booting into the new boot environment, in How to Upgrade the Software (Standard Upgrade) or How to Upgrade the Software (Rolling Upgrade). Then return to this procedure.
Disable each scbzt resource that you recorded in Step 2.
```
# clresource disable sczbt-resource
```
Disabling this resource ensures that the resource does not time out if the first boot of the upgraded zone takes more time than the resource's Start_timeout allows.

For each resource group that you recorded in Step 1. bring the resource group online on the same node where it was online during the upgrade.
```
# clresourcegroup online -n node resource-group
```
The updated failover zones are currently only associated with the global zone boot environment, where they were upgraded, and can only successfully boot there.
Attach and boot the failover zone.
Do this for each zone that is managed by an sczbt resource that you identified in Step 2.
```
# zoneadm -z zone-name attach
# zoneadm -z zone-name boot
```
Verify the zone console.
Do this for each zone that is managed by an sczbt resource that you identified in Step 2.
```
# zlogin -C zone-name
```
Shut down and forcibly detach the failover zone.
Do this for each zone that is managed by an sczbt resource that you identified in Step 2.
```
# zoneadm -z zone-name shutdown
# zoneadm -z zone-name detach -F
```
Enable each sczbt resource.
Do this for each zone that is managed by an sczbt resource that you identified in Step 2.
```
# clresource enable sczbt-resource
```
Synchronize the universally unique IDs (UUID) of the updated boot environments.
Note - If you are using the Oracle Solaris 11.2 OS, this step is optional.
- If you omit this step, at failover of a solaris brand zone, the last zone boot environment that was booted is first cloned and then activated on the node.
- If you perform this step, at failover of a solaris brand zone, the last zone boot environment that was booted is activated on the node without first creating a clone.
1. Determine the UUID of the updated boot-environment root dataset of one upgraded node.
```
phys-schost-1# /opt/SUNWsczone/sczbt/util/ha-solaris-zone-boot-env-id get [-b bename]
UUID
```
  -b bename
  
  Specifies the boot environment from which to retrieve the UUID.
  
  UUID
  
  The UUID of the specified boot environment.
  
  The ha-solaris-zone-boot-env-id get command output displays the UUID, similar to the following:
```
8fe53702-16c3-eb21-ed85-d19af92c6bbd
```
  This UUID will be used in the next steps as the reference UUID for all other upgraded cluster nodes.
2. Set the reference UUID in Step aon the updated boot environment for the other upgraded nodes.
```
phys-schost-N# /opt/SUNWsczone/sczbt/util/ha-solaris-zone-boot-env-id set [-b bename] UUID
```
  -b bename
  
  Specifies the boot environment in which to define the specified UUID.
  
  UUID
  
  The reference UUID that you obtained in Step a.
Resume each resource group that you brought online in Step 6.
```
# clresourcegroup resume resource-group
```

Next Steps

Go to Chapter 6, Completing the Upgrade.