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

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.

Installation

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):
     ${MQ_INSTALL_ROOT}/java/jre/jre/bin/java
     
     
   • AIX, Linux (64-bit), Solaris:
     ${MQ_INSTALL_ROOT}/java/jre64/jre/bin/java
     
     
   • HP-UX:
     ${MQ_INSTALL_ROOT}/java/jre64/bin/java
     
     
   • Windows
     %MQ_INSTALL_ROOT%\java\jre\bin\java
   
   
   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
         ${MQ_INSTALLATION_PATH}/java/jre
     
     
   • Linux (64-bit)
     cp ${LOCAL_DIR}/mq_jre64.tar.gz
         ${MQ_INSTALLATION_PATH}/java/jre64
     
     
   • AIX, HP-UX, Solaris:
     cp ${LOCAL_DIR}/mq_jre64.tar.Z
         ${MQ_INSTALLATION_PATH}/java/jre64
     
     
   • 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,
     "7-WS-MQ-Windows-ICXXXXX.zip", 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.
   
   

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 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.
   
   
2. • Linux (x86 32-bit):
     
     rm -rf ${MQ_INSTALLATION_PATH}/java/jre
     mv ${MQ_INSTALLATION_PATH/java/original.jre
        ${MQ_INSTALLATION_PATH}/java/jre
     
     
   • AIX, Linux (64-bit), HP-UX, Solaris:
     
     rm -rf ${MQ_INSTALLATION_PATH}/java/jre64
     mv ${MQ_INSTALLATION_PATH/java/original.jre64
        ${MQ_INSTALLATION_PATH}/java/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\*.*"
          "%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"
     
     If a "properties" directory was also backed up, then also restore this:
     
     move "%MQ_INSTALL_PATH%\java\java.original\properties"
          "%MQ_INSTALL_PATH%\java"
     
     Delete the empty backup directory:
     rmdir "%MQ_INSTALL_PATH%\java\java.original"