Instructions for manually updating the JRE within a WebSphere MQ V7.0 Installation

Fix readme


Abstract

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

Content

Updating the JRE which is supplied by the WebSphere MQ V7.0 Interim Fix package outside of the Fix Pack installation mechanism is a manual process.

The command line syntax for the installation procedure is different on 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.

Depending upon which components of WebSphere MQ have been installed, there are up to two JREs which are embedded into the product installation directory:

  1. IBM Java (JRE) Component

    For example, on the Linux platforms this is installed within the rpm package:

    MQSeriesJRE-7.0.x.x.${arch}


  2. SSL Support component

    For example, on the Linux platforms this is installed within the rpm package:

    MQSeriesKeyman-7.0.x.x.${arch}


The interim download package contains two updated JREs, either or both of which can be installed to match your system's WebSphere MQ component installation configuration.

Important: While the two JREs are at the same Java version, the Interim Fixes for both components are not identical. It is important to install the appropriate JRE corresponding the component.

Installation

The following instructions use the convention that %MQ_INSTALLATION_PATH% is the root directory location of the Windows WebSphere MQ installation, which defaults to the value "C:\Program Files\IBM\WebSphere MQ".


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


  2. Optional: Make a note of the version of the JREs which your installation is currently using. This is used to verify that these JRE updates have been successful.

    To determine the version of the JREs which are embedded into the WebSphere MQ V7.0 installation, use the 'java -fullversion' command, invoking the Java™ binary which is present within the WebSphere MQ installation.

    This location varies by platform:

    • AIX:
      mqm.jre.rte:          /usr/mqm/java/jre/bin/java
      mqm.keyman.rte:       /usr/mqm/ssl/jre/bin/java


    • Linux (x86 32-bit and 64-bit, pSeries, zSeries):
      MQSeriesJRE:          /opt/mqm/java/jre/bin/java
      MQSeriesKeyMan:       /opt/mqm/ssl/jre/bin/java


    • Solaris (x86 and SPARC):
      Class 'jre':          /opt/mqm/java/jre/bin/java
      Class 'keyman':       /opt/mqm/ssl/bin/java


    • HP-UX (Itanium):
      MQSERIES.MQM-KEYMAN:  /opt/mqm/java/jre/bin/java
      MQSERIES.MQM-JAVAJRE: /opt/mqm/ssl/jre/bin/java


    • Windows:
      JRE:                   %MQ_INSTALL_ROOT%\java\jre\bin\java
      GSKit:                 %MQ_INSTALL_ROOT%\gskit\jre\bin\java



    For example, on Linux, the "java -fullversion" command for the JRE component embedded into WebSphere MQ v7.0.1.9 returns the following information:

    $ /opt/mqm/java/jre/bin/java -fullversion
    java full version "J2RE 1.5.0 IBM Linux build pxi32devifx-20120228 (SR13 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.0-WS-MQ-AixPPC64-ICXXXXX.tar.Z | tar -xf -

    • Linux:
      cd ${LOCAL_DIR}
      tar -zxf 7.0-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.0-WS-MQ-HpuxIA64-ICXXXXX.tar.Z | tar -xf -


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


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

    • Windows:
      User the Windows Explorer to extract the two zip files from the downloaded zip file, "7.0-WS-MQ-Windows-ICXXXXX.zip", to a temporary directory.


    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 IC87301.




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



  5. If installed, backup the existing JRE installation, and extract the updated JRE into place. This can be achieved using the following steps:

    • AIX:
      cd /usr/mqm/java
      mkdir original_jre
      mv COPYRIGHT docs jre license original_jre
      zcat ${LOCAL_DIR}/mq_jre.tar.Z | tar -xf -
      chown -h mqm:mqm /usr/mqm/java/COPYRIGHT
      chown -h -R mqm:mqm /usr/mqm/java/docs
      chown -h -R mqm:mqm /usr/mqm/java/jre
      chown -h -R mqm:mqm /usr/mqm/java/license


    • Linux (x86 32-bit and 64-bit, pSeries and zSeries):
      cd /opt/mqm/java
      mkdir original_jre
      mv COPYRIGHT docs jre original_jre
      tar -zxf ${LOCAL_DIR}/mq_jre.tar.gz
      chown -h -R mqm:mqm /opt/mqm/java/jre
      chown -h -R mqm:mqm /opt/mqm/java/docs
      chown -h mqm:mqm /opt/mqm/java/COPYRIGHT


    • HP-UX, Solaris (x86-64 and SPARC):
      cd /opt/mqm/java
      mv jre jre.original
      mkdir jre
      cd jre
      zcat ${LOCAL_DIR}/mq_jre.tar.Z | tar -xf -
      chown -h -R mqm:mqm /opt/mqm/java/jre

    • 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 COPYRIGHT java.original
      move docs java.original
      move jre java.original

      Use the Windows Explorer to extract the contents of the mq_jre.zip file which was extracted from the downloaded Interim Fix file, into this directory:

      %MQ_INSTALLATION_PATH%\java



  6. If installed, backup the existing JRE used by the GSKit component, and extract the updated JRE into place. This can be achieved using the following steps:

    • AIX:
      cd /usr/mqm
      mv ssl ssl.original
      mkdir ssl
      chmod 555 ssl
      cd ssl
      zcat ${LOCAL_DIR}/mq_gskit_jre.tar.Z | tar -xf -
      chown -h -R mqm:mqm /usr/mqm/ssl


    • Linux (x86 32-bit and 64-bit):
      cd /opt/mqm
      mv ssl ssl.original
      mkdir ssl
      chmod 555 ssl
      cd ssl
      tar -zxf ${LOCAL_DIR}/mq_gskit_jre.tar.gz
      chown -h -R mqm:mqm /opt/mqm/ssl


    • HP-UX, Solaris (x86-64 and SPARC):
      cd /opt/mqm
      mv ssl ssl.original
      mkdir ssl
      chmod 555 ssl
      cd ssl
      zcat ${LOCAL_DIR}/mq_gskit_jre.tar.Z | tar -xf -
      chown -h -R mqm:mqm /opt/mqm/ssl


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

      cd "%MQ_INSTALLATION_PATH%\gskit"
      mkdir gskit.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 COPYRIGHT gskit.original
      move docs gskit.original
      move jre gskit.original

      Use the Windows Explorer to extract the contents of the mq_gskit_jre.zip file which was extracted from the downloaded Interim Fix file, into this directory:

      %MQ_INSTALLATION_PATH%\gskit



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

    Continuing with the example provided in step 2 which found the WebSphere MQ 7.0.1.9 JRE version on the Linux platform to be "SR13 FP1", after installing the updated JRE supplied under APAR IC87301, we see the JRE has been updated to "SR14":

    $ /opt/mqm/java/jre/bin/java -fullversion
    java full version "J2RE 1.5.0 IBM Linux build pxi32dev-20120810 (SR14 )"



