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.