Oracle Deinstallation Tool (Deinstall)

The deinstall tool is a script that you can run separately from Oracle Universal Installer (OUI).

Purpose

The deinstall tool stops Oracle software, and removes Oracle software and configuration files on the operating system for a specific Oracle home.

Syntax

The standalone deinstallation tool uses the following syntax:

(./deinstall [-silent] [-checkonly] [-paramfile complete path of input response file] 
[-params name1=value name2=value . . .] 
[-o complete path of directory for saving files] 
[-tmpdir complete path of temporary directory to use] 
[-logdir complete path of log directory to use] [-skipLocalHomeDeletion] [-skipRemoteHomeDeletion] [-help]

The deinstall tool run as a command option from OUI uses the following syntax, where path is the complete path to the home or file you specify:

./runInstaller -deinstall -home path [-silent] [-checkonly] 
[-paramfile path] [-params name1=value name2=value . . .] 
[-o path] [-tmpdir complete path of temporary directory to use] 
[-logdir complete path of log directory to use] [-skipLocalHomeDeletion] [-skipRemoteHomeDeletion] [-help]

Parameters

Parameter Description
-home

Use this flag to indicate the home path of the Oracle home to check or deinstall.

To deinstall Oracle software using the deinstall command, located in the Oracle home you plan to deinstall, provide a response file located outside the Oracle home, and do not use the -home flag.

If you run the deinstallation tool from the $ORACLE_HOME/deinstall path, then the -home flag is not required because the tool identifies the location of the home where it is run. If you use runInstaller -deinstall from the installation media, then -home is mandatory.

-silent

Use this flag to run the deinstallation tool in noninteractive mode. This option requires one of the following:

  • A working system that it can access to determine the installation and configuration information. The -silent flag does not work with failed installations.

  • A response file that contains the configuration values for the Oracle home that is being deinstalled or deconfigured.

You can generate a response file to use or modify by running the tool with the -checkonly flag. The tool then discovers information from the Oracle home to deinstall and deconfigure. It generates the response file that you can then use with the -silent option.

You can also modify the template file deinstall.rsp.tmpl, located in the $ORACLE_HOME/deinstall/response directory.

-checkonly Use this flag to check the status of the Oracle software home configuration. Running the deinstallation tool with the -checkonly flag does not remove the Oracle configuration. The -checkonly flag generates a response file that you can use with the deinstallation tool and -silent option.
-paramfile complete path of input response file

Use this flag to run the deinstallation tool with a response file in a location other than the default. When you use this flag, provide the complete path where the response file is located.

The default location of the response file depends on the location of the deinstallation tool:

  • From the installation media or stage location: /response

  • After installation from the installed Oracle home: $ORACLE_HOME/deinstall/response

-params [name1=value name2=value name3=value . . .]

Use this flag with a response file to override one or more values to change in a response file you have created.

-o complete path of directory for saving response files

Use this flag to provide a path other than the default location where the response file (deinstall.rsp.tmpl) is saved.

The default location of the response file depends on the location of the deinstallation tool:

  • From the installation media or stage location: /response

  • After installation from the installed Oracle home: $ORACLE_HOME/deinstall/response

-tmpdircomplete path of temporary directory to use

Use this flag to specify a non-default location where Oracle Deinstallation Tool writes the temporary files for the deinstallation.

-logdircomplete path of log directory to use

Use this flag to specify a non-default location where Oracle Deinstallation Tool writes the log files for the deinstallation.

-local

Use this flag on a multinode environment to deinstall Oracle software in a cluster.

When you run deinstall with this flag, it deconfigures and deinstalls the Oracle software on the local node (the node where deinstall is run). On remote nodes, it deconfigures Oracle software, but does not deinstall the Oracle software.

-skipLocalHomeDeletion

Use this flag in Oracle Grid Infrastructure installations on a multinode environment to deconfigure a local Grid home without deleting the Grid home.

-skipRemoteHomeDeletion

Use this flag in Oracle Grid Infrastructure installations on a multinode environment to deconfigure a remote Grid home without deleting the Grid home.

-help

Use this option to obtain additional information about the command option flags.