This chapter describes how to deinstall or reinstall Oracle Data Integrator.
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.
The following topics are covered in this chapter:
The Oracle Fusion Middleware deinstaller removes the software from the Oracle home directory from which it is started. Table 8-1 summarizes the procedure and provides links to supporting documentation.
Table 8-1 Roadmap for Deinstalling Oracle Data Integrator
| Task | Description | Documentation |
|---|---|---|
|
Stop Oracle Fusion Middleware. |
All servers and processes in your domain should be stopped before running the deinstaller. |
See Section 8.2. |
|
Remove your database schemas. |
Run Repository Creation Utility to remove your database schemas. |
See Section 8.3. |
|
Remove the software. |
Run the product deinstaller to remove Oracle Fusion Middleware Infrastructure. |
See Section 8.4. |
|
Remove the Oracle home directory. |
The deinstaller does not remove all files and folders from the Oracle home directory. After the deinstaller is finished, you must manually remove the Oracle home to complete your product removal. |
See Section 8.5. |
|
Remove your domain and application data. |
The deinstaller does not remove data contained in your Domain home or Application home directories, even if they are located inside the Oracle home. You must remove these directories manually. |
See Section 8.6. |
|
Remove Oracle Fusion Middleware Infrastructure. |
In you created the topology for Java EE agents, you can also remove the Oracle Fusion Middleware Infrastructure software from your system. |
See Section 8.8. |
Stopping Oracle Fusion Middleware involves the following:
Section 8.2.1, "Stopping Your Oracle Data Integrator Agents"
Section 8.2.2, "Stopping the Oracle Fusion Middleware Environment"
Before running the deinstaller, you should stop all agents that are running.
To stop your standalone agent, go to the DOMAIN_HOME/bin directory and run the following commands:
On UNIX operating systems:
./stopComponent.sh OracleDIAgent1
On Windows operating systems:
stopComponent.cmd OracleDIAgent1
Before running the deinstaller, you should 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 Administering Oracle Fusion Middleware.
Before your Oracle home is removed, you should run Repository Creation Utility to remove the database schemas associated with this domain. Each domain has its own set of schemas, uniquely identified by a custom prefix (see "Understanding Custom Prefixes" in Creating Schemas with the Repository Creation Utility). This set of schemas cannot be shared with any other domain (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 you are removing.
For schema removal instructions, see "Dropping Schemas" in Creating Schemas with the Repository Creation Utility.
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 Installing Software with the Oracle Universal Installer.
To start the deinstaller on a Windows operating system, do one of the following:
Use a file manager window to go to the ORACLE_HOME\oui\bin directory and double click on deinstall.cmd.
From the command line, go to the ORACLE_HOME\oui\bin and enter the following command:
deinstall.cmd
From the Start menu, select All Programs, then select Oracle, then select OracleHome, then select Uninstall Oracle Middleware.
To start the deinstaller on a UNIX operating system, go to the ORACLE_HOME/oui/bin directory and enter the following command:
./deinstall.sh
The deinstallation program displays a series of screens, in the order listed in Table 8-2.
If you need additional help with any of the deinstallation screens, click the screen name.
Table 8-2 Deinstall Screens and Descriptions
| Screen | Description |
|---|---|
|
This screen introduces you to the product deinstaller. |
|
|
This screen shows the Oracle home directory and its contents that will be deinstalled. Verify that this is the correct directory. Click Deinstall to begin removing the software. |
|
|
This screen shows the progress of the deinstallation. |
|
|
This screen appears when the deinstallation is complete. Review the information on this screen, then click Finish to dismiss the deinstaller. |
After the deinstaller is finished, you must manually remove your Oracle home directory and any existing sub-directories that were not removed by the deinstaller. For example, if your Oracle home directory was /home/oracle/product/Oracle_Home on a UNIX operating system:
> cd /home/oracle/product > rm -rf Oracle_Home
On a Windows operating system, if your Oracle home directory was C:\Oracle\Product\Oracle_Home, use a file manager window and navigate to the C:\Oracle\Product directory, then right-click on the Oracle_Home folder and select Delete.
To remove your domain and application data:
Manually remove your Domain home directory.
For example, if your Domain home directory was /home/oracle/config/domains/odi_domain on a UNIX operating system:
> cd /home/oracle/config/domains > rm -rf odi_domain
On a Windows operating system, if your Domain home directory was C:\Oracle\Config\domains\odi_domain, use a file manager window and navigate to the C:\Oracle\Config\domains directory, then right-click on the odi_domain folder and select Delete.
Manually remove your Application home directory.
For example, if your Application home directory was /home/Oracle/config/applications/odi_domain on a UNIX operating system:
> cd /home/Oracle/config/applications > rm -rf odi_domain
On a Windows operating system, if your Application home directory was C:\Oracle\Config\applications\odi_domain, use a file manager window and navigate to the C:\Oracle\Config\applications directory, then right-click on the odi_domain folder and select Delete.
Backup the domain_registry.xml file in your Oracle home, then edit the file and remove the line associated with the domain 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.
ODI wallet information should be manually removed; the deinstaller does not remove this information. In the event that Oracle Data Integrator is reinstalled on the same system by the same user, the wallet information will be remembered unless it is manually removed.
Wallet information is stored in a directory inside the user's home directory. For example, on a UNIX operating system:
/home/exampleuser/.odi
On a Windows operating system:
C:\Users\exampleuser\AppData\Roaming\odi
After you have removed your Oracle Data Integrator software, you can choose to remove the Oracle Fusion Middleware Infrastructure from your machine. Before doing so, make sure there are no other products using the Infrastructure; those products will no longer function once the Infrastructure is removed.
For deinstallation instructions, see "Deinstalling Oracle Fusion Middleware Infrastructure" in Installing and Configuring the Oracle Fusion Middleware Infrastructure.
You can reinstall your software into the same Oracle home as a previous installation only if you have deinstalled the software according to the instructions in this chapter, 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 will warn you that the Oracle home you specified during the installation already contains the same software you are trying to install. Your options are to:
Select a different installation type. In this case, only the feature sets that do not already exist in the Oracle home directory will be installed.
Select a different Oracle home directory.
Installing in an existing, non-empty Oracle home.
For example, suppose that you have chosen 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 attempt to reinstall into the same Oracle home, the installer will not allow it. Your options are to:
Deinstall your software from the Oracle home as described in this chapter, and then remove the Oracle home directory. After this is complete, you can reinstall and reuse the same Oracle home location, using the instructions in Chapter 2. Any domain or application data that was in the Oracle home will have to be re-created.
Select a different Oracle home directory.