Go to main content

Updating Your Oracle® Solaris Cluster 4.4 Environment

Exit Print View

Updated: March 2019

How to Update the Software (Rolling Update)

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

  1. Assume the root role or become an administrator with solaris.cluster.admin RBAC authorization on the node of the cluster you want to update.
  2. Subscribe to the ha-cluster publisher that contains the software you want to update to.
    # pkg set-publisher -p URL_for_ha-cluster_repository
  3. 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.

  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.
  5. As needed, update other applications that support alternate boot environments.
  6. 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
  7. Ensure that the updated node comes up without any problems.
    # svcs -x

    Resolve any problems reported by Oralce Solaris services.

  8. 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.