2 Installing the Microservices Architecture for Oracle GoldenGate

The new Microservices Architecture for Oracle GoldenGate 12c (12.3.0.1) installation is a three-step process.

  1. Install the Oracle GoldenGate SA.

  2. Set the necessary environment variables.

  3. Deploy an Oracle GoldenGate instance using the configuration assistant.

The Microservices Architecture is installed using the Oracle Universal Installer (OUI). OUI is a graphic installation program that prompts you for the input required to install the Oracle GoldenGate binaries and working files, and set the database environment in which Oracle GoldenGate will operate. You can also use a command line silent installation using OUI.

The installer registers the Oracle GoldenGate home directory 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.

Topics:

2.1 Performing an Interactive Installation with OUI

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

These instructions apply to new installations as well as 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.
  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 for your environment, and then click Next to continue.
  5. On the Specify Installation Details page, specify the following:
    • For Software Location, specify a new Oracle GoldenGate installation directory. The default location is under the installing user's home directory and Oracle recommends changing it to a local directory that is not mounted and has no quotas. The specified directory cannot be a registered home in the Oracle central inventory.

    • Click Next to continue. If this is an upgrade to an existing Oracle GoldenGate installation, OUI prompts that the selected software location has files or directories. Click Yes.

  6. The Create Inventory page is displayed if this is the first Oracle product to be installed from OUI on a host that does not have a central inventory.
    • For Inventory Directory, specify a directory for the central inventory. It can be a new directory or an existing directory that is empty and has the amount of disk space shown on the screen. The directory cannot be on a shared drive.

    • Select an operating system group in which the members have write permission to the inventory directory. This group is used to add inventory information to the Oracle GoldenGate subdirectory.

    • Click Next to continue.

  7. On the Summary page, confirm that there is enough space for the installation and that the installation selections are correct.
    • Optionally, 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.
  8. Click Close to complete the installation.

2.2 Performing a Silent Installation with OUI

Silent installation from the command console can be used if the system does not have an X-Windows interface, or to perform an automated installation.

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

You perform a silent installation by running a response file. You can create a response file by selecting the Save Response File option during an interactive OUI session or by editing a template, as shown in Example 2-1. To run a response file, issue the following command.

-silent -nowait -responseFile absolute_path_to_response_file

Note:

 When saving to a response file, the administrator password is not saved for security reasons. You must edit the response file and enter this password field if you want to reuse the response file for installation on other systems.

The response files and the template are stored in the response sub-directory of the Oracle GoldenGate installation directory. The Oracle GoldenGate response file contains a standard set of Oracle configuration parameters in addition to parameters that are specific to Oracle GoldenGate. These parameters correspond to the fields in the interactive session.

Example 2-1 Oracle GoldenGate Response File Template

####################################################################
## Copyright(c) Oracle Corporation 2016. All rights reserved.     ##
##                                                                ##
## Specify values for the variables listed below to customize     ##
## your installation.                                             ##
##                                                                ##
## Each variable is associated with a comment. The comment        ##
## can help to populate the variables with the appropriate        ##
## values.                                                        ##
##                                                                ##
## IMPORTANT NOTE: This file should be secured to have read       ##
## permission only by the oracle user or an administrator who     ##
## own this installation to protect any sensitive input values.   ##
##                                                                ##
####################################################################

#-------------------------------------------------------------------------------
# Do not change the following system generated value. 
#-------------------------------------------------------------------------------
oracle.install.responseFileVersion=/oracle/install/rspfmt_ogginstall_response_schema_v12_3_0


################################################################################
##                                                                            ##
## Oracle GoldenGate installation option and details                          ##
##                                                                            ##
################################################################################

#-------------------------------------------------------------------------------
# Specify the installation option.
# Specify ORA12c for installing Oracle GoldenGate for Oracle Database 12c and
#         ORA11g for installing Oracle GoldenGate for Oracle Database 11g 
#-------------------------------------------------------------------------------
INSTALL_OPTION=

#-------------------------------------------------------------------------------
# Specify a location to install Oracle GoldenGate
#-------------------------------------------------------------------------------
SOFTWARE_LOCATION=

################################################################################
##                                                                            ##
## Specify details to Create inventory for Oracle installs                    ##
## Required only for the first Oracle product install on a system.            ##
##                                                                            ##
################################################################################

#-------------------------------------------------------------------------------
# Specify the location which holds the install inventory files.
# This is an optional parameter if installing on
# Windows based Operating System.
#-------------------------------------------------------------------------------
INVENTORY_LOCATION=

#-------------------------------------------------------------------------------
# Unix group to be set for the inventory directory.  
# This parameter is not applicable if installing on
# Windows based Operating System.
#-------------------------------------------------------------------------------
UNIX_GROUP_NAME=