IBM Case Manager Interim Fix Readme: 5.3.3.0-ICM-IF003
© Copyright IBM Corporation 2019. All Rights Reserved.

Readme file for: IBM® Case Manager
Update name: 5.3.3.0
Fix ID: 5.3.3.0-ICM-IF003
Publication date: 31 Jan 2019
Last modified date: 04 Mar 2019

About this Interim Fix
Compatibility
New in this Interim Fix
Obtaining the fix from Fix Central
Description
Installation, migration, upgrade, and configuration
Requirements
Install this Interim Fix
Configuring IBM Case Manager
Configuring Case Event Emitter for Business Automation Insights
Uninstall this Interim Fix
Notices
Trademarks
Document change history

About this Interim Fix

This document provides information about the IBM Case Manager 5.3.3.0-ICM-IF003 Interim Fix.

New in this Interim Fix

For more information about IBM Case Manager V5.3.3 new features and known issues, see the IBM Case Manager Release Notes.

At the time of publication of this Fix Pack readme, the following problems, restrictions, and solutions were known:

Obtaining the fix from Fix Central

This Interim Fix is available on the IBM Fix Central website. To locate a fix on Fix Central, select Enterprise Content Management as your product group, Case Manager as your "Select from Enterprise Content Management" choice, 5.3.3.0 as the version, select the platform that applies, and search for this fix by using the complete fix ID. A fix ID is the package name that is used to identify a fix.

To access the Fix Central website and additional information about using Fix Central, see Fix Central.

For this Interim Fix, the following fix IDs are assigned:

Operating System
Description
AIX 5.3.3.0-ICM-AIX-IF003
Windows 5.3.3.0-ICM-WIN-IF003
Linux 5.3.3.0-ICM-LINUX-IF003
Linux for System Z 5.3.3.0-ICM-ZLINUX-IF003

Description

The table lists the fixes and features in this Interim Fix.

5.3.3.0-ICM-IF003
APAR Type
Description
PJ45232
Fix
Security APAR - CVE-2018-1844 - External DTD vulnerability with administration client.

Fix will requires application servers running IBM Case Manager to use Java 8.
PJ45413
Fix
Casesynchronizer tool doesn't add newly created automatic repeatable tasks to existing cases in a deployed solution.
PJ45446
Fix
Case title in the case list widget no longer displays as a hyperlink.
PJ45463
Fix
The icm.receivedDocumentsIds incoming event on the content list widget searches against a single object store only.
PJ45482
Fix
If 'Display a separate button for each case type' is selected, the add case button might not be displayed.
PJ45498
Fix
When you add multiple local documents to a single attachment array in a work item, you notice some attachments are missing.
PJ45506
Fix
The number of work items initially displayed when loading an inbasket is not configurable.
PJ45518
Fix
The document selector doesn't encode html characters for the document title when you create a case package.
PJ45529
Fix
Single click on existing folder in the case information widget does not open the folder.
PJ45532
Fix
Work items open slowly after you search or browse large result set in IBM Content Navigator.
PJ45536
Fix
IBM Case Manager doesn't use the encoding passed in as a charset header from external data services.
PJ45572
Fix
You see an exception when you try to create a case package using ICM_Operations for a case that has case stages defined.
PJ45596
Fix
Workflow validation fails in CaseBuilder step designer when the workflow has a partner link.
PJ45609
Fix
Newly added annotations to CM8 attachments are not refreshed automatically.
PJ45621
Fix
References to some work items are lost after an Inbasket list spanning multiple pages is resorted.

5.3.3.0-ICM-IF002
APAR Type
Description
N/A
Enh
Enables IBM Case Manager with IBM Business Automation Insights through a Case Event Emitter.

IBM Business Automation Insights allows for the capture the events generated by IBM Case Manager cases, aggregate them into business-relevant KPIs, and display them on meaningful dashboards for a real-time view of your business operations. The feature available through this interim fix enables the transmission of case events for IBM Case Manager to be captured by Business Automation Insights. After you install this interim fix, you can enable Business Automation Insights to process case events from ICM Case Manager.

