IBM FileNet P8 Content Platform Engine 5.2.1.3-P8CPE-FP003 Fix Pack readme
© Copyright IBM Corporation 2015.

Readme file for: IBM® FileNet® P8 Content Platform Engine
Update name: 5.2.1.3-P8CPE
Fix ID: 5.2.1.3-P8CPE-FP003
Publication date: 4 December 2015
Last modified date: 4 December 2015


Contents

About this Fix Pack
Prerequisites
New in this Fix Pack
Known problems, restrictions, and solutions
Download location
Installing and configuring this Fix Pack
Server update
Client update
Content Search Services update
Installing and configuring the server updates
Installing the client updates
Removing the Fix Pack
Fix Pack contents (APARs)
Notices
Trademarks
Document change history

About this Fix Pack

This Fix Pack updates the Content Platform Engine files. See the Fix Pack contents (APARs) section of this Readme for a list of fixes in this Fix Pack.


Prerequisites

Note: There is no 5.2.1.1-P8CPE-FP001 release, just a 5.2.1.1-P8CaseFoundation-FP001 release for new licenses

This Fix Pack requires:


New in Fix Pack 5.2.1.3-P8CPE-FP003

The following new features are introduced in this 5.2.1.3-P8CPE-FP003 Fix Pack:

Introduced in Interim Fix 5.2.1.2-P8CPE-IF001

Introduced in Fix Pack 5.2.1.2-P8CPE-FP002

Introduced in Interim Fix pack 5.2.1.0-P8CPE-IF003

Introduced in Interim Fix pack 5.2.1.0-P8CPE-IF002

Introduced in Interim Fix pack 5.2.1.0-P8CPE-IF001


Known problems, restrictions, and solutions

The following are some known problems and restrictions that are related to this Fix Pack:


Download Location

Click the following link to access the files for this Fix Pack server update: Fix Central for Fix Pack 5.2.1.3-P8CPE-FP003. You need an IBM login and password to access this download location.

The files that you download depend on your IBM software license and the GA product that you have installed.


Content Platform Engine server update files

The following table lists the names of the compressed feature pack server update files by operating system type:

Name of compressed Content Platform Engine feature pack server update file by operating system type
Operating system type
Name of compressed Content Platform Engine feature pack server update file
AIX®
5.2.1.3-P8CPE-AIX-FP003.tar.gz
HP-UX
5.2.1.3-P8CPE-HPUX-FP003.tar.gz
HP-UX Itanium®
5.2.1.3-P8CPE-HPUXI-FP003.tar.gz
Linux®
5.2.1.3-P8CPE-LINUX-FP003.tar.gz
Solaris
5.2.1.3-P8CPE-SOL-FP003.tar.gz
Windows®
5.2.1.3-P8CPE-WIN-FP003.zip
zLinux
5.2.1.3-P8CPE-ZLINUX-FP003.tar.gz

Content Platform Engine client update files

The following table lists the names of the compressed Fix Pack client update files by operating system type:

Name of compressed Content Platform Engine Fix Pack client update file by operating system type
Operating system type
Name of compressed Content Platform Engine Fix Pack client update file
AIX
5.2.1.3-P8CPE-CLIENT-AIX-FP003.tar.gz
HP-UX
5.2.1.3-P8CPE-CLIENT-HPUX-FP003.tar.gz
HP-UX Itanium
5.2.1.3-P8CPE-CLIENT-HPUXI-FP003.tar.gz
Linux
5.2.1.3-P8CPE-CLIENT-LINUX-FP003.tar.gz
Solaris
5.2.1.3-P8CPE-CLIENT-SOL-FP003.tar.gz
Windows
5.2.1.3-P8CPE-CLIENT-WIN-FP003.zip
zLinux
5.2.1.3-P8CPE-CLIENT-ZLINUX-FP003.tar.gz

Installing and configuring this Fix Pack

Server update

The server update automatically completes the following tasks:

The server update also modifies other tools and selectable components. If any client tools such as FileNet Deployment Manager (FDM), Consistency Checker, or the Bulk Import Tool (CEBI), are affected by changes in this Fix Pack, the installer can be run with the Tools option on those machines to update them.


Client update

The client update installs updated Content Platform Engine client files for Content Platform Engine-related Java EE applications, such as FileNet Application Engine, IBM FileNet Workplace XT, and IBM Enterprise Records.


Content Search Services update

The Content Search Services client software for Content Platform Engine is configured and deployed through the Configuration Manager. The Content Search Services server must be upgraded before installing Content Platform Engine server and client updates. If 5.2.1.3-P8CPE-FP003 is applied to the Content Platform Engine before upgrading the Content Search Services servers to 5.2.1.3-P8CSS-FP003, there will be a forward-compatibility error with the Content Search Services client and the Content Search Services servers. To avoid this, the Content Search Services servers must be upgraded to 5.2.1.3-P8CSS-FP003 prior to applying 5.2.1.3-P8CPE-FP003 to the Content Platform Engine.


Installing and configuring the server updates

This section consists of two parts: installing the Content Platform Engine 5.2.1.3 files, followed by configuring the Content Platform Engine. If you are licensed for FileNet Content Manager or IBM Content Foundation, complete the following sections.

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, install and configure the Content Platform Engine Fix Pack 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 the Content Platform Engine Fix Pack on one of the Content Platform Engine servers in the environment. After you configure the bootstrapped Content Platform Engine EAR file on this first server, copy and deploy the bootstrapped EAR file to each of the other servers.


Preparing the Content Platform Engine server for installation

Complete the following tasks to prepare the Content Platform Engine server for this Fix Pack.


Downloading this Fix Pack server update

  1. Log on as the "ce_install_user" user.
  2. Download the Fix Pack server update file that is appropriate for your operating system and extract its contents to a temporary location. For information, see Downloading this Fix Pack.
  3. Stop Content Platform Engine and all client applications, including, but not limited to:
  4. If you are installing only the .NET client or Tools components in the server update part of this Fix Pack, then skip step 5 and continue with Installing this Fix Pack on the Content Platform Engine server.
  5. (Existing 5.2.1.x installations only) Back up all existing bootstrapped Engine-xx.ear files (where xx is the application server abbreviation), on the Content Platform Engine server.

    Important Failure to make a backup of the existing bootstrapped Content Platform Engine EAR file can have serious repercussions on the operation of Content Platform Engine if you accidentally delete or overwrite the existing bootstrapped Content Platform Engine EAR file during the installation of this Fix Pack. A common symptom of a deleted or an overwritten bootstrapped EAR file is that system users cannot log on to Content Platform Engine and are not able to log on until that file is restored. If this situation occurs, you need a backup to recover.

  6. You can determine the location of the existing bootstrapped EAR file for Content Platform Engine by viewing the contents of the Servers.xml file, which is in the ce_install_path directory.


Installing this Fix Pack on the Content Platform Engine server

You can install the server updates either interactively or silently. This section consists of the following steps:


Installing the Content Platform Engine server updates interactively

Complete the following procedure to install the Content Platform Engine server updates interactively.

  1. Navigate to the temporary directory that you selected in Preparing the Content Platform Engine server for installation, and install the server updates on Content Platform Engine by running the installation program file that is appropriate for your operating system:

    Content Platform Engine server update executable file name by operating system
    Operating system
    Executable file name for the Content Platform Engine server update
    AIX
    5.2.1.3-P8CPE-AIX-FP003.BIN
    HP-UX
    5.2.1.3-P8CPE-HPUX-FP003.BIN
    HP-UX Itanium
    5.2.1.3-P8CPE-HPUXI-FP003.BIN
    Linux
    5.2.1.3-P8CPE-LINUX-FP003.BIN
    Solaris
    5.2.1.3-P8CPE-SOL-FP003.BIN
    Windows
    5.2.1.3-P8CPE-WIN-FP003.EXE
    zLinux
    5.2.1.3-P8CPE-ZLINUX-FP003.BIN

  2. From the Choose Components dialog box, select the components that you want to install.
  3. If you selected the Content Platform Engine server component, a dialog box prompts you to launch the Configuration Manager. Uncheck the Launch Configuration Manager check box and click Done.
  4. Continue with Completing the Content Platform Engine server installation.

