IBM FileNet P8 Content Platform Engine 5.2.0.3-P8CPE-IF005 Interim Fix readme
© Copyright IBM Corporation 2015.

Readme file for: IBM® FileNet® P8 Content Platform Engine
Update name: 5.2.0.3-P8CPE
Fix ID: 5.2.0.3-P8CPE-IF005
Publication date: 10 March 2015
Last modified date: 10 March 2015


Contents

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

About this Interim Fix

This Interim Fix updates the Content Platform Engine "Engine-xx.ear" file, where "xx" represents the Content Platform Engine application server type (ws, wl, jb or jbc). See the Interim Fix contents (APARs) section of this Readme for a list of fixes in this Interim Fix.


Prerequisites

This Interim Fix requires:


New in this Interim Fix

The following new features are introduced in this Interim Fix:

Introduced in Interim Fix pack 5.2.0.3-P8CE-IF004

Introduced in Interim Fix pack 5.2.0.3-P8CE-IF003

Introduced in Interim Fix pack 5.2.0.3-P8CPE-IF002


Introduced in Interim Fix pack 5.2.0.3-P8CPE-IF001


Known problems, restrictions, and solutions

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


Download Location

Click the following link to access the files for this Interim Fix server update: Fix Central for Interim Fix 5.2.0.3-P8CPE-IF005. 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.0.3-P8CPE-AIX-IF005.tar.gz
HP-UX
5.2.0.3-P8CPE-HPUX-IF005.tar.gz
HP-UX Itanium®
5.2.0.3-P8CPE-HPUXI-IF005.tar.gz
Linux®
5.2.0.3-P8CPE-LINUX-IF005.tar.gz
Solaris
5.2.0.3-P8CPE-SOL-IF005.tar.gz
Windows®
5.2.0.3-P8CPE-WIN-IF005.zip
zLinux
5.2.0.3-P8CPE-ZLINUX-IF005.tar.gz

Content Platform Engine client update files

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

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

Installing and configuring this Interim Fix

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 Interim Fix, 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 5.2.0.3-P8CPE-IF005 is packaged with and installed by the Interim Fix installation program. In the 5.2 GA version, the Content Search Services client software is configured and deployed through the Configuration Manager.


Installing and configuring the server updates

This section consists of two parts: installing the Content Platform Engine 5.2.0.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 Interim Fix 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 Interim Fix 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 Interim Fix.


