IBM Content Navigator Container, Version 3.0.6.0 Interim Fix 3 Readme

This readme document contains information about installation and removal of the interim fix and about known problems, restrictions, and solutions in support of IBM Content Navigator Container Version 3.0.6.0.

Readme file for:
IBM Content Navigator Container.
IBM CMIS does not have a Version 3.0.6. The latest release of IBM CMIS is Version 3.0.4. Please update to the latest interim fix for IBM CMIS Version 3.0.4 to obtain the most current fixes for IBM CMIS and refer to its readme for details on IBM CMIS APARs.
Product or component release:
Version 3.0.6.0
Update name:
Interim Fix 3
IBM Content Navigator build number:
icn306.003.129
IBM Content Navigator Fix ID:
3.0.6.0-ICN-Container-IF003
Publication date:
October 25, 2019
Last modified date:
October 25, 2019
Additional documentation for IBM Content Navigator Container 3.0.6.0 can be found at : https://www.ibm.com/support/knowledgecenter/en/SSGLW6_5.5.0/com.ibm.p8toc.doc/containers.htm

New Features

  • A new feature has been introduced in this interim fix which allows clients to upload a plug-in jar file to a server path from a client workstation. A new field or setting 'Upload File Path on server', is now available in the Settings section of the administration desktop, whose value is set to the target path on the IBM Content Navigator server machine that will contain the plug-in jar file. In the case where IBM Content Navigator is deployed to multiple nodes, this path should exist on all the nodes. When this feature is used, a New Plug-in or Modify Plug-in action will place the plugin-jar in a 'plugins' directory under the target path on the server. This new feature applies to only plug-ins uploaded as jar files but not as class files.

Known problems, restrictions, and solutions


Java and Google Chrome
Some features of IBM Content Navigator Container use Java applets. If you access IBM Content Navigator from Google Chrome, Version 42 or later, Chrome displays a message that the plug-in is blocked if you use an applet-based feature.
Starting with Google Chrome, Version 42, the Netscape Plugin Application Programming Interface (NPAPI) is disabled by default. Web applications that use Java applets do not function properly unless NPAPI is re-enabled. For more information on configuring NPAPI-based Java plug-ins under Google Chrome, Version 42, see:

Oracle Java Runtime Environment security warnings

You might see security warnings and update requests when using certain versions of Oracle Java Runtime Environment (JRE).
For information about issues with Oracle JRE, see http://www.ibm.com/support/docview.wss?uid=swg21640073

Additional Known problems and restrictions are documented in the 3.0.6.0 topic https://www.ibm.com/support/knowledgecenter/en/SSGLW6_5.5.0/com.ibm.p8.containers.doc/containers_knownissues.htm.

Prerequisites for Version 3.0.6.0 Interim Fix 3

Important: If you are using this interim fix as a part of a new deployment of the IBM Content Navigator container into IBM Cloud Private, you must first deploy the container as described in the Knowledge Center topic Deploying a new P8 domain by using containers. Then return to this readme and follow the instructions below to update the deployed IBM Content Navigator instances with the interim fix version of the container.

Important: If you will update a Kubernetes managed environment as described in the GitHub site ibm-ecm/container-samples, prepare by becoming familiar with the Kubernetes concepts for updating a deployment which are described at the following location: https://kubernetes.io/docs/concepts/workloads/controllers/deployment/#updating-a-deployment.

Upgrading to IBM Content Navigator Container, Version 3.0.6.0 Interim Fix 3

  1. Download and expand the interim fix package 3.0.6.0-ICN-Container-IF003.tar.gz in a location accessible to the IBM Cloud Private server master node or where the Kubernetes private registry is visible. You will see the following files in the subdirectory called icn:
  2. Change your working directory to the icn subdirectory, in the location where the interim fix package was expanded.
  3. Load the container image by using the following command: docker load < navigator.tgz
  4. Tag the local image by using the following command:
    • docker tag navigator:ga-306-icn-if003 <docker registry>/<namespace>/icn:<tag>
    For navigator-sso containers, the command is: 
    • docker tag navigator-sso:ga-306-icn-if003 <docker registry>/<namespace>/icn:<tag>
  5. Log onto the IBM or OpenShift Cloud Private platform. For example:
    • ICP:  cloudctl login -a https://<icp_ip_address>:8443 --skip-ssl-validation
    • OCP:  oc login -u <user>
  6. Log onto your cluster. For example: 
  7. Push the image to the IBM Cloud Private cluster by using the following command:
    • docker push <docker registry>/<namespace>/icn:<tag>
  8. Proceed to the following GitHub repository to find the remainder of the instructions to complete the deployment process: GitHub container samples.
  9. Open the IBM Content Navigator URL on a browser to verify that it is accessible. For example:
    https://hostname:port/navigator