Installing the Content Platform Engine server updates silently

Complete the following procedure to install the Content Platform Engine server updates silently.

  1. Navigate to the temporary directory that you selected in Preparing the Content Platform Engine server for installation.
  2. Open the ce_silent_install.txt file and edit the CHOSEN_INSTALL_FEATURE_LIST as appropriate for your configuration.
  3. Set LAUNCH_CM to 0 (zero). This setting prevents Configuration Manager from launching after the silent installation is complete.
  4. Read the license, and set LICENSE_ACCEPTED = true. This setting automatically accepts the end user license agreement. If LICENSE_ACCEPTED is not set to true, the installation program cannot run.
  5. On Linux systems, make sure execute permissions to install are set.
    For example: Run: "chmod +x 5.2.1.3-P8CPE-AIX-FP003.BIN"
  6. Install this Fix Pack by running the following command that is appropriate for your operating system.
Silent installation start commands by operating system for the Content Platform Engine server update
Operating system
Command to install the Content Platform Engine server update
AIX
5.2.1.3-P8CPE-AIX-FP003.BIN -f ce_silent_install.txt -i silent
HP-UX
5.2.1.3-P8CPE-HPUX-FP003.BIN -f ce_silent_install.txt -i silent
HP-UX Itanium
5.2.1.3-P8CPE-HPUXI-FP003.BIN -f ce_silent_install.txt -i silent
Linux
5.2.1.3-P8CPE-LINUX-FP003.BIN -f ce_silent_install.txt -i silent
Solaris
5.2.1.3-P8CPE-SOL-FP003.BIN -f ce_silent_install.txt -i silent
Windows
5.2.1.3-P8CPE-WIN-FP003.EXE -f ce_silent_install.txt -i silent
TIP You can use the Windows Task Manager to monitor completion of this Fix Pack server update installation on Windows based systems.
zLinux
5.2.1.3-P8CPE-ZLINUX-FP003.BIN -f ce_silent_install.txt -i silent

Completing the Content Platform Engine server installation

  1. Review the Content Platform Engine log files for installation errors

    Installation errors are recorded in the ce_install_log_5_2_1_3.txt file, which is in the ce_install_path directory (normally under ../IBM/FileNet/ContentEngine).

  2. Review the Content Platform Engine version log file (ce_version.txt)

    Record the Content Platform Engine build number from the ce_version.txt file, which is in the ce_install_path directory.

    You use this build number later in the installation process to confirm the deployment of the updated Content Platform Engine.

  3. (Custom .NET applications only) This step applies if you installed only the .NET client component on a machine that is not the Content Platform Engine server.
    1. Stop the .NET application.
    2. Activate the updated file (FileNet.API.dll) by placing it in the .NET application directory

      The Content Platform Engine installation program places the updated file (FileNet.API.dll) into the "installation_location\ContentEngine" directory.

    3. Restart the .NET application.

The remainder of this server update section applies only if you selected to install the Content Platform Engine server. Otherwise, you can skip to the section, Installing the client updates.


Configuring the Content Platform Engine server after installation

After you install the Content Platform Engine server software, configure it by using the steps in this section:

Determining the documentation to use for the remaining post-installation tasks

Removing a deployed Content Platform Engine

Removing the application server cache directories

Clearing the Internet browser cache on ACCE clients

Completing Configuration Manager tasks


Determining the documentation to use for the remaining post-installation tasks

The documentation that you use to configure and deploy Content Platform Engine depends upon the installation scenario.


Removing a deployed Content Platform Engine

To help prevent errors when you are redeploying the updated version of Content Platform Engine, remove the previously deployed copy of Content Platform Engine from the application server before you deploy the updated Content Platform Engine. The following sections provide information on specific application servers.


IBM WebSphere Application Server

Use the administrative console to uninstall the "FileNetEngine" application. This action deletes the Engine-ws.ear file from IBM WebSphere Application Server.


Oracle WebLogic Server

Use the Change Center in the administrative console to delete the "FileNetEngine" application. This action deletes the Engine-wl.ear file from Oracle WebLogic Server.


JBoss application server

Based on your "Standard" or "Cluster" deployment, remove the Engine-jb.ear file or Engine-jbc.ear file from one of the following directories, where jboss_install_directory is the JBoss installation directory and custom_name is the name of a user-defined directory.

Standard deployment

jboss_install_directory\server\default\deploy

jboss_install_directory\server\custom_name\deploy

Cluster deployment

jboss_install_directory\server\all\deploy


Removing the application server cache directories

To help prevent errors when you are redeploying the updated version of Content Platform Engine, remove the application server cache as described in the following topics.

MULTI-CPE NODE NOTE If your system has multiple Content Platform Engine nodes that run in a "managed" configuration, remove the application server cache directories from only the central "managing" application server and not from any managed application servers. If your system has multiple Content Platform Engine nodes that run in a "non-managed" configuration (multiple stand-alone application servers), remove the application server cache directories from all the application servers in the configuration.

IBM WebSphere Application Server

  1. Stop all WebSphere application server nodes, including the Deployment Manager node if one exists.
  2. Remove the FileNetEngine directory where the application server cache data is stored. For example, the default Windows path for this directory is:

    C:\Program Files\IBM\WebSphere\AppServer\profiles\profile_name\temp\node_name\server_name\FileNetEngine\

    profile_name
    Specifies the profile for Content Platform Engine
    node_name
    Specifies the name of the Content Platform Engine application server instance node
    server_name
    Specifies the name of the Content Platform Engine application server instance
  3. Restart all WebSphere nodes, including the Deployment Manager node if one exists.

Oracle WebLogic Server

  1. Stop the Oracle WebLogic Server.
  2. Remove the FileNetEngine and EJBCompilerCache directories, where the application server cache data is stored. For example, the default Windows paths for these WebLogic directories are:

    C:\bea\user_projects\domains\mydomain\servers\AdminServer\tmp\_WL_user\FileNetEngine

    C:\bea\user_projects\domains\mydomain\servers\AdminServer\cache\EJBCompilerCache

    mydomain
    Specifies the name of the Content Platform Engine application server instance.
  3. Restart Oracle WebLogic Server.

JBoss application server

  1. Stop the JBoss application server.
  2. Remove the following subfolders and files:
    jboss_install_directory
    Specifies the JBoss installation directory.
    custom_name
    Specifies the name of a user-defined directory.
  3. Standard deployment

    jboss_install_directory\server\default\tmp\deploy
    jboss_install_directory\server\default\work\jboss.web\localhost\FileNet

    jboss_install_directory\server\custom_name\tmp\deploy
    jboss_install_directory\server\custom_name\work\jboss.web\localhost\FileNet

    Cluster deployment

    jboss_install_directory\server\all\tmp\deploy
    jboss_install_directory\server\all\work\jboss.web\localhost\FileNet

  4. Do not restart JBoss until prompted to later in this readme. JBoss must not be running during the update process.

Clearing the Internet browser cache on ACCE clients

Clear the internet browser cache on all client computers that use Administration Console for Content Platform Engine (ACCE) for administering Content Platform Engine.

Firefox
Tools > Clear Recent History > Time range to clear: Everything. Make sure that all items are checked under Details.
Internet Explorer
Internet Options > Browsing history > Delete... > Check all boxes. Delete.
Safari
History > Clear History... > Clear

Completing Configuration Manager tasks

You can bootstrap and deploy Content Platform Engine either interactively or by using the command line. Choose one of the following links to complete the Configuration Manager tasks in this section.

Completing Configuration Manager tasks interactively

Completing Configuration Manager tasks using the command line

Completing Configuration Manager tasks interactively

Complete the following tasks in the order that is shown to set up and deploy the Content Platform Engine.


