IBM Support

Instructions for manually updating the IBM® Runtime Environment Java™ Technology Edition, Version 6 within an Enterprise Common Collector V1.1.0 Installation

Fix Readme


Abstract

This document describes the manual process necessary to update the IBM® Runtime Environment Java™ Technology Edition, Version 6 component of Enterprise Common Collector V1.1.0 outside of regular fix pack installations.

Content

Updating the IBM® Runtime Environment Java™ Technology Edition, Version 6 supplied by the Enterprise Common Collector 1.1.0 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 user id on the system which has sufficient authority to modify the Enterprise Common Collector installation, for example an administrator (Windows®) or root (Linux® or AIX®) user.

Note that these instructions should only be used when referenced by a fix that includes the runtime environment to be updated.

Installation

The following instructions use the convention that ${ECC_INSTALL_DIR} and %ECC_INSTALL_DIR% are the root directory location of the Enterprise Common Collector installation. The default value for this installation path is "/opt/IBM/ecc" on AIX and Linux. It is "C:\IBM\ecc" on Windows.

  1. Download the updated runtime environment package from the IBM Support website.

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

    To determine the version of the runtime environment which is embedded into the Enterprise Common Collector, use the 'java -fullversion' command, invoking the Java™ binary which is present within the Enterprise Common Collector installation.

    This location varies by platform:

    AIX, Linux
    ${ECC_INSTALL_DIR}/jre/jre/bin/java

    Windows
    %ECC_INSTALL_DIR%\jre\jre\bin\java

    For example, for the default installation location on Linux (s390x) the "java -fullversion" command for Enterprise Common Collector 1.1.0.2 returns the following information:

    $ /opt/IBM/ecc/jre/jre/bin/java -fullversion
    java full version "JRE 1.6.0 IBM Linux build pxz6460sr13ifx-20130325_01 (SR13)"

  3. Expand the compressed download file into an empty temporary local directory.

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

    AIX
    cd ${LOCAL_DIR}
    gzip -d jre664redist.tar.gz
    tar xf jre664redist.tar


    Note: for 1.1.0.5-TIV-ITM-ECC-JRE-AIX-IF0007 and later, the compressed downloaded file will be named jre664redist_nolic.tar.gz.

    Linux
    cd ${LOCAL_DIR}
    tar zxf ibm-java-jre-6.0-XX.X-linux-${arch}.tgz


    Note: for 1.1.0.5-TIV-ITM-ECC-JRE-AIX-IF0007 and later, the compressed downloaded file will be named ibm-java-jre-6.0-XX.X-linux-${arch}_nolic.tgz.

    Windows
    Use the Windows Explorer to copy the contents of the downloaded zip file, "ibm-java-jre-60-win-${arch}.zip", into %LOCAL_DIR%

    Note: for 1.1.0.5-TIV-ITM-ECC-JRE-AIX-IF0007 and later, the compressed downloaded file will be named "ibm-java-jre-60-win-${arch}_nolic.zip.

    where ${arch} is the system architecture, such as "i386" (x86 32-bit), "x86_64" (x86 64-bit), or "s390x" (64-bit zSeries).
    where ${LOCAL_DIR} and %LOCAL_DIR% is an empty, temporary local directory with sufficient space to unpack the downloaded compressed tar file.
    where XX.X is the Java service release and fix pack level, for example 16.0.

  4. Stop the Enterprise Common Collector service.

  5. Backup the existing runtime environment installation by renaming the existing jre directory.

    AIX, Linux
    cd ${ECC_INSTALL_DIR}
    mv jre original.jre
    mkdir jre
    chmod 775 jre


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

    cd "%ECC_INSTALL_DIR%"
    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
    move copyright original.jre
    move notices.txt original.jre

  6. Copy the runtime environment files to the Enterprise Common Collector installation:

    AIX
    cp -r ${LOCAL_DIR}/*
    ${ECC_INSTALL_DIR}/jre


    Linux
    cp -r ${LOCAL_DIR}/ibm-java-${arch}-60/*
    ${ECC_INSTALL_DIR}/jre


    Windows
    Use the Windows Explorer to copy the contents of %LOCAL_DIR% into %ECC_INSTALL_DIR%\ecc\jre

    where ${arch} is the system architecture, such as "i386" (x86 32-bit), "x86_64" (x86 64-bit), or "s390x" (64-bit zSeries).

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

    AIX, Linux
    chown -R 500:500 ${ECC_INSTALL_DIR}/jre
    chmod -R 775 ${ECC_INSTALL_DIR}/jre


    Windows
    This step is not required on Windows.

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

  9. Start the Enterprise Common Collector service.

[{"Product":{"code":"SSTFXA","label":"Tivoli Monitoring"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Enterprise Common Collector V1.1.0","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"6.2.3.3;6.2.3.4;6.3;6.2.3.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSPLFC","label":"Tivoli Application Dependency Discovery Manager"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":" ","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"7.2.2;7.5","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
17 June 2018

UID

swg21678794