Deploying under Kubernetes

  1. Change your working directory to be the location where the Interim Fix package was previously expanded.
  2. Upload and tag the container image, navigator.tgz, into the kubernetes private registry.
  3. Proceed to the following GitHub repository to find the remainder of the instructions to complete the deployment process: GitHub container samples.
  4. Open the IBM Content Navigator URL on a browser to verify that it is accessible. For example:
    https://hostname:port/navigator

Updating the Edit Service client

To update the Edit Service client, on Windows operating systems, uninstall the old version and install the new version and on Mac operating systems, remove the old version and unpack the new version.

Fixes included in IBM Content Navigator Container, Version 3.0.6.0 Interim Fix 3

The fixes that were provided in previous IBM Content Navigator Interim Fixes are combined in this fix.

Daeja ViewONE Virtual 5.0.6 iFix 7 and Daeja ViewONE Professional 4.1.5 Fix Pack 2 iFix 39 are included in this IBM Content Navigator Interim Fix.
Please note that the readme for Daeja ViewONE Professional is the same as the readme for Daeja ViewONE Professional 4.1.5 Fix Pack 2 iFix 1.


IO27310 Document can not be opened after updating properties in the viewer window when using Microsoft Internet Explorer.

(IBM Content Navigator users) When using Microsoft Internet Explorer, after updating properties of a document from the viewer and closing the viewer, the same document cannot be opened again. With this fix, documents can be reopened successfully after updating properties and closing the document in the viewer.


IO27214 Preview action on PDF shows black rectangles.

(IBM Content Navigator users) When some PDF documents are previewed, unexpected black rectangles are shown. With this fix, unexpected black rectangles are not shown.


IO27339 Annotation buttons are not disabled even when the annotationHideButtons parameter is set.

(IBM Content Navigator users) When viewing documents using Daeja ViewONE Virtual viewer, without access to annotate, the annotation buttons are enabled even if the Daeja ViewONE Virtual viewer parameter annotationHideButtons is defined. With this fix, the annotation buttons are disabled.


IO27289 When exporting properties containing Chinese or Japanese characters in the value, garbled characters are exported.

(IBM Content Navigator users) When exporting properties containing Chinese or Japanese characters in the value, garbled characters are seen to be exported. With this fix, the properties' values are exported correctly.


IO27374 Print action does not bring up the pop-up to choose the printer in Google Chrome v77.

(IBM Content Navigator users) Print action does not bring up the pop-up to choose the printer in Google Chrome v77. After the print is submitted it processes but there is no pop-up to choose the printer.


IO25505 Format of date and time of email message header does not match operating system settings.

(IBM Content Navigator users) When previewing an email file with extension .msg on Windows, the date and time format of the email header do not match the Windows operation system settings for date and time. With this fix, the format of date and time in the email header matches the operating system settings. This fix requires the application server to be started under the Windows administrator account.


IO27369 Error viewing properties of a document if it has dynamic roles assigned.

(IBM Content Navigator users) In IBM Content Navigator, if a document's security has been assigned a dynamic role, opening the security tab on the document properties dialog results in an error message and the document security is not displayed. With this fix, a document with dynamic roles assigned to it can have the document properties dialog security tab correctly displayed.


IO27377 For content manager worknodes that are defined with no action lists, default actions are enabled in the context menu.

(IBM Content Manager users) For Content Manager worknodes that are defined with no Action Lists, the 'Suspend', 'Resume' and 'Remove'actions are enabled in the context menu. With this fix, "worklistHideDefaultActions" custom setting can be enabled to hide these three default actions. If the user does not have permission to retrieve the work node, the 'Continue' / 'Work Item Actions' menu items will be disabled.


IO27262 Date field displays an out of range error before entering the full date.

(IBM Content Navigator users) Users get an out of range error before entering the full date. With this fix, an out of range error, if applicable, isn't displayed until the full date has been entered.


IO27320 Search operators like Added By, Include Any, cannot be hidden for user type properties.

(IBM Content Navigator users) Search operators like Added By, Include Any, cannot be hidden for user type properties. With this fix, operators for user type properties can be hidden by customizing the String operators in the Search Operators section of the Repository configuration's Search tab.


IO27341 P8 search template XML content element is missing the sort property and order.

(IBM FileNet Content Manager users) When a search is saved, the Stored Search XML content element is missing the sort property and order. With this fix, the Stored Search XML includes the sort property and order.


