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 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. - 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. - Uninstalling the Software
Follow the instructions in this section to start the Uninstall Wizard and remove the software. - 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. - 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. - Removing the Domain and Application Data
After you uninstall the software, you must remove the domain and application data. - Removing Oracle Data Integrator Wallet Information
The ODI wallet holds encrypted data credentials that must be removed manually. - 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.
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:
-
Go to the
DOMAIN_HOME/bin
directory. -
Enter the following command:
-
(UNIX)
./stopComponent.sh OracleDIAgent1
-
(Windows)
stopComponent.cmd OracleDIAgent1
-
- 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:
-
Go to the
DOMAIN_HOME/bin
directory. -
Enter the following command:
-
(UNIX)
./agentstop.sh -NAME=OracleDIAgent1
-
(Windows)
agentstop.cmd -NAME=OracleDIAgent1
-
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 |
---|---|
|
This parameter is deprecated. It is used to stop a standalone
agent on the same machine. It is a shortcut to
|
|
URL of the standalone agent to stop. This parameter has precedence over the AGENT_NAME and PORT parameter is deprecated. |
|
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. |
|
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'. |
|
This parameter can be used when |
Parent topic: Stopping the Oracle Data Integrator Agents
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.
Parent topic: Uninstalling or Reinstalling Oracle Data Integrator
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.
Parent topic: Uninstalling or Reinstalling Oracle Data Integrator
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
- Selecting the Product to Uninstall
- Navigating the Uninstall Wizard Screens
Parent topic: Uninstalling or Reinstalling Oracle Data Integrator
Starting the Uninstall Wizard
To start the Uninstall Wizard:
Parent topic: Uninstalling the Software
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 ODI 12.2.1.4.0 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.
Parent topic: Uninstalling the Software
Navigating the Uninstall Wizard Screens
The Uninstall Wizard shows a series of screens to confirm the removal of the software.
If you need help on screen listed in Table 10-2, 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. |
Parent topic: Uninstalling the Software
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 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.
Parent topic: Uninstalling or Reinstalling Oracle Data Integrator
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:
-
Change to the following directory:
C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Oracle\ORACLE_HOME\Product
-
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.
Parent topic: Uninstalling or Reinstalling Oracle Data Integrator
Removing the Domain and Application Data
After you uninstall the software, you must remove the domain and application data.
Parent topic: Uninstalling or Reinstalling Oracle Data Integrator
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
Parent topic: Uninstalling or Reinstalling Oracle Data Integrator
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.
If ODI is installed again in the same location where it was previously deleted, delete the entire Oracle Home where it was previously installed.
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.
-
Parent topic: Uninstalling or Reinstalling Oracle Data Integrator