Oracle® Fusion Middleware

1.1 Installing Java

The Oracle GoldenGate for Big Data are certified for Java 1.7. Before installing and running Oracle GoldenGate for Java, you must install Java (JDK or JRE) version 1.7 or later. Either the Java Runtime Environment (JRE) or the full Java Development Kit (which includes the JRE) may be used.

1.2 Setting up Environmental Variables

To configure your Java environment for Oracle GoldenGate for Java:

• The PATH environmental variable should be configured to find your Java Runtime

• The shared (dynamically linked) Java virtual machine (JVM) library must also be found.

On Windows, these environmental variables should be set as system variables; on Linux/UNIX, they should be set globally or for the user running the Oracle GoldenGate processes. Examples of setting these environmental variables for Windows, UNIX, and Linux are in the following sections.

set JAVA_HOME=C:\Program Files\Java\jdk1.7.0 
set PATH=%JAVA_HOME%\bin;%PATH% 
set PATH=%JAVA_HOME%\jre\bin\server;%PATH% 

C:\> java -version 
java version "1.7.0_29" Java(TM) SE Runtime Environment (build 1.7.0_29-b13) 

export JAVA_HOME=/opt/jdk1.7 
export PATH=$JAVA_HOME/bin:$PATH 
export LD_LIBRARY_PATH=$JAVA_HOME/jre/lib/i386/server:$LD_LIBRARY_PATH 

$ java -version 
java version "1.7.0_29" 
Java(TM) SE Runtime Environment (build 1.7.0_29-b02) 

2.1 Installation Overview

This section provides an overview of the installation contents and the Oracle GoldenGate instances used with the Oracle GoldenGate Adapter

2.2 Downloading Oracle GoldenGate for Big Data

Oracle GoldenGate for Big Data are available for Windows, Linux, and UNIX. To download, first visit the Oracle support site to see if there is a patch available for your operating system and architecture.

1. Navigate to http://support.oracle.com.

2. Sign in with your Oracle ID and password.

3. Select the Patches and Upgrades tab.

4. On the Search tab, click Product or Family.

5. In the Product Field, type Oracle GoldenGate for Big Data.

6. From the Release drop-down list, select the release version that you want to download.

7. Make sure Platform is displayed as the default in the next field, and then select the platform from the drop-down list.

8. Leave the last field blank.

9. Click Search.

10. In the Advanced Patch Search Results list, select the available builds that satisfy the criteria that you supplied.

11. In the file Download dialog box, click the ZIP file to begin the download.

If patches are not available on the support site, go to the Oracle delivery site for the release download.

1. Navigate to http://edelivery.oracle.com.

2. Sign in with your Oracle ID and password.

3. On the Terms and Restrictions page:

   • Accept the Trial License Agreement (even if you have a permanent license).

   • Accept the Export Restrictions.

   • Click Continue.

4. On the Media Pack Search page:

   • Select the Oracle Fusion Middleware Product Pack.

   • Select the platform on which you will be installing the software.

   • Click Go.

5. In the Results list:

   • Select the Oracle GoldenGate Applications Big Data Media Pack that you want.

   • Click Continue.

6. On the Download page:

   • View the Readme file.

   • Click Download for each component that you want. Follow the automatic download process to transfer the zip file to your system.

2.3 Directory Structure

The following table is a sample that includes the subdirectories and files that result from unzipping the installation file and creating the subdirectories. The following conventions have been used:

• Subdirectories are enclosed in square brackets []

• Levels are indicated by a pipe and hyphen |-

• The Internal notation indicates a read-only directory that should not be modified

• Text files (*.txt) are not included in the list

• Oracle GoldenGate utilities, such as Defgen, Logdump, and Keygen, are not included in the list

[gg_install_dir] 

|-ggsci 

|-mgr 

|-extract 

|-[UserExitExamples] 

|-[dirprm] 

javaue.prm 
javaue.properties 
jmsvam.prm 
jmsvam.properties 
ffwriter.prm 

|-[dirdef] 

|-[dirdat] 

|-[dirchk] 

|-[dirpcs] 

|-[dirjar] 

|-[ggjava] 

|-|-ggjava.jar 

|-|-[resources] 

|-ggjava_ue.dll 

|-ggjava_vam.dll 

|-gendef 

|-. . . 

2.4 Installation Steps

Perform the following steps to install the Oracle GoldenGate for Big Data:

1. Create an installation directory that has no spaces in its name. Then extract the ZIP file into this new installation directory. For example:

   Shell> mkdir installation_directory 
   Shell> cp path/to/installation_zip installation_directory 
   Shell> cd installation_directory 
   Shell> unzip installation_zip 
   

   If you are on Linux or UNIX, run:

   Shell> tar -xf installation_tar 
   

   This downloadS the files into several of the subdirectories Section 2.3, "Directory Structure."

2. Stay on the installation directory and bring up GGSCI to create the remaining subdirectories in the installation location.

3. Shell> ggsci 
   GGSCI> CREATE SUBDIRS 
   

4. Create a Manager parameter file:

   GGSCI> EDIT PARAM MGR 
   

5. Specify a port for the Manager to listen on by using the editor to add a line to the Manager parameter file. For example:

   PORT 7801 
   

6. If you are on Windows and running Manager as a service, set the system variable PATH to include jvm.dll, then delete the Manager service and re-add it.

7. Go to GGSCI, start the Manager, and check to see that it is running:

   GGSCI>START MGR 
   GGSCI>INFO MGR