Go to main content

Updating Your Oracle® Solaris Cluster 4.4 Environment

Exit Print View

Updated: March 2019

How to Finish the Update

Perform this procedure to finish Oracle Solaris Cluster update. Perform all steps from the global zone only.

Before You Begin

Ensure that all steps in How to Verify the Update are completed.

  1. If you updated any data services that are not supplied on the product media, register the new resource types for those data services.

    Follow the documentation that accompanies the data services.

  2. If necessary, reset the resource_security property.

    After update, the resource_security property for the cluster is reset to COMPATIBLE. To use a different security policy for RGM resources, run the following command from one node of the cluster:

    phys-schost# cluster set -p resource_security=policy clustername

    You can alternatively use the clsetup utility from the Other Cluster Tasks menu option. For more information about the resource_security property, see the cluster(8CL) man page.

  3. Migrate resources to new resource type versions.

    You must migrate all resources to the Oracle Solaris Cluster 4.4 resource-type version to use the new features and bug fixes that are provided in this release.

    See Upgrading a Resource Type in Planning and Administering Data Services for Oracle Solaris Cluster 4.4, which contains procedures which use the command line. Alternatively, you can perform the same tasks by using the Resource Group menu of the clsetup utility. The process involves performing the following tasks:

    • Registering the new resource type.

    • Migrating the eligible resource to the new version of its resource type.

    • Modifying the extension properties of the resource type.

      Note -  The Oracle Solaris Cluster 4.4 release might introduce new default values for some extension properties. These changes affect the behavior of any existing resource that uses the default values of such properties. If you require the previous default value for a resource, modify the migrated resource to set the property to the previous default value.
  4. In the global zone, re-enable all disabled resources and bring online all resource groups.
    • To use the clsetup utility, perform the following steps:
      1. From any node, start the clsetup utility.
        phys-schost# clsetup

        The clsetup Main Menu is displayed.

      2. Choose the menu item, Resource Groups.

        The Resource Group Menu is displayed.

      3. Choose the menu item, Enable/Disable a Resource.
      4. Choose a resource to enable and follow the prompts.

        Repeat for each disabled resource.

      5. When all resources are re-enabled, type q to return to the Resource Group Menu.
      6. Choose the menu item, Online/Offline or Switchover a Resource Group.
      7. Follow the prompts to put each resource group into the managed state and then bring the resource group online.
      8. When all resource groups are back online, exit the clsetup utility.

        Type q to back out of each submenu, or press Ctrl-C.

    • To use the command line, perform the following steps:
      1. Enable each disabled resource.
        # clresource enable resource
      2. Verify that each resource is enabled.
        # clresource status
      3. Bring online each resource group.
        # clresourcegroup online -emM resourcegroup
      4. Verify that each resource group is online.
        # clresourcegroup status
  5. If zone clusters are configured in the cluster, in each zone cluster re-enable all disabled resources and bring online all resource groups.
    # clresourcegroup online -Z zonecluster resource-group
    # clresource enable -Z zonecluster resource
    # clresourcegroup online -eM -Z zonecluster resource-group
  6. If, before update, you enabled automatic node reboot if all monitored shared-disk paths fail, ensure that the feature is still enabled.

    Also perform this task if you want to configure automatic reboot for the first time.

    1. Determine whether the automatic reboot feature is enabled or disabled.
      phys-schost# clnode show
      • If the reboot_on_path_failure property is set to enabled, no further action is necessary.
      • If reboot_on_path_failure property is set to disabled, proceed to the next step to re-enable the property.
  7. Enable the automatic reboot feature.
    phys-schost# clnode set -p reboot_on_path_failure=enabled node

    Specifies the property to set


    Specifies that the node will reboot if all monitored disk paths fail, provided that at least one of the disks is accessible from a different node in the cluster.

  8. Verify that automatic reboot on disk-path failure is enabled.
    phys-schost# clnode show
    === Cluster Nodes ===
    Node Name:                                      node
    reboot_on_path_failure:                          enabled
  9. Revalidate the updated cluster configuration.

    See How to Validate the Cluster in Installing and Configuring an Oracle Solaris Cluster 4.4 Environment.

  10. (Optional)Capture the ZFS root pool property information for future reference.
    phys-schost# zpool get all rootpool > filename

    Store the file in a location outside the cluster. If you make any root pool configuration changes, run this command again to capture the changed configuration. If necessary, you can use this information to restore the root pool partition configuration. For more information, see the zpool(8) man page.

  11. (Optional) Make a backup of your cluster configuration.

    An archived backup of your cluster configuration facilitates easier recovery of your cluster configuration.

    For more information, see How to Back Up the Cluster Configuration in Administering an Oracle Solaris Cluster 4.4 Configuration.


Resource type migration failure - Normally, you migrate resources to a new resource type while the resource is offline. However, some resources need to be online for a resource-type migration to succeed. If resource-type migration fails for this reason, error messages similar to the following are displayed:

phys-schost - Resource depends on a SUNW.HAStoragePlus type resource that is not online anywhere.

(C189917) VALIDATE on resource nfsrs, resource group rg, exited with non-zero exit status.

(C720144) Validation of resource nfsrs in resource group rg on node phys-schost failed.

If resource-type migration fails because the resource is offline, use the clsetup utility to re-enable the resource and then bring its related resource group online. Then repeat migration procedures for the resource.

Java version change - Only Java 8 is supported with Oracle Solaris Cluster 4.4 software. Running a Java version that is earlier or later than 8 might cause unexpected behavior. If necessary, use the following command to reset the Java version to 8:

phys-schost# pkg set-mediator -V 8 java

Java binaries location change - If the location of the Java binaries changed during the update of Oracle Solaris software, you might see error messages similar to the following when you attempt to run the /usr/sbin/cacaoadm start command:

No suitable Java runtime found. Java 1.7 or higher is required.

Jan 3 17:10:26 ppups3 cacao: No suitable Java runtime found. Java 1.7 or higher is required.

Cannot locate all the dependencies.

This error is generated because the start command cannot locate the current location of the Java binaries. The JAVA_HOME property still points to the directory where the previous version of Java was located, but that previous version was removed during update.

To correct this problem, change the setting of JAVA_HOME in the /etc/opt/SUNWcacao/cacao.properties configuration file to use the current Java directory:

Next Steps

The cluster update is complete.