8 Deinstallation of Oracle Clusterware

This chapter describes how to remove Oracle Clusterware.

This chapter contains the following topics:

See Also:

Product-specific documentation for requirements and restrictions, if you want to remove an individual product

8.1 Deciding When to Deinstall Oracle Clusterware

Remove installed components in the following situations:

  • You have encountered errors during or after installing or upgrading Oracle Clusterware, and you want to re-attempt an installation.

  • Your installation or upgrade stopped because of a hardware or operating system failure.

  • You are advised by Oracle Support to reinstall Oracle Clusterware.

  • You have successfully installed Oracle Clusterware, and you want to remove the Clusterware installation, either in an educational environment, or a test environment.

  • You have successfully installed Oracle Clusterware, but you want to downgrade to a previous release.

8.2 Relocating Single-instance ASM to a Single-Instance Database Home

If you have a single-instance Oracle Database on Oracle Clusterware, and you want to remove Oracle Clusterware, then use the following syntax to add the local CSS configuration to the ASM home:

ASM_home/bin/localconfig add

For example:

$ cd /u01/app/asm/bin/
$ ./localconfig add

8.3 Removing Oracle Clusterware

The scripts rootdelete.sh and rootdeinstall.sh remove Oracle Clusterware from your system. After running these scripts, run Oracle Universal Installer to remove the Oracle Clusterware home. The following sections describe the scripts, and later, provide exact procedure to the removal of the Oracle Clusterware software.

8.3.1 About the rootdelete.sh Script

The rootdelete.sh script should be run from the Oracle Clusterware home on each node. It stops the Oracle Clusterware stack, removes inittab entries, and deletes some of the Oracle Clusterware files. It can also be used to downgrade the Oracle Cluster Registry from the existing release to a previous release. The script uses the following syntax:

# rootdelete.sh options

Options:

  • paramfile: Use a parameter file containing configuration information for the rootdelete.sh command. Provide the path and name of the parameter file. For example: -paramfile /usr/oracle/cwdeletepar.

  • local|remote: Use local if you are running rootdelete.sh on the local node, and use remote if you are running the script on one of the other nodes. The local node is the one from which you run OUI (in other words, the last surviving node), and on which you run rootdeinstall.sh.

  • nosharedvar|sharedvar: Use nosharedvar if the directory path for ocr.loc (in /etc/oracle or /var/opt/oracle) is not on a shared file system. Use sharedvar if the directory path for ocr.loc is in a shared location. The default is nosharedvar.

  • sharedhome|nosharedhome: Use sharedhome if the Oracle Clusterware home is shared across the nodes. Otherwise, use nosharedhome. The default is sharedhome.

  • downgrade: Use this option if the Oracle Clusterware is downgraded to a previous Oracle Clusterware version. The -downgrade option takes the following flags:

    • -version: Use this option to specify the version to which you want to downgrade. The default is 10.2.

    • -force: Use this option to force cleanup of root configuration

For example, to run the rootdelete.sh script from an Oracle Clusterware home in the path /u01/app/crs, where you are running the script on a remote node, and the ocr.loc file is in /etc/oracle on each node, enter the following command:

# cd /u01/app/crs/install/
# ./rootdelete.sh remote nosharedvar

8.3.2 Example of the rootdelete.sh Parameter File

You can create a parameter file for rootdelete.sh to repeat deinstallation steps. You may want to do this if you intend to perform repeated reinstallations, as in a test environment. The following is an example of a parameter file for rootdelete.sh; terms that change relative to system configuration are indicated with italics:

CLUSTER_NODES=mynode1,mynode2
INVENTORY_LOCATION=u01/app/oracle/oraInventory
CRS_HOME=true
ORA_CRS_HOME=/u01/app/crs
ORACLE_OWNER=oracle
DBA_GROUP=oinstall

8.3.3 About the rootdeinstall.sh Script

The rootdeinstall.sh script should be run on the local node only, after rootdelete.sh has been run on all nodes of the cluster. Use this command either to remove the Oracle Clusterware OCR file, or to downgrade your existing installation. The rootdeinstall.sh script has the following command options:

  • paramfile: A parameter file containing configuration information for the rootdelete.sh command

  • downgrade: Use this option if the database is downgraded to a previous Oracle Clusterware version. Use the -version flag to specify the version to which you want to downgrade. The default is 10.2.

8.3.4 Removing Oracle Clusterware

Complete the following procedure to remove Oracle Clusterware:

  1. Log in as the oracle user, and shut down any existing Oracle Database instances on each node, with normal or immediate priority. For example:

    $ Oracle_home/bin/srvctl stop database -d db_name
    $ Oracle_home/bin/srvctl stop asm -n node
    $ Oracle_home/bin/srvctl stop nodeapps -n node
    
  2. Use Database Configuration Assistant and NETCA to remove listeners, Automatic Storage Management instances, and databases from the system. This removes the Oracle Clusterware resources associated with the listeners, Automatic Storage Management instances, and databases on the cluster.

  3. On each remote node, log in as the root user, change directory to the Oracle Clusterware home, and run the rootdelete script with the options remote nosharedvar nosharedhome. For example:

    [root@node2 /] # cd /u01/app/crs/install
    [root@node2 /install] # ./rootdelete.sh remote nosharedvar nosharedhome
    
  4. On the local node (the last cluster member node), log in as the root user, change directory to the Oracle Clusterware home, and run the rootdelete script with the options local nosharedvar nosharedhome. For example:

    [root@node1 /] # cd /u01/app/crs/install
    [root@node1 /install] # ./rootdelete.sh local nosharedvar nosharedhome
    
  5. On the local node, run the script rootdeinstall. For example:

    [root@node1 install]# ./rootdeinstall.sh
    
  6. Log in as the oracle user, and run Oracle Universal Installer to remove the Oracle Clusterware home. For example

    $ cd /u01/app/crs/oui/bin
    $ ./runInstaller -deinstall -removeallfiles