5.3.3.0-ICM-IF001
APAR Type
Description
PJ44326
Fix
Moving the mouse focus from submenu item to a context menu item will cause the entire context menu to close.
PJ44363
Fix
Users will receive an error trying to sort results by title from a custom case search when there are over 200 cases.
PJ45092
Fix
During run time, to-do list widget no longer displays if the solution was upgraded from a previous release.
PJ45138
Fix
The Case Manager comment box doesn't display comments properly.
PJ45239
Fix
A memory leak might occur when you open and close the work details page repeatedly.
PJ45253
Fix
Case Builder displays inconsistent last modified date after closing a solution compared to refreshing a solution.
PJ45262
Fix
The display name is not shown for single value properties populated in a choice list from an EDS when the case is selected.
PJ45274
Fix
Sending the 'Select A Row event' (icm.selectrow) to the case list widget doesn't highlight the selected row.
PJ45305
Fix
You can't edit a rule if it contains a property that is associated with a choice list and the name of choice list is changed.
PJ45314
Fix
A NoClassDefFoundError exception occurs and the ICM_RulesOperation component can't process further rules.
PJ45319
Fix
When no members are defined for a particular role for case membership, no user for the role is allowed access.
PJ45320
Fix
The permissions of case team membership are not checked when a case is opened directly by using a case link URL.
PJ45324
Fix
Selecting the value of a choice list for the first time in a table rule does not work when editing a rule.
PJ45325
Fix
Case Manager applications don't work with a custom context root.
PJ45332
Fix
The hyperlink to open a split case doesn't work unless the history tab is refreshed.
PJ45340
Fix
Error in applying audit manifest does not provide details to what is causing error.
PJ45353
Fix
Tab labels for a tab container in a free-form page layout are not available in a localized resource file to be translated.
PJ45365
Fix
You might receive an FNRPA0004E error when populating localized properties by using an external data source (EDS).
PJ45375
Fix
Chart widgets show 'no stores' although a Case Analyzer store is configured in the object store.
PJ45378
Fix
Clicking the title of a work item multiple times causes the properties widget to appear multiple times and the CDEWG8006E error.
PJ45421
Fix
The message you see when a work item can't be reassigned has a spelling error.
PJ45435
Fix
The property "expires" is not correctly set via non-english locale system resulting in garbled message in the response header.
PJ45442
Fix
The order of users within a role in the reassign dialog for a work item is not sorted.
PJ45443
Fix
Choice list items not displaying on in-basket filter fields. An error is thrown on the in-basket filter dialog.
PJ45456
Fix
Security APAR - CVE number not available - Zip Slip vulnerability.
PJ45475
Fix
Passing multiple documents to the icm.Attachment event, only the first document is attached.
PJ45479
Fix
Security APAR - CVE-2018-1364 - CMIS XXE vulnerability.

Installation, migration, upgrade, and configuration

Requirements

The following component must be installed before installing this Interim Fix:

Preparing the server for installation

Before you run the IBM Case Manager Version 5.3.3.0 Interim Fix 3 installation program, you must prepare your server for the installation. To prepare your server:

  1. Ensure that IBM Case Manager Version 5.3.3.0 or later is installed on your system.
  2. Ensure that the Case Manager configuration tool is not running.
  3. Ensure that you created backup copies of the icm_home/configure/configmgr.ini and icm_home/configure/configmgr_cl.ini files and that you save them to a location outside the icm_home directory. icm_home is the name of the IBM Case Manager installation directory.
  4. If you are using IBM Forms with IBM Case Manager, create a backup copy of the web.xml file that is in the Case Forms installation folder before you install the interim fix. For example, in a Windows environment, the default path for the installation folder is C:\Program Files (x86)\IBM\CaseManagement\configure\exploded_apps\forms\WEB-INF. When you install the interim fix, a revised version of that file is installed in the folder. After the installation is complete, replace the revised version of the web.xml file with the backup copy that you created before the installation.
  5. If you are planning to use Case Event Emitter for Business Automation Insights, ensure that IBM Business Automation Insights component is configured and running in IBM Cloud Private. Refer to Installing Business Automation Insights for more information.

Installing the interim fix

You can install the interim fix interactively by using the installation program. Alternatively, you can install the interim fix silently by adding installation values to an input file and running the installation from a command line.

If your environment is configured for high availability and if IBM Forms is used in this environment, you must run the installation on all managed nodes. If IBM Forms is not used in the high availability environment, run the installation on the server where you previously installed Case Manager and ran the configuration tool. For more information, see the IBM Case Manager Version 5.3.3 Knowledge Center topics in the Installing and configuring in a cluster deployment or network deployment section.

Before you begin

Ensure that you meet all requirements that are mentioned in the Preparing the server for installation section.

Installing the interim fix interactively

If you want to install the interim fix interactively, use the installation program. The installation program installs the files and updates for IBM Case Manager and the Case Management configuration tool.

To install the interim fix interactively:

  1. Log on to the IBM Case Manager server. Log on as the same user who installed the existing version of IBM Case Manager; otherwise, the installation program cannot find the correct .com.zerog.registry.xml file.
  2. Navigate to the IBM Case Manager interim fix software package.
  3. Run the installation program:
  4. Operating System Command
    AIX 5.3.3.0-ICM-AIX-IF003.BIN
    Linux 5.3.3.0-ICM-LINUX-IF003.BIN
    Linux for System z 5.3.3.0-ICM-ZLINUX-IF003.BIN
    Windows 5.3.3.0-ICM-WIN-IF003.EXE

  5. Click OK on the pages to confirm that the installation program detects required software.
  6. Review the preinstallation summary, and click Install.
  7. When the installation completes, click Next.
  8. Respond to the subsequent prompts to complete the installation.
  9. When the installation completes, check for errors in the interim fix installation log. The IBM_Case_Manager_5.3.3.0-IF003_InstallLog.txt file is created in the installation directory. For example:/opt/IBM/CaseManagement/logs/IBM_Case_Manager_5.3.3.0-IF003_InstallLog.txt.
Important: Ensure that you complete the steps in the What to do next section.

