5 Deinstalling or Reinstalling Oracle GoldenGate Studio

Follow the instructions in this section to deinstall 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.

5.1 Understanding 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.

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 GoldenGate Studio.

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

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.

5.2 Stopping Oracle Fusion Middleware

Before running the deinstaller, Oracle recommends that you 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.

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

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

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

5.4.1 Starting the Deinstallation Program

You can start the deinstaller on either Unix or Windows.

To start the deinstaller:

  • On Unix

    Go to the ORACLE_HOME/oui/bin directory and enter the following command:

    ./deinstall.sh
    
  • On Windows

    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, and then select Uninstall Oracle Software.

5.4.2 Selecting the Product to Deinstall

Because multiple products might exist in the Oracle home, ensure that you are deinstalling 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.1.0 and click Uninstall. The deinstallation program shows the screens listed in Navigating the Deinstallation Screens.

Note:

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

5.4.3 Navigating the Deinstallation Screens

The deinstaller shows a series of screens to confirm the deinstallation of the software.

If you need more help with a deinstallation screen listed in Table 5-2, click Help on the screen.

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

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 response file later during a silent deinstallation. For more on silent or command line deinstallation, see Running the Oracle Universal Installer for Silent Deinstallation in Installing Software with the Oracle Universal Installer.

Click Deinstall to begin removing the software.

Deinstallation Progress

Shows the deinstallation progress.

Deinstallation Complete

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

5.5 Removing the Oracle Home Directory Manually

After deinstalling the software, you must manually remove your Oracle home directory and any existing subdirectories that the deinstaller 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, then right-click on the ORACLE_HOME folder and select Delete.

5.6 Removing the Program Shortcuts on Windows Operating Systems

On Windows operating systems, you must also manually remove the program shortcuts; the deinstaller does not remove them for you.

Go to the C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Oracle\ORACLE_HOME\Product directory. If you only have one product installed in your Oracle home, you can remove the ORACLE_HOME directory. If you have multiple products installed in your Oracle home, you must remove all products before removing ORACLE_HOME.

5.7 Removing the Oracle GoldenGate Studio Cache Directory

Oracle GoldenGate Studio cache information should be manually removed; the deinstaller does not remove this information.

By default, the Oracle GoldenGate Studio cache is stored in a directory inside the user’s home directory. For example:

On Linux or UNIX:

/home/exampleuser/.oggstudio

On Windows:

C:\Users\exampleuser\AppData\Roaming\oggstudio

The binaries and user preferences are stored in this directory. As a result, if Oracle GoldenGate Studio is reinstalled on the same system by the same user, the binaries from a previous installation will be used unless this directory is manually removed.

5.8 Reinstalling the Software

You can reinstall your software into the same Oracle home as a previous installation only if you deinstalled 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.

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 you specified during installation already contains the same software you are trying to install.

    Your options are:

    • 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 that you chose 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 try to reinstall into the same Oracle home, the installer does not allow it. Your options are to:

    1. Deinstall your software from the Oracle home (as this section describes) and then remove the Oracle home directory. After you deinstall 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.

    2. Select a different Oracle home directory.