5 Uninstalling or Reinstalling Oracle GoldenGate Studio

Follow the instructions in this section to uninstall or reinstall Oracle GoldenGate Studio.

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.

About Product Deinstallation

The Oracle Fusion Middleware deinstaller removes the software from the Oracle home directory that it starts from.

Table 5-1 summarizes the deinstallation procedure and links to supporting documentation.

Table 5-1 Roadmap for Product Deinstallation

Task Description Documentation

Stop Oracle Fusion Middleware.

All servers and processes associated with the Oracle home should be stopped before running the deinstaller.

Note that you should disconnect from the repository and close Oracle GoldenGate Studio.

See Stopping Oracle Fusion Middleware.

Drop your database schemas.

Run Repository Creation Utility to remove the GoldenGate Studio Repository schema.

See Removing Your Database Schemas.

Remove the software.

Run the product deinstaller to remove Oracle GoldenGate Studio.

Note that if your Oracle home contains multiple products, you must run the deinstaller multiple times, once for each product.

See Uninstalling 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.

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

Removing Your Database Schemas

Before you remove the Oracle home, Oracle recommends that you run Repository Creation Utility to remove the GoldenGate Studio Repository schema associated with this installation.

If there are multiple sets of schemas on your database, be sure to identify the schema prefix associated with the schema you are removing.

To remove the 12c (12.2.1.3.0) GoldenGate Studio Repository schema, use the Repository Creation Utility (RCU) associated with your 12c (12.2.1.3.0) GoldenGate Studio Oracle home. If you use RCU associated with a previous installation to drop the 12c (12.2.1.3.0) repository or use RCU associated with your 12c (12.2.1.3.0) installation to drop previous versions of the repository, you might encounter problems while running the RCU drop repository operation.

For schema removal steps, see Dropping Schemas in Oracle Fusion Middleware Creating Schemas with the Repository Creation Utility.

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

Starting the Uninstall Wizard

To start the Uninstall Wizard:

  1. Change to the following directory:
    (UNIX) ORACLE_HOME/oui/bin
    (Windows) ORACLE_HOME\oui\bin
  2. Enter the following command:
    (UNIX) ./deinstall.sh
    (Windows) deinstall.cmd

Selecting the Product to Uninstall

Because multiple products might exist in the Oracle home, ensure that you are uninstalling the correct distribution.

After you start the deinstaller, the Distribution to Uninstall screen appears only if more than one distribution is detected in the Oracle home from where the program is started. From the drop-down list, select GG Studio 12.2.1.3.0 and click Uninstall. The deinstallation program shows the screens listed in Navigating the Uninstall Wizard Screens.

Note:

You will not encounter the Distribution to Uninstall screen if no other software is detected in the Oracle home.

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 5-2, click Help on the screen.

Table 5-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.

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.

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:

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

  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.

Removing the Oracle GoldenGate Studio Cache Directory

Oracle GoldenGate Studio cache information should be manually removed after you deinstall the software but before you begin a new Oracle GoldenGate Studio installation on the same system; the deinstaller does not remove this information.

If you didn’t redefine your user home directory (see Setting the User Home Directory), the Oracle GoldenGate Studio cache information is stored in a directory inside the user’s home directory by default. For example:

(Linux) </home/exampleuser/.oggstudio>
(Windows) <C:\Users\exampleuser\AppData\Roaming\oggstudio>

The binaries and user preferences are stored in this directory.

You must find and remove this directory if you plan to do a clean reinstall of Oracle GoldenGate Studio on the same system in the future. If you deinstall Oracle GoldenGate Studio but don’t manually remove the cache directory, the binaries stored in this directory are preserved. As a result, if you reinstall the software on the same system as the same user, the binaries from your previous installation will be used unless this directory is manually removed during deinstallation. For more information, see Performing a Clean Reinstall on the Same System as a Previous Installation.

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.

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

Performing a Clean Reinstall on the Same System as a Previous Installation

If you uninstall Oracle GoldenGate Studio but don’t remove the cache directory associated with the installation, the binaries and preferences stored in this directory will be preserved. If you reinstall the software on the same system as the previous installation, your new installation will automatically pick up the old binaries and preferences.

To do a clean reinstall of the software and to ensure that older binaries (from a previous installation) in the cache are not used to run GoldenGate Studio, you should either:

  • Find and remove the cache directory associated with the previous installation. See Removing the Oracle GoldenGate Studio Cache Directory.

  • Use the -clean option when starting Oracle GoldenGate Studio from the command line, which forces GoldenGate Studio to pick up the new binaries. For example:

    Linux <./oggstudio -clean>

    Windows <oggstudioW.exe -clean>