Release notes for Interim Fix for APAR PI84098 for Transformation Extender

Content

© Copyright IBM Corporation 2016. All Rights Reserved.
© Copyright HCL Technologies Ltd. 2017. All Rights Reserved.


=====================================================================
CONTENTS
=====================================================================

About this interim fix
Installing the interim fix
Known limitations, problems, and workarounds
Resolved Authorized Program Analysis Reports (APARs)
Contacting customer support
Notices and trademarks


=====================================================================
ABOUT THIS INTERIM FIX
=====================================================================


The interim fix for APAR PI84098 contains important fixes described in the Security Bulletin: Multiple vulnerabilities in IBM Runtime Environments Java Technology Edition, versions 6, 7, 8 affect Transformation Extender. It contains no changes to Transformation Extender components.

The interim fix for APAR PI84098 applies to all platforms on which Transformation Extender installs IBM Runtime Environment, Java Technology Edition, unless otherwise noted in the table below:


Table 1: Transformation Extender version, installed IBM Runtime Environment, Java Technology Edition version, and remediation

Transformation Extender version	Installed version of IBM Runtime Environment, Java Technology Edition	Remediation
Version 9.0.0: All releases through 9.0.0.1	Version 8	Install Transformation Extender V9.0.0.2
Version 8.4.1: All releases through 8.4.1.4	Version 7	Install Transformation Extender V8.4.1.5
Version 8.4.0: All releases through 8.4.0.5 Version 8.3.0: All releases through 8.3.0.7	Version 6	Install the interim fix for APAR PI84098

Important: The fix for APAR PI84098 upgrades the IBM® Runtime Environment, Java™ Technology Edition from version 6 to version 7.

You must first install Transformation Extender before you install the interim fix. Entitled customers can download Transformation Extender from the Passport Advantage online site. Download the interim fix for APAR PI84098 from Fix Central.

Reinstalling a Transformation Extender product or earlier fix pack after you apply an interim fix can overwrite the elements that are corrected by the interim fix.

The information in this document applies only to the interim fix. For information about Transformation Extender, read the product release notes and the latest product documentation.


=====================================================================
INSTALLING THE INTERIM FIX
=====================================================================

This section describes the steps to install the fix on all applicable platforms. The user ID that installs the interim fix must have sufficient authority to modify the Transformation Extender installation.

The following tables list the interim fix archive file names for each version of the runtime environment by platform and bit version:


Table 2: Archive file names for IBM Runtime Environment, Java Technology Edition: Version 6

Platform	Interim Fix Archive File Name 32-bit Versions	Interim Fix Archive File Name 64-bit Versions
AIX®	jre732redist.tar.gz	jre764redist.tar.gz
HP-Itanium	hpia3270sr10fp5hybrid-jre.tar.Z	hpia6470sr10fp5hybrid-jre.tar.Z
Linux®	ibm-java-jre-7.0-10.5-linux-i386.tgz	ibm-java-jre-7.0-10.5-linux-x86_64.tgz
Linux on System z	N/A	ibm-java-jre-7.0-10.5-linux-s390x.tgz
Solaris	sol70sr10fp5hybrid-jre.tar.Z	sol6470sr10fp5hybrid-jre.tar.Z
Microsoft® Windows®	ibm-java-jre-70-win-i386.zip	ibm-java-jre-70-win-x86_64.zip

The instructions that follow refer generically to the interim fix archive file as the java_archive file.

1. Stop all processes that use the Transformation Extender runtime environment.
2. Create a working directory named IFwork in the Transformation Extender installation directory (DTX_HOME_DIR) to hold the java_archive file. For example:

On UNIX® operating systems:
mkdir DTX_HOME_DIR/IFwork

On Windows operating systems:
mkdir DTX_HOME_DIR\IFwork

3. Transfer the java_archive file as a binary file to the DTX_HOME_DIR\IFwork directory.
4. Create a backup copy of the existing DTX_HOME_DIR\java directory. For example:

On Windows operating systems:
a. Create a backup directory named DTX_HOME_DIR\installed_java.
b. Move the existing DTX_HOME_DIR\java\bin directory and the DTX_HOME_DIR\java\lib directory into the DTX_HOME_DIR\installed_java directory.

On UNIX operating systems:
cd DTX_HOME_DIR
mkdir installed_java
mv java/bin installed_java/.
mv java/lib installed_java/.

5. Extract the java_archive file. For example:

On Windows operating systems, decompress the DTX_HOME_DIR\IFwork\java_archive file.

On AIX operating systems:
cd DTX_HOME_DIR/IFwork
gunzip -c java_archive | tar -xf -

On Linux, Linux on Power Systems, and Linux on System z operating systems:
cd DTX_HOME_DIR/IFwork
tar -zxf java_archive

On Solaris and HP Itanium operating systems:
cd DTX_HOME_DIR/IFwork
zcat java_archive | tar -xf -

6. The following table shows the extracted directory for each for each version of the runtime environment by platform and bit version.



