Installing Oracle GoldenGate

Learn about the steps for installing Oracle GoldenGate Microservices Architecture for the first time and includes instructions to download the base release of a new version of Oracle GoldenGate.

To download and install subsequent patches to the base release, go to the Patches and Updates tab of My Oracle Support at:

https://support.oracle.com

Also see Installing Patches for Oracle GoldenGate Microservices Architecture.

Installing Oracle GoldenGate Microservices Architecture

The steps for installing Oracle GoldenGate Microservices Architecture for Oracle and Non-Oracle databases are the same. However, there are some prerequisites before you begin the installation.

Verify that you meet the operating system and required database configuration before beginning the installation. Refer to the following links, before you begin installing Microservices Architecture:

To install Oracle GoldenGate Microservices Architecture (MA), perform the following steps:

  1. Install the Oracle GoldenGate software using the steps given in Performing an Interactive Installation with OUI for MA or Performing a Silent Installation with OUI.

  2. Set the necessary environment variables for your database, if required.

    Note:

    (Oracle only) From the Oracle GoldenGate 21c release onward, ORACLE_HOME and LD_LIBRARY_PATH do not point to any database directories. With the unified build feature, these environment variables now point to the OGG_HOME (sub)directories as the Oracle Database Client Software is embedded in Oracle GoldenGate.

  3. Create client, server, and trusted rootCA Certificates for a secure GoldenGate deployment. The steps to create these certificates are available in Create Certificates for Secure Deployments.

  4. Run the Oracle GoldenGate Configuration Assistant (oggca) wizard to add a deployment for the Oracle GoldenGate installation. For steps to run the OGGCA utility, see Add a Deployment.

The installer registers the Oracle GoldenGate home directory ($OGG_HOME) with the central inventory that is associated with the selected database. The inventory stores information about all Oracle software products installed on a host if the product was installed using OUI.

Performing an Interactive Installation with OUI for MA

Interactive installation provides a graphical user interface that prompts for the required installation information.

These instructions apply to new installations and upgrades.

  1. Create a temporary staging directory into which you will install Oracle GoldenGate. For example, mkdir /u01/stage/oggsc.
  2. Extract the installation ZIP file into the temporary staging directory. For example:

    unzip ./fbo_ggs_Linux_x64_services.zip -d ./temp directory

  3. From the expanded directory, run the fbo_ggs_Linux_x64_services_shophome/Disk1/runInstaller program on UNIX or Linux.
    The OUI Install Wizard is started.
  4. On the Select Installation Option page, select the Oracle Database version for your environment, then click Next.
  5. On the Specify Installation Details page, specify the following:

    • For Software Location, specify the location where Oracle GoldenGate software is to be installed. This will be your Oracle GoldenGate Home (OGG_HOME) after the installation is complete. If you have the $OGG_HOME environment variable set, this should be the path displayed. The specified directory cannot be a registered home in the Oracle Central Inventory.

    • Click Next.

  6. On the Summary page, confirm that there is enough space for the installation and that the installation selections are correct.

    • (Optional) Click Save Response File to save the installation information to a response file. You can run the installer from the command line with this file as input to duplicate the results of a successful installation on other systems. You can edit this file or create a new one from a template.

    • Click Install to begin the installation or Back to go back and change any input specifications. When upgrading an existing Oracle GoldenGate installation, OUI notifies you that the software location has files or directories. Click Yes to continue.

    • If you created a central inventory directory, you are prompted to run the INVENTORY_LOCATION/orainstRoot.sh script. This script must be executed as the root operating system user. This script establishes the inventory data and creates subdirectories for each installed Oracle product (in this case, Oracle GoldenGate).

    You are notified when the installation is finished.
  7. Click Close to complete the installation.

Performing a Silent Installation with OUI

Silent installation from the command line interface can be performed if your system does not have an X-Windows or graphical interface or you want to perform the installation in an automated way.

Silent installations ensure that multiple users in your organization use the same installation options when installing Oracle products.

Silent installations are driven by using a response file. Response files can be saved by selecting the Save Response File option during an interactive Oracle Universal Installer session or by editing the oggcore.rsp template located in the response directory after unzipping the Oracle GoldenGate binaries.

Editing the Default Response File

  • INSTALL_OPTION - The valid values are ORA11g, ORA12c, ORA18c, and ORA19c. Set the value based on the database version for the specific Oracle GoldenGate build to be installed.

    Example:

    INSTALL_OPTION=ORA19c

  • SOFTWARE_LOCATION - Absolute path to where Oracle GoldenGate will be installed. Do not use spaces in the path and ensure that the directory has been created and is empty.

    Example:

    SOFTWARE_LOCATION==/u01/userhome/oracle/ogg19c_ora

  • INVENTORY_LOCATION - Location of the Oracle Inventory files. This is optional for Windows installations.

    Example:

    INVENTORY_LOCATION=/u01/app/oraInventory

  • UNIX_GROUP - The Unix group to be set for the inventory directory. Not valid for Windows installations.

    Example:

    UNIX_GROUP=oinstall

Installing Oracle GoldenGate

To perform a silent installation using a response file, perform the following steps:

  1. Run the following command to unzip the folder that contains the Oracle GoldenGate installation program.

    cd unzipped_directory/[fbo_]ggs_OS_database_services_shiphome/Disk1

  2. Run the following command to launch the installer program.

    ./runInstaller -silent -nowait -responseFile absolute_path_to_response_file

Integrating Oracle GoldenGate Microservices Architecture into a Cluster

If you installed Oracle GoldenGate in a cluster, take the following steps to integrate Oracle GoldenGate within the cluster solution.

Oracle GoldenGate Microservices Architecture provides REST-enabled services with features including remote configuration, administration, and monitoring through HTML5 web pages, command line interfaces, and APIs.

For more information about installing and using Oracle GoldenGate in a cluster, see the Oracle GoldenGate Microservices Architecture with Oracle Real Application Clusters Configuration Best Practices technical brief.