IBM Content Navigator Container, Version 3.0.5.0 Interim Fix 1 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, IBM CMIS Container Version 3.0.5.0.

Readme file for:
IBM Content Navigator Container. There is no Version 3.0.5.0 release of IBM CMIS product.  Therefore there are no IBM CMIS APARs listed in this readme.
Product or component release:
Version 3.0.5.0
Update name:
Interim Fix 1
IBM Content Navigator build number:
icn305.001.032
IBM Content Navigator Fix ID:
3.0.5.0-ICN-Container-IF001
Publication date:
February 1, 2019
Last modified date:
February 1, 2019
Additional documentation for IBM Content Navigator Container 3.0.5.0 can be found at : https://www.ibm.com/support/knowledgecenter/en/SSGLW6_5.5.0/com.ibm.p8toc.doc/containers.htm

New Features

  • IBM Content Navigator 3.0.5 iFix 1 Security Enhancement
    IBM Content Navigator 3.0.5 iFix 1 introduces a new method for encrypting secrets stored in the IBM Content Navigator configuration database. For additional information, see the following technote: http://www.ibm.com/support/docview.wss?uid=ibm10869440

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.5.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.5.0 Interim Fix 1

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.5.0 Interim Fix 1

  1. Download and expand the interim fix package 3.0.5.0-ICN-Container-IF001.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-305-icn-if001 mycluster.icp:8500/<namespace>/icn:<tag>
  5. Log onto the IBM Cloud Private platform. For example:
    • cloudctl login -a https://<icp_ip_address>:8443 --skip-ssl-validation
  6. Log onto your cluster. For example: docker login mycluster.icp:8500
  7. Push the image to the IBM Cloud Private cluster by using the following command:
    docker push mycluster.icp:8500/<namespace>/icn:<tag>
  8. Content: change your working directory to icn/CONTENT and run the helm upgrade command to upgrade the IBM Content Navigator container
    • helm upgrade dbamc-icn ibm-dba-navigator-2.1.0.tgz --tls --reuse-values --set image.repository=mycluster.icp:8500/<namespace>/icn,image.tag=<tag>
    DBAMC: change your working directory to icn/DBAMC and run the helm upgrade command to upgrade the IBM Content Navigator container
    • helm upgrade dbamc-icn ibm-dba-navigator-2.1.0.tgz --tls --reuse-values --set image.repository=mycluster.icp:8500/<namespace>/icn,image.tag=<tag>
  9. Using the Workloads > Deployments page in the IBM Cloud Private dashboard, monitor the status of the ibm-dba-navigator ReplicaSets.
  10. 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. Using a deployment YAML file, such as icn-deploy.yml, modify the rolling update parameters as desired and point the image to the newly uploaded interim fix image url.
  4. Execute the deployment file to deploy the IBM Content Navigator service. For example: kubectl apply –f icn-deploy.yml
  5. Monitor the status of the deployment. For example: kubectl rollout status deployments/<ICN deployment name>
  6. Execute following command to get the Public IP and port to access the IBM Content Navigator service kubectl get svc | grep ecm-icn-svc
  7. 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.5.0 Interim Fix 1

Daeja ViewONE Virtual 5.0.5 iFix 3 and Daeja ViewONE Professional 4.1.5 Fix Pack 2 iFix 30 are included in this IBM Content Navigator Interim Fix. The Readmes for these Daeja versions is the same as the Readme for Daeja ViewONE Professional 4.1.5 Fix Pack 2 iFix 1.


Security Issue Security vulnerability CWE-798 fixed.


Security Issue CSV injection vulnerability when exporting content lists fixed.


Security Issue Vulnerability that allows executable files in Edit Service client fixed.


Security Issue Vulnerability that allows reflected XSS with the getDocument request fixed.


IO26816 The link to a CIWEB error does not display information about the error.

(IBM Content Navigator users) When the link to a CIWEB error message displayed on an error dialog is clicked, an incorrect web page is displayed instead of the expected documentation for the error. With this fix the, the correct information about the error is displayed.