Starting the Configuration Manager

  1. Log on to the Content Platform Engine server as the "config_mgr_user" user.
  2. Start Configuration Manager by completing the procedure that is appropriate for the operating system.

    Windows

    Select Start > All Programs > IBM FileNet P8 Platform > FileNet Configuration Manager or run the following command: ce_install_path\tools\configure\configmgr.exe.

    UNIX

    Run the following command from the command line: ce_install_path/tools/configure/configmgr.


Choosing Licenses

Complete the following procedure to choose which licenses apply for your system.

  1. Choose File > Upgrade Profile (or click Create a profile from the upgrade installation icon).
  2. Enter your application server credentials.
  3. When the profile opens, ensure that, in the Configure Bootstrap and Text Extraction task in the Content Platform Engine Task View pane, the Bootstrap operation property shows Upgrade.
  4. Right-click on the profile tree and choose Add New Task > Choose Licenses.
  5. Choose one of the following license types for your installed products:
  6. Click on the Save button.
  7. Click on the Run Task button

    The licensing choices that are stored in the software tag files are written into the Content Platform Engine EAR file as part of the "Configure Bootstrap and Text Extraction" task execution.

    The IBM System Dashboard for Enterprise Content Management Listener component is configured with that licensing information so that usage reporting and the IBM License Metric Tool can make the correct product and license association.

    If you rerun the "Choose Licenses" task with a different set of licensing choices, you must complete the following steps in order so that the Content Platform Engine component that is running always has the correct licensing information:

    1. Uninstall the FileNetEngine application from your application server.
    2. Run the "Configure Bootstrap and Text Extraction" task.
    3. Run the "Deploy Application" task.

Bootstrapping the Content Platform Engine

Complete the following procedure to update or verify the Content Platform Engine bootstrap information.

  1. In the Bootstrapped EAR file location field, verify the fully qualified path to the currently bootstrapped Content Platform Engine EAR file.
  2. Select File > Save.
  3. Right-click Configure Bootstrap and Text Extraction task in the Content Platform Engine Task View pane, and select Run Task. This operation applies the bootstrap information to the updated Content Platform Engine EAR file that is provided by this Fix Pack. This operation can take a few minutes. Task execution status messages display in the window below the bootstrap properties.

Copying the bootstrapped Content Platform Engine EAR file to the remaining application servers

(Multiple non-managed stand-alone application servers only) Copy the bootstrapped Content Platform Engine EAR file into the profiles directory (where 5.2.1.0-P8CPE was originally bootstrapped) on each of the remaining Content Platform Engine application servers in your P8 domain. For example:

ce_install_path\tools\configure\profiles\myprofile\ear

(JBoss Application server) Based on your "Standard or Cluster" deployment, remove the Engine-jb.ear file or Engine-jbc.ear file from one of the following directories, where jboss_install_directory is the JBoss installation directory and custom_name is the name of a user-defined directory.

Standard deployment

jboss_install_directory\server\default\deploy

jboss_install_directory\server\custom_name\deploy

Cluster deployment

jboss_install_directory\server\all\deploy

The location where you copy the bootstrapped Content Platform Engine EAR file is referred to as the "bootstrapped EAR path". You must enter this path when you deploy the Content Platform Engine EAR file on the remaining application servers.


Deploying Content Platform Engine

  1. Right-click Deploy Application in the Content Platform Engine Task View pane, and select Edit Selected Task.
  2. In the Bootstrapped EAR file location field, verify the fully qualified path to the currently bootstrapped Content Platform Engine EAR file.
  3. Right-click Deploy Application in the Content Platform Engine Task View pane, and select Run Task to deploy Content Platform Engine. This task can take a few minutes. Task execution status messages display in the Console pane.
  4. Repeat steps 1 - 3 on all non-managed Content Platform Engine application servers in your P8 domain.

Deployment of the Content Platform Engine server update is now complete. Continue with Restarting the application server.


Completing Configuration Manager tasks using the command line

