2 What are the Prerequisites?

Learn about what you need to do before installing.

Topics:

2.1 Oracle Universal Installer Requirements for Oracle Database Installations

The Oracle Universal Installer (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. To use OUI to install Oracle GoldenGate, the following requirements must be satisfied before running the installer.

  • OUI is a graphical Java application. The host platform must be Java-enabled. The required Java Runtime Environment (JRE) is automatically installed with OUI.

  • If this is the first time you are installing an Oracle product with OUI, you are prompted to create the Oracle central inventory, which also creates a subdirectory for Oracle GoldenGate to contain inventory information. This subdirectory typically requires 150 kilobytes of disk space.

2.2 Setting Library Paths for Dynamic Builds on Linux or UNIX

Oracle GoldenGate uses shared libraries. When you install Oracle GoldenGate on a Linux or UNIX system, you must use the following steps before you run GGSCI or any other Oracle GoldenGate process.

If you will be running an Oracle GoldenGate program from outside the Oracle GoldenGate installation directory on your system:

  • (Optional) Add the Oracle GoldenGate installation directory to the PATH environment variable.

  • (Required) Add the Oracle GoldenGate installation directory to the shared-libraries environment variable.

For example, given an Oracle GoldenGate installation directory of /users/ogg, the second command in the following example requires these variables to be set:

Command Requires Oracle GoldenGate libraries in environment variable?

users ./ogg> ./ggsci NO

No

users> ./ogg/ggsci YES

Yes

To Set the Variables in Korn Shell

PATH=installation_directory:$PATH
export PATH
shared_libraries_variable=absolute_path_of_installation_directory:$shared_libraries_variable
export shared_libraries_variable

To Set the Variables in Bourne Shell

export PATH=installation_directory:$PATH
export shared_libraries_variable=absolute_path_of_installation_directory:$shared_libraries_variable

To Set the Variables in C Shell

setenv PATH installation_directory:$PATH
setenv shared_libraries_variable absolute_path_of_installation_directory:$shared_libraries_variable

Where shared_libraries_variable is one of the variables shown in Table 2-1:

Table 2-1 UNIX and Linux Library Path Variables Per Platform

Platform Environment variable

IBM AIX

LIBPATH

HP-UX

SHLIB_PATH

Sun Solaris

LINUX

LD_LIBRARY_PATH

The following is an example of how to set the path in Bourne shell:

=> export LD_LIBRARY_PATH=/ggs/12.3:$LD_LIBRARY_PATH

Note:

To view the libraries that are required by an Oracle GoldenGate process, use the ldd goldengate_process shell command before starting the process. This command shows an error message for any that are missing.