How to Prepare the Cluster for an Upgrade or Software Update

Language:

On the cluster you are upgrading or updating, remove the Geographic Edition layer from production. Perform all steps from the global zone only.

Before You Begin

Perform the following tasks:

Ensure that the configuration meets the requirements for the upgrade. See Upgrade and Update Requirements and Software Support Guidelines.
Have available the installation media or the IPS publisher configured, documentation, and software updates for all software products that you are upgrading, including Oracle Solaris OS, Oracle Solaris Cluster software, and Geographic Edition 4.3 software.
Ensure that you have installed all the required software updates for your cluster configuration on each node of the cluster before you start upgrading the software.
If you are installing a software update, ensure that you have read the README file for each software update you will install.

Ensure that the cluster is functioning properly.
1. From any node, view the current status of the cluster.
```
% cluster status
```
  See the cluster(1CL) man page for more information.
2. Search the /var/adm/messages log on the same node for unresolved error messages or warning messages.
Assume the root role on a node of the cluster.
Remove all application resource groups from protection groups.
Highly available applications do not have downtime during the Geographic Edition software upgrade or update. This step ensures that resource groups are not stopped when you later stop the protection groups.
```
# geopg remove-resource-group resource-group protection-group
```
See the geopg(1M) man page for more information.
Stop all protection groups that are active on the cluster.
```
# geopg stop -e local protection-group
```
See the geopg(1M) man page for more information.
Stop the Geographic Edition framework.
Stopping the Geographic Edition framework ensures that a software upgrade or update on one cluster does not affect the other cluster in the partnership.
```
# geoadm stop
```
See the geoadm(1M) man page for more information.
On each node, stop the common agent container.
```
# /usr/sbin/cacaoadm stop
```

Next Steps

Upgrade or update the Geographic Edition software on the cluster. Go to How to Upgrade or Update Geographic Edition Software.