Downloading this Interim Fix server update

  1. Log on as the "ce_install_user" user.
  2. Download the Interim Fix server update file that is appropriate for your operating system and extract its contents to a temporary location. For information, see Downloading this Interim Fix.
  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 Interim Fix, then skip step 5 and continue with Installing this Interim Fix on the Content Platform Engine server.
  5. (Existing 5.2.0.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 Interim Fix. 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 Interim Fix 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.0.3-P8CPE-AIX-IF005.BIN
    HP-UX
    5.2.0.3-P8CPE-HPUX-IF005.BIN
    HP-UX Itanium
    5.2.0.3-P8CPE-HPUXI-IF005.BIN
    Linux
    5.2.0.3-P8CPE-LINUX-IF005.BIN
    Solaris
    5.2.0.3-P8CPE-SOL-IF005.BIN
    Windows
    5.2.0.3-P8CPE-WIN-IF005.EXE
    zLinux
    5.2.0.3-P8CPE-ZLINUX-IF005.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.
    Run: "chmod +x 5.2.0.3-P8CPE-AIX-IF005.BIN"
  6. Install this Interim Fix 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.0.3-P8CPE-AIX-IF005.BIN -f ce_silent_install.txt -i silent
HP-UX
5.2.0.3-P8CPE-HPUX-IF005.BIN -f ce_silent_install.txt -i silent
HP-UX Itanium
5.2.0.3-P8CPE-HPUXI-IF005.BIN -f ce_silent_install.txt -i silent
Linux
5.2.0.3-P8CPE-LINUX-IF005.BIN -f ce_silent_install.txt -i silent
Solaris
5.2.0.3-P8CPE-SOL-IF005.BIN -f ce_silent_install.txt -i silent
Windows
5.2.0.3-P8CPE-WIN-IF005.EXE -f ce_silent_install.txt -i silent
TIP You can use the Windows Task Manager to monitor completion of this Interim Fix server update installation on Windows based systems.
zLinux
5.2.0.3-P8CPE-ZLINUX-IF005.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_0_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 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 Interim Fix. 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.0.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:

      <propertyname="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.2.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 Interim Fix 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.2.0_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 FileNet Enterprise Manager:
    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 Interim Fix.


Installing the client updates

The following files are included in this Interim Fix:

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.

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

    Installation errors are recorded in the ceclient_install_log_5_2_0_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 Interim Fix 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.0.3-P8CPE-CLIENT-AIX-IF005.BIN -i silent -f ceclient_silent_install.txt
    HP-UX
    5.2.0.3-P8CPE-CLIENT-HPUX-IF005.BIN -i silent -f ceclient_silent_install.txt
    HP-UX Itanium
    5.2.0.3-P8CPE-CLIENT-HPUXI-IF005.BIN -i silent -f ceclient_silent_install.txt
    Linux
    5.2.0.3-P8CPE-CLIENT-LINUX-IF005.BIN -i silent -f ceclient_silent_install.txt
    Solaris
    5.2.0.3-P8CPE-CLIENT-SOL-IF005.BIN -i silent -f ceclient_silent_install.txt
    Windows
    5.2.0.3-P8CPE-CLIENT-WIN-IF005.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.2.0.3-P8CPE-CLIENT-ZLINUX-IF005.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_0_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 Interim Fix

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


Interim Fix contents (APARs)

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

5.2.0.3-P8CPE-IF005 (IF005 also includes all APARS listed in 5.2.0.3-P8CPE-IF001, 5.2.0.3-P8CPE-IF002, 5.2.0.3-P8CPE-IF003, and 5.2.0.3-P8CPE-IF004)
APAR
Description
PJ42434
Rare situation causes a NullPointerException when adding property nodes to Publishing request
PJ42448
Unable to transfer consistently due to repeated VWTime errors related to a deleted LDAP user being logged in the Process Engine (PE) server trace.
PJ42464
When an error occurs Content Engine (CE) does not close the CSM stubs.
PJ42475
Optimization of semaphore use for initial start-up requiring initTimeStamp.
PJ42481
Workobject entering the Component Manager queue is getting a delay in processing causing a performance lag.
PJ42496
GetObjectProperty method in CE_Operation failed to get the properties collection.
PJ42502
Setting of array values in workitem using vwWorkObject.setFieldValue gives NullPointerException error.
PJ42503
Case Analyzer (CA) Process Task Manager (PTM) is slow when connecting to a remote Case Analyzer
PJ42504
Unable to publish events in Case Analyzer due to NullPointerException error.
PJ42509
Case Analyzer (CA) Process Task Manager (PTM) to display only CA Stores local to the site of the Content Engine (CE) URL used.
PJ42513
If the logon name for the user is sent to Process Engine (PE) as domain\username, PE is not able to look up the user correctly.
PJ42516
Case Analyzer Processing events slow.
PJ42522
Workflow setting is incorrect in Administration Console for Content Platform Engine (ACCE).
PJ42547
Being able to set the component manager batch size below 10 may benefit some users for Process Engine performance gains.
PJ42551
Enhancing lease renewal mechanism in Case Analyzer
PJ42605
E_OBJECT_NOT_FOUND error in Java Compatibility API SID lookup.
PJ42612
Content Engine Bulk Importer (CEBI) login fails when apostrophe or opening curly brace is in password.
PJ42614
The ACCE "Available Users and Groups" list does not display the full user name or group.
PJ42635
Unable to import greater than approximately 5119 documents on a batch with Content Engine Bulk Importer (CEBI).
PJ42643
Content Based Retrieval (CBR) Summary feature producing invalid characters when iWorks file version/format is unrecognized by Outside In Technology (OIT) Filters.
PJ42644
Change to explicitly call definePackage when a new class is loaded to avoid NullPointerException.
PJ42648
Unable to index certain PDF files due to Outside In Technology (OIT) Text Extraction failure.
PJ42657
Case Analyzer (CA) stops processing if the class definition of the object that generated the CE event is deleted prior to CA processing it.
PJ42671
Content Engine Bulk Importer (CEBI) tool Extended ASCII codes could not be used for delimiter.
PJ42676
DOC service that the getAnnotLogEntries() method does not close its IS connection if it fails its re-logon attempt.
PJ42678
Sweep Management Policy-Controlled Sweeps choose any existing sweep (e.g. Document). After adding a Schedule (Day), unable to edit it or delete it.
PJ42686
Retention update jobs/policies - Define Retention Time dialog box - Base date property name not showing all date/time properties.
PJ42690
The strloc function that can be used to detect the location of a particular substring in a string appears to behave differently from prior versions.
PJ42696
Improvements to the logic surrounding the file containing Ids for use for IS documents.
PJ42704
Allow unsetting 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) duplicate users or groups show up in the Security tab of a document class.
PJ42725
Object Store Search exception thrown due to class "QueryResultRow" not found.
PJ42728
Select base workflow in Process Designer is slow.
PJ42753
Enhancing lease renewal mechanism in Case Analyzer.
PJ42755
Improve trace logging for "Invalid Field Type: {0}" error when a manual workflow task is starting (promoted to working).
PJ42761
Illegal conversion: can not convert from "java.sql.Timestamp" to "java.lang.Integer" during upgrade.
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.
PJ42824
Policy-controlled sweep generates incorrect and inefficient query when filter optimization is enabled. Sweep does not allow a handler to demand properties of a subclass of the swept class.
PJ42833
Intermittent NullPointerException when retrieving parent folder.
PJ42836
null (date) statement error in "Assign" step on all in-flight work items migrated from 4.5 and 5.2 P8. New workflows work fine
PJ42849
PSIRT 2290 (CVE-2014-3566): IBM SDK Java Technology Edition Quarterly November 2014 update. Add Transport Socket Layer (TSL) support. See techdoc 1688638
PJ42852
Content Manager User Interface (CMUI) prompts for both ojdbc5.jar when testing and ojdbc6.jar when creating datasources for Oracle RAC.
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.
PJ42907
Unable to remove DIRECT permissions on a sublcass if there's a duplicate INHERITED one on the Security tab.
PJ42908
VWStepDefinition PE API class allows setting a response for a launch step (it should be ignored).
PJ42909
No shortcut for Case Analyzer Components.
PJ42913
Improve logging and error handling in the region move tool.
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.

