IBM FileNet P8 Process Engine Interim Fix Readme: 4.5.1.0-P8PE-IF001
© Copyright IBM Corporation 2010. All Rights Reserved.

About this interim fix
Accessing IBM FileNet documentation, compatibility matrices, and fix packs
Compatibility
New in this interim fix
Installation, migration, upgrade, and configuration
Requirements
Install this fix
Uninstall this interim fix
Product fix history
Contact customer support
Notices
Trademarks

About this interim fix

This document provides information about the IBM® FileNet® P8 Process Engine 4.5.1.0-P8PE-IF001 interim fix, which updates the Process Engine client installation files. The fix provided in this interim fix removes an unnecessary class. The class conflicts with a class that is included in some versions of JBoss deployed for the Content Engine. The conflict causes some web services calls to fail.

Accessing IBM FileNet documentation, compatibility matrices, and fix packs

Documentation

To access documentation for IBM FileNet P8 Platform and related products:

  1. Navigate to the Information Management support page (www.ibm.com/software/data/support).
  2. Select either FileNet Business Process Manager or FileNet Content Manager from the “Select a category” list.
  3. From the Product Support page, click Documentation. Under Additional Documentation support links, Product Documentation, click P8 Platform.
  4. From the Product Documentation page for FileNet P8 Platform:
    1. If necessary, click a product Doc Link to display the list of component product documentation.
    2. Click the icon in the appropriate release column to access the document you need.

Compatibility matrices and fix packs

To access compatibility matrices and fix packs for IBM FileNet P8 Platform and related products:

  1. Navigate to the Information Management support page (www.ibm.com/software/data/support).
  2. From the 'Select a category' dropdown, select FileNet Product Family.
  3. From the 'Select a product' dropdown, select FileNet Business Process Manager.
  4. Click Download under “FileNet Business Process Manager support”.
  5. From the FileNet Business Process Manager support page, check the Updates box and enter "fix packs" in the 'Enter search criteria' box.
  6. From the search results page, click IBM FileNet Fix Packs.
  7. From the Fix Packs page, click a product name.
  8. In the select product page:

    Compatibility matrices
    Click Matrix to view the compatibility matrix.
    Note You will need an IBM account to view documents on this site.

    Fix packs
    Click the product version number to start the fix pack download.

Compatibility

For compatibility information, see the:

New in this interim fix

This interim fix does not introduce any new features.

For more information about Process Engine new features and known issues, see the IBM FileNet P8 Release Notes.

Installation, migration, upgrade, and configuration

Support documentation

Before installing this interim fix, verify you have an installed copy of the latest IBM FileNet P8 Platform Documentation package. This documentation package contains additional information that you might need to perform the procedures mentioned in this readme, such as stopping services and applications.

Search is enabled in the help system only if you have installed it as a web site on a web server that supports Java™ applications.

Requirements

The following component must be installed before installing this interim fix:

Run the Process Engine client installer

Run the Process Engine client installer that is shipped with this fix pack to synchronize the version of Process Engine files on the Content Engine. Do not update Process Engine client files to this fix pack if you have not already updated Process Engine.

You must run the installer once on each of the other servers. Perform one or more of the following procedures, depending on which applications run in your environment.

Run the Process Engine client installer on the Content Engine server

To install the Process Engine client files, perform the following steps on all Content Engine servers. Except where noted, the steps apply to WebSphere, WebLogic, and JBoss.

  1. Log on to the Content Engine server as a user who has permission to install software.
  2. Back up the system using your normal backup procedures.
  3. Select the TAR or ZIP file that is appropriate for your operating system and download it to Content Engine server. Unzip or untar the fix pack file for your system to a local directory:
  4. Close all instances of Enterprise Manager and any other Content Engine client applications, such as Application Engine. From the application server administrative console:
  5. (WebLogic only)Delete the application server cache directories shown in the following tables, substituting your domain name and machine name in place of mydomain and myserver, respectively:
    Operating system

    Cache directories to delete

    UNIX

    /opt/bea/user_projects/domains/mydomain/servers/AdminServer/tmp/_WL_user\Engine-wl
    /opt/bea/user_projects/domains/mydomain/servers/AdminServer/cache/EJBCompilerCache

    Windows

    C:\bea\user_projects\domains\mydomain\servers\AdminServer\tmp\_WL_user\Engine-wl
    C:\bea\user_projects\domains\mydomain\servers\AdminServer\cache\EJBCompilerCache


  6. Run the Process Engine client installer interactively or silently. To run silently, see Run the Process Engine client installer silently section. After running silently, continue to Step 8 to complete the update on the Content Engine server.
  7. Complete the Installer screens as follows:

    In this screen...

    Perform this action...

    Products to Update

    Select Content Engine

    Stop Running Software

    If prompted, stop all running software components

    Installation Summary

    Validate that the information displayed is correct and that there is enough space to complete the installation.

    Software Components

    Select the software components to automatically start after the installation is complete.


  8. Redeploy the Content Engine application. Refer to the latest version of the FileNet P8 4.5.x Platform Installation and Upgrade Guide for specifics on deploying the Content Engine on specific application server types.
  9. (JBoss only) Start JBoss.

Run the Process Engine client installer silently

  1. Follow the instructions in the P8PEClient_silent_input.txt file to modify the input information for the component on which you want to install the Process Engine client files.
  2. Execute the Process Engine Client installer with the following arguments:

    Windows 4.5.1.0-P8PECLIENT-IF001-WIN.EXE -silent -options path\P8PEClient_silent_input.txt

    UNIX 4.5.1.0-P8PECLIENT-IF001-<operating system>.BIN -silent -options path/P8PEClient_silent_input.txt

Uninstall this interim fix

This interim fix does not have an uninstall option. For support, see "Contact customer support".

Product fix history

The table lists the fixes and features in this interim fix.

4.5.1.0-P8PE-IF001


APAR Defect Type
Description
PJ37261
849700
Fix
A java.lang.LinkageError: loader constraint violation occurs when attempting to use Process Engine web services on JBoss 5.1 due to a conflict with the QName class.

Contact customer support

For information about contacting customer support:

  1. Navigate to the Information Management support page ( www.ibm.com/software/data/support ).
  2. Under the Search Information Management support section, enter the search term: 'support for IBM FileNet products'.
  3. Select How to get support for IBM FileNet products from the search results.

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 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