26 Deinstalling Oracle Management Agents
This chapter describes how you can deinstall standalone Oracle Management Agents (Management Agent). In particular, this chapter covers the following:
Note:
On a cluster, ensure that you deinstall the Management Agents from all the nodes one by one. To do so, follow the instructions outlined in this chapter.
Note:
When you deinstall an old standalone Management Agent and install a new standalone Management Agent on the same host, you will lose all historical target information from the Management Repository.
To avoid losing all historical target information, first install the new standalone Management Agent, then run the emcli relocate_targets
command to hand over the targets from the old standalone Management Agent to the new standalone Management Agent, and then deinstall the old standalone Management Agent.
For information about the emcli relocate_targets
command, see relocate_targets in the Oracle Enterprise Manager Cloud Control Command Line Interface Guide.
Deinstalling Oracle Management Agents
This section lists the deinstallation prerequisites and describes the various ways of deinstalling a standalone Management Agent. In particular, this section covers the following:
Deinstalling Standalone Oracle Management Agents
This section describes the following:
Deinstalling Standalone Management Agents Using the AgentDeinstall.pl Script
To deinstall a standalone Management Agent using the AgentDeinstall.pl
script, follow these steps:
Note:
While deinstalling the standalone Management Agent, the Management Agent service is removed automatically. If the service is not removed automatically, you can remove it manually after the deinstall, by running the following command:
sc delete <service_name>
Deinstalling Shared Agents
To deinstall a Shared Agent, run the following command from the Master Agent home that is visible on the host where your Shared Agent is installed:
$<AGENT_HOME>/perl/bin/perl <AGENT_HOME>/sysman/install/NFSAgentDeInstall.pl AGENT_INSTANCE_HOME=<absolute_path_to_agent_instance_home> ORACLE_HOME=<absolute_path_to_agent_home>
For example,
/shared/app/agentbasedir/agent_13.3.0.0.0/perl/bin/perl /shared/app/agentbasedir/agent_13.3.0.0.0/sysman/install/NFSAgentDeInstall.pl AGENT_INSTANCE_HOME=/shared/app/agentbasedir/agent_inst ORACLE_HOME=/shared/app/agentbasedir/agent_13.3.0.0.0
After Deinstalling Standalone Management Agents
After you deinstall a standalone Management Agent, follow these steps:
-
Verify that the Oracle homes you deinstalled are deregistered from the central inventory. However, some files might still remain in these Oracle homes. If they do, you can manually delete them.
You must also manually delete the auto-startup script called
gcstartup
that will be present under/etc/init.d
directory.Note:
These auto-start scripts are not available on Microsoft Windows.
-
If you deinstalled on a Microsoft Windows platform, then follow these steps to remove the entries from the Microsoft Windows registry. Ensure that you are logged in as a user with Administrator privileges on that host.
-
Expand HKEY_LOCAL_MACHINE, SOFTWARE, Oracle, and then Sysman. Under the Sysman directory, delete the Management Agent service. For example,
Oracleagent13cAgent
. -
Close the registry editor.
-
Deinstalling or Undeploying Only Plug-ins from the Oracle Management Agent
If you want to deinstall or undeploy only the plug-ins from the Management Agent, and not the Management Agent itself, then use the Plug-ins page within the Enterprise Manager Cloud Control Console. For instructions, see Undeploying Plug-Ins from Oracle Management Agent in the Oracle Enterprise Manager Cloud Control Administrator's Guide.Do NOT use the installer to undeploy only the plug-ins.