How to Update the Software (Dual-Partition)

Language:

Perform this procedure to update each node of the cluster to Oracle Solaris Cluster 4.4 software and, if necessary, update the Oracle Solaris software. You must also perform this procedure if you only updated to a different marketing release of the Oracle Solaris OS, such as from Oracle Solaris 11.3 to Oracle Solaris 11.4 software.

Note - If you intend to update failover zones, do not use the dual-partition update method. Instead, use the standard update or rolling update method.

Perform all steps from the global zone only.

Before You Begin

Perform the following tasks:

Ensure that all steps in How to Prepare the Cluster for Update (Dual-Partition) are completed.
Ensure that the node you are updating belongs to the partition that is not active in the cluster and that the node is in noncluster mode.
For immutable zone clusters, ensure that on each node of the partition you are updating, you reboot the immutable zone cluster's zone (on that node) to writable mode using the following command:
```
. zoneadm -z <zonecluster name> reboot -w
```
When the partition nodes are rebooted the immutable zone-cluster nodes will boot back to read-only mode.

Tip - You can use the pconsole utility to perform this procedure on multiple nodes simultaneously. See the pconsole(1) man page that is installed with the terminal/pconsole package for more information.

Assume the root role on a node that is a member of the partition that is in noncluster mode.
Subscribe to the ha-cluster publisher that contains the software you want to update to.
```
# pkg set-publisher -p URL_for_ha-cluster_repository
```

Ensure that the solaris publisher is valid.

# pkg publisher
PUBLISHER                           TYPE     STATUS   P  LOCATION
solaris                             origin   online   F  ha-cluster-repository
solaris                             origin   online   F  solaris-repository
ha-cluster                          origin   online   F  ha-cluster-repository

For information about setting the solaris publisher, see Adding, Modifying, or Removing Package Publishers in Updating Systems and Adding Software in Oracle Solaris 11.4.

Start the scinstall utility.
```
phys-schost# scinstall
```
The scinstall Main Menu is displayed.
Choose the menu item, Update This Cluster Node.
The Update Menu is displayed.
Follow the menu prompts to update the cluster framework.
Update processing is finished when the system displays the message Completed Oracle Solaris Cluster framework update and prompts you to press Enter to continue.
Quit the scinstall utility.
If you have HA for NFS configured on a highly available local file system, ensure that the loopback file system (LOFS) is disabled.
Note - If you have non-global zones configured, LOFS must remain enabled. For guidelines about using LOFS and alternatives to disabling it, see Planning Cluster File Systems in Installing and Configuring an Oracle Solaris Cluster 4.4 Environment.

To disable LOFS, ensure that the /etc/system file contains the following entry:
```
exclude:lofs
```
This change becomes effective at the next system reboot.
As needed, manually update any custom data services that are not supplied on the product media.
Verify that each data-service update is installed successfully.
View the update log file that is referenced at the end of the update output messages.
Install any Oracle Solaris Cluster 4.4 framework and data-service software updates.
For instructions on updating your software, see Overview of the Installation and Configuration Process in Planning and Administering Data Services for Oracle Solaris Cluster 4.4.
Update software applications that are installed on the cluster.
Ensure that application levels are compatible with the current versions of Oracle Solaris Cluster and Oracle Solaris software. See your application documentation for installation instructions.

Note - If any update procedure instructs you to perform a reboot, you must add the –x option to the boot command. This option boots the cluster into noncluster mode.
Repeat all steps in this procedure up to this point on all remaining nodes that you need to update in the partition.

After all nodes in a partition are updated, apply the update changes.

From one node in the partition that you are updating, start the interactive scinstall utility.
```
phys-schost# scinstall
```
The scinstall Main Menu is displayed.
Type option number for Apply Dual-Partition Update Changes to the Partition.

Follow the prompts to continue each stage of the update processing.

The command performs the following tasks, depending on which partition the command is run from:

First partition - The command halts each node in the second partition, one node at a time. When a node in the second partition is halted, any services on that node are automatically switched over to a node in the first partition, provided that the node list of the related resource group contains a node in the first partition. After all nodes in the second partition are halted, the nodes in the first partition are booted into cluster mode and take over providing cluster services.

Caution - Do not reboot any node of the first partition again until after the update is completed on all nodes. If you again reboot a node of the first partition before the second partition is updated and rebooted into the cluster, the update might fail in an unrecoverable state.

Second partition - The command boots the nodes in the second partition into cluster mode, to join the active cluster that was formed by the first partition. After all nodes have rejoined the cluster, the command performs final processing and reports on the status of the update.

Exit the scinstall utility, if it is still running.

If you are finishing update of the first partition, perform the following substeps to prepare the second partition for update.
Otherwise, if you are finishing update of the second partition, proceed to Step 16.
1. Boot each node in the second partition into noncluster mode.
  - SPARC:
```
ok boot -x
```
  - x86:
    1. In the GRUB menu, use the arrow keys to select the appropriate Oracle Solaris entry and type e to edit its commands.
      For more information about GRUB based booting, see About Run Level Booting in Booting and Shutting Down Oracle Solaris 11.4 Systems.
    2. In the boot parameters screen, use the arrow keys to select the kernel entry and type e to edit the entry.
    3. Add -x to the multiboot command to specify that the system boot into noncluster mode.
    4. Press Enter to accept the change and return to the boot parameters screen.
      The screen displays the edited command.
    5. Type b to boot the node into noncluster mode.
      Note - This change to the kernel boot parameter command does not persist over the system boot. The next time you reboot the node, it will boot into cluster mode. To boot into noncluster mode instead, perform these steps to again add the –x option to the kernel boot parameter command.
2. Update the nodes in the second partition.
  Return to Step 1.

If you changed the RG_system property of any resource groups to FALSE, change the settings back to TRUE.
```
phys-schost# clresourcegroup set -p RG_system=TRUE resourcegroup
```

Next Steps

Go to Completing the Update.

Troubleshooting

If you experience an unrecoverable error during dual-partition update, perform recovery procedures in How to Recover from a Failed Dual-Partition Update.