Oracle® Enterprise Manager Cloud Control Advanced Installation and Configuration Guide 12c Release 1 (12.1.0.1) Part Number E24089-01 |
|
|
PDF · Mobi · ePub |
This chapter describes how you can deinstall Oracle Management Agent (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.Before you deinstall a Management Agent, shut it down by running the following command from the Management Agent home:
$<AGENT_HOME>/bin/emctl stop agent
This section describes the following:
To deinstall a Management Agent in graphical mode, follow these steps:
Note:
Deinstall the components in the order described in this procedure. Otherwise, the installation wizard displays an error.Invoke the installer from the Management Agent home by running the following command:
$<AGENT_HOME>/oui/bin/runInstaller -deinstall [-removeallfiles] [-invPtrLoc <absolute_path_to_oraInst.loc>]
Note:
You can invoke the installer even from the directory where you downloaded the software. For example, <software_location>/
.
When you run runInstaller -help
, you will see the option -nowarningonremovefiles
listed. This option is currently not supported and has no effect even if you use it.
For Microsoft Windows, invoke the setup.exe
file.
In the installation wizard, click Installed Products.
On the Inventory screen, select the plug-in homes, and click Remove.
On the Inventory screen, select the sbin
home, and click Remove.
On the Inventory screen, select the Management Agent, and click Remove.
To deinstall a Management Agent in silent mode, follow these steps:
Note:
Deinstall the components in the order described in this procedure. Otherwise, the installation wizard displays an error.Deinstall the plug-in homes:
$<AGENT_HOME>/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={absolute_path_to_plug-in_home}" [-removeallfiles] [-invPtrLoc <absolute_path_to_oraInst.loc>]
Note:
When you run runInstaller -help
, you will see the option -nowarningonremovefiles
listed. This option is currently not supported and has no effect even if you use it.
On Microsoft Windows, invoke the setup.exe
file.
On Microsoft Windows, -invPtrLoc
is not supported.
To deinstall multiple plug-ins, enter the plug-in homes separated by a comma.
For example,
$<AGENT_HOME>/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={/home/oracle/agent/plugins/oracle.sysman.emas.oms.plugin_12.1.0.1.0,/home/oracle/agent/plugins/oracle.sysman.emct.oms.plugin_12.1.0.1.0}" -removeAllFiles -invPtrLoc /home/oracle/oraInst.loc
Deinstall the sbin
home:
$<AGENT_HOME>/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={absolute_path_to_sbin_directory}" [-removeAllFiles] [-invPtrLoc <absolute_path_to_oraInst.loc>]
For example,
$<AGENT_HOME>/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={/home/oracle/agent/sbin}"
-removeAllFiles
-invPtrLoc /home/oracle/oraInst.loc
Deinstall the Management Agent:
$<AGENT_HOME>/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={absolute_path_to_agent_oracle_home}" -removeAllFiles -invPtrLoc <absolute_path_to_oraInst.loc>
For example,
$<AGENT_HOME>/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={/home/oracle/agent/core/12.1.0.1.0}" -removeAllFiles -invPtrLoc /home/oracle/oraInst.loc
To deinstall a Shared Agent, follow these steps:
Identify the dependent plug-ins and the sbin home to be detached from the Central Inventory:
On the host where the Shared Agent is installed, open the following file from the Central Inventory:
<absolute_path>/oraInventory/ContentsXML/inventory.xml
Make a note of the dependent plug-ins listed within the <REFHOMELIST>
and </REFHOMELIST>
tags.
For example,
<HOME NAME="nfs5515" LOC="/home/john/software/oracle/agent/core/12.1.0.0.0" TYPE="O" IDX="1"> <REFHOMELIST> <REFHOME LOC="/home/john/software/oracle/agent/plugins/oracle.sysman.oh.discovery.plugin_12.1.0.0.0"/> <REFHOME LOC="/home/john/software/oracle/agent/plugins/oracle.sysman.db.discovery.plugin_12.1.0.0.0"/> <REFHOME LOC="/home/john/software/oracle/agent/plugins/oracle.sysman.emas.discovery.plugin_12.1.0.0.0"/> <REFHOME LOC="/home/john/software/oracle/agent/plugins/oracle.sysman.oh.agent.plugin_12.1.0.0.0"/> </REFHOMELIST> </HOME>
Make a note of the sbin directory listed within the <REFHOMELIST>
and </REFHOMELIST>
tags.
For example,
<HOME NAME="nfs5515" LOC="/home/john/software/oracle/agent/core/12.1.0.0.0" TYPE="O" IDX="1"> <REFHOMELIST> <REFHOME LOC="home/john/software/oracle/agent/sbin"/> </REFHOMELIST>
Detach the dependent plug-ins you identified in Step 1 (b) from the Central Inventory. To do so, run the following command from the Master Agent home that is visible on the host where your Shared Agent is installed:
$<AGENT_HOME>/oui/bin/runInstaller -detachHome -silent -waitForCompletion -invPtrLoc <absolute_path>/oraInst.loc ORACLE_HOME=<plug-in_home> -nogenerateGUID
For example,
/home/john/software/oracle/agent/core/12.1.0.1.0/oui/bin/runInstaller -detachHome -silent -waitForCompletion -invPtrLoc /home/john/software/oracle/agent/core/12.1.0.1.0/oraInst.loc ORACLE_HOME=/home/john/software/oracle/agent/plugins/oracle.sysman.emas.discovery.plugin_12.1.0.1.0 -nogenerateGUID
Note:
This step detaches only one plug-in at a time. Therefore, if you have multiple plug-ins, repeat this step to detach every other dependent plug-in.Detach the sbin home you identified in Step 1 (c) from the Central Inventory. To do so, run the following command from the Master Agent home that is visible on the host where your Shared Agent is installed:
$<AGENT_HOME>/oui/bin/runInstaller -detachHome -silent -waitForCompletion -invPtrLoc <absolute_path>/oraInst.loc ORACLE_HOME=<sbin_home> -nogenerateGUID
For example,
/home/john/software/oracle/agent/core/12.1.0.1.0/oui/bin/runInstaller -detachHome -silent -waitForCompletion -invPtrLoc /home/john/software/oracle/agent/core/12.1.0.1.0/oraInst.loc ORACLE_HOME=/home/john/software/oracle/agent/sbin -nogenerateGUID
Deinstall the Shared Agent. To do so, 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,
/home/john/software/oracle/agent/core/12.1.0.1.0/perl/bin/perl /home/john/software/oracle/agent/core/12.1.0.1.0/sysman/install/NFSAgentDeInstall.pl AGENT_INSTANCE_HOME=/home/john/software/oracle/agent/agent_inst ORACLE_HOME=/home/john/software/oracle/agent/core/12.1.0.1.0
To deinstall a Management Agent that was installed using a .rpm
file, follow these steps:
Deinstall the Management Agent as described in one of the following sections:
To deinstall in graphical mode, see Deinstalling in Graphical Mode.
To deinstall in silent mode, see Deinstalling in Silent Mode.
Run the following command as a root user:
rpm -e <rpm_name>
Note:
As a prerequisite, ensure that you have Resource Package Manager (RPM) installed on the host.After you deinstall the Management Agent, follow these steps:
(Only for Graphical Mode) Verify whether the Oracle homes and other directories were successfully deinstalled. To do so, follow these steps:
Invoke the installation wizard by running the following command from the Management Agent home:
$<AGENT_HOME>/oui/bin/runInstaller
Note:
On Microsoft Windows, invoke thesetup.exe
file.In the installation wizard, on the My Oracle Support Details screen, click Installed Products.
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. 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-start script titled S98gcstartup. To do so, navigate to the /etc/rc.d/
directory, and search for the auto-start script S98gcstartup. This script is usually present in a subdirectory within the /etc/rc.d/
directory. Navigate to the subdirectory where the script is found and delete the script. For example, /etc/rc.d/rc3.d/S98gcstartup
.
Note:
These auto-start scripts are not available on Microsoft Windows.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
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:
(a) KEY_agent12gn
(b) KEY_sbin12gn
Note:
Here, n refers to a numeral indicating the agent instance. For example,KEY_sbin12g9
for the first agent installation.Expand HKEY_LOCAL_MACHINE, SOFTWARE, Oracle, and then Sysman. Under the Sysman directory, delete the Management Agent service. For example, Oracleagent12g9Agent
.
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.
Clean Up Environment Settings
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.
In the System Variables section, click the variable PATH and modify the value.
Delete Management Agent home.
Click Apply and then click OK.
Close the Control Panel window.
Restart the host.