How to Update Java Using the Micro Focus Installation Package

  • 7021833
  • 20-May-2014
  • 25-Mar-2018

Environment

Reflection X Advantage

Situation

When you install Reflection X Advantage on Windows systems, a private copy of Java is installed by default using a separate, associated Java installation package. Micro Focus supplies updates to this package to provide customers with Java security updates. This note describes how to obtain and install the latest Java update provided by Micro Focus.

Resolution

Note the following:

  • This note does not apply to Reflection X Advantage installations on UNIX systems. Refer to Security Alerts - Reflection X Advantage for information about the latest Java security update available for UNIX systems. For information about manually updating Java on UNIX, see KB 7021834.
  • This note does not apply if you have configured Reflection X Advantage to use a copy of Java that you install and maintain yourself. See "Changing the JRE" in the product help:

Obtaining the Java Update

Maintained customers are eligible to download updated Java installation packages from Attachmate Downloads: https://download.attachmate.com/Upgrades/.

Installing the Java Update

Use this procedure to update the version of Java used by an existing Reflection X Advantage installation:

  1. Download the update file. You will be prompted to select a location for the extracted installation package. Select a folder and click Continue. The package is extracted to the folder you specify. The installation does not start automatically.
  2. Stop any running Reflection X Advantage applications: X Manager, X Manager for Domains, and the X Administrative Console.
  3. Stop the Reflection X Advantage service if it is installed. (Start > All Programs > Administrative Tools > Services > Attachmate Reflection X service > Stop)
  4. Navigate to the folder where you extracted the update and double-click the installation package, AttachmateJava.msi.

Updating an Administrative Installation

Administrators who have created an administrative installation can update the version of Java in the administrative installation. Making this change provides the updated version of Java to users who run the Setup program from the administrative installation for the first time.

Changing the Java package in the administrative installation point does not affect users who have already installed Reflection, even if they run Setup again from the updated installation point. These users must run the Java update package, AttachmateJava.msi, to update the version of Java used by Reflection.

To update the Java installation package in an administrative installation:

  1. Download the update file and extract the Java installation package, AttachmateJava.msi.
  2. In your administrative installation, replace the following file with the downloaded package:

<path_to_admin_install>\Prerequisites\JDK\AttachmateJava.msi

Note the following:

  • If you use setup.exe on the command line to deploy Reflection, you should apply Reflection Desktop 16 (or higher) or Reflection X 2014 Update 1 (or higher) to your administrative installation to fix a problem that affects Java installations when Reflection is installed using setup.exe in combination with command line switches. See KB 7021434.
  • If you use msiexec.exe on the command line to deploy Reflection, the Attachmate Java package does not install automatically. You need to install the Java program as a separate step.

Finding Java Version Information in the Log Files

The Reflection X Advantage application logs (xmanager.log and xadmin.log) provide information about which Java JVM is being used and what version is running.

Version 5.1 (and higher) log files are created by default in the Windows User Documents folder in the Micro Focus subfolder:

C:\Users\<username>\ Documents\Micro Focus\Reflection\Logs

Version 5.0 and 4.x log files are located in the Windows User Profile folder in a .attachmate subfolder: (If you upgraded from these earlier versions, your logs are also in this location.) For example:

C:\Users\<username>\.attachmate\rx\logs

To determine which copy of Java is being used, search for JVM_EXE. The following entry shows that the application is using the Java installation package provided by Micro Focus:

2015-08-07 14:51:45,340 INFO [ 7112 main] JVM_EXE is: C:\Program Files\Common Files\Micro Focus\JDK\Java8\jre\bin\java.exe

To confirm that the application is using an updated version of Java, search the log for java version and locate a date and time after you installed the updated Java installation package. The following entry shows that the application is using Java version 8 Update 45.

2015-08-07 14:51:44,716 INFO [ 7112 main] java version "1.8.0_45"

Additional Information

Legacy KB ID

This document was originally published as Attachmate Technical Note 2734.