This Readme document contains information about the installation of this package and about restrictions in support of IBM Content Navigator, Version 3.0.15 Interim Fix 3
Readme file for:
IBM Content Navigator.
Product or component release:
Version 3.0.15.0
Update name:
Interim Fix 3
IBM Content Navigator build number:
icn3015.003.137
IBM Content Navigator Fix ID:
Publication date:
June 28, 2024
Last modified date:
June 28, 2024
Additional documentation for IBM Content Navigator 3.0.15.0 can be found at : IBM Content Navigator 3.0.15
Dojo Toolkit: 1.17.2
Snowbound RasterMaster: 20.12.0
Oracle Outside In Technology: 8.5.6 Bundle Patch 8 patch 36291648
Log4j: 2.20
IBM Content Manager v8.7 Fix Pack 2 APIs
Spring jars v5.3.32
Known problems, restrictions, and solutions that affect administration and usage of interim fixes are documented as techdocs in the product support knowledge base. Use the following link to query the product support knowledge base by searching for the product and version number: https://www.ibm.com/support/home. In addition, the interim fix includes the following known problems:
Some features of IBM Content Navigator 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:
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.
If you use the IBM Content Navigator Configuration and Deployment Tool in the following locales, you might see a mix of English and non-English strings:
The Preview action on PDF documents fails on AIX, if using the Snowbound engine. The workaround is to switch to using the OutsideIn engine using these steps:
Additional Known problems and restrictions are contained in the 3.0.15.0 Release Notes https://www.ibm.com/docs/en/content-navigator/3.0.15?topic=content-navigator-release-notes.
The official statements for hardware and software support for IBM Content Navigator are provided as part of the hardware and software requirements for IBM Content Navigator, Version 3.0.15.0.
For complete details about the hardware and software requirements for IBM Content Navigator see Software Product Compatibility Reports.
The following information and steps apply to IBM Content Navigator. To install the interim fix, perform the steps below using the interim fix executable. When you install an interim fix, you can run the installation wizard or run a silent installation. The interim fix can be installed as an update to IBM Content Navigator Version 3.0.15.0 or later.
The interim fix installation program updates the files in the directory where IBM Content Navigator is installed. After the installation program completes successfully, restart the web application server and redeploy the IBM Content Navigator web application to apply the changes from the interim fix.
For more information about installing IBM Content Navigator Version 3.0.15.0, see https://www.ibm.com/docs/en/content-navigator/3.0.15?topic=planning-installing-configuring-content-navigator.
To install IBM Content Navigator, Version 3.0.15 Interim Fix 3:
Install the interim fix by running the installation wizard or by running a silent installation:
Important: Do not enter line breaks in the command that you enter to start the installation program.
AIX
At a command prompt, change to the directory where you downloaded the interim fix and enter one of the following commands:
Linux
At a command prompt, change to the directory where you downloaded the interim fix and enter one of the following commands:
Linux for System z
At a command prompt, change to the directory where you downloaded the interim fix and enter one of the following commands:
Windows
At a command prompt, change to the directory where you downloaded the interim fix and enter one of the following commands:
Open the IBM Content Navigator Configuration and Deployment tool, click File > Open Deployment Profile, select the target deployment profile and click Open.
If the External Share feature is needed, then perform the bulleted steps below and then continue to Step 7, else continue to Step 7
Run the "Configuring the IBM Content Navigator web application" task. For more instructions, see the topic, "Configuring the IBM Content Navigator web application" in the information center: https://www.ibm.com/docs/en/content-navigator/3.0.15?topic=server-configuring-content-navigator-web-application..
Run the "Build the Web Application" task. For more instructions, see the topic, Rebuilding the IBM Content Navigator web application in the information center: https://www.ibm.com/docs/en/content-navigator/3.0.15?topic=server-building-web-application.
Run the "Deploy the Web Application" task in the IBM Content Navigator Configuration and Deployment Tool for the profile that you want to redeploy.
Stop the IBM Content Navigator web application server.
Clear the application server cache:
For IBM WebSphere Application Server: Delete the following folders:
Delete the navigator folder from the temp temporary directory.
For example, on Microsoft Windows, delete the navigator folder from the following directory: \IBM\WebSphere\AppServer\profiles\AppSrv01\temp\ServerName Node01\server1.
Delete the subfolders in the wstemp directory. This folder is different from the temp folder. Do not delete the wstemp folder itself.
For example, on Windows, delete the subfolders in following directory: \IBM\WebSphere\AppServer\profiles\AppSrv01\wstemp.
For Oracle WebLogic Server: Delete the navigator folder from the tmp temporary directory.
For example, on Windows, delete the navigator folder from the following directory: \Oracle\Middleware\user_projects\domains\base_domain\servers\AdminServer\tmp\_WL_user.
Start the IBM Content Navigator web application server.
Verify that the correct version of the software is deployed to the web application server. For more information, see the topic, "Verifying your deployment" in the information center: https://www.ibm.com/docs/en/content-navigator/3.0.15?topic=tasks-verifying-your-content-navigator-deployment.
If IBM Content Navigator is configured for a high availability environment, see https://www.ibm.com/support/pages/node/869440 to ensure the crypto keys are set up properly in all servers.
When you uninstall the interim fix, you also uninstall IBM Content Navigator.
The interim fix for IBM Content Navigator uninstallation program removes the program and all applied fixes. You cannot remove only the interim fix.
To update the Edit Service client, uninstall the old version and install the new version on both Windows and Mac OS.
DT270282 Task Manager task instances are not rescheduled after server restart.
(IBM Content Navigator users) Task Manager task instances are not rescheduled after server is restarted - the next scheduled task instance is not created after one or more restarts. With this fix, this symptom does not occur.
DT379881
(IBM Content Navigator users) An unnecessary confirmation dialog is displayed informing that property values were modified, if properties of a document are modified and saved from the viewer window and the Next button in the viewer window is clicked.
DT380062
(IBM Content Navigator users) During ICN use, a large number of detached Event Listeners are seen when capturing a memory dump of the Memory tab of browser's Developer Tool's menu.
DT380888
(IBM Content Manager OnDemand users) An error occurs when opening an AFP or line data document from a folder which has an ampersand in the name.
DT380961
(IBM Content Navigator users) The browser status (message) bar shows incorrect characters when using Czech language.
DT382133
(IBM Content Manager users) ‘Failed to load data’ error can occur if the content list of a folder or search is refreshed after sorting by one of the displayed attribute columns.
DT386070
(IBM Content Navigator users) Entry Templates may not render correctly when used with EDS.
DT386267
(IBM FileNet Content Manager users) Extra searches are done to retrieve locale text of FileNet Content Manager (P8) choice list if there is no country specified for the locale of ICN requests.
DT386526
(IBM Content Navigator users) Desktop configuration can still be saved even when the layout of a desktop fails to be loaded correctly by a custom layout plugin. The causes the desktop to be saved in an incorrect state and users cannot login to it afterwards.
DT390358
(IBM Content Navigator users) The actionEditWithNativeApplication method of CommonActionsHandler class does not return a value for the callback parameter.
DT269877 EDS filter exception details not printed.
(IBM Content Navigator users) EDS filter exception details are not written to the server logs. With this fix, the exception details are written to the server log.
DT270303 Database schema is not set in the Task Manager orm.xml file.
(IBM Content Manager users) Database schema is not set in the orm.xml file for WebSphere, for Task Manager, during deployment. With this fix, the schema is set correctly.
DT277164 Configure IBM Content Navigator Web Application task does not use SSL protocol with Oracle WebLogic.
(IBM Content Navigator users) After creating a configuration profile that connects to Oracle WebLogic web application server using SSL protocol (t3s), if the Configure IBM Content Navigator Web Application task is run, the getWLJNDI script generated in the temporary folder (default location is ECMClient/configure/tmp) by this task, is observed to contain a non-SSL (t3) protocol URL with an SSL port. The task therefore fails to complete, resulting in a failure to correctly build the application and deploy it. With this fix, the WebLogic URL is generated correctly using the protocol specified in the profile properties and the subsequent build and deploy tasks complete successfully. This symptom does not occur if non-SSL (t3) protocol is used to connect to WebLogic server.
DT365463 Unable to check in document using Merge and Split action.
(IBM Content Navigator users) Users may be unable to check in document using Merge and Split action if the document is created by an entry template. With this fix, this symptom does not occur.
DT365927 Entry templates mail fail to render correctly when first opened.
(IBM Content Navigator users) Entry templates mail fail to render correctly when firt opened or loaded. With this fix, this symptom does not occur.
DT378558 Edit Service client fails to connect with SAML SSO.
(IBM Content Navigator users) When using Edit Service client v3.0.15-IF001 with SAML SSO configured using IBM Access Manager (IAM), the client fails to connect to Navigator server. Instead of downloading the document, the client hangs keeping Navigator window open. With this fix, this issue is resolved.
IO29281 PDF conversion of .msg files generates extra blank pages.
(IBM Content Navigator users) Download as PDF action on some .msg files may produce incorrect PDF documents, that contains extra blank pages. With this fix, this symptom does not occur.
IO29328 Plugin service call is made though request filter returns non-null JSON response.
(IBM FileNet Content Manager users) Plugin service call is made instead of being skipped when request filter returns non-null JSON response. With this fix, the call is skipped in the event of a non-null JSON response being returned.
IO29417 Browser plugin resource cache is not refreshed when plugin resources are updated.
(IBM Content Navigator users) The browser cache is not refreshed when a plugin updated. Users need to clear the browser cache manually in order to see the plugin changes. With this fix, once the prioir browser cache that was made without the fix is cleared, the subsequent browser cache is refreshed automatically once the plugin is updated, all ICN servers are restarted, and the browser is reloaded. The fix requires the following rule to be present in the ESAPI web application firewall policy file described in https://www.ibm.com/docs/en/content-navigator/3.0.15?topic=security-protecting-your-web-application-by-using-firewall). The rule is added to the default policy file, ESAPIWafPolicy.xml.default, as part of this fix: <add-header name="Cache-Control" value="no-cache" path=".*/plugin/.*/getResource/.*"/>.
IO29419 Custom labels do not work correctly.
(IBM Content Navigator users) Custom labels do not work correctly. With this fix, the custom labels work as expected.
IO29422 Microsoft Word and Powerpoint documents with Hebrew text are incorrectly converted to PDF documents.
(IBM Content Navigator users) Microsoft Office documents (Word and PowerPoint) with Hebrew text are incorrectly converted to PDF. The orientation of the text is not preserved and some characters fail to be converted in the output PDF. With this fix, these symptoms are resolved and the output PDF matches the source document.
IO29373 Inline editable list field in entry template disappears when more than 10 values are added.
(IBM Content Navigator users) If more than 10 values are added to a multi-valued property using an inline editable list field, and the Enter key is pressed, the field disappears without the values being saved. With this fix, this symptom does not occur.
IO29374 Work page filter closes automatically if mouse cursor is moved away from hover help text.
(IBM Content Navigator and IBM BAW users) When using the work page filter in BAW, if users moves the mouse cursor on the Info icon, hover help text or note is displayed. If the user moves the cursor out of text, the filter window closes automatically instead of only closing the note. However, if the user clicks on X to close the note, then the filter stays open. The symptom also occurs in the Search feature of Content Navigator when the mouse cursor is moved over the Info icon of any of the search panel's input fields. With this fix, this symptom does not occur.
IO29375 If 'All versions' is selected, document properties can be edited if the document isn't displayed in first page of results.
(IBM Content Manager users) When running a search for documents with 'All versions' selected, the document properties can be edited when the document is not displayed on the first page of the search results. The document properties should never be editable when 'All versions is selected. With this fix, the document properties will not be editable when the document is displayed on any of the pages of the search results.
IO29377 401 code is not gracefully handled when Single Sign-On (SSO) is enabled.
(IBM Content Navigator users) When SSO is enabled and the server returns a 401 code for re-authentication, Content Navigator does not handle it gracefully. With the fix, this error is correctly interpreted as a session expired situation and re-authentication is triggered.
IO29383 Document History shows user short name instead of full name.
(IBM FileNet Content Manager users) The History of document shows event creator's short name instead of full name. With this fix, the Document History displays the full name.
IO29385 Edit Service client fails login with single sign-on.
(IBM Content Navigator users) The Edit Service client fails to login using single sign-on (SSO) with Azure Active Directory. Users cannot login using SSO. With this fix the login using SSO succeeds.
IO29387 Sensitivity Label of .eml extension email file is not converted.
(IBM Content Navigator users) When opening a .eml extension email file using Ajax Viewer, the 'Sensitivity' label is not shown. With this fix, this symptom does not occur.
IO29389 Desktops are not displayed in the Desktops section of administration desktop.
(IBM Content Navigator users) When a new desktop is created by selecting an existing desktop and clicking Copy or by clicking New button, the existing desktops are not displayed anymore. The only way to restore the display of existing desktops is by restoring the Content Navigator configuration database from a backup created prior to creating the new desktop. With this fix, this symptom does not occur.
IO29394 Unable to use corbaloc URL containing query parameters.
(IBM FileNet Content Manager users) When adding a FileNet Content Manager repository with a corbaloc URL containing a query string, an error occurs when connecting to the repository, preventing the repository from being created. With this fix, the problem is resolved.
IO29395 Entry template hidden fields are displayed at runtime.
(IBM FileNet Content Manager users) Hidden fields in an entry template are displayed after upgrade to v3.0.11. This symptom occurs only with existing entry templates where the property specified as hidden has data type xs:timestamp and isDateOnly is set to true in ACCE web client. New entry templates created after upgrade to v3.0.11 do not show this symptom. With this fix, this symptom does not occur any more with existing entry templates.
IO29396 Event count is displayed as 0 in Doc Info pane for non-admin users.
(IBM FileNet Content Manager users) Event count for a document is displayed incorrectly as 0 in Doc Info pane for non-admin users. This does not match the count that is displayed in the History tab of the Properties dialog. With this fix, the Doc Info pane displays the event count correctly.
IO29401 Mutated vowels for German language incorrect after deployment.
(IBM Content Navigator users) Mutated vowels for German language are displayed incorrectly after deployment. With this fix, this symptom is resolved.
IO29405 'No secret key' error occurs with Edit Service client and Kerberos single sign-on (SSO).
(IBM Content Navigator users) A 'No secret key' error occurs when using Edit Service client with Kerberos SSO.
IO29412 DB2/zOS database script does not create tablespace for TASK_QUEUE table.
(IBM Content Navigator users) The DB2/zOS database script does not create tablespace for TASK_QUEUE table. With this fix, the tablespace is created for this table.
IO29413 Desktop is not loaded after upgrade to v3.0.15 for profiles without FileNet Content Manager (P8).
(IBM Content Navigator users) If the Content Navigator profile does not contain a P8 repository, then user desktops fails to load. The server log contains an error message, 'Caused by: java.lang.NoClassDefFoundError: org.apache.log4j.Layout'. With this fix, the desktops load successfully.
IO29421 Results Display panel cannot be opened.
(IBM Content Navigator users without IBM Content Manager OnDemand repositories) When clicking on the Results Display button of a new or an existing search, an error occurs. The application server log file contains an entry with 'java.lang.NoClassDefFoundError: com/ibm/edms/od/ODConfig' when the error occurs. With this fix, the problem is resolved.
http://www.ibm.com/legal/copytrade.shtml
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.
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: