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.
- Download the updated runtime environment package from the IBM Support website.
- 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)"
- 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.
- Stop the Enterprise Common Collector service.
- 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
- 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).
- 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.
- Verify that the update has been successful by re-running the 'java -fullversion' command, in a similar way to was used in step 2.
- Start the Enterprise Common Collector service.
Was this topic helpful?
Document Information
Modified date:
17 June 2018
UID
swg21678794