IO27382 Clicking on work feature causes the scroll bars in the left pane to disappear when there are a large number of in-baskets.

(IBM Content Navigator users) When there are a large number of in-baskets, clicking on the Work feature causes all in-baskets to be opened and the scroll bars to disappear, thus preventing scrolling through the list of in-baskets. The scroll bars re-appear only when the user navigates to another feature and returns to the Work feature, or resizes the in-baskets view or pane on the left slightly. With this fix, the scroll bars and the in-baskets are displayed correctly in the Work view.


IO27356 When editing a P8 or CM search, a warning message is displayed if a magazine view column is hidden.

(IBM Content Navigator users) When editing a search, a warning message is displayed if a magazine view column is hidden in the repository configuration. With this fix, the search can be edited without a warning.


Security Issue: Apache commons beanutils vulnerabilty fixed.


IO27346 The layout for a user desktop is modified from its initial value after enabling or disabling plug-ins.

(IBM Content Navigator users) The Layout field value in the Layout tab of a user desktop definition is modified from its initial value after enabling or disabling plug-ins in the Plug-ins section under the General tab of the desktop's definition. With this fix, desktop layout won't be changed.


IO27360 Using Daeja Virtual viewer, the properties of a document cannot be edited after adding an annotation.

(IBM Content Manger users) After saving an annotation in the Daeja ViewONE Virtual viewer on an item where the item type is set to Always Create, the user is unable to edit properties in the viewer window without closing and re-opening the viewer. With this fix, the user is able to edit properties after saving annotations.


IO27361 Using Daeja Virtual viewer, annotations added to a document after updating the properties, are not displayed.

(IBM Content Manager Users) Using Daeja ViewONE Virtual viewer, if the Properties pane is opened on the displayed document and then an annotation is added and saved, the added annotation is no longer visible. This happens when using Always Create as the version policy for Properties and Annotations. With this fix the annotation is visible in this scenario.


IO27362 Opening a bookmark link to a specific version of a document opens the current version instead.

(IBM Content Manager users) After selecting a prior version in the View Link dialog, if the bookmark link is opened in a browser, the current version's content and properties are displayed. With this fix, the correct version's content and properties are displayed.


IO27355 Download As PDF action on .msg file containing embedded attachment, converts only message body to PDF.

(IBM Content Navigator users) Download As PDF action on a .msg file containing an embedded attachment, converts only the message body to PDF, but not the attachment. With this fix, both the message and the attachment are converted to PDF.


IO27379 Convert Workplace XT entry template action fails if user does not have file access on root folder of repository.

(IBM FileNet Content Manager users) Convert action on Workplace XT entry template fails if user does not have file access to the root folder of repository.. With this fix, this issue is resolved.




Fixes included in IBM Content Navigator Container, Version 3.0.6.0 Interim Fix 2

IO27289 When exporting properties containing Chinese or Japanese characters in the value, garbled characters are exported.

(IBM Content Navigator users) When exporting properties having Chinese or Japanese characters in the value, garbled characters are seen to be exported.. With this fix, the properties' values are exported correctly


IO27264 Using Edit Service, if a document icon is double clicked, the document is opened three times.

(IBM Content Navigator users), When using Edit Service, if a document icon is double clicked, the document is seen to be opened three times by the Edit Client. With this fix, the document is only opened once.


IO27299 Unable to auto-open a document using a search bookmark unless the user has view content privileges.

(IBM Content Navigator users) When a search is accessed using a link with the autoRunSearch and autoOpenItem parameters, the document returned by the search is not opened. With this fix, the document is opened.


IO27303 #AUTHENTICATED-USERS group cannot be added to a teamspace's team members.

(IBM FileNet Content Manager users) After adding #AUTHENTICATED-USERS group to a teamspace's Team tab and fully saving the change, reopening the teamspace shows that the group is actually not saved. There is no error is presented to the user. With this fix, this group can be added successfully.


IO27322 HTML conversion viewer aligns document to the left.

(IBM Content Navigator users) When opening a document with the HTML Conversion viewer, the document is seen to be aligned to the left side of the viewer instead of in the center. With this fix, the document is aligned to the center.


IO27318 Users cannot open documents using Microsoft Office Online unless they have access to the default desktop.

(IBM Content Navigator users) Users cannot open documents using Microsoft Office Online unless they have access to the default desktop. With this fix, users can open documents using Microsoft Office Online even if they have not been granted access to the default desktop.


IO27287 String 'null' is displayed in the value of current version or released version property, in search results.

(IBM FileNet Content Manager users) When displaying Current Version or Released Version property in search results, 'null' is displayed as part of the value of this property. With this fix, 'null' is not displayed in the value.


