This readme document contains information about installation and removal of the fix pack and about known problems, restrictions, and solutions in support of IBM® Content Manager Version 8.5.
Download IBM Content Manager Version 8.5 Fix Pack 2 from the following location: Fix Central Download Support site or access the fix pack from the table below.
Platform | File Name |
---|---|
Windows | FP8.5.00.200_installer_win.zip |
AIX | FP8.5.00.200_installer_aix.tar.Z |
Solaris SPARC | FP8.5.00.200_installer_sun.tar.Z |
Linux | FP8.5.00.200_installer_lnx.tar.gz |
Linux zSeries | FP8.5.00.200_installer_zlnx.tar.gz |
Known problems, restrictions, and solutions that affect administration and usage of fix packs are documented as techdocs in the product support knowledge base.
To review all known problems, restrictions, and solutions that affect Version 8.5 fix packs, use the following link to query the product support knowledge base: IBM Content Manager Enterprise Edition Version 8.5.0 or IBM Content Manager for z/OS Version 8.5.0
Known issues while you are upgrading to Version 8.5 Fix Pack 2
If you are upgrading to IBM Content Manager Version 8.5 Fix Pack 2 on Linux®, you might experience DB2® instance down. In this case, you need to apply DB2 APAR IC98362 (for DB2 Version 10.1) or IC98880 (for DB2 Version 10.5) and try the upgrade again.
The official statements for hardware and software support for IBM Content Manager are provided as part of the hardware and software requirements for IBM Content Manager Version 8.5.
For complete details about the hardware and software requirements for IBM Content Manager, see Hardware and software requirements for IBM Content Manager Enterprise Edition Version 8.5.0 or Hardware and software requirements for IBM Content Manager for z/OS Version 8.5.0.
The fix pack includes the following new prerequisite:
IBM Content Manager for z/OS library server and resource manager have a new requirement: Integrated Cryptographic Service Facility
As this fix pack contains stronger encryption for passwords, you need to install Integrated Cryptographic Service Facility, ICSF, on the z/OS platform. ICSF is a component of z/OS and it is included in the base product. ICSF provides Cryptographic Support either in its own software routines or through access to the cryptographic hardware available on System z. Refer to http://www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/TD103782 for the supported hardware and operating system releases.
The fix pack includes the following optional prerequisite:
IBM HTTP Server Version 8.5.5 powered by Apache for z/OS, 31-bit instances
Resource manager on z/OS now supports running directly under either the IBM HTTP Server Version 5.3 (Domino Go Web) or under the IBM HTTP Server Version 8.5.5 powered by Apache, 31-bit instances. Refer to the z/OS technote http://www.ibm.com/support/docview.wss?uid=swg21688370 for details about this new support.
To install an IBM Content Manager Version 8.5 fix pack, you determine where the fix pack should be installed, prepare the environment for the fix pack installation, complete the installation worksheet for the fix pack programs, install the fix pack, and verify the fix pack installation.
Before you run the fix pack installation program on Windows®, you must prepare the environment.
Before you run the fix pack installation program on AIX®, Linux, or Solaris, you must prepare the environment.
/opt/IBM/db2cmv8/bin/cmlevel -l
You can use an installation worksheet to gather the information needed to install the fix pack for IBM Content Manager.
Product component to update | Data required | Your values |
---|---|---|
Library server | Library server database name | |
Library server schema name (DB2 only) | ||
Library server JDBC connection string (Oracle only) | ||
Library server database administration ID | ||
Library server database administration password | ||
Library server database connection port | ||
Resource manager database | Resource manager database name | |
Resource manager schema name (DB2 only) | ||
Resource manager JDBC connection string (Oracle only) | ||
Resource manager database administration ID | ||
Resource manager database administration password | ||
Resource manager database connection port | ||
Resource manager application (for each application) | Application server home directory | |
Application server profile home directory | ||
Resource manager Web application name | ||
Application server administration ID * | ||
Application server administration password * | ||
Application server node name ** | ||
Resource manager Web server name ** | ||
Application server cluster name *** |
* Only needed if application server security is enabled.
** Only needed if the deployment target is an application server.
*** Only needed if the deployment target is a cluster.
To install the fix pack for IBM Content Manager, run the installUpdate fix pack installation wizard.
If you have a large number of component views, such as thousands of views, and if the fix pack upgrade is slow, then you might want to inspect the installation log file during the installation. By inspecting this log file, you can find out if the delay is due to the generation of these access statements. The update configuration log including the generation of the access statements is IBMCMREPO/version/cmcfgmgr/log/hostname/version/cmfpconfig.log, where IBMCMREPO is the installation location on the reference machine as defined by the IBMCMREPO environment variable and version is the fix pack version.
The fix pack installation and configuration data is retained in log files that are created by the fix pack installation wizard during installation. You can find log files for the installation and configuration in the following locations. In the path for the log file location, IBMCMREPO is the installation directory, version is the fix pack version, and hostname is the name of the host for which the fix pack is being installed.
Log file type | Log file location |
---|---|
Installation | IBMCMREPO/version/cmcfgmgr/log/hostname/version/fpinstall.log |
Removal | IBMCMREPO/version/cmcfgmgr/log/hostname/version/fpuninstall.log |
Configuration | IBMCMREPO/version/cmcfgmgr/log/hostname/version/cmfpconfig.log |
Removal of configuration | IBMCMREPO/version/cmcfgmgr/log/hostname/version/cmfpunconfig.log |
Validation log | IBMCMREPO/version/cmcfgmgr/log/hostname/cfgactions.log |
install -i silent -f path/install.rspwhere path/install.rsp represents the complete path and file name for the installation response file. If no path is specified, the default location is the local directory.
IBMCMREPO/VERSION/bin/cmcfgmgr_CM -f path/config.rspwhere path/config.rsp represents the complete path and file name for the configuration response file. If no path is specified, the default location is the local directory.
IBMCMREPO/VERSION/bin/cmcfgmgr_CM -f path/config.rsp -p password
When the configuration manager runs in silent mode, no windows display and the configuration progresses as if you had entered the response file values into each window.
If you run a silent installation or configuration that stops immediately, you might not see any error messages. Some error messages are hidden when there are no installation windows.
To remove IBM Content Manager Fix Pack 2:
IBM Content Manager, Version 8.5 Fix Pack 2 includes the following additional updates.
Library server provides an option to gracefully shut down the usage statistics service on AIX, Linux, and Solaris
Manually modify the entry for the library server usage statistics service in /etc/inittab file and replace the word 'respawn' with 'once'.
After you modify the /etc/inittab file, enter the following command:
init q
To shut down the library server usage statistics service, enter the following command:
/etc/rc.cmusproc -shutdown
Improved performance for use with IBM Enterprise Records Version 5.2 Fix Pack 1
IBM Content Manager Enterprise Edition Version 8.5 Fix Pack 2 provides a much improved performance for use with the new IBM Enterprise Records Version 5.2 Fix Pack 1. The new integration of IBM Enterprise Records with Content Manager Version 8 removes the requirement for Content Federation Services and provides a highly scalable records management implementation to meet the demands of the largest Content Manager Version 8 systems. For more information, see IBM Enterprise Records V5.2 Announcement.
New check box in system administration client to indicate IBM Enterprise Records enablement
System administration client now has a new "IBM Enterprise Records" check box to indicate that IBM Enterprise Records is enabled. The new check box is located under the "Enable Record Management" section when you select the "Feature" tab in library server configuration window. Select this check box when Content Manager Version 8.5 is integrated with Enterprise Records Version 5.2 FP1 or later and Enterprise Records is configured for direct access to Content Manager.
On-hold enhancement
Holds are used to ensure that items cannot be updated or deleted until the hold is removed. Starting from Version 8.5 Fix Pack 2, an internal checkout operation is done before a hold is added to an item. After the add hold operation is finished, the item is checked in. If the item is already checked out, even from the same user ID that adds the hold, an ICM7960 error is returned. You can avoid this error by first checking in the item before a hold is added.
You can start Event Monitor or BPM Event Handler as a service on Windows operating system. For more information about event monitor and BPM event handler enhancements, see http://www.ibm.com/support/docview.wss?uid=swg21666540.
A Windows domain administration user is now supported to run Version 8.5 Fix Pack 2 or later installation and configuration with the following considerations:
db2set DB2_GRP_LOOKUP=LOCAL,LOCALTOKEN
db2 UPDATE DBM CFG USING CATALOG_NOAUTH YES
For more information about SQL1092N error, see SQL1092N.
The resource manager validation utility recovery tools ICMFILENOTFOUNDCleanup and ICMNOTINRMCleanup are enhanced with additional control options. For more information, see http://www.ibm.com/support/docview.wss?uid=swg27043867.
Resource manager provides an option for file system write operations to synchronize with the underlying storage devices to help prevent potential data loss when storage devices are not configured properly and run out of disk space. For more information, see http://www.ibm.com/support/docview.wss?uid=swg27043996.
Validation utility recovery tool for z/OS is enhanced with additional control options for NOTINRM cleanup function. For more information, see http://www.ibm.com/support/docview.wss?uid=swg27043974.
Content Manager Web services now support the EXPIRATIONDATE system attribute. This enhancement enables Web services to return the EXPIRATIONDATE system attribute when you run a RunQueryRequest or a RetrieveItemRequest.
Content Manager Version 8.5 Fix Pack 2 introduces new error message codes for library server and API when integrated with IBM Enterprise Records product. See the techdoc http://www-01.ibm.com/support/docview.wss?uid=swg21688872 for details about these error codes.
Content Manager now supports storing and retrieving objects that are greater than 2 gigabytes in size. You can use this feature when you use Content Manager Version 8.5 Fix Pack 2 Java APIs that use streaming. Loading these large objects into memory during the add, update, or retrieve operation is not allowed and produces an error. This change allows large objects to be stored and retrieved on Content Manager servers that are version 8.5 and above. This feature is not supported for z/OS resource managers. LAN cache and Tivoli Storage Manager retrieve cache features currently do not support caching of objects greater than 2 gigabytes in size. Synchronous replication with large objects requires the resource manager to be at version 8.5 Fix Pack 2 or above. Partial retrieve is not supported for objects larger than 2 gigabytes in size.
Content Manager APIs that use streaming for the document model use the following method to set the content for a part:
base.setAddLocation(location);
Where the location passed in is a stream or a file name. See the sample SDocModelItemICM.java for complete details.
For resource items, use one of the following methods:
- DKLobICM.add(filename) - DKLobICM.add(stream)
See the sample SResourceItemCreationICM.java for details.
boolean com.ibm.mm.viewer.CMBGenericDocViewer.canExtractTextByArea()
Returns true if extract text can be performed on the loaded document and there is a selected area, otherwise false is returned. This is used to enable an extract text by area action.
void com.ibm.mm.viewer.CMBGenericDocViewer.extractTextByArea()
This will get letters for a page if they have not already been determined. For PDF this will first try extract text and then OCR. The current mode will be set to SELECT_AREA_MODE.
CMBLetters com.ibm.mm.viewer.CMBGenericDocViewer.extractText(Rectangle r)
Extract text in specified rectangle from the current page of document.
Parameters:
r Rectangle that defines selected area on the page.
Returns:
CMBLetters that represent the text from the area on the page.
String com.ibm.mm.viewer.CMBLetters.toStringWithLinefeeds()
Returns:
string that represents the letters with line feeds
The cumulative fix list contains all APARs that are fixed in Version 8.5 of IBM Content Manager.
APAR | Description |
---|---|
Beans | |
IO21939 | CMBXMLServices does not return non-ascii characters correctly. |
Install and Upgrade | |
IO20997 | IBM Content Manager configuration manager GUI page gives false impression that the IBMCMROOT directory can be changed on UNIX. |
IO21451 | IBM Content Manager configuration manager requires DB2 product directory if configuring the resource manager application only on DB2. |
Connector | |
IO21250 | VI400 C++ query term value is uppercased during datastore query. |
IO21300 | Listing item type information, listing component type information, or calling the DKLSConfigurationMgmtICM.retrieveConfigParameters() all ACL names are initially retrieved into the cache instead of just the requested ACL names. |
IO21767 | C++ DKAuthorizationMgmtICM.isAuthorized method returns false instead of true for authorized privilege. |
IO22174 | Synchronization issue in logging with Java API can cause slow performance. |
Library Server | |
IO21088 | Library server fails to list group for user in Content Manager 8.5 on Oracle with II4C API. |
IO21015 | EML/MHT file types are not correctly indexed for text search. |
IO21326 | An error is returned when work package is routed to the next node: "DGL4052A: Unable to continue a document routing process". |
IO21842 | Update user attribute value to empty string does not work in Oracle. |
IO21862 | In Space optimized mode, query might encounter error : LSRC=7015 with ExtRC=-313. |
IO21882 | An error is returned when work package tries to reach end node: "DGL4052A: Unable to terminate a document routing process". |
IO21892 | When the library server uses Oracle database, ICM7800 error occurs when refreshing encryption key. |
IO22056 | Library server log reports SQL0440N error on usage statistics. |
IO22106 | Encryption key may not be synchronized between resource manager and library server. |
IO22233 | Update attribute value of ICM$NAME to NULL returns 'DB2 SQLError: SQLCODE=-1131' or 'ORA-28579'. |
IO22320 | AddItem CommonBaseEvent generated by event monitor has ATTRLEN=0 when its ATTRVAL is not an empty string. |
IO22368 | Library server monitor cannot start on UNIX when certain versions of DB2 v10 are used. |
PI17426 | ImagePlus migration job ICMMMIC1 does not cover the migration changes from ImagePlus to Content Manager for z/OS V8.5.0 FP1. |
PI22704 | Auto Delete on a retention policy is requiring a user ID to be defined in the DB2 catalog SYSIBM.SYSUSERAUTH. |
Resource Manager | |
IO21233 | Fix pack installation fails with error code 140. |
IO21776 | Aggregation migration process stops if some of the objects do not exist on the file system volumes. |
Resource Manager for z/OS | |
PI15927 | Adding support for IBM HTTP Server powered by Apache to IBM Content Manager for z/OS resource manager. |
PI18469 | Users see an error and message ICM118W in the log or console of the resource manager asynchronous tasks. For example, the asynchronous delete job. |
XMLSDK | |
IO21830 | XML item type update fails when more than one resource manager exists. |
Viewer | |
IO21011 | Extracted text is incorrect from PDF document that is using a non-ASCII font. |
IO21238 | PDF document is rendered with missing text content. |
IO21363 | Exporting or saving a TIFF document with unassociated alpha data fails. |
IO21928 | Modified TIFF document is saved with missing content on a page. |
IO21937 | Sticky note annotation with more than 29500 characters is not correctly truncated. |
IO21980 | Annotations are not correctly scaled and positioned during page manipulation between TIFF and PDF documents. |
Web Services | |
IO21840 | Starting all the JVMs from the cluster in parallel might fail when using Content Manager Web Services in a WebSphere cluster. |
Knowledge Center | |
IO20802 | Validation utility examples in documentation do not address operating system difference. |
IO21232 | The ICMSTITEMEVENTS table definition in the product documentation does not define document routing events. |
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.