IO26807 Template document with .msg extension cannot be added for edit category Outlook

(IBM Content Navigator users) After creating a new edit category, Outlook, in the administration desktop, with MIME type application/vnd.ms-outlook, if a template document with extension .msg is added into this category, an error is issued indicating that the selected document has an invalid MIME type. With this fix, the template document can be added correctly.


IO26759 Cross-repository searches show the choice list values instead of the display names in the search criteria

(IBM FileNet Content Manager users) Property choice lists in a cross-repository search show the values instead of the display names. With this fix, choice lists in a cross-repository search show the display names.


Security Issue Fix added for Edit Client (Windows) to validate SSL certificates along with an option to turn the validation off.


IO26708 Incorrect date is displayed after changing the date display format.

(IBM Content Navigator users) IBM Content Navigator users will see incorrect date value displayed in some circumstances after changing the desktop's display format for dates, For example, if the date display format is changed to display just the date portion instead of both date and timestamp portions, then subsequent date value changes will not be displayed correctly after saving the changes and refreshing. With this fix, the issue is resolved.


IO26724 Multi-line text annotations are displayed in IBM Daeja ViewONE Virtual Viewer with last line missing.

Multi-line text annotations created using IBM Content Manager Client for Windows using the MODCA format, are displayed in the IBM Daeja ViewONE Virtual Viewer, with the last line missing.


IO26829 Updates to properties in View Properties pane of a viewer, cannot be saved.

(IBM FileNet Content Manager users) Users may experience a situation in which they are unable to save the updates made to properties in the View Properties pane of a viewer. With this fix, the updated properties can be saved.


IO26672 Document is not checked out when editing properties from the Properties Pane

(IBM Content Manager users) If the properties of a document are modified in the Doc Info pane, the document is not checked out. With the fix, when a user modifies properties of a document in the Doc Info pane, the document will be checked out.


IO26703 Viewer mapping fails when using non-standard mime type formats.

(IBM Content Navigator users) Viewer mappings with a non-standard mime type format such as '.pdf' instead of 'application/pdf' are ignored. With this fix, viewer mappings with any value are honored.


IO26822 Heap memory consumption grows continuously

(IBM Content Manager users) The heap memory consumption grows continuously requiring the server to be restarted. With this fix, the memory consumption is stabilized.


IO26804 Document cannot be edited using the Edit Client when using Kerberos SSO, if the user doesn't have access to the default desktop.

(IBM Content Navigator users) There will be an error when editing documents with the Edit Client when using Kerberos SSO, if the user don't have access to default desktop. With this fix, the issue is resolved.


IO26783 A java.lang.nosuchmethoderror error occurs on call to getRequestActionForm() method.

(IBM Content Navigator users) A java.lang.NoSuchMethodError exception occurs when com.ibm.ecm.extension.PluginServiceCallbacks.getRequestActionForm() method is called in a plugin after updating to IBM Content Navigator 3.0.3 or later. With this fix, the error no longer occurs.


IO26716 search criteria pane cannot be expanded or collapsed using the Enter key.

(IBM Content Navigator users) When building a search, the search criteria and search results sections cannot be expanded or collapsed using the keyboard. With this fix, the search criteria and search results sections can be expanded or collapsed by pressing the Enter key or space bar.


IO26718 Unsupported object-valued properties with an enumeration cardinality can be added to search results.

(IBM FileNet Content Manager users) When you run a search that includes object-valued properties with an enumeration cardinality, such as Folders Filed In, no values are displayed for these type of properties in the search results since they are not supported. With this fix, object-valued properties with an enumeration cardinality are not available for inclusion in search results.


IO26799 Help link displays the help page after initial login to the administration desktop but not after the browser is refreshed.

(IBM Content Navigator users) The help link on the banner of the IBM Content Navigator administration desktop displays the help page only the first time after logging in, but not after the browser is refreshed. With this fix, the help link displays the help page.


IO26793 Entry template layout cannot be saved after setting a default value for a date or time property.

