23 Deinstalling Enterprise Manager Grid Control

This chapter describes how you can deinstall Enterprise Manager Grid Control (Grid Control). In particular, this chapter covers the following:

Deinstalling Enterprise Manager Grid Control Using OUI
Deinstalling Enterprise Manager Grid Control In Silent Mode

Note:

If you deinstall the Enterprise Manager 10g Grid Control or Management Agent Oracle homes using Oracle Universal Installer (OUI), the Oracle homes are de-registered from the central inventory and the oratab file. However, some files may remain in these Oracle homes.

If an Oracle home has been removed successfully (verify this in OUI by clicking Installed Products), you can manually delete the files present in the Oracle home directories.

Deinstalling Enterprise Manager Grid Control Using OUI

To deinstall Grid Control using OUI, do the following:

Shut down all opmn processes that are running by running the following command:
```
<OMS_HOME>/opmn/bin/opmn stopall
```
Shut down the Management Agent in the Agent Oracle home using the emctl stop agent command.
Stop Grid Control by running the following command:
```
<OMS_HOME>/bin/emctl stop em
```
Shut down the repository database (if the database software is installed as a part of the Management Service Oracle home being uninstalled).
Shut down the Oracle Database listener.
Run the Database Configuration Assistant (DBCA) to delete the database before proceeding to deinstall the Oracle home.
Run the OUI and select the Oracle home to deinstall. It is removed from the Central Inventory. When you invoke OUI, pass the -removeallfiles parameter.

For UNIX platforms:
```
./runInstaller -removeallfiles 
```
For Microsoft Windows platforms:
```
setup.exe -removeallfiles 
```
Manually delete all auto-start scripts that might be present in the /etc/rc.d/ directory. For example, /etc/rc.d/rc3.d/S98gcstartup.

Caution:

After deinstallation of certain Grid Control targets, when you try and remove the same targets from the Grid Control console, you may encounter an error.

To resolve this issue, deinstall the Grid Control targets and wait for at least 15 minutes before you attempt to remove the targets from the Grid Control console using the Hosts screen.

Additional Deinstallation Steps

For deinstalling Grid Control from Microsoft Windows operating system, you will need to perform the following additional steps to remove entries from the registry. Ensure that you are logged in as a user with Administrator privileges on that computer.

Remove Entries in Windows Registry

To remove entries in Windows registry:

Start the registry editor. Choose Start > Run > regedit.
Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\
Go to HKEY_LOCAL_MACHINE\SOFTWARE\ODBC and expand all subkeys and remove the key "Oracle in <HOME_NAME>". Check if the "Oracle ODBC Driver" key contents refer to the ORACLE_HOME to be deleted. If yes, delete the key.
Go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services. Delete the keys that begin with Oracle.
Go to HKEY_LOCAL_MACHINE\SYSTEM\ControlSet2\Services. Delete the keys that begin with Oracle.
Go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\EventLog\...\Application. Delete the keys whose names begin with Oracle and contain references to the EventMessageFile string entry for the ORACLE_HOME to be deleted or a location under it.
Go to HKEY_CLASSES_ROOT and search in the keys starting with Ora or ORCL (for example, Oracle..., ORADC... ..., OraPerf..and ORCL...). Delete keys which include string values with the specific ORACLE_HOME that is to be deleted.
Close the registry editor.

Clean Up Environment Settings

To clean up environment settings:

On Windows NT: Choose Start > Settings > Control Panel > System > Environment.

On Windows 2000 and Windows XP: Choose Start > Settings > Control Panel > System > Advanced > Environment Variables.
In the System Variables section, click the variable PATH in order to modify the value. For example, you may see a path similar to this one:
```
C:\ORACLE\EM10g\BIN
C:\PROGRAM FILES\ORACLE\JRE\1.1.7\BIN
```
If you are deleting the Oracle home C:\ORACLE\EM10g, remove the C:\ORACLE\EM10g\BIN expression from the PATH variable.

Delete any path expression in the PATH variable that contains the Oracle home to be removed or some location underneath.
If there is a CLASSPATH variable under "System Variables", delete the path expressions in the variable that contains the ORACLE_HOME to be removed or some location underneath.
Check if there are any other Oracle variables set in "System Variables". Delete those variables that contain the ORACLE_HOME that you are trying to remove. For example, ORACLE_HOME, ORACLE_SID, TNS_ADMIN, inventory_loc, and so on.
Click Apply and then click OK.
Close the Control Panel window.

Delete Software and Start Menu Icons

To delete software and start menu icons:

On Windows NT: Choose Start > Programs > Windows NT Explorer.

On Windows 2000 and Windows XP: Choose Start > Programs > Accessories > Windows Explorer.
On Windows NT: Go to %SystemDrive%\WINNT\PROFILES\ALL USERS\START MENU\PROGRAMS

On Windows 2000 and Windows XP: Go to %SystemDrive%\DOCUMENTS AND SETTINGS\ALL USERS\START MENU\ ...\PROGRAMS

