31 Deinstalling Oracle Management Agent in Graphical Mode

This chapter describes how you can deinstall standalone Oracle Management Agent (Management Agent) or cluster-based Management Agent from all nodes of a cluster, in graphical mode. In particular, this chapter covers the following:

Prerequisites
Deinstallation Procedure
After You Deinstall

Note:

For more information about deinstalling a Management Agent only from one node of a cluster and deinstalling shared Management Agents, see Chapter 32, "Deinstalling Oracle Management Agent in Silent Mode".

Prerequisites

Before you deinstall a Management Agent, shut it down by running the following command from its Oracle home:

<ORACLE_HOME>/bin/emctl stop agent

Deinstallation Procedure

This section describes the following:

Deinstalling Standalone or Cluster-Based Oracle Management Agents
Deinstalling Cluster-Based Oracle Management Agent from Only One Node of a Cluster

Deinstalling Standalone or Cluster-Based Oracle Management Agents

To deinstall standalone Management Agents or cluster-based Management Agents from all the nodes of a cluster, run the following command from the Oracle home of the Management Agent:

Invoke the installer from the Oracle home of the Management Agent by running the following command:

$<ORACLE_HOME>/oui/bin/runInstaller -removeallfiles

Note:
For Microsoft Windows, invoke setup.exe. Also, when you runInstaller -help, you will see the option -nowarningonremovefiles listed. This option is currently not supported and has no effect even if you use it.
In the Enterprise Manager Grid Control Installation Wizard, on the My Oracle Support Details screen, click Installed Products.
On the Inventory screen, select the Oracle home of the Management Agent (agent11g) and click Remove.

For example, /u01/app/Oracle/Middleware/agent11g

Note:

On a cluster, this procedure deinstalls the Management Agents from all the nodes.

Deinstalling Cluster-Based Oracle Management Agent from Only One Node of a Cluster

To deinstall a cluster-based Management Agent from only one node of a cluster, follow these steps:

On the node where you want to deinstall the Management Agent, after shutting down the Management Agent as described in Prerequisites, invoke the installer from the Oracle home of the Management Agent by running the following command:

$<ORACLE_HOME>/oui/bin/runInstaller -local -removeallfiles

Note:
For Microsoft Windows, invoke setup.exe. Also, when you runInstaller -help, you will see the option -nowarningonremovefiles listed. This option is currently not supported and has no effect even if you use it.
In the Enterprise Manager Grid Control Installation Wizard, on the My Oracle Support Details screen, click Installed Products.
On the Inventory screen, select the Oracle home of the Management Agent (agent11g) and click Remove.

For example, /u01/app/Oracle/Middleware/agent11g
From all other nodes, run the following command:

./runInstaller -updateNodeList ORACLE_HOME=<Oracle_Home_of_Agent> "CLUSTER_NODES=<other_nodes_separate_by_a_comma>"

For example, if you have a cluster of five nodes, and if you have run Step (1) on node1, then run this command on node2, nod3, node4, and node5:

./runInstaller -updateNodeList ORACLE_HOME=<Oracle_Home_of_Agent> "CLUSTER_NODES=<node2, node3, node4, node5>"

After You Deinstall

After you deinstall the Management Agent, follow these steps:

Verify whether the Oracle homes and other directories were successfully deinstalled. To do so, follow these steps:
1. Invoke the installer by running the following command from the Oracle home of the Management Agent:
  
  $<ORACLE_HOME>/oui/bin/runInstaller
  
  Note:
  For Microsoft Windows, invoke setup.exe instead of runInstaller.
2. In the Enterprise Manager Grid Control Installation Wizard, on the My Oracle Support Details screen, click Installed Products.
3. On the Inventory screen, check whether or not the Oracle homes and other directories you deinstalled appear. If the deinstallation was successful, then those Oracle homes and directories should not appear.
The Oracle homes you deinstalled are deregistered from the central inventory and the oratab file. However, some files might still remain in these Oracle homes. If they do, you can manually delete them.

You must also manually delete all auto-start scripts present in the /etc/rc.d/ directory. For example, /etc/rc.d/rc3.d/S98gcstartup.
If you deinstalled on a Microsoft Windows platform, then follow these steps. Ensure that you are logged in as a user with Administrator privileges on that host.

Remove Entries from Microsoft Windows Registry
1. Start the registry editor by selecting Start and then Run. Type regedit and click OK.
2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Oracle and remove the Management Agent entry.
  
  For example, if you have Management Agent 11g, then you select and remove the following:
```
HKEY_LOCAL_MACHINE\SOFTWARE\Oracle\Key_agent11g
```
3. Navigate to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services. Delete the Management Agent keys.
4. Navigate to HKEY_LOCAL_MACHINE\SYSTEM\ControlSet2\Services. Delete the Management Agent service.
5. Exit from the registry editor.
Clean Up Environment Settings
1. Open the Environment Variables window.
  
  On Microsoft Windows NT, select Start, Settings, Control Panel, System, and then Environment.
  
  On Microsoft Windows XP or 2000, select select Start, Settings, Control Panel, System, Advanced, and then Environment Variables.
2. In the System Variables section, click the variable PATH and modify the value.
3. Delete Management Agent home.
4. Click Apply and then click OK.
5. Close the Control Panel window.
6. Restart the host.
  
  Note:
  On a cluster, restart all the nodes.