4 Deinstalling Oracle Data Integrator

This appendix describes how to remove Oracle Data Integrator products from your system.

You should always use the instructions provided in this chapter for removing the software. If you try to remove the software manually, you may experience problems when you try to reinstall the software again at a later time. Following the procedures in this chapter will ensure that the software is properly removed. See Section 4.4, "Reinstallation" for more information.

The following topics are covered:

4.1 Performing Pre-Deinstallation Tasks

This section describes the tasks that should be performed prior to removing your Oracle Data Integrator software.

The following topics are covered:

4.1.1 Stopping Oracle Fusion Middleware

Before deinstalling Oracle Fusion Middleware software components, you should stop all servers and processes.

For more information about starting and stopping Oracle Fusion Middleware, refer to "Starting and Stopping Oracle Fusion Middleware" in Oracle Fusion Middleware Administrator's Guide.

4.1.2 Stopping a Standalone Agent

You can stop a Standalone Agent by stopping the Java process of this agent. You can also stop a Standalone Agent remotely using the agentstop command.

To stop a Standalone Agent:

  1. Go to the ODI_HOME/oracledi/agent/bin (on UNIX operating systems) or ODI_HOME\oracledi\agent\bin (on Windows operating systems) directory of the Oracle Data Integrator Agent.

  2. Enter the following command to stop the agent.

    On UNIX operating systems:


    On Windows operating systems:


For more information on stopping the agent with OPMN, see Appendix G, "OPMN Configuration for Standalone Agent".


For security reasons, it is only possible to stop an agent from a command line launched on the same machine that the agent's process was started. It is not possible to stop a remote agent.

AgentStop Command Parameters

Table 4-1 lists the different parameters for the command to stop the agent. The parameters are preceded by the "-" character and the possible values are preceded by the "=" character. When entering the command, consider the operating system specific syntax of the delimiters.

Table 4-1 AgentStop Command Parameters

Parameter Description


URL of the standalone agent to stop:



If this parameter is specified, the physical agent whose name is provided is killed. This agent may be a local or remote agent, and must be declared in the Master Repository.

-IMMEDIATE=true | false

If this parameter is set to true then the agent is killed without waiting for completion of its running sessions. If it is set to false then the agent is killed after all its running sessions reach completion or after the MAX_WAIT time-out is reached. Default value is true.


This parameter can be used when IMMEDIATE is set to false. It defines a timeout in milliseconds after which the agent is killed regardless of the running sessions. Default is 0, meaning no timeout and the agent is killed after all its running sessions reach completion.

4.1.3 Removing the Oracle Data Integrator Schemas

Run the Repository Creation Utility (RCU) to drop the Oracle Data Integrator Master and Work Repositories from your database. For instructions, see "Dropping Schemas" in Oracle Fusion Middleware Repository Creation Utility User's Guide.

If you manually installed the repositories, use the database tools to remove the schemas storing the repositories. See your database administration documentation for more information.

4.2 Deinstalling Oracle Data Integrator

This section contains information and instructions for removing Oracle Data Integrator components. When you run the Oracle Data Integrator deinstaller, it removes everything under the Oracle home (referred to in this guide as ODI_HOME) from which the deinstaller is started. Be sure that no system components are using the Oracle home you want to remove.

The following topics are covered in this section:

4.2.1 Starting the Deinstaller

To start the Oracle Data Integrator deinstaller, go to the ODI_HOME/oui/bin (on UNIX operating systems) or ODI_HOME\oui\bin (on Windows operating systems) directory and start the deinstaller.

  • On UNIX operating systems:

    ./runInstaller.sh -deinstall
  • On Windows operating systems:

    setup.exe -deinstall

    On Windows operating systems, you can also start the Deinstaller from the Start menu by selecting Programs > Oracle Home - ODI_HOME > Uninstall.


    You must reboot your Windows operating system after running the Deinstaller. Failure to do so may result in an incomplete deinstallation.

Follow the instructions in Table 4-2 to remove the ODI_HOME.

4.2.2 Removing the ODI Home

After starting the Deinstaller, follow the instructions in Table 4-2 to remove your ODI_HOME.

Table 4-2 Removing Your Oracle Data Integrator Home

Screen Description and Action Required


The installer displays this screen when you are about to deinstall one or more Oracle Fusion Middleware software components.

Deinstall Oracle Home

Verify the Oracle home you are about to deinstall.

