Instructions for manually updating the IBM Semeru 25 JRE in an IBM MQ 10.0.0.0 or later installation

Content

For more information about CSUs and Fix Packs, see https://www.ibm.com/support/pages/changes-ibm-mqs-maintenance-delivery-model.

Updating the IBM Semeru 25 JRE that is supplied by the IBM MQ 10.0.0.0 and later installation package, outside of the CSU and Fix Pack maintenance mechanism, is a manual process.

The installation procedure command line syntax is different for each platform. The installation steps need to be performed by a user ID on the system that has sufficient authority to modify the IBM MQ installation, for example the root user.

Obtaining the JRE

Updated IBM Semeru 25 JRE binaries for all supported platforms may be downloaded from https://github.com/ibmruntimes/semeru25-binaries/releases/

The most recent IBM Semeru 25 JRE version successfully tested with IBM MQ is 25.0.3

IBM recommends that you do not attempt to apply a newer JRE version than the version above until it has been tested and this page updated accordingly.

Installation

The following instructions use the convention that ${MQ_INSTALLATION_PATH} and %MQ_INSTALLATION_PATH% are the root directory location of the IBM MQ installation. The default value for this installation path is /opt/mqm on Linux. It is /usr/mqm on AIX, and C:\Program Files\IBM\MQ on Windows.

1. Download the updated JRE package from one of the locations mentioned in the "Obtaining the JRE" section above.

2. Optional: Make a note of the version of the JRE that your installation is currently using. This is used to verify that this JRE update has been successful.

   To determine the version of the JRE that is embedded into the IBM MQ installation, use the java -fullversion command, invoking the Java binary that is present within the installation.

   This location varies by platform:
   o AIX, Linux:
   ${MQ_INSTALL_ROOT}/java/jre64/jre/bin/java
   o Windows
   %MQ_INSTALL_ROOT%\java\jre\bin\java

3. If an updated JRE package has been downloaded from Fix Central or made available via an IBM Support case, expand the compressed download file into a temporary local directory.

   This can be achieved on the various platforms using the following commands, where:

   ${LOCAL_DIR} is an empty, temporary local directory with sufficient space to unpack the downloaded compressed tar file

   The value DTXXXXXX is replaced with the name of the APAR that the updated JRE package is shipped under, for example DT457367.
   o AIX:
   cd ${LOCAL_DIR}
   zcat 7-WS-MQ-AixPPC640DTXXXXX.tar.Z | tar -xf -
   o Linux:
   cd ${LOCAL_DIR}
   tar -zxf 7-WS-MQ-Linux${arch}-DTXXXXX.tar.gz
   where ${arch} is the system architecture, such as "X64" (x86 64-bit), "PPC64" (Linux pSeries) or "S390X" (Linux zSeries).
   o Windows:
   This step is not required on the Windows platform.

4. If a new JRE package was downloaded for Windows, AIX or Linux from the GitHub site mentioned in the “Obtaining JRE” section, copy it into a temporary local directory.
5. Stop all IBM MQ activity associated with the installation that is to be updated.

6. Backup the existing JRE installation by renaming the existing jre or jre64 directory.
   Note that on the UNIX platforms, the backup directory name must not begin with the characters jre, as this interferes with the operation of the runmqckm and strmqikm commands.
   o AIX, Linux:
   cd ${MQ_INSTALLATION_PATH}/java
   mv jre64 original.jre64
   mkdir jre64
   chmod 555 jre64
   cd jre64
   o Windows:
   Either use the Windows Explorer to create a backup directory or use the command line:
   cd "%MQ_INSTALLATION_PATH%\java"
   mkdir original.jre

   Then move the following files and directories into this backup directory, again using either the Windows Explorer or the following command line operations:
   move jre original.jre

7. Copy the JRE compressed files to the IBM MQ installation. This can be achieved using the following commands:
   o Linux:
   cp ${LOCAL_DIR}/*
   ${MQ_INSTALLATION_PATH}/java/jre64
   o AIX:
   cp ${LOCAL_DIR}/*
   ${MQ_INSTALLATION_PATH}/java/jre64
   o Windows:
   cp %{LOCAL_DIR}%/*
   %{MQ_INSTALLATION_PATH}%/java/jre

8. Extract all these JRE files into this directory.
   This can be achieved with the following commands, where the value of ${JRE_PACKAGE} varies depending on how the JRE package was obtained. If step 3 above was performed, the ${JRE_PACKAGE} will be a name that starts with mq_jre64.

   The packages that were downloaded from the GitHub site have names in the format:
   AIX: ibm-semeru-open-jre_ppc64_aix{Java_version_number}openj9-${jvm_version}.tar.gz,
   Linux: ibm-semeru-open-jre${arch}linux${Java_version_number} openj9-${jvm_version}.tar.gz
   Windows: ibm-semeru-open-jre_x64_windows${Java_version_number}_openj9-${jvm_version}.zip
   o Linux:
   cd ${MQ_INSTALLATION_PATH}/java/jre64
   tar -zxf ${JRE_PACKAGE}
   o AIX:
   cd ${MQ_INSTALLATION_PATH}/java/jre64
   zcat ${JRE_PACKAGE} | tar -xf –
   o Windows:
   Use the Windows Explorer to copy the contents of the downloaded zip file into the java sub directory of the IBM MQ installation directory. In the default installation location, this is the directory:
   C:\Program Files\IBM\MQ\java\jre

9. Update the file permissions to match the original installation:
   The directory structure of this JRE directory should now resemble the original directory that was moved in step 5 above.
   o AIX, Linux:
   chown -h -R mqm:mqm ${MQ_INSTALLATION_PATH}/java/jre64
   chmod -R u-w,g-w,o-w ${MQ_INSTALLATION_PATH}/java/jre64
   o Windows:
   This step is not required on Windows.
10. Optional: Verify that the update has been successful by re-running the java -fullversion command, in a similar way to that used in step 2.

Uninstallation

To ensure that the eventual uninstallation of IBM MQ from the system does not leave files behind, before applying a fix pack to this installation these updated JRE files should be removed.

This is achieved by deleting the JRE directory, and moving the backed up directory back into its original location:

1. Stop all IBM MQ activity associated with the installation that is to be updated.
   o AIX, Linux:
   rm -rf ${MQ_INSTALLATION_PATH}/java/jre64
   mv ${MQ_INSTALLATION_PATH/java/original.jre64
   ${MQ_INSTALLATION_PATH}/java/jre64
   o Windows:
   Either delete the set of folders which were extracted from the zip file using the Windows Explorer, and then rename the backed up original version, or use the command line operations:
   rmdir "%MQ_INSTALL_PATH%\java\jre"
   move "%MQ_INSTALL_PATH%\java\original.jre" "%MQ_INSTALLATION_PATH%\java\jre"