1. Installing and Configuring Oracle Data Integrator
  2. Uninstalling or Reinstalling Oracle Data Integrator

10 Uninstalling or Reinstalling Oracle Data Integrator

Follow the instructions in this section to uninstall or reinstall Oracle Data Integrator.

Oracle recommends that you always use the instructions in this section to remove the software. If you try to remove the software manually, you may encounter problems when you try to reinstall the software again at a later time. Following the procedures in this section ensures that the software is properly removed.

Stopping the Oracle Data Integrator Agents

Before running the uninstaller, stop all running components/processes.

Stopping a Standalone Agent with Node Manager

To stop a standalone agent when using Node Manager:

  1. Go to the DOMAIN_HOME/bin directory.

  2. Enter the following command:

    • (UNIX) ./stopComponent.sh OracleDIAgent1

    • (Windows) stopComponent.cmd OracleDIAgent1

  3. At the prompt, enter the Administrator password for the domain.

Stopping a Standalone Agent Without Node Manager

To stop a standalone agent without Node Manager by using the agent command:

  1. Go to the DOMAIN_HOME/bin directory.

  2. Enter the following command:

    • (UNIX) ./agentstop.sh -NAME=OracleDIAgent1

    • (Windows) agentstop.cmd -NAME=OracleDIAgent1

    where, -NAME must be entered in capital letters, and the name of the agent (in this example, OracleDIAgent1) is case-sensitive.

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.

Table 10-1 Different Parameters for the Command to Stop the Agent.

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 parameter is deprecated.

-NAME=<agent name>

If this parameter is specified, the physical agent whose name is provided is terminated. This agent may be a local or a remote agent, and must be declared in the master repository. This parameter has precedence over the PORT parameter.

-IMMEDIATE=<true|false(default)>

If this parameter is set to 'true', the agent is terminated without waiting for completion of its running sessions. If it is set to 'false', the agent is terminated after all its running sessions reach completion or after the MAX_WAIT timeout is reached. The default value is 'false'.

-MAX_WAIT=<stop timeout in millis>

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

Stopping Oracle Fusion Middleware

Before running the Uninstall Wizard, Oracle recommends that you stop all servers and processes associated with the Oracle home you are going to remove.

See Stopping an Oracle Fusion Middleware Environment in Administering Oracle Fusion Middleware.

Removing Your Database Schemas

Before you remove the Oracle home, Oracle recommends that you run the Repository Creation Utility (RCU) to remove database schemas associated with this domain.

Each domain has its own set of schemas, uniquely identified by a custom prefix. For more information about custom prefixes, see About Custom Prefixes in Creating Schemas with the Repository Creation Utility. This set of schemas cannot be shared with any other domain. For more information about creating schemas with the RCU, see Planning Your Schema Creation in Creating Schemas with the Repository Creation Utility.

If there are multiple sets of schemas on your database, be sure to identify the schema prefix associated with the domain that you are removing.

For schema removal steps, see Dropping Schemas in Creating Schemas with the Repository Creation Utility.

Uninstalling the Software

Follow the instructions in this section to start the Uninstall Wizard and remove the software.

If you want to uninstall the product in a silent (command-line) mode, see Running the Oracle Universal Installer for Silent Uninstallation in Installing Software with the Oracle Universal Installer.

Starting the Uninstall Wizard

To start the Uninstall Wizard:

  1. Change to the following directory:
    (UNIX) ORACLE_HOME/oui/bin
    (Windows) ORACLE_HOME\oui\bin
  2. Enter the following command:
    (UNIX) ./deinstall.sh
    (Windows) deinstall.cmd

Selecting the Product to Uninstall

Because multiple products exist in the Oracle home, ensure that you are uninstalling the correct product.

After you run the Uninstall Wizard, the Distribution to Uninstall screen opens. From the dropdown menu, select the product you want to remove and click Uninstall. The uninstallation program shows the screens listed in Navigating the Uninstall Wizard Screens.

Note:

You can uninstall Oracle Fusion Middleware Infrastructure after you uninstall Oracle Data Integrator software by running the Uninstall Wizard again. Before doing so, make sure that there are no other products using the Infrastructure; those products will no longer function once the Infrastructure is removed. You will not encounter the Distribution to Uninstall screen if no other software depends on Oracle Fusion Middleware Infrastructure. See Uninstalling Oracle Fusion Middleware Infrastructure in Installing and Configuring the Oracle Fusion Middleware Infrastructure.

Navigating the Uninstall Wizard Screens

