How to Update the Software (Rolling Update)

Language:

Perform this procedure to update to Oracle Solaris Cluster 4.4 software or to an Oracle Solaris Cluster 4.4 SRU while the remaining cluster nodes are in cluster mode.

Note - Until all nodes of the cluster are updated and the update is committed, new features that are introduced by the new release might not be available.

Before You Begin

If you have failover zones of brand type solaris configured on the cluster, you must perform additional steps. Follow the instructions in How to Update a solaris Branded Failover Zone before you begin this procedure.
If you have a solaris10 brand zone in a zone cluster, follow the instructions in Upgrading a solaris10 Branded Zone in a Zone Cluster.
If you have configured immutable zone clusters, reboot the node you are updating with the .clzonecluster reboot -n <node-updating> -w <zone-cluster-name> command before you start the update to ensure that any write operations are allowed when installing or applying maintenance. After the upgrade has finished on that node, the subsequent reboot into the new boot environment ensures that the immutable zone cluster node is no longer in write mode. To update packages inside the zone-cluster see Administering an Immutable Zone Cluster by Making It Writable in Administering an Oracle Solaris Cluster 4.4 Configuration

Assume the root role or become an administrator with solaris.cluster.admin RBAC authorization on the node of the cluster you want to update.
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.

Run the update on the node you want to update.
If you are updating a failover zone, follow the instructions in How to Update a solaris Branded Failover Zone.
- To use the command line, perform the following:
```
# scinstall -u update [-b bename | -R mounted-be-path] [-L accept,licenses]
```
  - You can choose to specify a name for the new boot environment with the -b bename option, or specify a mounted boot environment with the -R mounted-be-path option. You cannot use both options in the same command.
  - If you specify the -L accept,licenses option, the command accepts and displays the licenses of the packages you update.
  See the scinstall (8) man page for more information about these options.
- To use the interactive scinstall utility, perform the following:
  1. Start the scinstall utility.
```
phys-schost# scinstall
```
    The scinstall Main Menu is displayed.
  2. Choose the Update This Cluster menu item.
    The Update Menu is displayed.
  3. If you are updating a global-cluster node, follow the menu prompts to update the cluster framework, data service agents, or underlying OS.
    If you are updating a zone cluster node, follow the menu prompts to update the cluster framework, data service agents, or Oracle RAC for this node.
    
    Update processing is finished when the system displays the message Completed Oracle Solaris Cluster framework update and prompts you to press Enter to continue.
  4. Quit the scinstall utility.
As needed, update other applications that support alternate boot environments.
Boot the node into the new boot environment.
- If you need to update any applications that do not support alternate boot environments, boot into the new boot environment in noncluster mode, update your applications, then reboot the node into cluster mode.
  - On SPARC based systems, run the following command to boot the node into non-cluster mode.
```
# shutdown -g0 -i0 -y
ok> boot -x
```
  - On x86 based systems, run the following commands to boot the node into non-cluster mode.
    1. In the GRUB menu, use the arrow keys to select the appropriate Oracle Solaris entry and type e to edit its commands.
      The GRUB menu appears.
      
      For more information about GRUB based booting, see Chapter 4, Booting a System 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.
      The GRUB boot parameters screen appears.
    3. Add -x to the command to specify system boot in noncluster mode.
```
[ Minimal BASH-like line editing is supported. For the first word, TAB
lists possible command completions. Anywhere else TAB lists the possible
completions of a device/filename. ESC at any time exits. ]

grub edit> kernel$ /platform/i86pc/kernel/$ISADIR/unix -B $ZFS-BOOTFS -x
```
    4. Press the Enter key 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 again to add the -x option to the kernel boot parameter command.
- Boot the node into the new boot environment.
```
# shutdown -g0 -i0 -y
ok> boot
```
Ensure that the updated node comes up without any problems.
```
# svcs -x
```
Resolve any problems reported by Oralce Solaris services.
Starting with How to Prepare a Cluster Node for Update (Rolling Update), repeat all the steps on each remaining node you want to update, one at a time.

Next Steps

When all nodes in the cluster are updated, go to Completing the Update.