IO27300 Work in-baskets are displayed intermittently when the work view has only one application space.

(IBM FileNet Content Manager users) Work in-baskets are displayed intermittently when the work view has only one application space. With this fix, the issue is resolved.


IO27267 Work list value on Name field is changed.

IBM Content Manager users) When multiple users access different desktops that each connect to different CM8 repositories, a refresh action on worklist in desktop causes the Name field value to change in the worklist of another desktop. With this fix, users will always see the correct name field value in the worklists.


IO27316 Application server logs become confusing due to numerous 'com.ibm.ecm.jaxrs.upload.DefaultHttpServletRequestWrapper' messages.

(IBM Content Navigator users) Application server logs become confusing due to numerous 'com.ibm.ecm.jaxrs.upload.DefaultHttpServletRequestWrapper' messages being added to them while using the system. With this fix, these messages are no longer added to the application server log files.


IO27307 Documents in a worklist fail to be opened. The viewer window does not launch.

(IBM Content Manager users) When using Internet Explorer v11, if a document in a worklist is attempted to be opened, nothing happens. The viewer window is not launched. With this fix, this symptom does not occur.


IO27313 Profile Plugin causes numerous E_OBJECT_NOT_FOUND errors in the SystemOut.log file.

(IBM Content Navigator users) The out-of-the-box Profile Plugin causes numerous E_OBJECT_NOT_FOUND errors in the SystemOut.log file. With this fix, users will no longer see the E_OBJECT_NOT_FOUND exceptions for invalid short names supplied to the Profile Plugin.


Security Issue: Security Issue

Vulnerability CVE 2019-12402 in Apache Commons Compress v1.18 fixed.


Security Issue: Security Issue

DOM-based XSS vulnerability in entry templates fixed.




Fixes included in IBM Content Navigator Container, Version 3.0.6.0 Interim Fix 2

IO27055 The original filename is not used when saving a redacted document to a local file.

(IBM FileNet Content Manager users) When saving a redacted document to a local file, the default filename is getDocument instead of the original filename. With this fix, the default filename is the original filename.


IO27077 When viewing multi-part documents, annotations on parts with differing DPI than the first part are displaced.

(IBM Content Manager users) When viewing multi-part documents in the IBM Daeja ViewONE Virtual viewer, annotations on parts with differing resolutions than the first part are displaced. With this fix, annotations are placed correctly.


IO27128 IBM Daeja ViewONE Virtual viewer tries to display content parts of a multi-content document, whose file types are not mapped to the viewer.

(IBM Content Navigator users) When opening a multi-content document with multiple file types, IBM Daeja ViewONE Virtual viewer tries to display all content parts including those with file types that are not mapped to the viewer. With this fix, the viewer will display only those content parts with file types that are mapped to the viewer.


IO27107 Content Manager OnDemand documents federated to FileNet P8 repositories cannot be opened using the CFS viewer plugin.

(IBM Content Navigator users) When Content Navigator is deployed to Websphere v9.x using JAX-RS 2.0, Content Manager OnDemand (CMOD) documents federated to Filenet P8 repositories cannot be opened using the CFS viewer plugin. With this fix, CMOD documents can be opened successfully.


IO27223 Ping page hangs after entering login credentials, if the IBM Case Manager Client plugin is enabled.

(IBM Content Navigator users) The Ping page hangs after entering login credentials, if the IBM Case Manager client plugin is enabled. With this fix, the Ping page displays correctly.


IO27081 When scheduling an hourly asynchronous task, the days of the week buttons don't toggle on and off when selected.

(IBM Content Navigator users) When scheduling an hourly asynchronous task, the days of the week buttons don't toggle on and off when selected. With this fix, the buttons toggle on and off.


IO27103 Custom viewer displays blank image when opening and switching between multiple documents.

(IBM Content Navigator users) Custom viewer displays blank image when opening and switching between multiple documents. The browser console shows the error 'Maximum call stack size exceeded'. With this fix, this issue does not occur.


IO27059 Download As PDF action on an AFP produces a larger than expected file.

(IBM Content Navigator users) When using the Download as PDF action for AFP documents, the AFP resources are being appended to the PDF file, resulting in a larger than expected file. With this fix, only the document content that is converted to PDF is returned, when using the Download as PDF action.


IO27072 User values specified in Action Filter of saved search are reset to null.

After creating a saved search that has the Action Filter enabled in Search Options and the filter 'Added by' is used to specify one or more Specific Users, if the search is reopened and Search Options examined, the specified users are seen to be replaced with null values. With this fix, the users specified in the Action Filter are retained.


