Skip Headers
Oracle® Fusion Middleware Installation Guide for Oracle Data Integrator
11g Release 1 (11.1.1)

Part Number E16453-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

D Deinstalling Oracle Data Integrator and Oracle Data Quality

This appendix describes how to remove Oracle Data Integrator and the Oracle Data Quality 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 D.2, "Reinstallation" for more information.

D.1 Deinstallation Instructions

This section contains information and instructions for removing Oracle Data Integrator and Oracle Data Quality components. When you run the Oracle Data Integrator Deinstaller, it removes everything under the Oracle home (referred to in this guide as ODI_HOME or ODQ_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:

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

D.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:

  1. Change directory to the /agent/bin directory of the Oracle Data Integrator Agent.

  2. 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 I, "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.

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

D.1.4 Removing Oracle Data Integrator Components

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

D.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 D-1 to remove the ODI_HOME.

D.1.5 Removing Oracle Data Quality Components

Follow the instructions in this section to deinstall the Oracle Data Integrator and Oracle Data Quality components from the ODQ_HOME directory.

D.1.5.1 Starting the Deinstaller

For Oracle Data Quality products, go to the ODQ_HOME/oui/bin (on UNIX operating systems) or ODQ_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 - ODQ_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 D-1 to remove the ODQ_HOME.

D.1.6 Removing the ODI Home and ODQ Home

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

Note:

If you plan to reinstall Oracle Data Quality and use the same port numbers, you must modify the services file and the inetd.conf file after the deinstallation. See Section D.1.10, "Removing Entries from Services File on UNIX Operating Systems" and Section D.1.11, "Removing Entries from inetd.conf File on UNIX Operating Systems".

Table D-1 Removing Your Oracle Data Integrator and Oracle Data Quality 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.


D.1.7 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 D-1 to remove the Oracle Common home.

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

D.1.9 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.

D.1.10 Removing Entries from Services File on UNIX Operating Systems

When you installed Oracle Data Quality, two entries were added to the bottom of the services file found in the /etc directory. These entries must be removed before you attempt to reinstall the Oracle Data Quality products.

To remove entries in the Services file

  1. After removing Oracle Data Quality binaries and metabases as described in Section D.1.5 and Section D.1.6, log in as root and change directories to the directory /etc.

  2. Locate the file named services and make a backup.

  3. Open the services file for editing and go to the end of the file. You will see three lines inserted into the file as shown below:

    #  These lines are entered for TSS 12 - Metabase Server
    dscserv1_rel1200 8500/tcp
    dscserv1_lm_rel1200 8501/tcp
    
  4. Delete these three lines from the services file.

  5. Save your changes and close the file.

D.1.11 Removing Entries from inetd.conf File on UNIX Operating Systems

When you installed Oracle Data Quality, an entry was added to the bottom of the inetd.conf file found in the /etc directory. This entry must be removed before you attempt to reinstall the Oracle Data Quality products.

To remove entries from inetd.conf

  1. After modifying the services file as described in Section D.1.10, locate the file named inetd.conf. (You should still be in the directory /etc. You must be logged in as root to perform this task.)

  2. Locate the file named inetd.conf and make a backup.

    NOTE: On Linux operating systems the file is named TSDiscovery and is located in the hidden directory /etc/xinetd.d.

  3. Open inetd.conf for editing and go to the end of the file. You will see one line inserted into the file as shown below:

    # These lines are entered for TSS 12 - Metabase Server
    dscserv1_rel1200 stream tcp nowait systest /usr/bin/env -i HOME=/home systest
    .LOGNAME=systest /home/system/rel1200_doc/metabase/bin/mtb_server
    
  4. Delete the line from the inetd.conf file.

  5. Save your changes and close the file.

  6. Restart inetd in order to release the ports. While logged in as root, use the following command:

    kill -HUP $(ps -e|grep inetd|head -1|awk '{print$1}')
    

    This command will stop and restart inetd. Check with your UNIX administrator to ensure that this command will not cause problems in your environment.

D.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:

  1. Follow the instructions in Section D.1.4, "Removing Oracle Data Integrator Components" to remove all Oracle Data Integrator components from the ODI_HOME directory and Section D.1.5, "Removing Oracle Data Quality Components" to remove the Oracle Data Quality components from the ODQ_HOME directory.

  2. If you plan to reuse ports, you must follow the instructions in Section D.1.10, "Removing Entries from Services File on UNIX Operating Systems" and Section D.1.11, "Removing Entries from inetd.conf File on UNIX Operating Systems".

  3. Follow the instructions in Chapter 2, "Installing Oracle Data Integrator" and Chapter 4, "Installing Oracle Data Profiling and Oracle Data Quality" to reinstall the software.