The Uninstall Wizard shows a series of screens to confirm the removal of the software.

Table 10-2 describes the screens in the Uninstall Wizard. For information, click Help on the screen.

Table 10-2 Uninstall Wizard Screens and Descriptions

Screen Description

Welcome

Introduces you to the product Uninstall Wizard.

Uninstall Summary

Shows the Oracle home directory and its contents that are uninstalled. Verify that this is the correct directory.

If you want to save these options to a response file, click Save Response File and enter the response file location and name. You can use the response file later to uninstall the product in silent (command-line) mode. See Running the Oracle Universal Installer for Silent Uninstall in Installing Software with the Oracle Universal Installer.

Click Deinstall, to begin removing the software.

Uninstall Progress

Shows the uninstallation progress.

Uninstall Complete

Appears when the uninstallation is complete. Review the information on this screen, then click Finish to close the Uninstall Wizard.

Removing the Oracle Home Directory Manually

After you uninstall the software, you must manually remove your Oracle home directory and any existing subdirectories that the Uninstall Wizard did not remove.

For example, if your Oracle home directory is /home/Oracle/product/ORACLE_HOME on Linux or UNIX operating systems, enter the following commands: 

 cd /home/Oracle/product
 rm -rf ORACLE_HOME

Removing the Program Shortcuts on Windows Operating Systems

On Windows operating systems, you must also manually remove the program shortcuts; the Deinstallation Wizard does not remove them for you.

To remove the program shortcuts on Windows:

  1. Change to the following directory: C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Oracle\ORACLE_HOME\Product

  2. If you only have one product installed in your Oracle home, delete the ORACLE_HOME directory. If you have multiple products installed in your Oracle home, delete all products before you delete the ORACLE_HOME directory.

Removing the Domain and Application Data

After you uninstall the software, you must remove the domain and application data.

To remove the domain and application data:
  1. Manually remove your Domain home directory. For example:

    On Linux operating systems, if your Domain home directory is /home/Oracle/config/domains/odi_domain, enter the following command:

    cd /home/Oracle/config/domains

    rm -rf odi_domain

    On Windows operating systems, if your Domain home directory is C:\Oracle\Config\domains\odi_domain, use a file manager window and navigate to the C:\Oracle\Config\domains directory. Right-click on the odi_domain folder and select Delete.

  2. Manually remove your Application home directory. For example:

    On Linux operating systems, if your Application home directory is /home/Oracle/config/applications/odi_domain, enter the following commands:

    cd /home/Oracle/config/applications

    rm -rf odi_domain

    On Windows operating systems, if your Application home directory is C:\Oracle\Config\applications\odi_domain, use a file manager window and navigate to the C:\Oracle\Config\applications directory. Right-click on the odi_domain folder and select Delete.

  3. Back up the domain_registry.xml file in your Oracle home, then edit the file and remove the line associated with the domain that you are removing. For example, to remove the odi_domain, find the following line and remove it:
    <domain location="/home/Oracle/config/domains/odi_domain"/>

    Save and exit the file when you are finished.

Removing Oracle Data Integrator Wallet Information

The ODI wallet holds encrypted data credentials that must be removed manually.

The uninstaller does not remove the ODI wallet, and it must be manually removed. Wallet information is stored in a directory inside the user's home directory as follows:

  • (UNIX) /home/exampleuser/.odi

  • (Windows) C:\Users\exampleuser\AppData\Roaming\odi

Reinstalling the Software

You can reinstall your software into the same Oracle home as a previous installation only if you uninstalled the software by following the instructions in this section, including manually removing the Oracle home directory.

When you reinstall, you can then specify the same Oracle home as your previous installation.

Consider the following cases where the Oracle home is not empty:

  • Installing in an existing Oracle home that contains the same feature sets.

    The installer warns you that the Oracle home that you specified during installation already contains the same software you are trying to install.

    You can either:

    • Select a different installation type. In this case, only the feature sets that do not exist in the Oracle home directory are installed.

    • Select a different Oracle home directory.

  • Installing in an existing, non-empty Oracle home.

    For example, suppose you chose to create your Domain home or Application home somewhere inside your existing Oracle home. This data is not removed when you uninstall a product, so if you try to reinstall into the same Oracle home, the installer does not allow it. Your options are:

    • Uninstall your software from the Oracle home (as this section describes) and then remove the Oracle home directory. After you uninstall the software and remove the Oracle home directory, you can reinstall and reuse the same Oracle home location. Any domain or application data that was in the Oracle home must be re-created.

    • Select a different Oracle home directory.