Instructions for manually updating the JRE within a WebSphere MQ V7.1 and V7.5 Installation

Fix readme


This document describes the manual process necessary to update the JRE component of WebSphere MQ V7.1 and V7.5 outside of regular fix pack installations.


Updating the JRE which is supplied by the WebSphere MQ V7.1 and V7.5 package outside of the Fix Pack installation 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 userid on the system which has sufficient authority to modify the WebSphere MQ installation, for example the root user.


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

  1. Download the updated JRE package from the IBM Support website.

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

    To determine the version of the JRE which is embedded into the WebSphere MQ V7.1 and V7.5 installation, use the 'java -fullversion' command, invoking the Java™ binary which is present within the WebSphere MQ installation.

    This location varies by platform:

    • Linux (x86 32-bit):

    • AIX, Linux (64-bit), Solaris:

    • HP-UX:

    • Windows

    For example, for the default installation location on Linux (x86-64) the "java -fullversion" command for WebSphere MQ v7.1.0.0 returns the following information:

    $ /opt/mqm/java/jre64/jre/bin/java -fullversion
    java full version "JRE 1.6.0 IBM Linux build pxa6460sr9fp1-20110208_03 (SR9 FP1)"

  3. Expand the compressed download file into a temporary local directory.

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

    • AIX:
      cd ${LOCAL_DIR}
      zcat 7-WS-MQ-AixPPC640ICXXXXX.tar.Z | tar -xf -

    • Linux:
      cd ${LOCAL_DIR}
      tar -zxf 7-WS-MQ-Linux${arch}-ICXXXXX.tar.gz

      where ${arch} is the system architecture, such as "IA32" (x86 32-bit), "X64" (x86 64-bit), "PPC64" (Linux 64-bit pSeries) or "S390X" (Linux 64-bit zSeries).

    • HP-UX:
      cd ${LOCAL_DIR}
      zcat 7-WS-MQ-HpuxIA64-ICXXXXX.tar.Z | tar -xf -

    • Solaris:
      cd ${LOCAL_DIR}
      zcat 7-WS-MQ-Solaris${arch}-ICXXXXX.tar.Z | tar -xf -

      where ${arch} is the system architecture, such as "Sparc64" or "X86".

    • Windows:
      This step is not required on the Windows platform.

    where ${LOCAL_DIR} is an empty, temporary local directory with sufficient space to unpack the downloaded compressed tar file.
    The value ICXXXXXX is to be replaced with the name of the APAR which the updated JRE package is shipped under, for example IC87062.

  4. Stop all WebSphere MQ activity associated with the installation which is to be updated, including the WebSphere MQ Explorer if open.

  5. 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 will interfere with the operation of the 'runmqckm' and 'strmqikm' commands.

    • Linux (x86 32-bit)
      cd ${MQ_INSTALLATION_PATH}/java
      mv jre original.jre
      mkdir jre
      chmod 555 jre
      cd jre

    • AIX, Linux (64-bit), HP-UX, Solaris:
      cd ${MQ_INSTALLATION_PATH}/java
      mv jre64 original.jre64
      mkdir jre64
      chmod 555 jre64
      cd jre64

    • Windows:
      Either use the Windows Explorer to create a backup directory, or the command lines:

      cd "%MQ_INSTALLATION_PATH%\java"
      mkdir java.original

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

      move docs java.original
      move jre java.original
      move copyright java.original
      move notices.txt java.original
      move readmefirst.win32.txt java.original

      Additionally, if the "properties" directory exists in your installation, also move this to the backup directory:

      move properties java.original

  6. Copy the JRE compressed files to the WebSphere MQ installation from the unpacked download directory:

    • Linux (x86 32-bit)
      cp ${LOCAL_DIR}/mq_jre.tar.gz

    • Linux (64-bit)
      cp ${LOCAL_DIR}/mq_jre64.tar.gz

    • AIX, HP-UX, Solaris:
      cp ${LOCAL_DIR}/mq_jre64.tar.Z

    • Windows:
      This step is not necessary on the Windows platform.

  7. Extract all these JRE files into this directory.

    This can be achieved with the commands:

    • Linux (x86 32-bit):
      cd ${MQ_INSTALLATION_PATH}/java/jre
      tar -zxf mq_jre.tar.gz

    • Linux (64-bit):
      cd ${MQ_INSTALLATION_PATH}/java/jre64
      tar -zxf mq_jre64.tar.gz

    • AIX, HP-UX, Solaris:
      cd ${MQ_INSTALLATION_PATH}/java/jre64
      zcat mq_jre64.tar.Z | tar -xf -

    • Windows:
      Use the Windows Explorer to copy the contents downloaded zip file,
      "", into the "java" subdirectory of the WebSphere MQ installation directory. In the default installation location, this is the directory:

      C:\Program Files\IBM\WebSphere MQ\java

  8. Update the file permissions to match the original installation:

    • Linux (x86 32-bit):

      chown -h -R mqm:mqm ${MQ_INSTALLATION_PATH}/java/jre
      chmod -R u-w,g-w,o-w ${MQ_INSTALLATION_PATH}/java/jre

    • AIX, Linux (64-bit), HP-UX, Solaris:

      chown -h -R mqm:mqm ${MQ_INSTALLATION_PATH}/java/jre64
      chmod -R u-w,g-w,o-w ${MQ_INSTALLATION_PATH}/java/jre64

    • Windows:
      This step is not required on Windows.

    The directory structure of this JRE directory should now resemble the original directory which was moved in step 5 above.

  9. Optional: Verify that the update has been successful by re-running the 'java -fullversion' command, in a similar way to was used in step 2.


To ensure that the eventual uninstallation of WebSphere 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 WebSphere MQ activity associated with the installation which is to be updated.

    • Linux (x86 32-bit):

      rm -rf ${MQ_INSTALLATION_PATH}/java/jre
      mv ${MQ_INSTALLATION_PATH/java/original.jre

    • AIX, Linux (64-bit), HP-UX, Solaris:

      rm -rf ${MQ_INSTALLATION_PATH}/java/jre64
      mv ${MQ_INSTALLATION_PATH/java/original.jre64

    • 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 /s "%MQ_INSTALLATION_PATH%\java\jre"
      rmdir /s "%MQ_INSTALLATION_PATH%\java\docs"
      rmdir /s "%MQ_INSTALLATION_PATH%\java\properties"
      del "%MQ_INSTALLATION_PATH%\java\copyright"
      del "%MQ_INSTALLATION_PATH%\java\notices.txt"
      del "%MQ_INSTALLATION_PATH%\java\readmefirst.win32.txt"
      move "%MQ_INSTALL_PATH%\java\java.original\*.*"
      move "%MQ_INSTALL_PATH%\java\java.original\jre"
      move "%MQ_INSTALL_PATH%\java\java.original\docs"

      If a "properties" directory was also backed up, then also restore this:

      move "%MQ_INSTALL_PATH%\java\java.original\properties"

      Delete the empty backup directory:
      rmdir "%MQ_INSTALL_PATH%\java\java.original"

Product Alias/Synonym

WebSphere MQ WMQ

Rate this page:

(0 users)Average rating

Document information

More support for:

WebSphere MQ
Install / Migration

Software version:

7.1, 7.5

Operating system(s):

AIX, HP Itanium, HP-UX, Linux, Solaris, UNIX, Windows

Reference #:


Modified date:


Translate my page

Machine Translation

Content navigation