Note:
These locations depend on whether the operating system was upgraded from NT or was a new install of Windows 2000 or Windows XP.
Delete the folders -Oracle - <HOME_NAME> where <HOME_NAME> is the Oracle home that you are trying to remove.

Note:
To locate your System Drive, type echo %SystemDrive% in the Command Prompt.
Go to the temp directory and delete all files and directories at the following locations:

On Windows NT: %SystemDrive%\Temp

On Windows 2000 and Windows XP: %SystemDrive%\Documents and Settings\<username>\Local Settings\Temp\
Reboot the machine.

Deinstalling Enterprise Manager Grid Control In Silent Mode

This section describes how you can deinstall Grid Control in silent mode. In particular, this section covers the following:

Deinstalling Enterprise Manager 10g Grid Control Release 4 (10.2.0.4) or Lower
Deinstalling Enterprise Manager 10g Grid Control Release 5 (10.2.0.5) or Higher

Note:

If you are deinstalling Grid Control from Microsoft Windows platform, then follow the additional steps given in Additional Deinstallation Steps.

Caution:

After deinstallation of certain Grid Control targets, when you try and remove the same targets from the Grid Control console, you may encounter an error.

To resolve this issue, deinstall the Grid Control targets and wait for at least 15 minutes before you attempt to remove the targets from the Grid Control console using the Hosts screen.

Deinstalling Enterprise Manager 10g Grid Control Release 4 (10.2.0.4) or Lower

To deinstall Enterprise Manager 10g Grid Control Release 4 (10.2.0.4) or lower in silent mode, that is, without using OUI, do the following:

Shut down all opmn processes that are running by executing the following command:
```
<OMS_HOME>/opmn/bin/opmn stopall
```
Shut down the Management Agent in the Agent Oracle home using the emctl stop agent command.
Stop Grid Control by executing the following command:
```
<OMS_HOME>/bin/emctl stop em
```
Shut down the repository database (if the database software is installed as a part of the Management Service Oracle home being uninstalled).
Shut down the Oracle Database listener.
Run the Database Configuration Assistant (DBCA) to delete the database before proceeding to deinstall the Oracle home.
Run the following command to deinstall Grid Control:

./runInstaller -deinstall -silent "REMOVE_HOMES={absolute_path_to_oracle_homes_to_be_deinstalled}" -removeallfiles

For example, if you deinstalling Grid Control that was installed using a new database, then you must run the following command. No changes are required for the response file.

./runInstaller -deinstall -silent "REMOVE_HOMES={/scratch/oraclehome/db10g,/scratch/oraclehome/oms10g,/scratch/oraclehome/agent10g}" -removeallfiles
Manually delete all auto-start scripts that might be present in the /etc/rc.d/ directory. For example, /etc/rc.d/rc3.d/S98gcstartup.

Deinstalling Enterprise Manager 10g Grid Control Release 5 (10.2.0.5) or Higher

To deinstall Enterprise Manager 10g Grid Control Release 5 (10.2.0.5) or higher in silent mode, that is, without using OUI, you have to run the deinstall.pl script. This deinstalls the database that was installed with Grid Control, the OMS, as well as the Management Agent. Optionally, you can run the script to drop the Grid Control schema from an existing database that was not installed along with Grid Control.

Note:

This deinstallation method applies only to Enterprise Manager 10g Grid Control Release 5 (10.2.0.5) or higher, and is supported only on Linux and Microsoft Window platforms.

Deinstalling Enterprise Manager Grid Control (All Core Components)

To deinstall Grid Control, navigate to the Oracle home directory of the OMS or Management Agent, and run the following command. This command essentially deinstalls all core components residing in the base directory.

$ORACLE_HOME/install/deinstall/Deinstall.pl -baseDir <full path to the base directory>

For example:

$ORACLE_HOME/install/deinstall/Deinstall.pl -baseDir /john/OracleHomes

Note:

If the Management Agent is installed in a location that is different from the base directory or if the Oracle home directory of the Management Agent is different from agent10g (the default name), then deinstall that Management Agent separately. For instructions to deinstall Management Agent only, see Deinstalling Oracle Management Agent 10g Release 5 (10.2.0.5) or Higher.

Note:

After you deinstall the product, manually delete all auto-start scripts that might be present in the /etc/rc.d/ directory. For example, /etc/rc.d/rc3.d/S98gcstartup.

Deinstalling Enterprise Manager Grid Control and Dropping Grid Control Scheme from an Existing Database

Optionally, if you want to drop the Grid Control schema from an existing database that was not installed along with Grid Control, then run the following command:

$ORACLE_HOME/install/deinstall/Deinstall.pl -baseDir <full path to the base directory> -reposDrop

For example:

$ORACLE_HOME/install/deinstall/Deinstall.pl -baseDir /john/OracleHomes -reposDrop

Note:

After you deinstall the product, manually delete all auto-start scripts that might be present in the /etc/rc.d/ directory. For example, /etc/rc.d/rc3.d/S98gcstartup.