IBM Content Navigator Container, Version 3.0.5.0 Interim Fix 2 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 2
IBM Content Navigator build number:
icn305.002.052
IBM Content Navigator Fix ID:
3.0.5.0-ICN-Container-IF002
Publication date:
March 8, 2019
Last modified date:
March 8, 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

  • Introduced in this interim fix: A new parameter, autoCheckoutWithView, with values true or false has been introduced. If the value is set to true, then when opening a document in a viewer, the document is first checkedout before displaying it. A lock icon is displayed to indicated checkedout status. The document is unlocked when the user closes the document tab or the viewer window. Refreshing the content list will display the checkout status. Auto-checkin of the document occurs only if the document was automatically checked out.

    To configure this parameter,

  • Go to Settings section in the IBM Content Navigator administration desktop.
  • On the General tab, scroll down to Additional Settings section.
  • Click on New button.
  • Select autoCheckoutWithView parameter from the Name dropdown and specify the value.

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 2

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 2

  1. Download and expand the interim fix package 3.0.5.0-ICN-Container-IF002.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-if002 mycluster.icp:8500/<namespace>/icn:<tag>
    For navigator-sso containers, the command is: 
    • docker tag navigator-sso:ga-305-icn-if002 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.2.0.tgz --tls --reuse-values --set image.repository=mycluster.icp:8500/<namespace>/icn,image.tag=<tag>,resources.requests.cpu=250m,resources.requests.memory=256Mi,resources.limits.cpu=1,resources.limits.memory=1024Mi
    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.2.0.tgz --tls --reuse-values --set image.repository=mycluster.icp:8500/<namespace>/icn,image.tag=<tag>,resources.requests.cpu=250m,resources.requests.memory=256Mi,resources.limits.cpu=1,resources.limits.memory=1024Mi
  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 2

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

Daeja ViewONE Virtual 5.0.5 iFix 5 and Daeja ViewONE Professional 4.1.5 Fix Pack 2 iFix 32 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.


IO26672 (Regression) 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.


IO26852 Cannot switch the view mode once switched to a split view.

(IBM Content Navigator users) When the view mode is switched to a split view with more than one document opened in the IBM Daeja ViewONE Virtual viewer, the view mode cannot be switched to any other mode. With the fix, the view mode can be switched to any other mode.


IO26865 New annotations are duplicated when automatically saved.

(IBM Content Navigator users) When closing the viewer window with the IBM Daeja ViewONE Virtual viewer tab that has news annotations without saving, if the 'annotationAutoPrompt' parameter is set to false and the 'annotationAutoSave' parameter set to true, then the new annotations are auto-saved but with duplicate copies laid over each other. With this fix, the new annotations are auto-saved without any duplicate copies.


IO26820 Content list in Attachment tab of custom step processor does not resize.

(IBM Content Navigator users) When resizing a custom step processor, the content list hosted on the attachments tab does not resize as expected. If the user increases the width of the screen, the widget remains the same size and does not adjust to fill the available screen space. With this fix, this issue is resolved.


IO26792 Cannot save a document that has a read-only multi-valued string property with an empty string value.

(IBM FileNet Content Manager users) An error occurs when a user attempts to save the properties of a document that has a read-only multi-valued string property with an empty string value. With this fix, the document can be saved. For External Data Service requests, an array will be sent for multi-valued properties regardless if the value is empty, not set, or has only one item. Before this fix under some circumstances, a blank string (' ') would be sent for empty values and if the value contained one item, only the item in the array would be sent (i.e., 'abc' was sent to EDS if the value was [ 'abc' ]).


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


IO26851 Save button is not available when editing a search template that was opened using a bookmark link.

(IBM Content Navigator users) When editing a search that was opened using a link, the search cannot be saved because the Save button is not available. With this fix, the search can be saved.


IO26881 Database script is executed every time ping page is accessed or desktop login is done.

(IBM Content Navigator users) The IBM Content Navigator database script is run every time the ping page is accessed or a desktop login is performed. With this fix, the database script is run only if it was not previously run during the configuration step.


IO26885 Error occurs when saving a document that has a read-only DateTime property with a value that contains seconds.

(IBM FileNet Content Manager users) An error occurs when a user attempts to save the properties of a document that has a read-only DateTime property with a value that contains seconds, e.g., 12/31/2018 12:00:55 PM. With this fix, the document can be saved.


IO26819 Session timeout is not reset while Office Online document is being edited.

(IBM Content Navigator users) A session expiration warning message is displayed in the Office Online edit window when editing documents using Office Online, even though the document is being actively edited. With this fix, the Office Online edit window will update the session expiration timer as long as the document is being updated, so that the session expiration dialog is not prematurely displayed.


IO26878 Teamspace folders not shown in 'Move to Folder' action from teamspace search results.

(IBM Content Navigator users) When selecting the Move to Folder action on a document in a teamspace from the teamspace search results list, the dialog displays the folders in the repository and not the teamspace folders. With this fix, the move to folder dialog will display the teamspace and its folders.


IO26843 Folder contents are empty.

(IBM FileNet Content Manager users) Users may experience a situation in which they are unable to view content lists when they either have Box share enabled or have registered model classes with the ContentItem registerFactory method, whenever there is a video item in the content list. With this fix, users should be able to view the content list items, including videos.


IO26858 Session is invalidated when viewing a corrupted document.

(IBM Content Navigator users) The session is invalidated when an error occurs while viewing a corrupted document. With this fix, the session is not invalidated.


IO26864 Video bookmarks do not open the Video Viewer.

(IBM FileNet Content Manager users) Users are unable to view videos in the Video Viewer when using a Bookmark link. With this fix, users can now use a bookmark link to view a supported video in their browser.


IO26870 Text area is not resized if it is put on a titled layout.

(IBM Content Navigator users) Text area is not resized if it put on a titled layout and the second tab is put on a tab layout. With this fix, the text area is expanded correctly and shows all of the text.


IO26835 Notelogs are not refreshed in the View Notelog pane of a viewer after adding a new note.

(IBM Content Manager users) Notelogs are not refreshed in the View Notelog pane of a viewer after adding a new note and switching to the View Properties pane. With this fix, the latest notelogs are always displayed.


IO26842 Modifying a property causes the viewer to reload.

(IBM Content Navigator users) Modifying a document property in the viewer causes the viewer to reload when saving the property. With this fix, the viewer does not reload when saving property changes.


IO26833 Launching a workflow that has a subscription results in an error.

(IBM FileNet Content Manager users) Launching a workflow that has a subscription results in the error, 'com.filenet.apiimpl.core.ClassWorkflowSubscriptionImpl incompatible with com.filenet.api.events.InstanceWorkflowSubscription'. With this fix the error does not occur and the workflow is launched successfully.


IO26826 Saved search execution results in error if the 'Default search results toolbar menu' contains a sub-menu.

(IBM Content Navigator users) Attempt to run a saved search results in an error if the 'Default search results toolbar menu' is contains a sub-menu.


IO26875 Many unexpected warning messages are written to application server log after Recycle Bin plugin is installed.

(IBM Content Navigator users) Many unexpected warning message are written to the application server log (SystemOut.log) if the Recycle Bin plugin is installed. There is no functional impact from these warning messages. With this fix, the unexpected warning messages are not logged.




Fixes included in IBM Content Navigator Container, Version 3.0.5.0 Interim Fix 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.