15 Deinstalling Oracle GoldenGate Veridata

We recommend that you always use these instructions to remove the software. Note that if you try to remove the software manually, you may encounter problems when you try to reinstall the software again.

This chapter includes the following sections:

15.1 Understanding Product Deinstallation

The Oracle Fusion Middleware deinstaller removes the software from the Oracle home directory from which it is started. Table 15-1 summarizes the procedure and provides links to supporting documentation.

Table 15-1 Roadmap for Deinstalling GoldenGate Veridata

Task Description Documentation

Stop Oracle Fusion Middleware.

All servers and processes in your domain should be stopped before running the deinstaller.

See Stopping Oracle Fusion Middleware.

Remove your database schemas.

Run Repository Creation Utility to remove your database schemas.

See Removing Your Database Schemas.

Remove the software.

Run the product deinstaller to remove Oracle Fusion Middleware Infrastructure.

See Deinstalling the Software.

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 Removing the Oracle Home Directory Manually.

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 Removing Your Domain and Application Data.

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 Deinstalling Oracle Fusion Middleware Infrastructure.

15.2 Stopping Oracle Fusion Middleware

Stopping Oracle Fusion Middleware involves the following:

15.2.1 Stopping Your Oracle GoldenGate Veridata Agent

Before running the deinstaller, you should stop all agents that are running.

To stop your standalone agent, go to the Veridata Agent deployment directory and run the following commands:

On UNIX operating systems:

./agent.sh stop

On Windows operating systems:

./agent.bat stop

15.2.2 Stopping the Oracle Fusion Middleware Environment

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.

15.3 Removing Your Database Schemas

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 About Custom Prefixes in the Oracle Fusion Middleware Creating Schemas with the Repository Creation Utility Guide. This set of schemas cannot be shared with any other domain (see Planning Your Schema Creation in the Oracle Fusion Middleware Creating Schemas with the Repository Creation Utility Guide).

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 theOracle Fusion Middleware Creating Schemas with the Repository Creation Utility Guide.

15.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 Installing Software with the Oracle Universal Installer.

15.4.1 Starting the Deinstaller

To start the deinstaller on a Windows operating system, do one of the following:

  1. Use a file manager window to go to the ORACLE_HOME\oui\bin directory and double click on deinstall.cmd.
  2. From the command line, go to the ORACLE_HOME\oui\bin and enter the following command:
    deinstall.cmd
  3. 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

15.4.2 Navigating the Deinstallation Screens

The deinstallation program displays a series of screens, in the order listed in Table 15-2.

If you need additional help with any of the deinstallation screens, click the screen name.

Table 15-2 Deinstall Screens and Descriptions

Screen Description

Welcome

This screen introduces you to the product deinstaller.

Deinstallation Summary

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.

Deinstallation Progress

This screen shows the progress of the deinstallation.

Deinstallation Complete

This screen appears when the deinstallation is complete. Review the information on this screen, then click Finish to dismiss the deinstaller.

15.5 Removing the Oracle Home Directory Manually

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.

Note:

You can delete the Oracle_Home directory only if Oracle GoldenGate Veridata was installed in it. If any other product is configured within the same location, then delete just the Oracle GoldenGate Veridata specific files from the directory.

15.6 Removing Your Domain and Application Data

To remove your domain and application data:

  1. Manually remove your Domain home directory.

    For example, if your Domain home directory was /home/oracle/config/domains/veridata_domain on a UNIX operating system: 

    > cd /home/oracle/config/domains
> rm -rf veridata_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.

  2. Manually remove your Application home directory.

    For example, if your Application home directory was /home/Oracle/config/applications/veridata_domain on a UNIX operating system: 

    > cd /home/Oracle/config/applications
> rm -rf veridata_domain

    On a Windows operating system, if your Application home directory was C:\Oracle\Config\applications\veridata_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.

  3. 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/veridata_domain"/>

    Save and exit the file when you are finished.

15.7 Deinstalling Oracle Fusion Middleware Infrastructure

After you have removed your Oracle GoldenGate Veridata 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.

15.8 Reinstalling the Software

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:

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

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

    1. 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 Installing Oracle GoldenGate Veridata. Any domain or application data that was in the Oracle home will have to be re-created.

    2. Select a different Oracle home directory.