IO27125 Deleting an item from a folder using a bookmark link results in an unexpected message.

(IBM Content Navigator users) Deleting an item from a folder using a bookmark link results in an unexpected message that there are no Favorites. With this fix, deleting an item works successfully.


IO27155 Red exclamation mark is cut off in required multi-valued properties in a document entry template

(IBM Content Navigator users) Red exclamation mark is cut off in required multi-valued properties in a document entry template. With this fix, the red exclamation mark will be displayed next to the multi-valued property.


IO27078 Multi-valued String property containing emptry string as value is displayed with half height row.

(IBM FileNet Content Manager users) When a multi-valued String property containing an empty string as value is edited in the step processor, a single half height row is displayed. With this fix, users will no longer see the single half height row in the editor.


IO27079. Changing the item type of a document in a workflow results in an error.

(IBM Content Manager users) When the item type of a document in a workflow is changed, an error message is sometimes displayed stating 'Checking in an item requires that the item be checked out'. With this change, the error message is no longer displayed.


IO27058 IO27058 Users cannot select a radio button value in Property Table widget with a mouse click.

(IBM Content Navigator users) Using Property Table Widget in IBM Case Manager Desktop using Chrome, users cannot select a radio button value with a mouse click.


IO27106; After changing password, password field on login screen is prefilled with old password which causes an error on attempt to login.

(IBM Content Navigator users) If a user account is configured to change password on the next login and the password changed due to this setting, the subsequent login screen is seen to prefilled with the old password, which is confusing to the user and results in an error if a login is attempted. With this fix, the password field on the subsequent login screen is cleared, prompting the user to enter the new password and the login is successful.


IO27109 Entry template's workflow is not launched when checking in a document to create a new version.

(IBM FileNet Content Manager users) Workflow configured for an entry template is not launched when a new verion of a document associated with the entry template, is created by checkin action. With this fix, the entry template's workflow is launched when a new version is created.


IO27200 When selecting dates in the recycle bin date picker, ie11 will truncate the dates selected..

When selecting dates in the Recycle Bin date picker, IE11 will truncate the dates selected.


IO27192 An error occurs on attempt to delete a document in the work list view.

(IBM Content Manager users) An error occurs on attempt to delete a document while in the work list view. With this fix, documents in the work list view can be deleted successfully.


IO27193 A hang occurs when launching workflow.

(IBM FileNet Content Manager users) A hang occurs when launching workflow, if the user performing this action does not have access to one or workflow definitions. With this fix, this issue does not occur and the user is able to launch workflows successfully.


IO27191 An error occurs when selecting an action from the list of available actions in the work item context menu.

(IBM Content Manager users) When selecting an action from the list of available actions in the work item context menu, an error message occurs sporadically - 'You must select a response to continue the work item. Open the work item and select a response to continue on the workflow'. The same action however works for the same worklist within the Step Processor. With this fix, this issue does not occur.


IO27209 Document remains checked out even after completing work item actions in the worklist context menu.

(IBM Content Manager users)  Document is not unlocked after it is routed to another work node by selecting one of the the available work item actions. With this fix, the document will be unlocked after it is routed to another work node if the document was locked by the user that performed the action.


IO27222 Worklist document that has been automatically checked out, remains checked out when browser is closed or user navigates away from the worklist view to other tasks.

(IBM Content Manager users) When a document in a worklist that has been configured to return one item at a time, is automatically checked out by this setting, it is seen to remain checked out even though the user closes the browser window or navigates away from the worklist view, to another application or area within the desktop. With this fix, this issue is resolved by introducing a new setting, ‘systemAssignedWorklistsAutoOpenStepProcessor’, which when set to ‘true’, causes the step processor window to be automatically displayed, as a popup, when the system-defined worklist is viewed by a user.  When the user closes the step processor popup window (that has been opened automatically) the work list is refreshed and the current item is unlocked.


IO27054 System properties are displayed out of order in the document info pane

(IBM Content Navigator users) When editing properties in the document info pane, the system properties are not always displayed in the order configured on the repository. With this fix, the system properties are displayed in the right order.




Copyright and trademark information

Notices

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

Other company, product, or service names may be trademarks or service marks of others.

THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION

The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version.

Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM"), the third party software code identified below are "Excluded Components" and are subject to the following terms and conditions:
  • the Excluded Components are provided on an "AS IS" basis
  • IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  • IBM will not be liable to you or indemnify you for any claims related to the Excluded Components
  • IBM will not be liable for any direct, indirect, incidental, special, exemplary, punitive or consequential damages with respect to the Excluded Components.