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 the Oracle Enterprise Manager Cloud Control Command Line Interface Guide.
This section lists the deinstallation prerequisites and describes the various ways of deinstalling a standalone Management Agent. In particular, this section covers the following:
This section describes the following:
To deinstall a standalone Management Agent using the
AgentDeinstall.pl script, follow these steps:
AgentDeinstall.pl script to delete the standalone Management Agent and also remove the agent base directory.
$<AGENT_HOME>/perl/bin/perl <AGENT_HOME>/sysman/install/AgentDeinstall.pl -agentHome <AGENT_HOME>
/u01/software/em13c/agentbasedir/agent_18.104.22.168.0/perl/bin/perl /u01/software/em13c/agentbasedir/agent_22.214.171.124.0/sysman/install/AgentDeinstall.pl -agentHome /u01/software/em13c/agentbasedir/agent_126.96.36.199.0
Manually remove the targets, which were being monitored by the standalone Management Agent you deinstalled, from the Enterprise Manager Cloud Control Console. To do so, run the following EM CTL command from any host where EM CLI is installed.
Manually delete the agent base directory. For information on agent base directory, see Section 2.3.4.
For UNIX platforms:
rm -rf <absolute_path_to_install_base_dir>
For Microsoft Windows platforms:
Note:While deinstalling the standalone Management Agent, the Management Agent service is not removed automatically. You must remove it manually after the deinstall, by running the following command:
sc delete <service_name>
$<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>
/shared/app/agentbasedir/agent_188.8.131.52.0/perl/bin/perl /shared/app/agentbasedir/agent_184.108.40.206.0/sysman/install/NFSAgentDeInstall.pl AGENT_INSTANCE_HOME=/shared/app/agentbasedir/agent_inst ORACLE_HOME=/shared/app/agentbasedir/agent_220.127.116.11.0
Run the following command on the Management Agent host to obtain the RPM name:
rpm -qa | grep oracle-agt
Run the following command as a root user to deinstall the Management Agent:
rpm -e <rpm_name>
<rpm_name> is the RPM name that is displayed in the output of the command you ran in Step 1.
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
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.
Start the registry editor by selecting Start and then Run. Type
regedit and click OK.
In the Registry Editor window, in the left pane, expand HKEY_LOCAL_MACHINE, SOFTWARE, and then Oracle. Under the Oracle directory, delete the following:
Note:Here, n refers to a numeral indicating the agent instance. For example,
KEY_sbin12g9for the first agent installation.
Expand HKEY_LOCAL_MACHINE, SOFTWARE, Oracle, and then Sysman. Under the Sysman directory, delete the Management Agent service. For example,
Expand HKEY_LOCAL_MACHINE, SYSTEM, CurrentControlSet, and then Services. Under the Services directory, delete the Management Agent keys.
Expand HKEY_LOCAL_MACHINE, SYSTEM, ControlSet002, and then Services. Under the Services directory, delete the Management Agent service.
Close the registry editor.
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 the Oracle Enterprise Manager Cloud Control Administrator's Guide. Do NOT use the installer to undeploy only the plug-ins.