This chapter describes how you can deinstall an entire Enterprise Manager system, and also how you can remove the entries of an Oracle Management Service (OMS) from the Oracle Management Repository (Management Repository) in case you lost the host where the OMS was running.
In particular, this chapter covers the following:
This section covers the following subsections to describe how you can deinstall the entire Enterprise Manager system—single OMS environment or multi-OMS environment with additional Oracle Management Services (OMS).
Prerequisites for Deinstalling Only the OMS and Retaining the Management Repository
Prerequisites for Deinstalling the Entire Enterprise Manager System
Caution:
Make sure you meet the prerequisites before deinstalling the software. Make sure you follow the flow or sequence outlined in this chapter. For example, make sure you drop the schemas as described in the prerequisites section before deinstalling the software binaries. Do NOT change the order of instructions.Before you deinstall Enterprise Manager, meet the following prerequisites:
(For Multi-OMS Environment, and if Oracle BI Publisher is Configured on Additional OMS Instances) Stop all the Oracle BI Publisher managed servers, which are running on the additional OMS hosts, by running the following command from the OMS home on each host:
$<OMS_HOME>/bin/emctl stop oms -bip_only
Note:
If any Oracle BI Publisher managed server fails to stop, then manually kill it using the operating system commands.(For Multi-OMS Environment, and if Oracle BI Publisher is Configured on Additional OMS Instances) Delete all the Oracle BI Publisher managed servers, which you stopped in the previous step, by running the following command:
$<OMS_HOME>/bin/configureBIP -delete
(For Multi-OMS Environment) Deconfigure and delete all the additional OMS instances by running the following command from each of their homes:
$<OMS_HOME>/bin/omsca delete -OMSNAME <oms_name>
Note:
Run this command on each of the additional OMS instances.
You are prompted to confirm your action, and furnish the AdminServer credentials and the repository database details such as the database host name, listener port, SID, and password. Once you provide the required details, the command automatically stops the OMS, Oracle WebLogic Server, and also Oracle WebTier.
For example, if you have two additional OMS instances named EMGC_Addln_OMS2 and EMGC_Addln_OMS3, on two different hosts, then on the first additional OMS, run the following command:
/u01/app/Oracle/Middleware/oms/bin/omsca delete -OMSNAME EMGC_Addln_OMS2
Then, on the second additional OMS, run the following command:
/u01/app/Oracle/Middleware/oms/bin/omsca delete -OMSNAME EMGC_Addln_OMS3
(For Multi-OMS Environment) Manually delete the following WebLogic targets of the deleted OMS:
/EMGC_GCDomain/GCDomain/EMGC_OMS2 (Oracle WebLogic Server)
/EMGC_GCDomain/instance2/ohs2 (Oracle HTTP Server)
(For Multi-OMS Environment) Stop all the Oracle Management Agents (Management Agent), which are running on the additional OMS hosts, by running the following command from each of their homes:
$<AGENT_HOME>/bin/emctl stop agent
Note:
Run this command on each of the Management Agents configured with the additional OMS instances.For example, if you have two additional OMS instances with a Management Agent on each of them, then on the first additional OMS host where the first Management Agent is running, run the following command:
/u01/app/Oracle/agent/core/12.1.0.5.0/bin/emctl stop agent
Then, on the second additional OMS host where the second Management Agent is running, run the following command:
/u01/app/Oracle/agent/core/12.1.0.5.0/bin/emctl stop agent
(If Oracle BI Publisher is Configured on the First [Main] OMS) Stop the Oracle BI Publisher managed server running on the first (main) OMS, by running the following command from the OMS home:
$<OMS_HOME>/bin/emctl stop oms -bip_only
Note:
If any Oracle BI Publisher managed server fails to stop, then manually kill it using the operating system commands.Deconfigure and delete the first (main) OMS where the Admin Server is configured:
$<OMS_HOME>/bin/omsca delete -full
For example,
/u01/app/Oracle/Middleware/oms/bin/omsca delete -full
You are prompted to confirm your action, and furnish the AdminServer credentials and the repository database details such as the database host name, listener port, SID, and password. Once you provide the required details, the command automatically stops the OMS, Oracle WebLogic Server, and also Oracle WebTier.
Note:
If the Oracle Database where the Management Repository is configured, is set with a service name, then run the following command:On UNIX platforms:
./omsca delete -full -REP_CONN_STR '(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=<>)(PORT=<>)))(CONNECT_DATA=(SERVICE_NAME=<>)))'
For example,
/u01/app/Oracle/Middleware/oms/bin/omsca delete -full -REP_CONN_STR '(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=example.com)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=srvc.example.com)))'
On Microsoft Windows platforms:
.\omsca delete -full -REP_CONN_STR "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=<>)(PORT=<>)))(CONNECT_DATA=(SERVICE_NAME=<>)))"
For example,
C:\Program Files\Oracle\Middleware\oms\bin\omsca delete -full -REP_CONN_STR "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=example.com)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=srvc.example.com)))"
Note:
When you runomsca delete -full on the first (main) OMS, the command also deletes the primary Oracle BI Publisher managed server, if configured on the first OMS.Stop the Management Agent running on the first (main) OMS, by running the following command from its home:
$<AGENT_HOME>/bin/emctl stop agent
For example,
/u01/app/Oracle/agent/core/12.1.0.5.0/bin/emctl stop agent
Stop the Oracle WebLogic Server so that it does not access the schemas you are going to drop in the next step. For instructions, see the chapter on starting and stopping Oracle Fusion Middleware components in the Oracle Fusion Middleware Administrator's Guide.
Before you deinstall Enterprise Manager, meet the following prerequisites:
Perform the steps outlined in Section 21.1.1.
Drop the Oracle Management Repository (Management Repository):
WARNING:
Once the Management Repository is dropped, it CANNOT be retrieved. Therefore, drop the Management Repository ONLY IF you want to deinstall the entire Enterprise Manager system, that is, all your OMS instances, Management Agents, and also the Management Repository. If you want to deinstall only the OMS (or any additional OMS), then do not drop the Management Repository.
WARNING:
The RepManager in drop mode puts the database in quiesce mode by "ALTER SYSTEM QUIESCE RESTRICTED;" command.
Ensure that there are no SYSMAN users logged in.
Drop the Enterprise Manager Cloud Control schema (SYSMAN schema) and the Metadata schema (MDS schema) from the Management Repository by running the following command from the OMS home:
$<OMS_HOME>/sysman/admin/emdrep/bin/RepManager <database_host> <repository_database_port> <repository_database_sid> -action drop -dbUser <repository_database_user> -dbPassword <repository_database_password> -dbRole <repository_database_user_role> -reposName <repository_name> -mwHome <middleware_home> -mwOraHome <middleware_ora_home> -oracleHome <OMS_HOME>
For example,
/u01/app/Oracle/Middleware/oms/sysman/admin/emdrep/bin/RepManager example.com 1234 sid_em -action drop -dbUser sys -dbPassword letmein -dbRole sysdba -reposName SYSMAN -mwHome /u01/app/Oracle/Middleware/ -mwOraHome /u01/app/Oracle/Middleware/ -oracleHome /u01/app/Oracle/Middleware/oms/
Note:
On Microsoft Windows, if you are invoking RepManager.bat from outside of <OMS_HOME>\sysman\admin\emdrep\bin directory, then set the ORACLE_HOME environment variable to the OMS home.
For example,
set ORACLE_HOME=c:\oracle\middleware\oms
OMS home or $<OMS_HOME> refers to the first (main) OMS where the Admin Server is configured.
-mwHome and -mwOraHome refer to the middleware home where the first (main) OMS is configured. The first (main) OMS is the OMS where the Admin Server is configured.
-oracleHome refers to the Oracle home of the first (main) OMS where the Admin Server is configured.
If you are dropping the schemas that belong to a 10g Release 2 (10.2.x.x) Management Repository, then run the command without these arguments: -mwHome <middleware_home> -mwOraHome <middleware_ora_home> -oracleHome <oracle_home>
For example,
/u01/app/Oracle/Middleware/oms/sysman/admin/emdrep/bin/RepManager example.com 1234 sid_em -action drop -dbUser sys -dbPassword letmein -dbRole sysdba -reposName SYSMAN
For information on the support for -action drop and -action dropall, see Table 2-3.
The -action drop command drops all the schemas and provides a confirmation message. If the action was unsuccessful, then it lists all the entities that could not be cleaned or dropped. For example, X schema is not cleaned, synonyms are not cleaned, tablespaces are not cleaned. In this case, rerun the command.
If you do not have RepManager, or if you want to manually clean up the leftover entities, then see My Oracle Support note 1365820.1.
If you want to drop the Enterprise Manager schema completely, then use the RepManager available in the OMS home. Do not use the one in database home because it cannot remove the Enterprise Manager schema completely.
Manually delete the data files mgmt.dbf and mgmt_ecm_depot1.dbf from the database home.
Note:
On Microsoft Windows, if you see the following error while deleting the.dbf files, then stop the database service, and try deleting the files again.
The process cannot access the file because it is being used by another process
This section describes the following:
To deinstall Enterprise Manager—single OMS environment or multi-OMS environment with additional OMS instances—in graphical mode, follow these steps:
Note:
Deinstall the components in the order described in this procedure. Otherwise, the installation wizard displays an error.
For a multi-OMS environment, perform the steps outlined in this section on each of the additional OMS instances.
Invoke the installer from the OMS home by running the following command:
$<OMS_HOME>/oui/bin/runInstaller -deinstall ORACLE_HOME=<absolute_path_to_oms_home> -jreLoc <path> [-removeallfiles] [-invPtrLoc <absolute_path_to_oraInst.loc>]
For example,
/u01/app/Oracle/Middleware/oms/oui/bin/runInstaller -deinstall ORACLE_HOME=/u01/app/Oracle/Middleware/oms/ -jreLoc /u01/app/Oracle/Middleware/jdk16/jdk -removeallfiles -invPtrLoc /u01/oraInst.loc
Note:
You can invoke the installer even from the directory where you downloaded the software. For example, <software_location>/.
The -invPtrLoc parameter is supported only on UNIX platforms, and not on Microsoft Windows platforms.
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 the Inventory screen, select the plug-in homes, and click Remove.
If you are deinstalling the entire Enterprise Manager system (with or without the Management Repository), then deinstall all the plug-in homes, including the OMS and Management Agent plug-in homes.
If you are deinstalling an additional OMS, then deinstall only the OMS plug-in homes.
On the Inventory screen, select the sbin home, and click Remove.
On the Inventory screen, select the Java Development Kit (JDK) home, and click Remove.
Note:
Deinstall JDK only if it was installed by the installation wizard while installing the Enterprise Manager system. Otherwise, you can skip this step.Note:
After deinstalling JDK, do NOT exit the installer. If you exit the installer inadvertently, then follow these steps:Manually download and install JDK 1.6.0.43.0 on the OMS host. If you already have this supported version, then you can reuse it.
Invoke the installer again and pass the absolute path to the location where you have JDK:
$<OMS_HOME>/oui/bin/runInstaller -deinstall -jreLoc <JDK_HOME> [-removeallfiles] [-invPtrLoc <absolute_path_to_oraInst.loc>]
On the Inventory screen, select the Oracle WebTier home, and click Remove.
On the Inventory screen, select the Oracle BI Publisher home, and click Remove.
Note:
You must perform this step even if you have not configured Oracle BI Publisher.On the Inventory screen, select the OMS home, the Management Agent home, and the Oracle Common directory, and click Remove.
If you are deinstalling the entire Enterprise Manager system (with or without the Management Repository), then select and deinstall the OMS home, the Management Agent home, and the Oracle Common directory.
If you are deinstalling an additional OMS, then do one of the following:
If you plan to install another additional OMS on that host later, then select and deinstall only the OMS home and the Oracle Common directory.
In this case, do NOT select and deinstall the Management Agent home. This Management Agent home belongs to the standalone Management Agent that was installed as a prerequisite for additional OMS installation. You will need this Management Agent when you install the new additional OMS. If you deinstall it now, then you will have to reinstall it later when you plan to install the new additional OMS.
If you do not plan to install another OMS on that host, then select and deinstall the OMS home, the Management Agent home, and the Oracle Common directory.
On the Inventory screen, click Close to exit the wizard.
Manually delete the middleware home:
For UNIX platforms:
rm -rf <absolute_path_to_middleware_home>
For Microsoft Windows platforms:
del <absolute_path_to_middleware_home>
Note:
If you see an error stating that the middleware home could not be deleted because of a long path, then shorten the middleware home name in one of the following ways:Rename the middleware home to a short name.
For example, change C:\Oracle\Middleware to C:\OR\MW.
Mount a drive to the middleware home path.
For example, if C:\Oracle\Middleware\oms\bin is the directory that is causing an issue, then shorten the path in such a way that path length decreases to a reasonable extent (the file path limits differ from one operating system to another).
Mount C:\Oracle\Middleware\oms to drive Z.
Navigate to drive Z, and delete the files:
prompt>Z:
prompt>del bin
Navigate to the middleware home, and delete the leftover files:
prompt:>C:
prompt>del C:\Oracle\Middleware\
To deinstall Enterprise Manager—single OMS environment or multi-OMS environment with additional OMS instances—in silent mode, follow these steps:
Note:
Deinstall the components in the order described in this procedure. Otherwise, the installation wizard displays an error.
For a multi-OMS environment, perform the steps outlined in this section on each of the additional OMS instances.
Deinstall Oracle WebLogic Server 11g Release 1 (10.3.6) following the instructions outlined in the Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server. See the chapter that describes how you can deinstall the software.
The Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server is available in the Oracle WebLogic Server documentation library available at:
http://www.oracle.com/technetwork/indexes/documentation/index.html
Note:
Deinstall Oracle WebLogic Server 11g Release 1 (10.3.6) only if it was installed by the installation wizard while installing the Enterprise Manager system.Deinstall the plug-in homes:
If you are deinstalling the entire Enterprise Manager system (with or without the Management Repository), then deinstall all the plug-in homes, including the OMS and Management Agent plug-in homes.
If you are deinstalling an additional OMS, then deinstall only the OMS plug-in homes.
To deinstall the plug-in homes, run the following command:
$<OMS_HOME>/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={absolute_path_to_plug-in_home}" ORACLE_HOME=<absolute_path_to_oms_home> -jreLoc <JDK_HOME> [-removeallfiles] [-invPtrLoc <absolute_path_to_oraInst.loc>]
For example,
/u01/app/Oracle/Middleware/oms/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={/u01/app/Oracle/Middleware/plugins/oracle.sysman.db.oms.plugin_12.1.0.2.0,/u01/app/Oracle/agent/plugins/oracle.sysman.db.discovery.plugin_12.1.0.2.0}" ORACLE_HOME=/u01/app/Oracle/Middleware/oms -jreLoc /u01/app/Oracle/Middleware/jdk16/jdk -removeAllFiles -invPtrLoc /u01/oraInst.loc
Note:
You can invoke the installer even from the directory where you downloaded the software. If you do so, then do NOT pass -removeallfiles.
For example, if you have downloaded the software to /u01/app/Oracle/Downloads, then run the following command, skipping the -removeallfiles argument.
/u01/app/Oracle/Downloads/Disk1/runInstaller -deinstall -silent "REMOVE_HOMES={/u01/app/Oracle/Middleware/plugins/oracle.sysman.db.oms.plugin_12.1.0.2.0,/u01/app/Oracle/agent/plugins/oracle.sysman.db.discovery.plugin_12.1.0.2.0}" ORACLE_HOME=/u01/app/Oracle/Middleware/oms -jreLoc /u01/app/Oracle/Middleware/jdk16 -invPtrLoc /u01/oraInst.loc
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.
To deinstall multiple plug-ins, enter the plug-in homes separated by a comma.
The -invPtrLoc parameter is supported only on UNIX platforms, and not on Microsoft Windows platforms.
Deinstall the sbin home:
$<OMS_HOME>/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={absolute_path_to_sbin_home}" ORACLE_HOME=<absolute_path_to_oms_home> -jreLoc <JDK_HOME> [-removeAllFiles] [-invPtrLoc <absolute_path_to_oraInst.loc>]
For example,
/u01/app/Oracle/Middleware/oms/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={/u01/app/Oracle/agent/sbin}" ORACLE_HOME=/u01/app/Oracle/Middleware/oms -jreLoc /u01/app/Oracle/Middleware/jdk16 -removeAllFiles -invPtrLoc /u01/oraInst.loc
Deinstall the Java Development Kit (JDK) home:
$<OMS_HOME>/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={absolute_path_to_jdk_home}" ORACLE_HOME=<absolute_path_to_oms_home> -jreLoc <JDK_HOME> [-removeAllFiles] [-invPtrLoc <absolute_path_to_oraInst.loc>]
For example,
/u01/app/Oracle/Middleware/oms/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={/u01/app/Oracle/Middleware/jdk16}" ORACLE_HOME=/u01/app/Oracle/Middleware/oms -jreLoc /u01/app/Oracle/Middleware/jdk16 -removeAllFiles -invPtrLoc /u01/oraInst.loc
Note:
Deinstall JDK only if it was installed by the installation wizard while installing the Enterprise Manager system. Otherwise, you can skip this step.Manually download and install JDK 1.6.0.43.0 on the OMS host. If you already have this supported version, then you can reuse it.
You must reinstall JDK because the installer has a dependency on it. The new JDK can be installed anywhere on the OMS host, not necessarily in the same location where it existed before. However, ensure that you pass the -jreLoc parameter (as described in the following steps) while invoking the installer to indicate the location where you have installed the JDK.
Deinstall the Oracle WebTier home:
$<OMS_HOME>/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={absolute_path_to_web_tier}" ORACLE_HOME=<absolute_path_to_oms_home> -jreLoc <JDK_HOME> [-removeAllFiles] [-invPtrLoc <absolute_path_to_oraInst.loc>]
For example,
/u01/app/Oracle/Middleware/oms/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={/u01/app/Oracle/Middleware/Oracle_WT}" ORACLE_HOME=/u01/app/Oracle/Middleware/oms -jreLoc /u01/app/Oracle/Middleware/jdk16 -removeAllFiles -invPtrLoc /u01/oraInst.loc
Deinstall the Oracle BI Publisher home:
$<OMS_HOME>/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={absolute_path_to_bip}" ORACLE_HOME=<absolute_path_to_oms_home> -jreLoc <JDK_HOME> [-removeAllFiles] [-invPtrLoc <absolute_path_to_oraInst.loc>]
Note:
You must perform this step even if you have not configured Oracle BI Publisher.For example,
/u01/app/Oracle/Middleware/oms/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={/u01/app/Oracle/Middleware/Oracle_BI1}" ORACLE_HOME=/u01/app/Oracle/Middleware/oms -jreLoc /u01/app/Oracle/Middleware/jdk16 -removeAllFiles -invPtrLoc /u01/oraInst.loc
Deinstall the OMS home, the Management Agent home, and the Oracle Common directory.
If you are deinstalling the entire Enterprise Manager system (with or without the Management Repository), then deinstall the OMS home, the Management Agent home, and the Oracle Common directory.
If you are deinstalling an additional OMS, then do one of the following:
If you plan to install another additional OMS on that host later, then deinstall only the OMS home and the Oracle Common directory.
In this case, do NOT select and deinstall the Management Agent home. This Management Agent home belongs to the standalone Management Agent that was installed as a prerequisite for additional OMS installation. You will need this Management Agent when you install the new additional OMS. If you deinstall it now, then you will have to reinstall it later when you plan to install the new additional OMS.
If you do not plan to install another OMS on that host, then deinstall the OMS home, the Management Agent home, and the Oracle Common directory.
To deinstall the OMS home, the Management Agent home, and the Oracle Common directory, run the following command:
$<OMS_HOME>/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={absolute_path_to_oracle_homes_and_directories_to_be_deinstalled}" ORACLE_HOME=<absolute_path_to_oms_home> -jreLoc <JDK_HOME> [-removeAllFiles] [-invPtrLoc <absolute_path_to_oraInst.loc>]
Note:
The argumentREMOVE_HOMES accepts more than one path separated by a comma.For example,
/u01/app/Oracle/Middleware/oms/oui/bin/runInstaller -deinstall -silent "REMOVE_HOMES={/u01/app/Oracle/Middleware/oms,/u01/app/Oracle/agent/core/12.1.0.5.0,/u01/app/Oracle/Middleware/oracle_common}" ORACLE_HOME=/u01/app/Oracle/Middleware/oms -jreLoc /u01/app/Oracle/Middleware/jdk16 -removeAllFiles -invPtrLoc /u01/oraInst.loc
Manually delete the middleware home:
For UNIX platforms:
rm -rf <absolute_path_to_middleware_home>
For Microsoft Windows platforms:
del <absolute_path_to_middleware_home>
After you deinstall, perform these steps:
The Oracle homes you deinstalled are deregistered from the central inventory. However, some files might still remain in these Oracle homes. You might also see the OMS instance base directory and the Oracle home for Web Tier. You can manually delete these files and directories.
The deinstallation process removes the entry of the S98gcstartup script, an auto-start script, from the /etc/oragchomelist file, but does not remove the script itself. You can leave this script and the soft links associated with it because when you install Enterprise Manager again on the same host, the installer automatically overwrites the script and re-create the soft links.
However, if you want to clear the host of any Oracle products, then Oracle recommends that you manually delete this script and the soft links associated with it. To do so, navigate to the /etc/rc.d/ directory, and search for the 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 or /etc/rc.d/init.d/gcstartup/S98gcstartup.
The JDK, which was installed as part of Step (5) of Section 21.1.3.2 to allow complete removal of the Enterprise Manager system, can now be removed manually (by deletion of the installed directory) if it is no longer needed for other purposes and if it did not replace the system-registered JDK.
If you want to deinstall or undeploy only the plug-ins from the OMS, and not the entire Enterprise Manager system, 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 runInstaller to undeploy only the plug-ins.
If you lose the host where an additional OMS is running, then make sure you manually delete the entry for that OMS from the Management Repository. To do so, follow these steps:
Run the following command to deconfigure Oracle WebLogic Server, applications, and so on from the WebLogic Domain; remove all OMS-related entries from the Management Repository; and delete these targets of the OMS: oracle_oms, oracle_oms_pbs, oracle_oms_console.
$ORACLE_HOME/bin/omsca delete
Manually delete the following WebLogic targets of the OMS.
/EMGC_GCDomain/GCDomain/EMGC_OMS2 (weblogic_j2eeserver)
/EMGC_GCDomain/instance2/ohs2 (oracle_apache)
Now Enterprise Manager will not have any reference of the deleted additional OMS. If you want to delete the OMS, follow the instructions outlined in Section 21.1.