5.2.0.3-P8CPE-IF004 (IF004 also includes all APARS listed in 5.2.0.3-P8CPE-IF001, 5.2.0.3-P8CPE-IF002, and 5.2.0.3-P8CPE-IF003)
APAR
Description
PJ42527
PSIRT 1929 (CVE-2014-4263): IBM SDK Java Technology Edition Quarterly July 2014 update. See techdoc 1683298
PJ42593
Intermittent E_ACCESS_DENIED exception when deleting a document with thumbnails.
PJ42626
Customer unable to use CE_Operations getStringProperty, as they need the ability to return values for id, guid, and OIID.
PJ42621
Add support for Process Engine (PE) HTTP subject caching.
PJ42720
NullPointerException occurs when thumbnail sweep is initializing and INSO binaries were not laid down correctly.
PJ42721
NullPointerException as Content Platform Engine failed to lay down files with Jboss 4.3 EAP on Windows 2008 R2.

5.2.0.3-P8CPE-IF003 (IF003 also includes all APARS listed in 5.2.0.3-P8CPE-IF001 and 5.2.0.3-P8CPE-IF002)
APAR
Description
PJ41638
ACCE cannot change the Workflow properties on the advanced tab in non-English environments. The "all servers" link is missing.
PJ41982
PSIRT 1422 (CVE-2013-5879): Oracle OIT 8.4.1 Security Patch p17733168. See techdoc 1672337
PJ42059
Running a Workflow as a service, and waiting on it at another workflow, using Condition Identifier, gives assertion failure.
PJ42089
Process Engine NullPointerException is being thrown because the inquiry URL is not returning any information.
PJ42093
Pinging is not working if the event logging for the Process Engine region is completely disabled.
PJ42099
"This Fixed Content Device is not implemented" message when attempting to add FCD.
PJ42128
IBM FileNet Process Engine parameter replacement in sendMailTemplate function of CE-Operations works only until $9 parameter.
PJ42135
The contributor (submitter name) of a comment is not displayed correctly in the "Recent Updates" view on Connections 4.5.x
PJ42136
Workplace XT throws exception while trying to display audit event info.
PJ42154
No logged on session exists at FILENET.VW.API.VWSESSION.CHECKSESSION
PJ42158
In some cases, creating a sub-folder can result in two File events being fired, when there should only be one.
PJ42159
Content Engine Bulk Importer (CEBI) -CE switch is not working, always runs with default of 3 threads.
PJ42161
Process Engine (PE) Exception: java.lang.ClassNotFoundException: filenet.pa.sql.DBInt in pesvr_trace.log
PJ42163
Process Engine (PE) CE_Operations copy operation fails when source document is a case related document.
PJ42180
Process Engine CE_Operations::setMultipleStringProperty throws Work Performer Exception: null error when the value of the property is empty.
PJ42184
Attachment sent through a workflow using Process Engine CE_Operations sendMailAttachment or sendMailTemplateAttachment are either blank or result in "file appears to be damaged, corrupted, or is too large".
PJ42191
Processing of Content Engine (CE) Events stopped due to unique key violation error.
PJ42193
Content Search Services (CSS) indexing plain text document binary recognizer incorrectly setting document type causing the document to not be indexed.
PJ42201
Errors occur when replicating SAP ALF print lists archived by IBM Content Collector for SAP applications.
PJ42237
IBM Enterprise Records foreign object reference declaration error. See techdoc 1669418
PJ42239
Unable to create content when number of subscribed events exceeds the number of subscription cache entries.
PJ42240
Content Engine enable database tracing causes failure to add a new case with an automatic start of task that simply assign a date of creation (F_CaseFolder.DateCreated) into a custom property of the case folder Process Engine error.
PJ42241
Content Search Services (CSS) incorrectly indexing email attachments with Oracle OIT.
PJ42248
Case Analyzer 5.2 is not able to process user without a display name.
PJ42249
PSIRT 1486 (CVE-2014-0050): Apache and Tomcat security. See techdoc 1672717
PJ42252
Reassign Object Store operation not prevented when associated with Workflow system isolated region.
PJ42271
IBM Case Manager (ICM) Timeline visualizer should expose at least one Document Update event when filing a document into Case Folder.
PJ42274
Content Search Services (CSS) text search error for an Object Store in a larger cluster of Content Platform Engine (CPE) servers.
PJ42289
Persister processing non-persistent OVPs in security proxy propagation code causes FNRCD0003E: DB_BAD_DATATYPE: Bad data type: (null).
PJ42324
MIME type values are truncated to 64 characters for Content Federation Services Image Services (CFS-IS) migrated documents.
PJ42328
Activity Stream does not encode Chinese characters correctly in file names.
PJ42331
Create wizard unable to display existing object names in Internet Explorer (IE) 10.
PJ42339
Process Engine (PE) class loading constraint violated issue with axis.jar (org.apache.axis.MessageContext) due to missing jaxrpc.jar in ICM All-In-One Configurations - Process Orchestration and Simulation functionality impacted.
PJ42277
PSIRT 1732 (CVE-2014-0453, CVE-2014-0878): IBM SDK Java Technology Edition Quarterly April 2014 update. See techdoc 1674132
PJ42359
PSIRT 1696 (CVE-2014-0107): Apache Xalan-Java security. See techdoc 1674134
PJ42364
Intermittently unable to access ObjectStore.
PJ42372
Case Analyzer (CA) store creation fails when using the Oracle 11.2.0.3 JDBC driver embedded with WebLogic 12.1.2.
PJ42375
INSUBFOLDER search query is mistranslated by the Content Engine (CE) server.
PJ42384
Process Engine (PE) WSRequest performance for version agnostic workflows.
PJ42408
Process Engine (PE) Case History shows information on additional case properties instead of only the modified case properties.
PJ42412
DB2 for zOS downgrades "SELECT for update with RS" lock on Queueitem table causing duplicate workflows to be launched
PJ42425
Class path problem causes Content Search Services (CSS) Outside In Technology (OIT) filters to be installed in the wrong location with JBoss EAP 4.3.
PJ42426
When a Content Engine (CE) object property is changed from any non-NULL to NULL value on the Case details page, the change is not saved/reflected on the Work Item list in-basket.
PJ42436
PSIRT 1907 (CVE-2014-4763): ACCE Potential Cross Site Scripting (XSS) vulnerability. See techdoc 1679930
PJ42444
Process Engine (PE) CE_Operations Copy operation fails when document is inheriting permissions.
PJ42450
Process Engine (PE) CE_Operations will only get the current or released version of a document passed as a VWAttachment; it ignores any specific version GUID.
PJ42453
When a Process Engine (PE) workflow is added to a solution's global workflow collection, the roster name and required class values are not updated.
PJ42478
Process Engine (PE) CE_Operations.searchForOne retrieving too many CE objects.
PJ42505
Content Engine (CE) sweep framework policy handler objects are leaked at the end of a complete sweep pass.
PJ42573
Events are not fired correctly when moving a folder.

5.2.0.3-P8CPE-IF002 (IF002 also includes all APARS listed in 5.2.0.3-P8CPE-IF001)
APAR
Description
PJ42268
PSIRT 1719 (CVE-2014-4763): Apache Struts security. See techdoc 1674128
PJ42328
Activity stream does not encode file name non-English (UTF-8) characters correctly.

5.2.0.3-P8CPE-IF001
APAR
Description
PJ42154
Process Engine (PE) REST throws No logged-on session exists even if a session is still active after 30 minutes
IBM Case Manager 5.1.1.2 users must install 5.2.0.3-P8CPE-IF001. See techdoc 1668534
PJ42158
Content Engine (CE) sub-folder event subscriptions when creating a sub-folder can result in two File events being fired, when there should only be one.
PJ42161
Process Engine (PE) Exception: java.lang.ClassNotFoundException: filenet.pa.sql.DBInt in pesvr_trace.log.
PJ42179
Case Analyzer (CA) fails with error FNRCS0001E: SECURITY_ANONYMOUS_DISALLOWED: Access to Content Engine was not allowed because the request was made anonymously instead of by an authenticated user. The application server reported that the user was anonymous.

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
10 March 2015
Initial release of this Interim Fix.