How to Prepare a Cluster Node for Update (Rolling Update)

Language:

Perform this procedure on one node at a time. You will take the updated node out of the cluster while the remaining nodes continue to function as active cluster members.

Before You Begin

Perform the following tasks:

Ensure that the configuration meets requirements for update. See Updating to a New Oracle Solaris Cluster Version.
Have available the installation media, documentation, and updates for all the software products that you are updating, including the following software:
- Oracle Solaris OS
- Oracle Solaris Cluster
- Applications that are managed by Oracle Solaris Cluster 4.4 data service agents
- Any other third-party applications to update
For instructions about updating single or multiple packages, see How to Update the Software (Rolling Update).

Ensure that the cluster is functioning normally.
1. View the current status of the cluster by running the following command from any node.
```
phys-schost% cluster status
```
  See the cluster(8CL) man page for more information.
2. Search the /var/adm/messages log on the same node for unresolved error messages or warning messages.
3. Check the volume-manager status.
If necessary, notify users that cluster services might be temporarily interrupted during the update.
Service interruption will be approximately the amount of time that your cluster normally takes to switch services to another node.
Assume the root role on a node of the cluster.
Evacuate resource groups and device groups from the node, except those used by failover zones on the node.
- If the node is configured with failover zones, suspend the resource groups used by the failover zones and evacuate all other resource groups and device groups on the node.
  Failover zones refers to solaris brand zones that are configured with the HA for Oracle Solaris Zones data service.
```
# clresourcegroup suspend <failover-zone-resource-group-list>
# clresourcegroup evacuate -n node-to-evacuate 
# cldevicegroup switch -n backup-node device-group device-group-list
```
  Alternatively, you can use the clnode evacuate command to evacuate all resource groups and device groups from the node, then use the clresourcegroup switch command to move back to the node you will update only those resource groups that are used by a failover zone. See the clresourcegroup(8CL) and clnode(8CL) man pages for more information.
  
  For more information about failover zones, see Updating Solaris Branded Failover Zones.
- If there are no failover zones configured on the node, evacuate all resource groups and device groups on the node.
  Note - Do not use this command if failover zones are configured on the node. If a resource group that is used by a failover zone is evacuated from the node, even though the resource group is suspended, the evacuate operation will take the resource group offline.
```
phys-schost# clnode evacuate node-to-evacuate
```
  See the clnode(8CL) man page for more information.
Evacuate any resource groups that are running in a zone-cluster node that is on the node to update.
```
phys-schost# clresourcegroup evacuate -n zone-cluster-node -Z zone-cluster-name +
```

Verify that the move was completed successfully.

phys-schost# cldg status;clrg status -Z all;clrs status -Z all

Ensure that the system disk, applications, and all data are backed up.

Next Steps

Go to How to Update the Software (Rolling Update).