A Installing the Java Runtime Environment (JRE)

The Oracle GoldenGate Director software and installer both rely on components in the Java Runtime Environment (JRE). In many cases, this environment already exists because it was installed when the system was configured or when another program was installed. If the system where you are installing the server or client components does not have this environment, follow these instructions to download the JRE and verify the JRE environment on UNIX and Windows systems to support Oracle GoldenGate Director.

Note:

See System Requirements for the supported JRE versions.

Downloading the Java Runtime Environment

You can download the JRE free of charge from Oracle.

  1. Go to http://www.oracle.com/technetwork/java/javase/downloads/index.html.

  2. Under Java Platform, Standard Edition, select either the current release, or click Previous Releases to install an earlier supported version. You can use either the JDK or JRE. The JDK includes the JRE. Do not use any non-supported version or edition of the Java JRE or JDK.

  3. Follow the navigation aids to download the JRE or JDK that is appropriate for your operating system.

  4. Follow the installation instructions that are provided with the JRE.

  5. Save the path to the JRE executable file. You will need it later.

  6. Proceed to the instructions in Verifying the JRE Environment.

Verifying the JRE Environment

This section contains instructions for verifying the JRE environment on UNIX and Windows platforms.

Verifying the JRE on UNIX

After installing the JRE, run the following test to verify the version of Java that is recognized by the system.

  1. From the command shell of the operating system, issue the following command.

    java -version
    
  2. Make certain the command output shows the version that you downloaded.

Verifying the JRE on Windows

After installing the JRE, but before installing Oracle GoldenGate Director Server, verify the path to the JRE by completing the following tasks:

Verify the JRE Version

Set the JAVA_HOME System Variable

Set the JAVA_HOME System Path

Verify the JRE Version

These steps verify the JRE version that is installed on the server machine.

  1. On the keyboard, press the Win (Windows) key and the R key simultaneously to open the Run box. Alternatively, you can select Start, then Run.

  2. In the Run box, type cmd to run the Windows command console.

  3. Issue the following command:

    java -version
    
  4. Do one of the following:

Set the JAVA_HOME System Variable

These steps verify that the JAVA_HOME system environment variable points to the JRE that you installed, or creates the variable if absent.

  1. On the desktop (Windows 2000) or in the Start menu (Windows XP), right-click My Computer and then click Properties.

  2. Click the Advanced tab, and then click Environment Variables.

  3. Under System Variables, look for the JAVA_HOME system variable. The JAVA_HOME path should point to the location that you recorded when you installed the JRE.

  4. Do one of the following:

    • If you see the JAVA_HOME system variable and it points to the correct location, leave the Environment Variables dialog box open and follow the instructions in Set the JAVA_HOME System Path.

    • If a JAVA_HOME system variable does not exist, or if it points to the wrong location, continue to the next step.

  5. Under System Variables, do one of the following:

    • Click New to create a JAVA_HOME variable.

    • Select the existing JAVA_HOME variable and then click Edit. This opens a dialog box to edit this variable.

  6. In the Variable Name box, type JAVA_HOME in capital letters.

  7. In the Variable Value box, type the correct path to the JRE.

  8. Click OK to set the path and close the dialog box.

  9. Leave the Environment Variables dialog box open and follow the instructions in Set the JAVA_HOME System Path.

Set the JAVA_HOME System Path

These steps ensure that the JAVA_HOME path is in the expected location within the Path system variable. Programs such as the Oracle database software place the path to their own JRE installations in the location that is expected by Oracle GoldenGate Director Server.

  1. In the Environment Variables dialog box, look for the Path variable under System Variables.

  2. Confirm that the path to JAVA_HOME appears as the first path in the list of paths.

    %JAVA_HOME%\bin;
    
  3. Do one of the following:

    • If this JAVA_HOME path is the first path in the string, close the Environment Variables and System Properties dialog boxes and follow the instructions in Installing Oracle GoldenGate Director Server.

    • If this JAVA_HOME path is not the first path in the string, continue to the next step.

  4. Under System Variables, double click the Path variable to open it for editing.

  5. In the path string, locate the JAVA_HOME path. If it is there, cut and paste it (including the terminating semi-colon) to the front of the list; otherwise, type it. The path must be entered as %JAVA_HOME%\bin.

  6. Click OK to close the Edit System Variable dialog box.

  7. Close the Environment Variables and System Properties dialog boxes.