1. Installation and Configuration Guide for Exadata Database Machine
  2. OEDA Command Line Interface
  3. OEDACLI Command Reference
  4. CLUSTER
  5. UPGRADE CLUSTER

4.3.5.7 UPGRADE CLUSTER

Use this command upgrade an Oracle Grid Infrastructure cluster.

Syntax

UPGRADE 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: 12.1.0.2.170418

  • 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 upgrade step:

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

Usage Notes

  • The command can only upgrade a cluster in a VM deployment. You cannot use this command to upgrade 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 in conjunction with the UPGRADE CLUSTER command, you cannot later use the DOWNGRADE CLUSTER command to roll back the upgrade.

Example 4-10 Using the UPGRADE CLUSTER Command

This example shows the first three steps (ADD_HOME, CONFIG_HOME, and RUN_ROOTSCRIPT) in a step-by-step cluster upgrade. At the end of this example, the cluster is upgraded, but downgrade is still possible because the DELETE_OLDHOME step has not been run. 

oedacli> upgrade cluster giversion=18.13.0.0.210119 gihomeloc=/u01/app/18.13.0.0/grid where clusternumber=1 stepname=add_home
oedacli> save action
oedacli> merge actions
 processMerge
 processMergeActions
 Merging Action : upgrade cluster giversion=18.13.0.0.210119 gihomeloc=/u01/app/18.13.0.0/grid where clusternumber=1 stepname=add_home
 Merging UPGRADE CLUSTER
 Action Validated and Merged OK
oedacli> deploy actions
 Deploying Action ID : 1 upgrade cluster giversion=18.13.0.0.210119 gihomeloc=/u01/app/18.13.0.0/grid where clusternumber=1 stepname=add_home
 Deploying UPGRADE CLUSTER
 Upgrading Cluster
 Performing Upgrade Validations...
 Validating target Clusterware version 18.13.0.0...
 Validating source Clusterware version 12.2.0.1.190115...
 Checking Cluster status...
 Checking status of cluster...
 Active cluster version on cluster ovmClus8 is 12.2.0.1.0
 Validating Target Clusterware Home.. /u01/app/18.13.0.0/grid
 Checking to see if /u01/app/18.13.0.0/grid is already mounted
 SUCCESS: 18.13.0.0 is supported version for upgrade.
 SUCCESS: Current Cluster Version 12.2.0.1.190115 is supported for Upgrade using this Utility.
 SUCCESS: 
 SUCCESS: Required Image Version 21.2.0.0.0 for Oracle18c found on dbm01adm01vm08
 SUCCESS: Required Image Version 21.2.0.0.0 for Oracle18c found on dbm01adm02vm08
 SUCCESS: Cluster verification completed successfully
 SUCCESS: Find the valid upgrading version from 12.2.0.1 to 18.13.0.0
 SUCCESS: Target Cluster Version is valid..
 SUCCESS: Target Clusterware Home /u01/app/18.13.0.0/grid is not already mounted.
 SUCCESS: Found valid target clusterware version.
 SUCCESS: Valid Bundle Patch / RU Version found.
 Validating required files...
 Extracting files..
 Copying files...
 Creating new disk image file..
 Attaching disk image to Virtual Machine dbm01adm01vm08.example.com
 Attaching disk image to Virtual Machine dbm01adm02vm08.example.com
 Completed adding new Clusterware home /u01/app/18.13.0.0/grid on  Cluster  ovmClus8
 Done...
 Done
oedacli> upgrade cluster giversion=18.13.0.0.210119 gihomeloc=/u01/app/18.13.0.0/grid where clusternumber=1 stepname=config_home
oedacli> save action
oedacli> merge actions
 processMerge
 processMergeActions
 Merging Action : upgrade cluster giversion=18.13.0.0.210119 gihomeloc=/u01/app/18.13.0.0/grid where clusternumber=1 stepname=config_home
 Merging UPGRADE CLUSTER
 Action Validated and Merged OK
oedacli> deploy actions
 Deploying Action ID : 2 upgrade cluster giversion=18.13.0.0.210119 gihomeloc=/u01/app/18.13.0.0/grid where clusternumber=1 stepname=config_home
 Deploying UPGRADE CLUSTER
 Upgrading Cluster
 Configuring new clusterware home at /u01/app/18.13.0.0/grid
 Running Cluster Verification Utility for upgrade readiness..
 Pre-upgrade Validation completed successfully.
 Setting up new clusterware home...
 Relinking binaries with RDS /u01/app/18.13.0.0/grid
 Upgrading software..
 Completed configuring new Clusterware home /u01/app/18.13.0.0/grid
 Done...
 Done
oedacli> upgrade cluster giversion=18.13.0.0.210119 gihomeloc=/u01/app/18.13.0.0/grid where clusternumber=1 stepname=RUN_ROOTSCRIPT
oedacli> save action
oedacli> merge actions
 processMerge
 processMergeActions
 Merging Action : upgrade cluster giversion=18.13.0.0.210119 gihomeloc=/u01/app/18.13.0.0/grid where clusternumber=1 stepname=RUN_ROOTSCRIPT
 Merging UPGRADE CLUSTER
 Action Validated and Merged OK
oedacli> deploy actions
 Deploying Action ID : 3 upgrade cluster giversion=18.13.0.0.210119 gihomeloc=/u01/app/18.13.0.0/grid where clusternumber=1 stepname=RUN_ROOTSCRIPT
 Deploying UPGRADE CLUSTER
 Upgrading Cluster
 Running Cluster Verification Utility for upgrade readiness..
 Pre-upgrade Validation completed successfully.
 Running rootupgrade.sh on node dbm01adm01vm08.example.com
 Checking file root_dbm01adm01vm08.example.com_2021-05-07_16-35-47-279774287.log on node dbm01adm01vm08.example.com
 Checking status of cluster on dbm01adm01vm08.example.com
 Running rootupgrade.sh on node dbm01adm02vm08.example.com
 Checking file root_dbm01adm02vm08.example.com_2021-05-07_16-55-09-777507261.log on node dbm01adm02vm08.example.com
 Checking status of cluster on dbm01adm02vm08.example.com
 Running Configuration Assistants on dbm01adm01vm08.example.com
 Active cluster version after upgrade 18.0.0.0.0
 Clusterware successfully upgraded to 18.13.0.0.210119
 Applying Security Fixes...
 Done...
 Done

Parent topic: CLUSTER