Complete the following procedure to specify setup information and deploy Content Platform Engine.

  1. Log on to the Content Platform Engine server as the "config_mgr_user" user.
  2. Navigate to ce_install_path/tools/configure.
  3. Run the configmgr_cl listServers command to display a list of valid server name values (in preparation for running the generateupgrade command).

    configmgr_cl listServers

  4. Run the generateupgrade command to generate the configuration profile. Enter the command on one line without line breaks.

    configmgr_cl generateupgrade [-appserver app_server_type] -server server_name [-deploy deploy_type] -profile myprofile [-silent] [-force] [-help]

    If a message indicates that a profile already exists, record the profile name. Use this profile name in places where this readme references myprofile.

    The following table lists the descriptions for the configmgr_cl generateupgrade command parameters:

  5. command line configuration profile parameters
    Parameter Description
    -appserver appserver_type Required only if the ce_install_path/Servers.xml file does not exist or does not contain any servers. This parameter specifies the type of application server and must be one of the following values: WebSphere, WebLogic, or JBoss.
    -server server_name Indicates the server for which the upgrade profile is being created. Run the configmgr_cl listServers command to display a list of valid server name values before you run the generateupgrade command.
    -deploy deploy_type Type of deployment.

    Required if the Servers.xml file does not exist or does not contain a deployment type for the selected server.

    If the Servers.xml file already has a deployment type for the selected server, then the value from the Servers.xml file is used instead of the value you specify on the command line.

    • Select one of the following values: Standard, Cluster, or Netdeploy (network deployment).
    • Specify Standard if you are deploying Content Platform Engine to a standalone WebSphere application server, Oracle WebLogic Server, or JBoss application server.
    • Specify Cluster if you are deploying Content Platform Engine to a WebSphere application server cluster, Oracle WebLogic Server cluster, or JBoss Application Server cluster.
    • Specify Netdeploy if you are deploying Content Platform Engine to a managed WebSphere application server instance. That is, you are using Network Deployment to manage individual servers that are not necessarily in a cluster.
    -profile myprofile The myprofile value can be one of the following items:
    • The name of the profile, such as ce_was_tiv_db2. The profile must be in the ce_install_path/tools/configure/profiles directory.
    • The absolute path to the profile directory, such as "C:\Program Files\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2" or opt/IBM/FileNet/ContentEngine/tools/configure/profiles/ce_was_tiv_db2.
    • The absolute path to the profile input file, such as "C:\Program Files\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2\ce_was_tiv_db2.cfgp" or opt/IBM/FileNet/ContentEngine/tools/configure/profiles/ce_was_tiv_db2/ce_was_tiv_db2.cfgp.

    If the path includes a directory name with spaces, enclose the entire path in quotation marks. For example, enter "C:\Program Files\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2\ce_was_tiv_db2.cfgp".

    -silent When -silent is specified, no prompts or informational messages display in the console, but errors are written to the log. Failure messages and validation error messages display as needed, such as messages about missing passwords or invalid port numbers.
    If you run the execute command to run all the tasks in a profile, and you specify the -silent parameter, you must also specify the -force parameter.

    The -silent parameter is optional.

    -force When -force is specified, the command is forced to continue running while in silent mode. Requires -silent.
    -help When -help is specified, a brief message describing the command syntax displays; the command does not run.
  6. (IBM WebSphere application server and Oracle WebLogic Server only) Set the application server administrator properties:
    1. Navigate to the myprofile/mycontent_engine_instance directory.
    2. Open the applicationserver.xml file in a text editor.
    3. Set the value for the ApplicationServerAdminUsername property:

      <property name="ApplicationServerAdminUsername">

      <value>administrator_user_name</value>

      </property>

    4. (IBM WebSphere application server only) Verify the values for the ApplicationServerInstallationFolder properties. If these properties do not exist, add them and set the values according to your environment:

      <property name="ApplicationServerInstallationFolder">

      <value>/opt/IBM/WebSphere/AppServer</value>

      <description>Enter the absolute path to the directory where the WebSphere application server is installed.</description>

      <displayName>Application server installation directory</displayName>

      </property>

      <property name="ApplicationServerProfileFolder">

      <value>/opt/IBM/profiles/AppSrv01</value>

      <description>Enter the absolute path to the directory where the WebSphere application server profile for Content Platform Engine is stored. If you are installing Content Platform Engine on a node in a cluster or on a managed server node and Deployment Manager is remote from Configuration Manager, use the directory for the WebSphere profile that is on the node. </description>

      <displayName>Application server profile directory</displayName>

      </property>

    5. Save your changes and close the file.
  7. (Optional) To encrypt and store the web application server administrator password to the applicationserver.xml file, run the storepasswords command. If you do not need to encrypt the application server administrator password, edit the applicationserver.xml file and enter the clear text of the password for the ApplicationServerAdminPassword property.

    configmgr_cl storepasswords -profile myprofile

    Repeat steps 5 and 6 as needed to edit the application server properties for each Content Platform Engine instance directory that was created.

  8. Enter the following command to run the Choose Licenses task:

    configmgr_cl generateconfig -appserver app_server_type -task task_type -license license_type -profile upgrade_profile_name

    Where the following parameters apply:

    The licensing choices that are stored in the software tag files are written into the Content Platform Engine EAR file as part of the "Configure Bootstrap and Text Extraction" task execution.

    The IBM System Dashboard for Enterprise Content Management Listener component will be configured with that licensing information so that usage reporting and the IBM License Metric Tool can make the correct product and license association.

    If you rerun the "Choose Licenses" task with a different set of licensing choices, you must complete the following steps in order that the running application always has the correct licensing information:

    1. Uninstall the FileNet Engine application from your application server.
    2. Run the "Configure Bootstrap and Text Extraction" task.
    3. Run the "Deploy Application" task.
  9. Enter the following command to run the Choose Licenses task:

    configmgr_cl execute [-task task_type | -taskfile task_file_name ] -profile upgrade_profile_name [-silent] [-force] [-help]

    Where the following parameters apply:

  10. If a bootstrap upgrade task (configurebootstrap.xml) does not already exist, generate the bootstrap information by entering the following information at the command line prompt.

    configmgr_cl generateConfig -task configurebootstrap -profile myprofile -bootstrap upgrade -appserver appserver_type

    -appserver appserver_type
    Specifies the application server type. Valid values are: WebSphere, WebLogic, or JBoss.
    -profile myprofile
    Specifies the profile name. If a profile already exists, use the name that you recorded earlier in this procedure.

    The bootstrap information is stored in the configurebootstrap.xml and the deployapplication.xml files. Each time the bootstrap information is generated, the system saves a unique version of the file. The initial file name is configurebootstrap.xml; subsequent file names are configurebootstrap.n.xml where "n" starts with 1 and represents the version number of each file.

  11. Confirm that the bootstrap configuration file was properly generated for an upgrade as follows.
    1. If this is the first time that the bootstrap information has been generated:
      1. Open the configurebootstrap.xml file and verify that the configuration tag contains the string implementorid="upgrade".
      2. If the configuration tag contains the string implementorid="upgrade", update the EAR file with bootstrap information by entering the following information at a command line prompt:

        configmgr_cl execute -task configurebootstrap -profile myprofile

        Status messages display in the console.

      3. If the configuration tag does not include the string implementorid="upgrade", return to step 9 and generate the bootstrap information again so that the next configurebootstrap.n.xml file is properly configured with the implementorid="upgrade" string.
    2. If the bootstrap information has been previously generated:
      1. Open the most recent configurebootstrap.n.xml file and verify that the configuration tag contains the string implementorid="upgrade".

        JBoss example: <configuration class="com.ibm.ecm.configmgr.product.ce.task.UpgradeJBBootstrap">

      2. If the configuration tag contains the string implementorid="upgrade", enter this command:

        configmgr_cl execute -task configurebootstrap -profile myprofile -taskfile configurebootstrap.n.xml

        Status messages display in the console.

      3. If the configuration tag does not include the string implementorid="upgrade", return to step 9 and generate the bootstrap information again so that the next configurebootstrap.n.xml file is properly configured with "upgrade".
      4. Check the completion status of the bootstrap task by running the checkStatus command as follows:

        configmgr_cl checkStatus -task configurebootstrap -profile myprofile -taskfile configurebootstrap.n.xml

        -profile myprofile
        Specifies the profile name. If a profile already exists, use the name that you recorded earlier in this procedure.
        -taskfile configurebootstrap.n.xml
        Specifies the version of the file to use. Omit this parameter if only one version of the task file exists.
    3. (Multiple non-managed stand-alone application servers only) Copy the newly updated Content Platform Engine EAR file into the Profiles directory on each of the remaining application servers. For example:

      ce_install_path\tools\configure\profiles\myprofile\ear

      The location you select is referred to as the "bootstrapped EAR path". You must enter this path when you deploy the Content Platform Engine EAR file on the remaining application servers.

    4. Edit the deployapplication.xml file and verify that the value of the BootstrappedContentEngineEar property is the same as the location of the Content Platform Engine bootstrapped EAR file.
    5. Run the following command to deploy Content Platform Engine:

      configmgr_cl execute -task deployapplication -profile myprofile

      -profile myprofile
      Specifies the profile name. If a profile already exists, use the name that you recorded earlier in this procedure.
    6. Check the completion status of the Content Platform Engine deployment by running the following command:

      configmgr_cl checkstatus -task deployapplication -profile myprofile

      -profile myprofile
      Specifies the profile name. If a profile already exists, use the name that you recorded earlier in this procedure.
    7. If the Content Platform Engine uses multiple non-managed, stand-alone application servers, repeat steps 10 c-f on all the application servers.

Deployment of the Content Platform Engine server update is now complete. Continue with the next section, Restarting the application server.


Restarting the application server


WebSphere and WebLogic

Stop and restart all servers and clusters where the Content Platform Engine EAR file has been deployed.


JBoss

Start all servers and clusters where the Content Platform Engine EAR file has been deployed.


Verifying the deployment of the updated Content Platform Engine EAR file

Complete the following procedure to verify that Content Platform Engine deployed successfully:

  1. Navigate to the following page:

    http://server:port/FileNet/Engine

    server
    Specifies the host name of the machine where Content Platform Engine is deployed.
    port
    Specifies the HTTP port used by the Web application server on the machine where Content Platform Engine is deployed.

    The defaults for the application server HTTP port number are as listed:

    • 9080 for WebSphere
    • 7001 for WebLogic
    • 8080 for JBoss
  2. Verify that the value in the Startup Message key for Content Platform Engine is the same as the Content Platform Engine build number that you recorded earlier in this procedure.

Checking the automatic upgrade status for Content Platform Engine data

When you deploy the upgraded Content Platform Engine application on the web application server and start the application, the existing Content Platform Engine data upgrade begins. You can check the progress on the upgrade to confirm that the upgrade was successful. Complete the following steps to check the status of the automatic data upgrade:

  1. Enter the URL for the automatic upgrade status page into your browser:
    http://server_name:port/FileNet/AutomaticUpgradeStatus
  2. Review the status for the FileNet P8 domain or object store.
  3. Verify that the status of the upgrade is "Completed" for the GCD and object stores. The upgrades are complete when they have a status of "Ready".

For more information on upgrades, see the IBM FileNet P8 Version 5.2 documentation for: Working with Configuration Manager.

Configuring the Rendition Engine connection to connect to an Oracle RAC