Uninstallation

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 updated JRE directories, and moving the backed up directory or contents back into its original location:

  1. Stop all WebSphere MQ activity associated with the installation which is to be updated.

  2. To uninstall the JRE Interim Fix from the JRE component of the WebSphere MQ installation:

    • AIX:
      rm -rf /usr/mqm/java/jre /usr/mqm/java/docs
      rm -rf /usr/mqm/java/license /usr/mqm/java/COPYRIGHT
      mv /usr/mqm/java/original_jre/* /usr/mqm/java
      rmdir /usr/mqm/java/original_jre


    • Linux (x86 32-bit and 64-bit, pSeries, zSeries):
      rm -rf /opt/mqm/java/jre /opt/mqm/java/docs
      rm -f /opt/mqm/java/COPYRIGHT
      mv /opt/mqm/java/original_jre/* /opt/mqm/java
      rmdir /opt/mqm/java/original_jre


    • HP-UX, Solaris (x86-64 and SPARC):
      rm -rf /opt/mqm/java/jre
      mv /opt/mqm/java/jre.original /opt/mqm/java/jre


    • 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:

      del "%MQ_INSTALLATION_PATH%\java\COPYRIGHT"
      rmdir /s "%MQ_INSTALLATION_PATH%\java\jre"
      rmdir /s "%MQ_INSTALLATION_PATH%\java\docs"
      move "%MQ_INSTALL_PATH%\java\java.original\COPYRIGHT"
           "%MQ_INSTALL_PATH%\java"
      move "%MQ_INSTALL_PATH%\java\java.original\jre"
           "%MQ_INSTALL_PATH%\java"
      move "%MQ_INSTALL_PATH%\java\java.original\docs"
           "%MQ_INSTALL_PATH%\java"


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


  3. To uninstall the JRE Interim Fix from the GSKit component of the WebSphere MQ installation:

    • AIX:
      rm -rf /usr/mqm/ssl
      mv /usr/mqm/ssl.original /usr/mqm/ssl


    • HP-UX, Linux (x86 32-bit and 64-bit, pSeries, zSeries), Solaris (x86-64 and SPARC):
      rm -rf /opt/mqm/ssl
      mv /opt/mqm/ssl.original /opt/mqm/ssl


    • 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:

      del "%MQ_INSTALLATION_PATH%\gskit\COPYRIGHT"
      rmdir /s "%MQ_INSTALLATION_PATH%\gskit\jre"
      rmdir /s "%MQ_INSTALLATION_PATH%\gskit\docs"
      move "%MQ_INSTALL_PATH%\gskit\gskit.original\COPYRIGHT"
           "%MQ_INSTALL_PATH%\gskit"
      move "%MQ_INSTALL_PATH%\gskit\gskit.original\jre"
           "%MQ_INSTALL_PATH%\gskit"
      move "%MQ_INSTALL_PATH%\gskit\gskit.original\docs"
           "%MQ_INSTALL_PATH%\gskit"


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


Cross reference information
Segment Product Component Platform Version Edition
Business Integration WebSphere MQ Java AIX, HP Itanium, Linux, Solaris, Windows 7.0

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.0

Operating system(s):

AIX, HP Itanium, Linux, Linux iSeries, Linux on Power, Linux zSeries, Solaris, Windows

Reference #:

1614349

Modified date:

2013-05-13

Translate my page

Machine Translation

Content navigation