Click Deinstall to continue.

On the Warning screen, select whether or not you want the deinstaller to remove the Oracle home directory in addition to removing the software.

Click Yes to have the deinstaller remove the software and Oracle home, No to remove only the software, or Cancel to return to the previous screen.

If you select No, go to Section 4.2.4, "Manually Removing Your Oracle Home Directories" for instructions on how to manually remove your Oracle home directory.

Deinstallation Progress

This screen shows the progress and status of the deinstallation.

Deinstallation Complete

This screen summarizes the deinstallation that was just completed.

Click Finish to dismiss the screen.

4.2.3 Removing the Oracle Common Home

This section describes how to remove the oracle_common directory in your Middleware home. This directory contains its own deinstaller in MW_HOME/oracle_common/oui/bin (on UNIX operating systems) or MW_HOME\oracle_common\oui\bin (on Windows operating systems), just like any other Oracle home directory.

The deinstaller requires the location of a Java Runtime Environment (JRE) on your system. When you installed Oracle WebLogic Server, a JRE was installed on your system. You can use this location (the location of the JRE directory) to start the installer. The default location for the JRE is MW_HOME/jdk160_version (on UNIX operating systems) or MW_HOME\jdk160_version (on Windows operating systems), where MW_HOME is the Middleware home directory.

On 64-bit platforms, the JRE location is the JAVA_HOME you used to install Oracle WebLogic Server.

On UNIX operating systems:

./runInstaller -deinstall -jreLoc [JRE_LOCATION]

On Windows operating systems:

setup.exe -deinstall -jreLoc [JRE_LOCATION]

You must specify the absolute path to your JRE_LOCATION; relative paths will not work.

After the deinstaller is started, follow the instructions in Table 4-2 to remove the Oracle Common home.

4.2.4 Manually Removing Your Oracle Home Directories

If you selected No on the warning screen during deinstallation, you must manually remove your Oracle home directories and all sub-directories. For example, if your ODI Oracle home directory was /home/Oracle/Middleware/Oracle_ODI1 on a UNIX operating system:

> cd /home/Oracle/Middleware
> rm -rf Oracle_ODI1

On a Windows operating system, if your ODI Oracle home directory was C:\Oracle\Middleware\Oracle_ODI1, use a file manager window and navigate to the C:\Oracle\Middleware directory, then right-click on the Oracle_ODI1 folder and select Delete.

The same procedure can be used to manually remove the Oracle Common home (oracle_common) directory.

4.2.5 Removing the Program Groups (Windows Only)

On Windows operating systems, you must also manually remove the program groups from the Start Menu\Programs folder. As an example (the folder names and program group names on your system may be different), you might remove the following from C:\Documents and Settings\All Users\Start Menu\Programs:

  • Oracle Fusion Middleware 11.1.1.n.n

  • Oracle Data Integrator 11g - Home1

  • Oracle WebLogic


You should reboot your computer after you have finished removing all of your programs to ensure proper cleanup.

4.3 Uninstalling Your Application Server

After you have removed your Oracle Data Integrator software, you can choose to remove your application server from your system. Before doing so, make sure there are no other products using the application server; those products will no longer function once the application server is removed.

This section contains the following topics:

4.3.1 Removing Oracle WebLogic Server

Refer to "Uninstalling the Software" in Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server for instructions on how to remove Oracle WebLogic Server.

After you have removed the Oracle WebLogic Server, you must manually remove the Oracle Fusion Middleware home directory. For example, if your Oracle Fusion Middleware home directory was /home/Oracle/Middleware on a UNIX operating system:

> cd /home/Oracle
> rm -rf Middleware

On a Windows operating system, if your Middleware home directory was C:\Oracle\Middleware, use a file manager window and navigate to the C:\Oracle directory, then right-click the Oracle Fusion Middleware folder and select Delete.

4.3.2 Removing IBM WebSphere

Refer to your IBM WebSphere documentation for instructions on how to remove IBM WebSphere from your system.

4.4 Reinstallation

The installer does not allow reinstallation of Oracle Data Integrator in a directory that already contains an Oracle instance. To reinstall Oracle Data Integrator in the same directory as before, you must:

  1. Follow the instructions in Section 4.2, "Deinstalling Oracle Data Integrator" to remove all Oracle Data Integrator components from the ODI_HOME directory.

  2. Follow the instructions in Chapter 2, "Installing Oracle Data Integrator" to reinstall the software.