(IBM Content Navigator users) When a user edits an entry template layout and sets a default value for a date or time property, the Save button remains disabled and the changes cannot be saved. With this fix, the Save button is enabled and the changes can be saved.


IO26699 Firefox users may experience failure of launching of the native PDF viewer

(IBM Content Navigator users) Users of Firefox may experience a situation in which opening a PDF using PDF Conversion Viewer will not open the browser's built-in PDF viewer. With this fix, users should be able to view PDFs using the browser's native PDF viewer.


IO26666 Download of a group of files fails if one of the files is zero bytes in size.

(IBM Content Manager users) Users may experience a situation in which they are unable to download a group of files if one of the files has a size of 0 bytes. With this fix, users should be able to download a group of files even if one of the files is 0 bytes in size.


IO26769 Inserting a row into the property table of an Entry Template causes the row to be appended.

(IBM FileNet Content Manager users) If multiple rows are deleted from the Property Table of an Entry Template and then a new row is inserted, the last row is moved up and the new row is appended. With this fix, this issue does not occur.


IO26725 Error message issued when validating format of date or time values, does not contain the custom format specified in the entry template.

(IBM Content Navigator users) If a custom date or time pattern is specified for a property in the layout of an Entry Template and an invalid date or time for that property is entered, the error message does not contain the custom date or time pattern indicating that an invalid value was entered. With this fix, the custom date or time pattern is displayed in the error message.


IO26694 Move from Teamspace dialog fails to open after re-sorting content list.

(IBM Content Navigator users) After re-sorting a teamspace folder's contents, if a document is selected from the teamspace folder and the "Move from Teamspace" action is performed using the context menu, nothing happens. The Move from Teamspace dialog is not displayed. With this fix, the Move from Teamspace dialog will open when selecting the "Move from Teamspace" action after re-sorting a teamspace folder's contents.


IO26712 Icon displayed for group added to a teamspace is incorrect.

(IBM Content Navigator users) After adding a group to a Teamspace, the icon for groups being added to a teamspace changes to a 'user' icon instead of a 'group' icon. With this fix, users will see the 'group' icon being displayed after a group is added to a teamspace, instead of a 'user' icon.


IO26675 Help text for a multi-value property in property table of an entry template is not displayed in Internet Explorer.

(IBM FileNet Content Manager users) The help text for multi-value properties in the Property Table is not displayed in Microsoft Internet Explorer, if a user adds a document or creates a folder using an Entry Template. With this fix, the issue does not occur.


IO26743 Sticky note annotation's text color is same as fill color, causing the text to be unreadable.

(IBM Content Manager users) If a sticky note annotation is created using the IBM Daeja ViewONE Virtual viewer without the application/vnd.ibm.v1json mime type created in IBM Content Manager, the box and the text are found to have the same color, which makes the annotation unreadable. With this fix, this issue is resolved and the text is made readable.


IO26801 Print output of a JPEG image printed using Print Applet may contain a shadow.

(IBM Content Navigator users) When using the Print Applet to print a JPEG image, the output may contain a shadow. With this fix, the quality of the printed image is improved and this issue does not occur.


IO26788 Viewer window position is not maintained if it is maximized and closed and the viewer is launched again.

(IBM Content Navigator users) When using Microsoft Internet Explorer, after launching a viewer, if the viewer window is maximized and then closed, then the next time the viewer window is opened, it is seen to be off the center of the screen. With this fix, this issue is resolved.


IO26789 Choice list value is not saved for date property in Entry Template layout when using EDS.

(IBM Content Navigator users) If a choice list is returned as a dependent attribute by EDS for a date property in an Entry Template layout, the selected date value is not saved to the property. With this fix, the issue does not occur.


IO26784 Work items in a worklist are sorted incorrectly when sorting using a decimal attribute.

(IBM Content Manager users) IBM Content Manager users will see incorrect order in a worklist when sorting on a decimal attribute if paging of the workitems is also present. With this fix, the issue is resolved



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.