Installing the interim fix silently

If you want to install the interim fix silently, run a command in the interim fix software package that refers to parameters in an installation text file.

To install the interim fix silently:

  1. Log on to the IBM Case Manager server where you plan to install the interim fix. Log on as the same user who installed the existing version of IBM Case Manager; otherwise, the installation program will not find the correct .com.zerog.registry.xml file.
  2. Navigate to the IBM Case Manager interim fix software package.
  3. Edit the cm_silent_install.txt file to change the LICENSE_ACCEPTED value to TRUE.
  4. Run the installation program:
  5. Operating System Command
    AIX 5.3.3.0-ICM-AIX-IF003.BIN -i silent -f cm_silent_install.txt
    Linux 5.3.3.0-ICM-LINUX-IF003.BIN -i silent -f cm_silent_install.txt
    Linux for System z 5.3.3.0-ICM-ZLINUX-IF003.BIN -i silent -f cm_silent_install.txt
    Windows 5.3.3.0-ICM-WIN-IF003.EXE -i silent -f cm_silent_install.txt

  6. When the installation completes, check for errors in the interim fix installation log. The IBM_Case_Manager_5.3.3.0-IF003_InstallLog.txt file is created in the installation directory. For example: /opt/IBM/CaseManagement/logs/IBM_Case_Manager_5.3.3.0-IF003_InstallLog.txt.
Important: Ensure that you complete the steps in the What to do next section.

What to do next

  1. Update the settings in the newly installed icm_home/configure/configmgr.ini and icm_home/configure/configmgr_cl.ini files to match the settings in the backup copies of these files.
  2. If you are using IBM Forms with IBM Case Manager and you created a backup copy of the web.xml file as described in "Preparing the server for installation", replace the new web.xml file in the Case Forms installation folder with the backup copy that you created before the installation.
  3. You must run the IBM Case Manager configuration tool and complete the configuration tasks for your environment before you can use IBM Case Manager. See “Configuring IBM Case Manager” for instructions.

Configuring IBM Case Manager

About this task

If you applied the interim fix to a new IBM Case Manager installation that is not configured yet, you must complete all of the configuration tasks.

If you applied the interim fix to an existing IBM Case Manager installation that was already configured, then you must rerun some configurations tasks. You can use your existing IBM Case Manager configuration tool profiles to run the required configuration tasks.

Configuring an existing IBM Case Manager deployment

If you applied the interim fix to an existing IBM Case Manager installation that was previously configured, you must then update the development environment and the production environment.

Use your existing IBM Case Manager configuration tool profiles to run the required configuration tasks.

Procedure:

  • Configure the development environment by running the following tasks:

    1. Update the Content Platform Engine Client Connector files.
      Important:Ensure you restart IBM Case Manager configuration tool before continuing to the next task.
    2. Configure the Case Management Object Stores.
    3. Create Case Manager Applications.
    4. Deploy the Case Manager API.
    5. Deploy Case Manager Builder.
    6. Deploy and Register Widgets Package, specifically the ICMClient widget package. (<IBM Case Manager install location>\configure\deploy\ICMClient.zip)
    7. Configure Business Rules. Run this task only if your environment uses business rules.
    8. Restart IBM Case Manager server.
    9. Before accessing IBM Case Client, clear the browser cache.

  • Configure the production environment by running the following tasks:
    1. Update the Content Platform Engine Client Connector files.
      Important: Ensure you restart IBM Case Manager configuration tool before continuing to the next task.
    2. Configure the Case Management Object Stores.
    3. Create Case Manager Applications.
    4. Deploy the Case Manager API.
    5. Deploy and Register Widgets Package, specifically the ICMClient widget package. (<IBM Case Manager install location>\configure\deploy\ICMClient.zip)
    6. Configure Business Rules. Run this task only if your environment uses business rules.
    7. Restart IBM Case Manager server.
    8. Before accessing IBM Case Client, clear the browser cache.

Configuring Case Event Emitter for Business Automation Insights

About this task

In order for IBM Business Automation Insights to aggregate data from IBM Case Manager, you must complete the configuration of Case Event Emitter.

Removing the Interim Fix

The Interim Fix updates the IBM Case Manager uninstallation program. There is no option to remove only the files that were installed with the Interim Fix. The updated IBM Case Manager uninstallation program removes both the base IBM Case Manager files and the Interim Fix files.

About this task

To remove IBM Case Manager, see Removing IBM Case Manager.

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
North Castle Drive
Armonk, NY  10504-1785
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:

IBM World Trade Asia Corporation
Licensing
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 Japan 

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

IBM Corporation
J46A/G4
555 Bailey Avenue
San Jose, CA  95141-1003
U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

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

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

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

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.

Trademarks

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are marked on their first occurrence in this information with a trademark symbol (® or ™), these symbols indicate U.S. registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Microsoft, Windows, Windows NT, SQL Server, 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 company, product, or service names might be trademarks or service marks of others.

Document change history


Date
Description
31 January 2019 Initial release of Interim Fix.
04 March 2019 Added Java 8 requirement for APAR PJ45232.