If your configuration uses Rendition Engine with Oracle RAC, complete the steps in this section, otherwise the Fix Pack installation is complete.

  1. Add the following parameter to the FileNet.properties file on the Content Platform Engine server.

    Publishing.OracleJDBCServiceFormat=true

    The following table lists the possible location of the FileNet.properties file:

    Possible location of the FileNet.properties file
    Application server
    Sample location of the FileNet.properties file
    IBM WebSphere® application server
    C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\FileNet.properties
    Oracle WebLogic Server
    C:\bea\user_projects\domains\mydomain\FileNet.properties
    JBoss Application Server
    C:\jboss\jboss-5.1_as\bin\FileNet.properties

    Important Because the publishing database connection is cached, you must restart the application server that is running Content Platform Engine after you update the parameter value of Publishing.OracleJDBCServiceFormat.

  2. Start the application server that is running Content Platform Engine.
  3. Modify the properties of the Rendition Engine connection. The properties can be set at either the Domain, Site, or Virtual Server level in your configuration.

    For example, to set the properties of the connection at the Domain level, complete the following procedure by using Administration Console for Content Platform Engine (ACCE):
    1. Right-click the Domain and choose Properties.
    2. Select the Publishing tab.
    3. Click Properties in the Select Rendition Engine Connection, or in the Select DITA Rendition Engine Connection area.
    4. Edit the Database name to be the service name of the Oracle RAC.
    5. Edit the Database Server Name to be the SCAN name of the Oracle RAC.
    6. Click OK to accept the change and close the property sheet.
  4. Restart the application server that is running Content Platform Engine.
  5. Verify that Rendition Engine is started.
  6. Verify the Rendition Engine Connection configuration by publishing a test document.

This completes the installation and configuration of the server upgrade part of this Fix Pack.


Installing the client updates

The following files are included in this Fix Pack:

You can install the client updates either interactively or silently. This section consists of the following steps:


Installing the Content Platform Engine fix pack client update on Content Platform Engine-related Java EE applications interactively

After you have updated the Content Platform Engine servers and the Content Platform Engine-related .NET clients, complete the following tasks for all of the Content Platform Engine-related Java EE applications, such as Application Engine, Workplace XT, IBM FileNet Services for Lotus Quicker, and IBM Enterprise Records servers and any custom Content Platform Engine-related Java EE applications (like IBM Content Navigator).

  1. Back up the existing Content Platform Engine client directories.
  2. Download the appropriate fix pack client update file and extract its contents to a temporary location. For information, see Downloading this fix pack.
  3. Complete the following instructions as appropriate for the client installation:
  4. 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.

    Documentation: IBM FileNet P8 Version 5.2 Knowledge Center

  5. Review the Content Platform Engine client log files for installation errors.

    Installation errors are recorded in the ceclient_install_log_5_2_1_3.txt file, which is in the ceclient_install_path directory.

  6. Restart the custom applications that use the Content Platform Engine client.

The installation and configuration of the client upgrade for this fix pack is complete.


Installing the Content Platform Engine client updates silently

Complete the following procedure to install the Content Platform Engine client updates silently.

  1. Log on as a user with permissions to install software.
  2. Stop all custom applications that use the Content Platform Engine client.
  3. Back up the existing Content Platform Engine client directories.
  4. Download the appropriate fix pack client update file and extract its contents to a temporary location. For information, see Downloading this fix pack.
  5. Open the ceclient_silent_install.txt file and edit the file as appropriate for your configuration, including the following fields and other fields that apply to your system.
  6. Install this Fix Pack by running the following command that is appropriate for your operating system.

    Silent installation start commands by operating system for the Content Platform Engine client update
    Operating system
    Command to install the Content Platform Engine server update
    AIX
    5.2.1.3-P8CPE-CLIENT-AIX-FP003.BIN -i silent -f ceclient_silent_install.txt
    HP-UX
    5.2.1.3-P8CPE-CLIENT-HPUX-FP003.BIN -i silent -f ceclient_silent_install.txt
    HP-UX Itanium
    5.2.1.3-P8CPE-CLIENT-HPUXI-FP003.BIN -i silent -f ceclient_silent_install.txt
    Linux
    5.2.1.3-P8CPE-CLIENT-LINUX-FP003.BIN -i silent -f ceclient_silent_install.txt
    Solaris
    5.2.1.3-P8CPE-CLIENT-SOL-FP003.BIN -i silent -f ceclient_silent_install.txt
    Windows
    5.2.1.3-P8CPE-CLIENT-WIN-FP003.EXE -i silent -f ceclient_silent_install.txt
    TIP You can monitor completion of this Fix Pack server update installation on Windows-based systems by using the Windows Task Manager.
    zLinux
    5.2.1.3-P8CPE-CLIENT-ZLINUX-FP003.BIN -i silent -f ceclient_silent_install.txt

  7. Review the Content Platform Engine client log files for installation errors.

    Installation errors are recorded in the ceclient_install_log_5_2_1_3.txt file, which is in the ceclient_install_path directory.

  8. Restart the custom applications that use the Content Platform Engine client.

The installation and configuration of the client upgrade for this fix pack is complete.


Removing the Fix Pack

This Fix Pack does not have an uninstall option. To remove this Fix Pack, you must redeploy the backed up copy of your previously bootstrapped Content Platform Engine EAR file.


Fix Pack contents (APARs)

The following table lists the product fix for this Fix Pack.

