Readme file for: IBM® FileNet® P8 Content Platform Engine
Update name: 5.5.12.0-P8CPE
Fix ID: 5.5.12.0-P8CPE-IF001
Publication date: 27 March 2024
Last modified date: 27 March 2024
This interim fix updates the Content Platform Engine services, client API jars, and tools.
This interim fix is cumulative, and includes previous interim fixes.
Important: If you are using this interim fix as a part of a new installation of the Content Platform Engine, install the interim fix files as directed here but stop before "Configuring the server after installation". Instead follow the instructions in the IBM Docs topic "Installing and configuring Content Platform Engine" Installing Content Platform Engine to complete your new installation.
Important: If you are using this interim fix to upgrade from a release prior to 5.5.12, install the interim fix files as directed here but stop before "Configuring the server after installation". Instead continue with the upgrade process as described in the IBM Docs topic "Upgrading and configuring Content Platform Engine" Upgrading Content Platform Engine.
Click the following link to access the files for this interim fix server update: Fix Central for Interim Fix 5.5.12.0-P8CPE-IF001. You need an IBM login and password to access this download location.
To verify the FileNet Content Manager files that were not altered, see the signature verification technical note 6416109.
This interim fix requires:
The following changes are introduced in this 5.5.12.0-P8CPE-IF001 Interim Fix:
This interim fix has the following known problems and restrictions that might be continuing, and the solutions are provided where applicable:
Tip When you are copying files from Windows to Linux, make sure the copy program used does not modify CR/LF
Installation of this interim fix consists of the following tasks:
In environments where there is more than one Content Platform Engine server running in the P8 domain, the Content Platform Engine nodes can be set up in either a managed or non-managed configuration.
When you deploy Content Platform Engine in a "managed" application server environment, this Content Platform Engine interim fix is installed and configured on the administration server. The Configuration Manager uses the administration tools of the application server to deploy the Content Platform Engine EAR file to the managed servers. This is known as a "managed" deployment.
When you deploy Content Platform Engine in a "non-managed" application server environment, install and configure this Content Platform Engine interim fix on any Content Platform Engine server in the environment. After configuring the Content Platform Engine EAR file on this first server, you will be directed to copy the EAR file to each of the other servers and deploy the EAR file on all of the servers.
Complete the following tasks to prepare the Content Platform Engine server for this interim fix.
WL_HOME is the installation path for WebLogic Server.
mydomain is the WebLogic domain where the FileNetEngine application is deployed.
servername is the name of the Content Platform Engine (CPE) server instance where the FileNetEngine application is deployed.
Complete the following tasks to install this interim fix.
Important: The Content Platform Engine (CPE) EAR file naming convention is "Engine-xx.ear" where "xx" represents the Content Platform Engine application server type (ws, wl122).
For WebLogic customers, Engine-wl122.ear is for users of WebLogic 12.2 and later.
Take a backup of the following existing files.
Then copy the updated versions of the files that were extracted from the fix (see prior step) into the same directory as the existing copy that you just backed up. (This action overwrites the existing copy.)
On UNIX
installation_location/ContentEngine/lib/Engine-xx.ear
installation_location/ContentEngine/lib/Jace.jar
On Windows
installation_location\ContentEngine\lib\Engine-xx.ear
installation_location\ContentEngine\lib\Jace.jar
On UNIX
user_home_directory/configmgr_workspaceOn Windows
user_home_directory\configmgr_workspaceOn UNIX
user_home_directory/configmgr_workspace_5.5.12On Windows
user_home_directory\configmgr_workspace_5.5.12This installation is required only on Windows systems where Content Search Services (CSS) indexing and searching or Thumbnails are configured for Oracle Outside In Technology (OIT) v8.5.3 and higher.
Note: If the Microsoft 2013 & 2015-2019 Redistributable files are currently installed, you do not need to re-install them. Both 2013 & 2015-2019 versions are required.
On Windows
Complete the tasks in this section to configure the server set-up information and to deploy Content Platform Engine.
Important: If you are using this interim fix as a part of a new installation of the Content Platform Engine or upgrade from a pre-5.5.12 version of the Content Platform Engine, stop here. Return to the instructions in the IBM Docs topic to complete the process for your new installation of a 5.5.12.0-P8CPE version or your upgrade from a pre-5.5.12 CPE version.
Before you deploy Content Platform Engine, you must gather information that is needed for the application server configuration profile and for startup and deployment of the Content Platform Engine EAR file.
Use the Installation and Upgrade Planning worksheet to identify all the required information about your Content Platform Engine installation. Refer to the following link for more details:
See IBM Docs Using the installation and upgrade worksheet.
Take a backup of the following existing files.
Then copy the updated versions of the files that were extracted from the fix (see prior step) into the same directory as the existing copy that you just backed up. (This action overwrites the existing copy.)
On UNIX
installation_location/ContentEngine/tools/configure/SwingCMUI.jarOn Windows
installation_location\ContentEngine\tools\configure\SwingCMUI.jar
installation_location\ContentEngine\tools\configure\SilentCE.jar
installation_location\ContentEngine\tools\configure\configmgr.bat
installation_location\ContentEngine\tools\configure\configmgr_cl.bat
installation_location\ContentEngine\tools\configure\configuration\cmlogging.properties
installation_location\ContentEngine\tools\configure\scripts\wlConnect.py
installation_location\ContentEngine\tools\configure\scripts\testDBConnect.tcl
installation_location\ContentEngine\tools\configure\scripts\configureWSJDBC.tcl
installation_location\ContentEngine\tools\configure\scripts\fetchNodes.py
Complete the tasks in this section to configure the server set-up information and to deploy Content Platform Engine.
Completing Configuration Manager update tasks interactively
Completing Configuration Manager tasks Command-line: Add and execute deployupdate
| Configuration Manager interface |
Executable name |
|---|---|
UNIX graphical user interface |
configmgr |
UNIX command line |
configmgr_cl |
Windows graphical user interface |
configmgr.bat |
Windows command line |
configmgr_cl.bat |
On UNIX
Run the following command from the command line: ce_install_path/tools/configure/configmgr.
On Windows
Select Start > All Programs > IBM FileNet P8 Platform > FileNet Configuration Manager or run the following command: ce_install_path\tools\configure\configmgr.bat.
In a non-managed application server environment, repeat the EAR deployment for all servers.
Note: You use the Content Platform Engine client installer to install the new jars that come from the updated Content Platform Engine server via the download service. It's important that the Content Platform Engine server be already updated by this interim fix and be running prior to running the client installer. By following the client installation instructions, the updated files are installed on all clients that are supported by the client installer. The files are also provided separately for clients not supported by the client installer.
The following Content Platform Engine client API files are included in this interim fix. These files must be installed as needed on the Content Platform Engine clients and customized application installation locations.
The below files are installed
After you have updated the Content Platform Engine servers complete the following tasks for all of the Content Platform Engine-related Java EE applications, and any custom Content Platform Engine-related Java EE applications.
The following table lists the names of the compressed fix client update files by operating system type:
Operating system type |
Name of compressed Content Platform Engine client update file |
|---|---|
| AIX |
5.5.12.0-P8CPE-CLIENT-AIX.tar.gz |
| Linux |
5.5.12.0-P8CPE-CLIENT-LINUX.tar.gz |
| Windows |
5.5.12.0-P8CPE-CLIENT-WIN.zip |
| zLinux |
5.5.12.0-P8CPE-CLIENT-ZLINUX.tar.gz |
Tip If the client installation program is unable to detect the existing installation of the FileNet P8 application you are updating, you must manually ensure that the update occurs. Check the item in the "Select FileNet P8 Applications" dialog box and complete the client installation by entering (or browsing to) the location where that application is installed.
If you have a custom application which uses the Content Platform Engine client files then follow the instructions:
Installation errors are recorded in the ceclient_install_log_5.5.12.0.txt file, which is in the ceclient_install_path directory.
The installation and configuration of the client upgrade for this interim fix is complete.
Complete the following procedure to install the Content Platform Engine client updates silently.
The following table lists the names of the compressed fix client update files by operating system type:
Operating system type |
Name of compressed Content Platform Engine client update file |
|---|---|
| AIX |
5.5.12.0-P8CPE-CLIENT-AIX.tar.gz |
| Linux |
5.5.12.0-P8CPE-CLIENT-LINUX.tar.gz |
| Windows |
5.5.12.0-P8CPE-CLIENT-WIN.zip |
| zLinux |
5.5.12.0-P8CPE-CLIENT-ZLINUX.tar.gz |
Install this fix by running the following command that is appropriate for your operating system.
Operating system |
Command to install the Content Platform Engine server update |
|---|---|
| AIX |
5.5.12.0-P8CPE-CLIENT-AIX.BIN -i silent -f ceclient_silent_install.txt |
| Linux |
5.5.12.0-P8CPE-CLIENT-LINUX.BIN -i silent -f ceclient_silent_install.txt |
| Windows |
5.5.12.0-P8CPE-CLIENT-WIN.EXE -i silent -f ceclient_silent_install.txt
TIP You can monitor completion of this interim fix server update installation on Windows-based systems by using the Windows Task Manager. |
| zLinux |
5.5.12.0-P8CPE-CLIENT-ZLINUX.BIN -i silent -f ceclient_silent_install.txt |
Installation errors are recorded in the ceclient_install_log_5.5.12.0.txt file, which is in the ceclient_install_path directory.
This interim fix updates the .Net API FileNet.Api.dll and FileNetApiSetup.msi files.
Complete the following procedure to update .Net API client installed on a Windows machine.
The installation and configuration of the client upgrade for this interim fix is complete.
As the Java software used by FileNet Content Manager v5.5.10 and higher is now solely supplied by the customer, please be sure to check for updates to the versions you are using in the three instances we have use for Java: within your Application Server, check for JRE/SDK updates; in Content Search Services (CSS), check your vendor for updates; and for your private Java installations which may be used by our Content Platform Engine (CPE) stand-alone tools, also check your vendor for updates.
For customers who have installed the FileNet Deployment Manager (FDM) tool, this interim fix updates the FileNet Deployment Manager files.
Complete the following procedure to update Deployment Manager.
On Linux
Unzip fdm-linux.zip
On Windows
Unzip fdm-windows.zip
On Linux
Copy the fdm-linux.zip extracted files in the deploy directory to installation_location/deploy/
Run the following command: chmod +x DeploymentManager
On Windows
Copy the fdm-linux.zip extracted files in the deploy directory to installation_location\deploy\
On Linux
FDM_installation_directory/deploy
Run the following command: DeploymentManager -clean
On Windows
FDM_installation_directory\deploy
Run the following command: DeploymentManager.exe -clean
Note: With 5.5.12.0-P8CPE (GA) and higher versions, the Process Engine (PE) Process Designer (PD) tools are installed separately from Passport Advantage.
For customers who have installed the Process Engine (PE) Process Designer (PD) Tools, this interim fix updates the Process Designer and Process Engine Tools pe.jar file.
Complete the following procedure to update Process Designer and Process Engine Tools.
On Linux
client_library_installation_location/Jace.jar
On Windows
client_library_installation_location\Jace.jar
This interim fix updates the Content Engine Bulk Import (CEBI) tool bulkimport.jar and Jace.jar files.
Complete the following procedure to update Content Engine Bulk Import Tool.
Linux
installation_location/tools/CEBI/bulkimport.jar
installation_location/CEClient/lib/Jace.jar
Windows
installation_location\tools\CEBI\bulkimport.jar
installation_location\CEClient\lib\Jace.jar
You can use the Content event emitter with an IBM FileNet® Content Manager instance that is deployed on-premises in a traditional WebSphere Application Server environment by following the instructions.
This Interim fix does not have an uninstall option.
You can return to the prior release level by manually restoring the backed up files.
The following table lists the product fixes for this interim fix.
Deployment type: T=Traditional application server, C=Containerized, A=All deployment types
APAR / Known Issue |
Deployment |
Description |
|---|---|---|
DT244913 |
A |
Case History: Activity Comments not showing up in time-line visualizer. |
DT269751 |
A |
Administration Console for Content Platform Engine (ACCE) issue with Code Module re checkin of Jars. |
PJ47210 |
T |
Configuration Manager preferences for saving passwords to files unchecked still saves passwords. |
PJ47211 |
A |
Thread deadlock contention is preventing Process Engine (PE) server from starting. |
PJ47220 |
A |
Content Engine (CE) server CMCL-P8-*.JAR file leak in /tmp folder. |
PJ47222 |
T |
Configuration Manager NULL Pointer Exception (NPE) displayed when saving a freshly created profile or opening an existing profile. |
PJ47223 |
T |
Configuration Manager missing log messages under user.home. |
PJ47225 |
A |
Administration Console for Content Platform Engine (ACCE) can not list any ApplicationSpace of workflow system after adding more than two new workspaces including Japanese. |
PJ47228 |
A |
Administration Console for Content Platform Engine (ACCE) Simple Search Results and SQL Search Results are different. |
PJ47230 |
T |
Configuration Manager unable to configure Oracle 21c. |
PJ47232 |
A |
Administration Console for Content Platform Engine (ACCE) Process Configuration Console (PCC) Error on Committing Changes - Failed API_TransferConfig. |
PJ47234 |
T |
Configuration Manager configmgr_cl listservers command does not list the currently deployed Content Engine servers information. |
PJ47241 |
A |
Process Engine (PE) workflow case insensitive search using IN and collection is not correct. |
PJ47247 |
T |
Content Engine Bulk Import Tool (CEBIT): A journals directory and file is being created in the home directory before being switched to the JournalDirectory location. |
PJ47266 |
T |
Configuration Manager User Interface (CMUI) error in CPE 5.5.12 Deploy Application task when selecting 'Application server node' in a WebSphere Application Server (WAS) 8.5.5.x environment. |
PJ47267 |
A |
Content Engine (CE): Some GB18030 chars when used in the object store name or description are displayed incorrectly. |
n/a |
A |
Administration Console for Content Platform Engine (ACCE) (WS-2023-0429): ESAPI.jar security vulnerability. Affected, not vulnerable. Resolved by IBM Content Navigator (ICN) toolkit icn3.0.15-1-041. |
n/a |
A |
PSIRT ADV0112357 (CVE-2024-26308, CVE-2024-25710): Apache commons-compress security vulnerability. Affected, not vulnerable. Resolved by Apache commons-compress.jar v1.26.0 (February 2024) in IBM Content Navigator (ICN) toolkit 3.0.15-2-060. |
n/a |
T |
FileNet Deployment Manager (FDM) (CVE-2022-46337): Apache Derby security vulnerability. Affected, not vulnerable. Resolved by Apache Derby v10.14.3. |
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. 19-21, Nihonbashi-Hakozakicho, Chuo-ku Tokyo 103-8510, 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.
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.
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.
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.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.
Other product and service names might be trademarks of IBM or other companies.
| Date |
Description |
|---|---|
| 27 March 2024 |
Initial interim fix release. |