Uninstalling Oracle GoldenGate Microservices Architecture

Learn about uninstallling Oracle GoldenGate Microservices Architecture processes and files from the host in Linux, UNIX, and Windows environments.

It is assumed that you no longer need the data in the Oracle GoldenGate trails, and that you no longer need to preserve the current Oracle GoldenGate environment. To preserve your current environment and data, make a backup of the Oracle GoldenGate directory and all subdirectories before starting this procedure.

Before uninstalling Oracle GoldenGate Microservices Architecture, you must stop the Service Manager and all the deployments.

Topics:

Removing Deployments and Service Manager

Learn how to remove a deployment using OGGCA.

Topics:

Removing Deployments and Service Manager Using Oracle GoldenGate Configuration Assistant

To remove a deployment using Oracle GoldenGate Configuration Assistant (OGGCA), perform the following steps:

  1. Connect to the Administration Server of all deployments to be removed, and stop any running Extracts and Replicats.

  2. In Linux systems, run the command ./oggca.sh from the $OGG_HOME/bin directory to launch the Oracle GoldenGate Configuration Assistant (OGGCA). In Windows systems, right-click the oggca.bat file and select Run as administrator. This file is located in the OGG_HOME\bin directory.

  3. Select the Existing Service Manager option and click Next.

  4. Select Remove Existing Oracle GoldenGate deployment and click Next.

  5. Follow the steps in the OGGCA wizard to remove the deployment.

  6. Repeat the steps to remove multiple deployments and the Service Manager.

Using Oracle GoldenGate Configuration Assistant - Silent

To run the Configuration Assistant in silent mode, execute it with the -silent -responseFile fullPathToResponseFile flags.

The properties expected to be set in the response file for removing a deployment are:
CONFIGURATION_OPTION, 
DEPLOYMENT_NAME, 
ADMINISTRATOR_USER, 
ADMINISTRATOR_PASSWORD,
HOST_SERVICEMANAGER, 
PORT_SERVICEMANAGER, 
SECURITY_ENABLED,
REMOVE_DEPLOYMENT_FROM_DISK

Files to be Removed Manually

Operating System Files to be Removed Manually to Unregister an Existing Service Manager

Linux 6

Note:

Linux 6 is not certified for Oracle GoldenGate 21c (21.3.0). This information may be required when trying to perform upgrades or downgrades.
  • /etc/init.d/OracleGoldenGate
  • /etc/rc.d/*OracleGoldenGate
  • /etc/rc*.d/*OracleGoldenGate
  • /etc/oggInst.loc

Linux 7 and Linux 8

/etc/systemd/system/OracleGoldenGate.service

Uninstalling Microservices Architecture with Oracle Universal Installer

Note:

It's important to remove all deployments prior to uninstalling Oracle GoldenGate home directory.
To uninstall Oracle GoldenGate Microservices Architecture with Oracle Universal Installer:
  1. Navigate to the following directory:

    /$OGG_HOME/deinstall/

  2. Run the command:

    On UNIX and Linux: ./deinstall.sh

    On Windows: \deinstall.bat

See Files to be Removed Manually for steps that you may need to perform manually.

Uninstalling Microservices Architecture Using Silent Mode

Note:

It's important to remove all deployments prior to uninstalling Oracle GoldenGate home directory.

See Files to be Removed Manually for steps that you may need to perform manually.

To uninstall Oracle GoldenGate Microservices Architecture with Oracle Universal Installer silent mode:
  1. Navigate to the following directory:

    cd /$OGG_HOME/deinstall/

    Make sure that you've set the OGG_HOME variable correctly as the uninstallation is silent so you will not be prompted.

  2. Run the command:

    deinstall.sh -silent
    Here's the output:
    
    ALERT: Ensure all the processes running from the current Oracle Home are shutdown prior to running this software uninstallation script.
    Proceed with removing Oracle GoldenGate home:
    /net/xyz02/scratch/scott/view_storage/scott_x21300x/local/ggtest/install_202214
                (yes/no)? [no] yes
    Starting Oracle Universal Installer...
    Checking swap space: must be greater than 500 MB.   
    Actual 11648 MB    
    Passed
    Preparing to launch Oracle Universal Installer from /tmp/OraInstall2022-08-19_10-52-30AM.
              Please wait ...
    Oracle Universal Installer, Version 21.1.3.0 Production Copyright (C) 1999, 2022, Oracle. All rights reserved.Starting deinstall
    Deinstall in progress (Wednesday, August 19, 2022 10:52:33 AM PDT)............................................................... 100% Done.
    Deinstall successful