24 Deinstalling Management Agent

This chapter describes how you can deinstall Oracle Management Agent (Management Agent). In particular, this chapter covers the following:

• Deinstalling Oracle Management Agent Using OUI

• Deinstalling Oracle Management Agent in Silent Mode

• Deinstalling NFSAgent

Note:

If you deinstall the Enterprise Manager 10g Grid Control or Management Agent Oracle homes using Oracle Universal Installer, 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 Oracle Management Agent Using OUI

To deinstall Oracle Management Agent using OUI, do the following:

1. Shut down the Management Agent in the Agent Oracle home using the emctl stop agent command.

   For example,

   <agent_home>/emctl stop agent 
   

2. Run the OUI and select the Agent 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 
   

If you want to deinstall the Management Agent from one node of a cluster, then follow these steps:

1. Invoke the installer on the node from where you want to deinstall the Management Agent using -local as the agrument.

   ./runInstaller -local

2. Run the following command on all other nodes of the cluster:

   ./runInstaller -updateNodeList ORACLE_HOME=<Oracle_Home_of_Agent> "CLUSTER_NODES=<other nodes separate by a comma node2>"

   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>"

3. Manually delete all auto-start scripts that might be present in the /etc/rc.d/ directory. For example, /etc/rc.d/rc3.d/S98gcstartup.

Additional Deinstallation Steps

For deinstalling Oracle Management Agent 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:

1. Start the registry editor. Choose Start > Run > regedit.

2. Go to HKEY_LOCAL_MACHINE\SOFTWARE\Oracle and remove the Agent entry.

   For example, if you have Management Agent 10g, then you would select and remove the following:

   HKEY_LOCAL_MACHINE\SOFTWARE\Oracle\Key_agent10g
   

3. Go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services. Delete the Agent keys.

4. Go to HKEY_LOCAL_MACHINE\SYSTEM\ControlSet2\Services. Delete the Agent service.

5. Close the registry editor.

Clean Up Environment Settings

To clean up environment settings:

1. 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.

2. In the System Variables section, click the variable PATH in order to modify the value.

3. Delete Agent home.

4. Click Apply and then click OK.

5. Close the Control Panel window.

6. Reboot the computer.

   After rebooting, you can start fresh Management Agent installation.

   Note:

   On RAC, you have to reboot both the nodes.

Deinstalling Oracle Management Agent in Silent Mode

This section describes how you can deinstall Oracle Management Agent in silent mode. In particular, this section covers the following:

• Deinstalling Oracle Management Agent 10g Release 4 (10.2.0.4) or Lower

• Deinstalling Oracle Management Agent 10g Release 5 (10.2.0.5) or Higher

Deinstalling Oracle Management Agent 10g Release 4 (10.2.0.4) or Lower

To deinstall Oracle Management Agent 10g Release 4 (10.2.0.4) or Lower in silent mode, that is, without using OUI, do the following:

1. Shut down the Management Agent in the Agent Oracle home using the emctl stop agent command.

   For example,

   <agent_home>/emctl stop agent 
   

2. Run the following command to deinstall Oracle Management Agent:

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

   For example:

   ./runInstaller -deinstall -silent "REMOVE_HOMES={/scratch/oraclehome/agent10g}" -removeallfiles

   Note:

   If you are deinstalling Enterprise Manager 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.

3. 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 Oracle Management Agent 10g Release 5 (10.2.0.5) or Higher

To deinstall Oracle Management Agent 10g Release 5 (10.2.0.5) or higher in silent mode, navigate to the Oracle home directory of the Management Agent, and run the following command.

$ORACLE_HOME/install/deinstall/Deinstall.pl -agentHome <full path to agent's Oracle home directory>

For example:

$ORACLE_HOME/install/deinstall/Deinstall.pl -agentHome /john/agent/OracleHomes/agent10g

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 NFSAgent

If the nfsagent you want to deinstall is the only Oracle product installed on the host, you must check the /etc/oraInst.loc directory for the inventory location and perform the following steps to deinstall the agent:

1. Stop the agent using the following command:

   <EMSTATE DIR>/bin/emctl stop agent
   

2. On Microsoft Windows, you must delete the agent service by executing the following command:

   nmesrvops delete <service name>
   

3. Execute rm -rf <inventory_location>

4. Execute rm -rf <EMSTATE Dir>

If the nfsagent you want to deinstall is not the only Oracle product installed on the host, then go to the master agent Oracle home (using the mounted path) and perform the following steps to deinstall the agent:

1. Stop the agent using the following command:

   <EMSTATE DIR>/bin/emctl stop agent
   

2. On Microsoft Windows, you must delete the agent service by executing the following command:

   nmesrvops delete <service name>
   

3. Execute the following command from the master agent Oracle home:

   <master agent home>/oui/bin/runInstaller -detachHome ORACLE_HOME=<master agent home>
   

4. Execute rm -rf <EMSTATE Dir>