5.2.1.3-P8CPE-FP003 (includes 5.2.1.0-P8CPE-IF001, 5.2.1.0-P8CPE-IF002, 5.2.1.0-P8CPE-IF003, 5.2.1.2-P8CPE-FP002, 5.2.1.2-P8CPE-FP002a, and 5.2.1.2-P8CPE-IF001)
APAR
Description
PJ42852
Configuration Manager User Interface (CMUI) prompts for both ojdbc5.jar and ojdbc6.ar when creating datasources for Oracle RAC.
PJ42958
Updating the display name for a property template in Administration Console for Content Platform Engine (ACCE) does not update it in FileNet Enterprise Manager (FEM).
PJ43056
Error committing changes through PCC and transferring workflow assertion failed in RenameViewField.
PJ43237
Objects in storage cache cannot be decrypted correctly after the original content has been moved to a new location.
PJ43267
Administration Console for Content Platform Engine (ACCE) unable to display lifecycle policies with duplicate display names.
PJ43276
vwusersync stops updating environment records and group membership information is no longer up to date.
PJ43290
TSM management class does not appear on the fixed content storage area retention tab in Administration Console for Content Platform Engine (ACCE).
PJ43298
Web Service ProcessEngineWS issue.
PJ43303
Process designer invoked from IBM Content Navigator (ICN) fails with HTTP 505 error.
PJ43315
Search template returns unexpected results when using common search criteria for documents and folders.
PJ43317
Process Engine CE_Operations method setMultiStringProperty() is causing an exception.
PJ43318
Administration Console for Content Platform Engine (ACCE) cannot map Image Service (IS) F_DOCNUMBER property to Content Process Engine float type property.
PJ43320
Export of a moved folder that was previously exported will use the cached pathname for the contents.
PJ43321
Creating a workflow subscription in Administration Console for Content Platform Engine (ACCE) with enable manual launch unchecked sets EnableManualLaunch to NULL instead of false.
PJ43335
Process Engine's vwtool fails with a socket timeout when running the env cache * command.
PJ43355
Unable to access Case Builder due to a NOCLASSDEFFOUNDERROR error.
PJ43359
DB2 field overflow errors while inserting data into the blob fields.
PJ43366
Problem with validating WSDL at run time, get error "ERRORS: 0 : [UNRECOVERABLE ERROR] NULL: LINE -1, COLUMN -1, PREMATURE END O".
PJ43370
Process Engine limits SID length to 256, causing error on importing security manifest in CM Admin client.
PJ43379
Inbound and outbound replication fails with a CLASSCASTEXCEPTION due to an attempt to cast a string value to a hashmap.
PJ43382
Process Configuration Console does not display all the keys of an event log index.
PJ43387
FileNet Deployment Manager clears existing labels from security principal half map when merging entries retrieved from deploy dataset.
PJ43390
"Save Search" does not work the first few times after a new Object Store has been created.
PJ43392
"SMTP subsystem" tab has "Object Store" text rather than "Domain".
PJ43393
On multiple Case Analyzer (CA) stores configured environment, one or more CA stores republish events after running reset CA DB from CA Process Task Manager (PTM).
PJ43403
Error message when unlocking an unlocked queue record is missing a parameter.
PJ43404
Content Engine Web Services (CEWS) listener is not preserving the namespace abbreviations of SAML assertion.
PJ43405
"COM.FILENET.WCM.API.BADPROPERTYVALUEEXCEPTION: THERE IS NO PROPERTY NAMED BP8CASEID ON CE CLASS CUSTOMOBJECT." error occurs.
PJ43410
PSIRT 2048 (CVE-2012-5784, CVE-2014-3596): Apache Axis 1.4 vulnerability, saaj.jar used in PE Process Orchestration Web Service invocation. See techdoc 1965451
PJ43412
Process Engine (formally Visual Workflow) VWQueueQuery sometimes adds "... is not NULL..." to user criteria when an index is specified.
PJ43417
Database clock skew is reported in the error log but user transactions are incorrectly processed successfully.
PJ43425
Administration Console for Content Platform Engine (ACCE) hangs when saving an update to a complex choice list.
PJ43427
Process Engine Region Move tool can double the size of columns defined as VARGRAPHIC.
PJ43435
Cannot configure SSL/TLS email notification encryption on Content Platform Engine (CPE).
PJ43439
Content Platform Engine (CPE) installer fails when using Finnish (Finland) on Windows.
PJ43443
When -DFILENET.PE.BOOTSTRAP.CEURI is set, Process Engine Web Services (PEWS) uses it for Content Engine (CE) URI.
PJ43446
Opening Content Engine health page causes a SECURITY_ANONYMOUS_DISALLOWED exception to be issued in seemingly random places later.
PJ43447
Improve PCH counter metrics for content upload and download.
PJ43452
Process Engine (PE) upgrade syslog error should show root cause to help analyze issues.
PJ43455
Null Pointer exception when updating security object cache.
PJ43460
With Administration Console for Content Platform Engine (ACCE) storage area creation wizard for TSM does not save default management class in resource string property.
PJ43467
Cached Content Federated Services-Image Services (CFS-IS) properties become out of sync with property mapping when the name of the property that is being mapped is changed.
PJ43473
Cannot import "Iterator" error encountered during upgrade.
PJ43477, PJ43509
Administration Console for Content Platform Engine (ACCE) enhancement to Object Store simple search dialog. Should be able to show in the criteria drop down object type properties.
PJ43478
Version Series is not exposed in Administration Console for Content Platform Engine (ACCE) search.
PJ43484
Process Engine (PE) Admin and configuration group fails to decrypt correctly after upgrade in some cases.
PJ43485
Content Engine Bulk Importer (CEBI) add multi-value attribute support enhancement.
PJ43495
Unable to create new sweep object if parent class is set to not allow instances to be created.
PJ43505
Need to add Content Search Services keep alive for queries that do not write responses for 33 minutes to prevent time-out on the client side.
PJ43508
Upgrade "org.apache.commons.jason.jasonexception" when creating a principal half map from a dataset on Linux.
PJ43514
When trying to create an index that included OBJECT_CLASS_ID in Content Process Engine (CPE) using Administration Console for Content Platform Engine (ACCE) an E_INVALID_ENUM_VALUE error appears.
PJ43519
Boolean property should have 3 values in drop-down list.
PJ43520
Security templates do not provide the setting for the unlink document rights.
PJ43521
Wait For Condition assignment fails when triggered by old version of workflow with other than current field layout.
PJ43525
Configuration Manager's deploy application task fails when running on a non-English Operating System.
PJ43528
E_BAD_CLASSID: CLASS "CMACMCM8PROXYDOCUMENT" NOT FOUND error is logged when a subscription is configured to create cases in ICM.
PJ43530
Auto-upgrade should discard string-ized SIDS encountered on Object Store ACLS when creating ACLS for new base class definitions.
PJ43541
EVENTEXP25B5 PESECONDARY2 [ERROR] FNRPE2131090405E exception while attempting to begin processing a store CMTOS_EVENTEXPORTSTOR.
PJ43557
Content Engine Bulk Importer (CEBI) batch jobs terminates and does not complete when the STOP is detected.
PJ43562
Process Engine (PE) Upgrade should enforce that only one server in the farm would carry out this task.
PJ43566
PSIRT 3528 (CVE-2015-2613, CVE-2015-2601, CVE-2015-2625, CVE-2015-1931, CVE-2015-4749): Java Technology Edition security vulnerability critical patch update - July 2015. See techdoc 1967351
PJ43576
Unable to modify the Object Store property Database schema name in Administration Console for Content Platform Engine (ACCE).
PJ43590
Handling of XML character encoding can lead to mix up between ANSI and UTF-8 using XMLStringXpr and CE_Operations GetContent.
PJ43600
Image Services (IS) has been waiting over 16 minutes on Content Engine (CE).
PJ43606
Component Queue - Wrong queue version number after conversion of a JMS v1 (Legacy) queue to JMS v2 queue.
PJ43608
For IBM VMM Provider using UPN (UserPrincipalName) login uses the Mail virtual attribute to login.
PJ43616
Region Move tool DB2 create sequence should be consistent with Process Engine (PE) and PE upgrade creation of sequences on DB2.
PJ43619
Cannot open link on subclass of annotation.
PJ43629
Source destination pairs are not sorted when deployment data is stored on a Linux share.
PJ43631
Implementation of change class does not persist data.
PJ43634
Policy sweep does not generate most efficient query.
PJ43639
Case Analyzer (CA) publishing fails with error "ORA-02291: INTEGRITY CONSTRAINT VIOLATED - PARENT KEY NOT FOUND".
PJ43643
Case History (CH) upgrade fails when the case objects are deleted from Content Engine database.
PJ43648
WSRequest synchronous timeout setting to configure the timeout for individual Web Service calls is no longer available.
PJ43651
When a step deadline expired and some defined response is missing, VWTime unable to process the work item out of delay queue.
PJ43658
Increase Content Search Services socket read timeout to 60 minutes.
PJ43668
Failure to convert some TIF files to thumbnails on AIX.
PJ43669
Content Engine Bulk Importer (CEBI) previous files removed from Content Platform Engine (CPE) if a batch is run with same name twice and the .RPT file is in the working directory.
PJ43673
Process Engine (PE) WSBroker.properties LogEnabled=false WSInvoke not turned off.
PJ43681
Content Search Services text extraction indexing failing on content added to Fixed Content Device (FCD) or DB Storage when file name extension exceeds 19 characters.
PJ43684
Integer property is not selectable in Administration Console for Content Platform Engine (ACCE) for mapping a number with an 8 digit display mask.
PJ43699
PSIRT 4021 (CVE-2015-5006): IBM SDK, Java Technology Edition security vulnerability critical patch update - October 2015. See techdoc 1969428
PJ43703
PSIRT 4025 (CVE-2015-4809, CVE-2015-4811, CVE-2015-4877, CVE-2015-4878): Oracle Outside In Technology Critical Patch Update - October 2015. See techdoc 1969427
PJ43728
PSIRT 4202 (CVE-2015-7450): Apache Commons collections issue patch. See techdoc 1970916

5.2.1.2-P8CPE-IF001
APAR
Description
PJ43172
PSIRT 3058: Bar Mitzvah exploit: Update the IBM private JRE of the Process Engine server to version 1.6 SR16 FP3+IV70681+IV71888 in response to a Java PSIRT security issue (Bar Mitzvah - CVE-2015-2808). See Security Bulletin 1701597
PJ43196
PSIRT 3141: April 2015 Quarterly JRE Update: Update the IBM private JRE of the Process Engine server to version 1.6 SR16 FP4 in response to a Java PSIRT security issue. See Security Bulletin 1883959
PJ43346
PSIRT 3328: Logjam exploit: Update the IBM private JRE of the Process Engine server to version 1.6 SR16 FP5 in response to a Java PSIRT security issue. See Security Bulletin 1960191

5.2.1.2-P8CPE-FP002a (includes 5.2.1.0-P8CPE-IF001, 5.2.1.0-P8CPE-IF002, 5.2.1.0-P8CPE-IF003, and 5.2.1.2-P8CPE-FP002)
APAR
Description
PJ43419
Cannot launch the 5.2.1.2-P8CPE-FP002 installer on AIX as a non-root user.

