4.3.5.7 UPDATE CLUSTER

Use this command to update an Oracle Grid Infrastructure cluster, but only within the same major release.

Syntax

UPDATE CLUSTER
   GIVERSION=Grid_relnum
   GIHOMELOC=Grid_home_dir
WHERE 
   { CLUSTERNAME=cluster_name [ STEPNAME=step_name ] | 
     CLUSTERNUMBER=cluster_number [ STEPNAME=step_name ] | 
     ID=cluster_id [ STEPNAME=step_name ] }

Arguments

  • GIVERSION: The version of the Oracle Grid Infrastructure software you are upgrading to, including the release update (RU). For example, 19.26.0.0.250121. The minimum version supported by the command is 19.15.0.0.220419.

  • GIHOMELOC: The target location of the Oracle Grid Infrastructure home directory

The following arguments are available in the WHERE clause:

  • CLUSTERNUMBER: Specifies the cluster number in the es.xml, starting at 1

  • CLUSTERNAME: Specifies the name of the cluster

  • ID: Specifies the es.xml ID of the cluster

  • STEPNAME : Optionally, specifies the individual update step:

    1. ADD_HOME
    2. CONFIG_HOME
    3. RUN_ROOTSCRIPT
    4. DELETE_OLDHOME

Usage Notes

  • The command can only update a cluster to a later version within the same major release. For example, upgrading from Oracle Grid Infrastructure release 19c version 19.15 to version 19.21.

  • The command can only update a cluster in a VM deployment. You cannot use this command to update the cluster in a physical (bare-metal) deployment.

  • If STEPNAME is not specified, then the ADD_HOME and CONFIG_HOME steps are performed.

  • The RUN_ROOTSCRIPT step runs the rootupgrade.sh script sequentially in a rolling mode on all nodes. This step also restarts the database instances on each of the nodes.

  • After you run the DELETE_OLDHOME step, you cannot later use the DOWNGRADE CLUSTER command to roll back the update.

Parent topic: CLUSTER