10 Deinstalling or Reinstalling Oracle Data Integrator

Follow the instructions in this section to deinstall 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.

10.1 Stopping the Oracle Data Integrator Agents

Before running the deinstaller, stop all running agents.

To stop agents:

  1. Go to the DOMAIN_HOME/bin directory.

  2. Enter the following command:

    • (UNIX) ./stopComponent.sh OracleDIAgent1

    • (Windows) stopComponent.cmd OracleDIAgent1

10.2 Stopping Oracle Fusion Middleware

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

For more information, see Stopping an Oracle Fusion Middleware Environment in Oracle Fusion Middleware Administering Oracle Fusion Middleware.

10.3 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 Oracle Fusion Middleware Creating Schemas with the Repository Creation Utility. This set of schemas cannot be shared with any other domain. For more information, see Planning Your Schema Creation in Oracle Fusion Middleware 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 Oracle Fusion Middleware Creating Schemas with the Repository Creation Utility.

10.4 Deinstalling the Software

Follow the instructions in this section to start the product deinstaller and remove the software.

If you want to perform a silent (command-line) deinstallation, see Running the Oracle Universal Installer for Silent Deinstallation in Oracle Fusion Middleware Installing Software with the Oracle Universal Installer.

10.4.1 Starting the Deinstallation Program

To start the deinstaller:

  • On UNIX

    On the command line, enter the following commands:

    cd ORACLE_HOME/oui/bin
    ./deinstall.sh
    
  • On Windows

    Do one of the following:

    • Use a file manager window to navigate to the ORACLE_HOME\oui\bin directory, and double-click on deinstall.cmd.

    • Open a command prompt and enter the following commands:

      cd %ORACLE_HOME%\oui\bin
      deinstall.cmd
      
    • From the Start menu, select All Programs, then Oracle, then OracleHome, and then Uninstall Oracle Software.

10.4.2 Selecting the Product to Deinstall

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

After you run the deinstaller, the Distribution to Uninstall screen opens. From the drop-down list, select ODI 12.2.1.2.0 and click Uninstall. The deinstallation program shows the screens listed in Navigating the Deinstallation Screens.

Note:

You can deinstall Oracle Fusion Middleware Infrastructure after you deinstall Oracle Data Integrator software by running the deinstallation 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. For deinstallation instructions, see Deinstalling Oracle Fusion Middleware Infrastructure in Oracle Fusion Middleware Installing and Configuring the Oracle Fusion Middleware Infrastructure.

10.4.3 Navigating the Deinstallation Screens

The deinstaller shows a series of screens to confirm the deinstallation of the software.

If you need help on screen listed in Table 10-1, click Help on the screen.

Table 10-1 Deinstallation Screens and Descriptions

Screen Description

Welcome

Introduces you to the product deinstaller.

Deinstallation Summary

Shows the Oracle home directory and its contents that are deinstalled. 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 during a silent deinstallation. For more information on silent or command-line deinstallation, see Running the Oracle Universal Installer for Silent Deinstallation in Installing Software with the Oracle Universal Installer.

Click Deinstall, to begin removing the software.

Deinstallation Progress

Shows the deinstallation progress.

Deinstallation Complete

Appears when the deinstallation is complete. Review the information on this screen, then click Finish to close the deinstaller.

10.5 Removing the Oracle Home Directory Manually

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

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

 cd /home/Oracle/product
 rm -rf ORACLE_HOME

On a Windows operating system, if your Oracle home directory is C:\Oracle\Product\ORACLE_HOME, use a file manager window and navigate to the C:\Oracle\Product directory. Right-click on the ORACLE_HOME folder and select Delete.

10.6 Removing the Program Shortcuts on Windows Operating Systems

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

To remove the program shortcuts on Windows:

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

  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.

10.7 Removing the Domain and Application Data

After you deinstall 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 a UNIX operating system, 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 a Windows operating system, 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 a UNIX operating system, 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 a Windows operating system, 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.

10.8 Removing Oracle Data Integrator Wallet Information

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

The deinstaller 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

10.9 Reinstalling the Software

You can reinstall your software into the same Oracle home as a previous installation only if you deinstalled 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.

    Your options are:

    • 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 during the deinstallation process, so if you try to reinstall into the same Oracle home, the installer does not allow it. Your options are:

    1. Deinstall your software from the Oracle home (as this section describes) and then remove the Oracle home directory. After you deinstall 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.

    2. Select a different Oracle home directory.