5.2.1.2-P8CPE-FP002 (includes 5.2.1.0-P8CPE-IF001, 5.2.1.0-P8CPE-IF002, and 5.2.1.0-P8CPE-IF003)
APAR
Description
PJ42448
Unable to transfer consistently due to repeated VWTime errors related to a deleted LDAP user being logged in the Process Engine (PE).
PJ42614
The Administration Console for Content Platform Engine (ACCE) "Available Users and Groups" list does not display the full user name or group.
PJ42626
Unable to use CE_OPERATIONS getStringProperty to return values for ID, GUID, and OIID.
PJ42635
Content Engine Bulk Importer is unable to import greater than 5120 documents in a batch.
PJ42644
Change to explicitly call definePackage when a new class is loaded to avoid Null Pointer Exception
PJ42646
Administration Console for Content Platform Engine (ACCE) is enforcing the condition that the Object Store where the workflow event subscription resides must also contain a workflow system.
PJ42647,
PJ42947
vwtool's env i f m y and env v(view) p(persistent) commands can get stuck on a bad environment record if the blob is null
PJ42648
Unable to index certain PDF files, Oracle Outside In Technology (OIT) Text Extraction failure.
PJ42653
Incorrect linkage when replacing TCCL
PJ42657
Case Analyzer (CA) stops processing if the class definition of the object that generated the Content Engine (CE) event is deleted prior to CA processing it.
PJ42665
The getAnnotLogEntries() method does not close its Image Services (IS) connection if it fails its re-logon attempt.
PJ42671
Content Engine Bulk Import (CEBI) tool Extended ASCII codes could not be used for delimiter.
PJ42676
The getAnnotLogEntries() method does not close its Image Service (IS) connection if it fails its re-logon attempt
PJ42678
Administration Console for Content Platform Engine (ACCE) can not edit or delete schedule on sweep
PJ42690
The strloc function that detects the location of a substring in a string does not work with the substring is not found.
PJ42696
Improvements to the logic surrounding the Content Engine file containing IDs for use for use for Image Services (IS) documents
PJ42704
Allow unset of Verity Domain Configuration from domain following Legacy Content Search Engine (LCSE) decommission
PJ42705
Content Repository items are being assigned duplicate sequence numbers because of E_DEADLOCK_ERROR
PJ42706
"Work queue record...is not locked" exception during workflow processing
PJ42709
Administration Console for Content Platform Engine (ACCE) producing duplicate ACL's on Doc class security tab
PJ42716
Sweep timeslots are non-functional on Internet Explorer (IE) 10/11, Chrome, and Safari
PJ42719
Entry template associated to a folder property fails to convert in FileNet Deployment Manager
PJ42728
Select base workflow in process Designer is slow.
PJ42738
Administrative Console for Content Platform Engine (ACCE) can not update directory configuration bind user's password.
PJ42753
Case Analyzer processes events slow and logs error "Missing operation dimension info, will try to get it from PE".
PJ42755
Process Engine (PE) Exception "Invalid Field Type {0}".
PJ42761
Illegal conversion: can not convert from "java.sql.Timestamp" to "java.lang.Integer" during upgrade from 5.1 to 5.2
PJ42762
The searchForMany function of CE_Operations does not work as documented when used with stored search.
PJ42767
Timeline Visualizer widget shows "Call" events, displaying no further context information
PJ42791
Administration Console for Content Platform Engine (ACCE) does not properly display Application Spaces with blank spaces in the Name
PJ42821
Custom application gets CONTENT_PC_UNKNOWN_STATE on Content Engine upload of large documents
PJ42824
Policy-controlled sweep generates incorrect and inefficient query when filter optimization is enabled
PJ42832
vwtool's "env cache " command only refreshed the persistent database store and did not update the runtime memory cache
PJ42836
In-flight workflows upgraded from releases older then Process Engine (PE) 5.0 with NULL (DATE) expression get bad datatype exception
PJ42857
PSIRT 2498 (CVE-2014-8917): Dojo Toolkit Cross Site Scripting (XSS) vulnerability. See Security Bulletin 1697151
PJ42858
When installer runs out of disk space during ear generation it fails silently and only logs error to stdout located in temp directory
PJ42863
Upgrade workflow error "The method invoked is inappropriate for the datatype of the property..."
PJ42747
Process designer displays does not display double-byte characters when opening a solution workflow collection.
PJ42864
RMI Connectivity issues between CPE and SSAS connector node due to firewall in between.
PJ42865
Race condition occurs where multiple asynchronous upgrade queueitems rows are created for event_operation=4
PJ42866
Process Engine Component Manager CE_Operations.GetObjectProperty sets attachment with local object store
PJ42869
Object Store upgrade from 4.5.1 to 5.2.1 appears to be halted on the asynchronous upgrade tasks: replication and LCSE decommission.
PJ42903
Connections folder activity stream json should have "visible=false" attribute
PJ42904
A document filed in a subfolder of a review-enabled teamspace inherits security from the folder without having been approved.
PJ42906, PJ43038
In the Connections integration, an editor cannot check in after a file has been shared with them
PJ42907
Unable to remove DIRECT permissions on a subclass if there's a duplicate INHERITED one on the Security tab.
PJ42908
Incorrect validation warning is issued: The step contains a reminder, but no deadline expiration has been specified.
PJ42909
No shortcut for Case Analyzer Components in start menu.
PJ42913
Improve logging and error handling in the region move tool
PJ42919
FileNet Content Platform Engine Create Object Store Wizard fails to create Fixed Content Area for TSM Fixed Content Devices (FCD).
PJ42920
Case History CH) stops processing if the class definition of the object that generated the Content Engine (CE) event is deleted prior to CH processing it
PJ42922
Incorrect Content Platform Engine (CPE) version reported to IBM License Management Tool (ILMT)
PJ42929
Workflow fails at step opening the eForm with the error java.lang.StringIndexOutOfBoundsException
PJ42948
[FNRPE2131090436E]Assertion failed in file "WorkObject.java", method "checkFailed", line 6,793 is reported after a split when a component queue tries to terminate the child work object
PJ42949
Administration Console for Content Platform Engine (ACCE) is too restrictive when defining workflow event subscription.
PJ42950
Case folder auditing update events are generated even when multi-value case property is not updated.
PJ42959, PJ42960
Process Engine (PE) Upgrade failed with error: "SysAdminGroup value must be specified".
PJ42971
Administration Console for Content Platform Engine (ACCE) hangs when accessing the Fixed Storage Area "Retention" tab.
PJ42974
.Net custom application could not work with P8 5.2.1 Kerberos enabled.
PJ42980
Content Engine (CE) retry problems when the MSAR surface is not available on Image Services (IS).
PJ42997
Closing and saving Directory Configuration settings by clicking "x" on the tab will cause Administration Console for Content Platform Engine (ACCE) to hang.
PJ43003
When opening Process Designer from IBM Content Navigator (ICN), a CPEApplet listener Plug-in service exception is logged in Application Server logs.
PJ43007
Cannot create thumbnails for certain TIFF documents.
PJ43016
Content Engine (CE) throws non-useful 'Create date does not exist in the buddy file' warnings.
PJ43017
Improve new collection creation by completing creation before reporting insert of invalid dates.
PJ43019
Administration Console for Content Platform Engine (ACCE) does not handle replication mapping of same Content Engine (CE) class to multiple Image Service (IS) external repositories correctly.
PJ43023
After APAR PJ42705 fix is applied, customers with existing DocVersion items that contain out of sequence numbers need those to be fixed in the database.
PJ43025
When PA/CA is enabled, vwlog / pelog tool does not clean up 550 events that do not have termination event.
PJ43027
Administrative Console for Content Platform Engine (ACCE) document class displays as "Questa procedura consentirĂ  di ricostruire..." where it should be "Documento"
PJ43031
PSIRT 1220 (CVE-2013-5452): XML External Entity (XXE) injection vulnerabilities. See Security Bulletin 1699588
PJ43039
Partner Link is Null while deploying the solution from Case Builder, in the inherited partner link from base workflow.
PJ43049
Security update with Administrative Console for Content Platform Engine (ACCE) Bulk Operation does not work correctly.
PJ43057
Document with retention (set at document Class level), check-in with content fails if user does not have the "WRITE_ACL = Modify" permission.
PJ43058
Intermittent NullPointerException occurs in isMarkingSet() using Content Engine Bulk Import (CEBI) tool.
PJ43070
Case History gets stuck processing Process event log entry with F_CaseFolder = 0.
PJ43072
Process Engine (PE) Out of Memory (OMM) error using "substitute (text, search text, replacement text)" when is empty.
PJ43081
Unable to delete an orphaned work item using the deletewob or emptyqueue force command if the work item is associated with a deleted case.
PJ43084
API_PROPERTY_NOT_IN_CACHE error occurs when importing with audit only in FileNet Deployment Manager (FDM).
PJ43086
Need to ensure ibmfndcm and ibmfnthb child processes are eliminated during Content Process Engine (CPE) shutdown.
PJ43087
Modify logic to avoid DocVersion table deadlock when checking in high number of documents with many references to other documents.
PJ43095
Performance degradation using Compatibility API 3.5.x with FileNet P8 5.2.1 on heavy CPU load on application server. See techdoc 7045313
PJ43097
Failed to create Index due to duplicate column names in the statement.
PJ43099
Deletion Event throws FNRCE0051E: E_OBJECT_NOT_FOUND error.
PJ43121
FileNet Deployment Manager (FDM) IBM Content Navigator (ICN) search entry templates convert errors if source has distinct values for display name and symbolic name. ICN 2.0.3.2 and later entry templates and folder preferences (JSON data).
PJ43134
Performance improvement for Case Analyzer while trying to retrieve missing operation information of Process Engine (PE) events.
PJ43149
Content Federation Services for Image Services (CFS-IS) resource leak when encountering zero-length file during file upload process.
PJ43153
Content Engine Bulk Import (CEBI) allows blank values to be inserted for required properties.
PJ43161
Process Designer applet window is unusable if launched from Case Builder and using Internet Explorer (IE) browser.
PJ43166
In Process Engine Database Views a column for F_StepProcID is missing.
PJ43183
PSIRT 3149 (CVE-2015-0493, CVE-2015-0474): Oracle Outside In Technology (OIT) April 2015 Critical Patch Advisory Update - p20572683. See techdoc 1883962
PJ43190
Consistency Checker: NullPointerException thrown when detecting an item without a Storage Policy.
PJ43208
New option to allow Process Engine (PE) to provide better runtime response times in cases where environment records are not up to date.

