C 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 C.2, "Reinstallation" for more information.

C.1 Deinstallation Instructions

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. For example, when you launch the ODI Deinstaller from the ODI_HOME/oui/bin directory, all of the ODI components in the ODI_HOME will be deinstalled. Be sure that no system components are using the Oracle home you want to remove.

This procedure involves the following:

Section C.1.1, "Stopping Oracle Fusion Middleware"
Section C.1.2, "Stopping a Standalone Agent"
Section C.1.3, "Removing the Oracle Data Integrator Schemas"
Section C.1.4, "Removing Oracle Data Integrator Components"
Section C.1.5, "Removing the ODI Home"
Section C.1.6, "Removing the Oracle Common Home"
Section C.1.7, "Removing Oracle WebLogic Server"
Section C.1.8, "Removing the Program Groups (Windows Only)"

C.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.

C.1.2 Stopping a Standalone Agent

You can stop 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:

Change directory to the /agent/bin directory of the Oracle Data Integrator Agent.
Enter the following command to stop the agent.
- On UNIX system:
  
  ./agentstop.sh
- On Windows system:
  
  agentstop.bat

The Standalone Agent is stopped.

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

Note:

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.

Examples:

On UNIX operating systems: ./agentstop.sh stops the agent on the default port.
On Windows: agentstop "-PORT=20300" stops the agent on the port 20300.

AgentStop Command Parameters

The table below 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.

Parameters	Description
`-PORT=<port>`	This parameter is deprecated. It is used to stop a standalone agent on the same machine. It is a shortcut to `-AGENT_URL=http://localhost:<port>/oraclediagent`. The default port is 20910.
`-AGENT_URL=<agent_url>`	URL of the standalone agent to stop. This parameter has precedence over the AGENT_NAME and PORT parameters is deprecated.
`-NAME=<agent name>`	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. This parameter has precedence over the PORT parameter.
`-IMMEDIATE=<true(default)\|false>`	If this parameter is set to `Yes` then the agent is killed without waiting for completion of its running sessions. If it is set to no then the agent is killed after all its running sessions reach completion or after the MAX_WAIT time-out is reached. Default value is No.
`-MAX_WAIT=<stop timeout in millis>`	This parameter can be used when IMMEDIATE is set to No. 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.

C.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. 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.

C.1.4 Removing Oracle Data Integrator Components

Follow the instructions in this section to deinstall the Oracle Data Integrator components from the ODI_HOME.

C.1.4.1 Starting the Deinstaller

For Oracle Data Integrator products, 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.

Caution:
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 C-1 to remove the ODI_HOME.

C.1.5 Removing the ODI Home

After starting the Deinstaller, follow the instructions in Table C-1 to remove your ODQ_HOME.

Table C-1 Removing Your Oracle Data Integrator Home

Number	Screen	Description and Action Required
1	Welcome Screen	Click Next to continue.
2	Deinstall Oracle Home Screen	Select Deinstall Oracle Home. Verify the Oracle home directory that is about the be deinstalled. Click Deinstall to continue.
3	Deinstallation Progress Screen	This screen shows the progress and status of the deinstallation.
4	Deinstallation Complete Screen	Click Finish to dismiss the screen.

C.1.6 Removing the Oracle Common Home

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

To start the Deinstaller, navigate to the MW_HOME/oracle_common/oui/bin (on UNIX operating systems) or MW_HOME\oracle_common\oui\bin (on Windows operating systems) directory and start the Deinstaller.

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 (on UNIX operating systems) or MW_HOME\jdk160 (on Windows operating systems), where MW_HOME is the Oracle Fusion 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 C-1 to remove the Oracle Common home.

C.1.7 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.

C.1.8 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

Note:

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

C.2 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:

Follow the instructions in Section C.1.4, "Removing Oracle Data Integrator Components" to remove all Oracle Data Integrator components from the ODI_HOME directory.
Follow the instructions in Chapter 2, "Installing Oracle Data Integrator" to reinstall the software.