IBM FileNet P8 Content Engine 4.5.1.7-P8CE-ALL-IF002 Interim Fix Readme

© Copyright IBM Corporation 2010, 2014

Readme file for: IBM® FileNet® P8 Content Engine
Update name: 4.5.1.7-P8CE
Fix ID: 4.5.1.7-P8CE-ALL-IF002
Publication date: 14 January 2014
Last modified date: 14 January 2014

Contents

About this fix
Compatibility
Installation and configuration
Installing this fix
Removing the interim fix
Fix list (APARs)
Notices
Trademarks
Document change history

About this interim fix

This interim fix provides resigned .jar certificates for a specific IBM FileNet P8 Content Engine release. The files provided in this interim fix are Content Engine built JAR files, but only need to be applied on the Application Server of Content Engine web based client applications, such as the Application Engine, and custom Java applications using the Content Engine Java client API. Verify that resigned JAR files from other engines (specifically, the Application Engine and Process Engine) are applied, based on the version of those products.

The certificates are required with Java v1.7.0_051 and higher.

Prerequisites

This interim fix requires:

Installation and configuration

Support documentation

Before installing this interim fix, verify that you have access to the IBM FileNet P8 Information Center at:http://publib.boulder.ibm.com/infocenter/p8docs/v4r5m1/index.jsp. The P8 Info Center contains additional information that you might need to perform the procedures included in this readme, such as stopping services and applications.

Installing this interim fix

Installation of this software requires Administrator privileges.

There are two sections for installing this interim fix:

To install on the Application Engine Server

Install the .JAR files in two locations on the Application Engine Server: the download directory and the installation directory.

  1. Download the 4.5.1.7-P8CE-IF002.zip file, and extract its contents to a temporary location.
  2. Log on to the Application Engine Server with a user account that has the appropriate permissions to create folders and install files.
  3. Stop the application server.
  4. Stop any component managers and Content/Process Engine-related services that are running.
  5. Back up the existing files located in the following directories, and then copy the new .jar files provided with this interim fix into these directories.

    WebSphere 6.0.x, 6.1.x, 7.0.x

    WebLogic 9.0.x, 10.0.x

    JBoss

  6. Delete the Workplace/Workplace XT temp directories:
  7. WebSphere 6.0.x, 6.1.x, 7.0.x

    WebLogic 9.0.x, 10.0.x

    JBoss

  8. Restart the application server.
  9. To ensure that the updated Java certificate.jar files are downloaded and used, open the Java Control Panel and clear out any java caching from the client machines.
  10. Restart any Process-Engine services and Component Managers that were previously stopped.
  11. Repeat for all other Application Engines in the environment.

    IMPORTANT Rebooting the FileNet P8 system or restarting the FileNet P8 services without applying the required FileNet P8 fixes on all machines might cause the system to become out of synch with the other FileNet P8 machines. Having an unsynchronized FileNet P8 environment can cause problems because FileNet P8 processes might automatically restart before the complete FileNet P8 environment has been updated.

To install for custom Java applications

Tip Do not install the resigned jars on the Process Engine. This is not necessary and can cause a communication issue between Process Engine and Content Engine.

  1. Download the Content Engine 4.5.1.7-P8CE-IF002.zip file, and extract its contents to a temporary location.
  2. Back up the existing copies of the Jace.jar and javaapi.jar files, located in: drive:\Program Files\IBM\FileNet\CEClient\lib
  3. Copy the updated version of the Jace.jar and javaapi.jar files provided with this interim fix into the same directory as the existing files. (This action overwrites the existing copies.)
  4. On some systems (for example, systems using custom applications), the Jace.jar and javaapi.jar files might also exist in other directories or be otherwise bundled with the custom application (for example, with the J2EE WAR or EAR file). If you have any custom applications, search for the files and replace other instances with the new versions supplied in this interim fix.

Removing the interim fix

After installing this interim fix, if you need to restore Application Engine and/or any specific custom application changes to their previous condition, use the backed up copy of the .jar files.

Fix list (APARs)

The following table lists the product fixes this interim fix.

4.5.1.7-P8CE-ALL-IF002 (includes 4.5.1.7-P8CE-ALL-IF001)
APAR
Description
PJ41753
Update to JRE v1.7.0_051 Certificates and to support SHA-256. See techdoc 1640073

4.5.1.7-P8CE-ALL-IF001
APAR
Description
NA
Provides Java Certificate updates.

Notices

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative 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
J74/G4
555 Bailey Avenue
San Jose, CA 95141
U.S.A.

For license inquiries regarding double-byte (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.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: 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 states 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 Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply 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 Corporation
J46A/G4
555 Bailey Avenue
San Jose, CA  95141-1003
U.S.A.

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.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

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.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

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 the names and addresses used by an actual business enterprise 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 Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are marked on their first occurrence in this information with a trademark symbol (® or ™), these symbols indicate U.S. registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. 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.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.

Document change history

Date
Description
09 March 2012 Updates the installation instructions.
14 January 2014
Initial release of interim fix.