Environment Cache Improvement Option
A new Process Engine "advanced tab" option has been added to Process Engine. CacheUseExpiredIfNecessary defaults to true so the default behavior of this new option is to provide better response times at the expense of using slightly out of date group membership information if necessary.

If CacheUseExpiredIfNecessary is added to the advanced tab and set to true, the Process Engine's environment record caching behavior changes so that if the PE's cache of user information (e.g., group membership) in the database is old, the Process Engine will use it anyway rather than call into the Content Engine (CE) at runtime to get updated information. Generally, these "on demand" calls into the CE to get updated group information happen only if the vwusersync daemon was unable to keep the users and group information up to date in the time allocated by the Cached Entry Timeout setting (defaults to 4 hours). The "on demand" calls (which should not generally be happening) can be very expensive and disruptive if the groups contain many members, and the "on demand" refreshing cause significant response time issues that are visible to end users. For a more detailed explanation of how the environment caching works, see technote 1501780.

Setting this new option to true will make the PE Server avoid the costs and response time impacts that are seen when the "on demand" calls to refresh group membership information are made. With this option set to true, the vwusersync daemon will continue to do its background refreshing of the user and group information in the PE's database. And the PE runtime will still notice that the memory cache group information is old and re-read the group membership data from the database (a fast operation). So once vwusersync gets the PE's database updated, the new group membership information will be seen by the Process Engine the next time it's accessed. That is, the group membership is still automatically refreshed and brought into play as soon as possible. But, with the CacheUseExpiredIfNecessary set, the PE Server will use older (slightly expired) group membership information and "carry on" with its work rather than forcing the update to the group membership immediately.
PJ43210
Error 'ORA-01722 - Invalid Number' in Cognos Real Time Monitor (RTM) after creating a Case Analyzer Store.
PJ43214
Intermittently Content Engine Bulk Importer (CEBI) allows blank values to be inserted for required properties.
PJ43225
"Error in Security Interceptor" error occurs in a new Content Platform Engine (CPE) install on JBoss.
PJ43232
FileNet Enterprise Manager (FEM) shortcut link is installed with Content Platform Engine (CPE) 5.2.1. FEM is no longer installed with CPE 5.2.1.
PJ43281
FileNet Deployment Manager (FDM) support for IBM Content Navigator (ICN) 2.0.3.x Teamspaces in Content Platform Engine (CPE) Teamspace Templates.
PJ43284
Failed delete audit event does not work in Administration Console for Content Platform Engine (ACCE).
PJ43285
Errors "<92,2,11>" appear in error log when using Content Federation for Image Services (CFS-IS).
PJ43268
AbstractMethodError when calling CHSession.updateGCDandCreateStore().
PJ43289
Case Analyzer: Content Engine (CE) Events processing is considerably slower compared to Process Engine (PE) events processing.
PJ43292
Indexing Open Office Impress file text extraction failed and reported the error "status code: 32. The execution of the ibmfndcm application returned unrecognized return code 139.
PJ43293
Can not reference attachment fields in certain string expressions "incompatible type".
PJ43297
In Case Analyzer, increase the display name field length in D_DMUser table from 32 to 256 characters.
PJ43307
Case Analyzer - WorkFlow field in the CaseMonitor.jar field width is increased to 128.
Async mechanism tasks initiated via the Case Analyzer Process Task Manager (PTM) do not reflect the process states on the client as expected.
PJ43193, PJ43196
PSIRT 3141 (CVE-2015-0488, CVE-2015-0478, CVE-2015-1916): IBM SDK Java Technology Edition Quarterly April 2015 update. See techdoc 1883959
PJ43172
PSIRT 3058 "Bar Mitzvah" (CVE-2014-2808): IBM SDK Java Technology Edition Vulnerability in RC4 stream cipher update. See techdoc 1701597
PJ43363
Case History: Avoid wait when events other than ObjectChangeEvent creates a gap in the sequence number.
PJ43419
Installer updated to run as non-root user on AIX.

5.2.1.0-P8CPE-IF002 (IF002 is ONLY a new JRE and it does not include all APARS listed in 5.2.1.0-P8CPE-IF001)
APAR
Description
PJ43093
PSIRT 2696 (CVE-2014-6593, CVE-2015-0410, CVE-2015-0393): IBM SDK Java Technology Edition Quarterly January 2015 update. Update the IBM private JRE of the Process Engine server to version 1.6 SR16 FP3 in response to a Java security issue. See Security Bulletin 1697152
PJ43077
PSIRT 2913 "FREAK" (CVE-2015-0138): Update the IBM private JRE of the Process Engine server to version 1.6 SR16 FP3+IV70681 in response to a Java PSIRT security issue. See Security Bulletin 1699589
PJ42849
PSIRT 2290 "Poodle" (CVE-2014-3566): IBM SDK Java Technology Edition Quarterly November 2014 update. Add Transport Socket Layer (TSL) support. See techdoc 1688638

5.2.1.0-P8CPE-IF001
APAR
Description
PJ42903
Connections folder activity stream json should have "visible=false" attribute
PJ42904
A document filed in a subfolder of a review-enabled teamspace inherits security from the folder without having been approved
PJ42906
In the Connections integration, an editor cannot check in after a file has been shared with them. This issue is a bug in the change preprocessor for the Connections Document Review feature.

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

Trademarks

IBM, the IBM logo, FileNet, 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.


Document change history


Date
Description
4 December 2015
Initial release of this Fix Pack.
13 January 2016
Removed PJ43337 (deferred to 5.2.1.4)
PJ43208 text updated