Table 3: Extracted directory by platform for IBM Runtime Environment, Java Technology Edition: Version 6

Platform	Extracted runtime environment directory
AIX (32-bit and 64-bit)	DTX_HOME_DIR/IFwork/jre
HP-Itanium (32-bit and 64-bit)	DTX_HOME_DIR/IFwork
Linux (32-bit)	DTX_HOME_DIR/IFwork/ibm-java-i386-60/jre
Linux (64-bit)	DTX_HOME_DIR/IFwork/ibm-java-x86_64-60/jre
Linux on System z (64-bit)	DTX_HOME_DIR/IFwork/ibm-java-s390x-60/jre
Solaris (32-bit and 64-bit)	DTX_HOME_DIR/IFwork
Windows (32-bit and 64-bit)	DTX_HOME_DIR\IFwork\jre

7. Copy the /bin and /lib subdirectories from the extracted directory to the DTX_HOME_DIR/java directory.

8. Optionally, set the appropriate ownership and access permission on the UNIX deployments. For example:

chown -h -R install_owner_id:install_owner_group DTX_HOME_DIR/java
chmod -R u-w,g-w,o-w DTX_HOME_DIR/java

9. To test that the runtime environment is operable, enter: java -version
The system returns the version of the service pack that the interim fix installed.

10. After you verify that the runtime environment is working, delete the DTX_HOME_DIR/IFwork and DTX_HOME_DIR/installed_java directories.



=====================================================================
3. KNOWN LIMITATIONS, PROBLEMS, AND WORKAROUNDS
=====================================================================

See the Transformation Extender release notes for known problems and workarounds in each release.

For additional support resources, go to the Transformation Extender support portal.


=====================================================================
3. RESOLVED AUTHORIZED PROGRAM ANALYSIS REPORTS (APARs)
=====================================================================

The interim fix for APAR PI84098 contains no APAR fixes for Transformation Extender.


=====================================================================
4. CONTACTING CUSTOMER SUPPORT
=====================================================================

Contact Customer Support at 1-800-IBM-SERV or go to the Transformation Extender support portal.

==============================================================================

NOTICES
=======================================================================

This information was developed for products and services offered in the US. This material might be available from IBM in other languages. However, you may be required to own a copy of the product or product version in that language in order to access it.

IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBMrepresentative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US

HCL
330 Potrero Ave.
Sunnyvale, CA 94085
USA
Attention: Office of the General Counsel

For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan

HCL
330 Potrero Ave.
Sunnyvale, CA 94085
USA
Attention: Office of the General Counsel

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk.

IBM may use or distribute any of the information you provide in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

IBM Director of Licensing
IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US

HCL
330 Potrero Ave.
Sunnyvale, CA 94085
USA
Attention: Office of the General Counsel

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to actual people or business enterprises is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.

Trademarks

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

• Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.
• Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.
• Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.
• UNIX is a registered trademark of The Open Group in the United States and other countries.

Terms and conditions for product documentation

Permissions for the use of these publications are granted subject to the following terms and conditions.

Applicability
These terms and conditions are in addition to any terms of use for the IBM website.

Personal use
You may reproduce these publications for your personal, noncommercial use provided that all proprietary notices are preserved. You may not distribute, display or make derivative work of these publications, or any portion thereof, without the express consent of IBM.

Commercial use
You may reproduce, distribute and display these publications solely within your enterprise provided that all proprietary notices are preserved. You may not make derivative works of these publications, or reproduce, distribute or display these publications or any portion thereof outside your enterprise, without the express consent of IBM.

Rights
Except as expressly granted in this permission, no other permissions, licenses or rights are granted, either express or implied, to the publications or any information, data, software or other intellectual property contained therein.

IBM reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use of the publications is detrimental to its interest or, as determined by IBM, the above instructions are not being properly followed.

You may not download, export or re-export this information except in full compliance with all applicable laws and regulations, including all United States export laws and regulations.

IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE PUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.

IBM Online Privacy Statement

IBM Software products, including software as a service solutions, (“Software Offerings”) may use cookies or other technologies to collect product usage information, to help improve the end user experience, to tailor interactions with the end user, or for other purposes. In many cases no personally identifiable information is collected by the Software Offerings. Some of our Software Offerings can help enable you to collect personally identifiable information. If this Software Offering uses cookies to collect personally identifiable information, specific information about this offering’s use of cookies is set forth below.

This Software Offering does not use cookies or other technologies to collect personally identifiable information.

If the configurations deployed for this Software Offering provide you as customer the ability to collect personally identifiable information from end users via cookies and other technologies, you should seek your own legal advice about any laws applicable to such data collection, including any requirements for notice and consent.

For more information about the use of various technologies, including cookies, for these purposes, see IBM’s Privacy Policy at http://www.ibm.com/privacy and IBM’s Online Privacy Statement at http://www.ibm.com/privacy/details in the section entitled “Cookies, Web Beacons and Other Technologies,” and the “IBM Software Products and Software-as-a-Service Privacy Statement” at http://www.ibm.com/software/info/product-privacy.