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 6 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.600_installer_win.zip |
AIX | FP8.5.00.600_installer_aix.tar.Z |
Solaris SPARC | FP8.5.00.600_installer_sun.tar.Z |
Linux | FP8.5.00.600_installer_lnx.tar.gz |
Linux zSeries | FP8.5.00.600_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. For Content Manager for z/OS, also read the cover letter that is shipped with the PTF.
Known issues while you are upgrading to Version 8.5 Fix Pack 6
If you are upgrading to IBM Content Manager Version 8.5 Fix Pack 6 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.
Error com.ibm.db2.jcc.am.SqlException: DB2 SQL Error: SQLCODE=-1131, SQLSTATE=38503, during creating or retrieving a document
This error indicates that the library server was terminated abnormally.
This problem happens because the library server might not return data for the requested operation. The CLOB/BLOB output parameters of one of the library server stored procedures are not large enough to contain the data to be returned. The default value is 320 K.
In this fix pack, instead of terminating abnormally, the library server now has a new error code 7964 with the following error message:
ICM0001: This is an unexpected internal error or an unrecognized error code. Run the application again with server trace set to Detail and Data. Save the server log and see your IBM service representative. : 7964 (STATE) : [LS RC = 7964]
When a stored procedure needs to return data that is bigger than its LOB parameters maximum size, it returns this error code. You can redefine the stored procedure's LOB parameters to be bigger and try again the operation that caused the error.
When this error occurs, the library server trace log will contain the detailed information about this error. Open the library server log to find the error code and determine which stored procedure returned this error and contact IBM support for assistance to redefine such stored procedure.
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 prerequisites:
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 powered by Apache for z/OS, 31-bit instances of either Version 8.5.5 or the base element of z/OS 2.2
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, or under the IBM HTTP Server powered by Apache base element of z/OS 2.2, 31-bit instances. Refer to the z/OS technote http://www.ibm.com/support/docview.wss?uid=swg21688370 for details about this updated 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.
The fix packs on z/OS are installed by using SMP/E. During the SMP/E RECEIVE process, installation instructions are in the ++HOLD sections, which can be found in the SMPRPT DD name in the RECEIVE job. The ++HOLD sections must be reviewed before the start of the SMP/E APPLY process.
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 Enterprise Edition, 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 6:
IBM Content Manager, Version 8.5 Fix Pack 6 includes the following additional updates.
Content Manager Enterprise Edition Version 8.5 Fix Pack 6 includes the following updated software.
With this fix pack, Content Manager EE supports the following operating systems and software.
Operating systems:IBM Content Manager system administration web client plugin supports languages other than English. For the list of supported languages, see http://www.ibm.com/support/docview.wss?uid=swg27048909.
The Content Manager Java API now supports WebSphere Liberty database connection pooling. For more information about using the WebSphere Liberty database connection pooling with Java API, see http://www.ibm.com/support/docview.wss?uid=swg27048913.
The Content Manager EE resource manager Version 8.5 Fix Pack 6 introduces a new encryption utility named Encryptor. You can use the encryptor to encrypt the existing data at rest. The encrypt data at rest feature was introduced in resource manager Version 8.5 Fix Pack 3. When the data at rest encryption feature is enabled, the resource manager encrypts newly stored data. However, the existing data in the resource manager is not encrypted unless this feature is enabled and the content is updated. You can now use the encryptor to encrypt the existing data at rest in resource manager. For more information, see http://www.ibm.com/support/docview.wss?uid=swg27048930.
The System administration client and LDAP import utility provide the following enhancements:
IBM Content Manager, Version 8.5 Fix Pack 6 includes the following behavior changes.
The cumulative fix list contains all APARs that are fixed in Version 8.5 of IBM Content Manager.
APAR | Description |
---|---|
Connector | |
IO24496 | Error sometimes happened when searching a string with non-single byte UTF8 characters. |
IO24544 | Active item type view cache is not cleared when datastore cache is cleared. |
IO24611 | Query returns unexpected search results when the search string contains a single quote. |
IO24827 | Null pointer error when setting C++ DKLobICM with invalid MIME type. |
Install and Upgrade | |
IO24783 | Library server configuration fails if the user password contains the character $ on UNIX or % on Windows. |
Library Server | |
IO24651 | Auto-link/foldering is creating a new folder instead of linking document to an existing folder |
IO24850 | New versions have incorrect CREATETS and CREATEUSERID values |
Library Server for z/OS | |
PI60151 | Library server monitor heart beat incorrectly marks resource manager as unavailable. |
PI64680 | High volume batch utility is not processing all input when stopcount is used. |
PI67963 | Importing itemtype definitions to create itemtypes is getting unexpected error with SQL error -519. |
Resource Manager | |
IO24832 | Resource manager threads hang during migration to Tivoli Storage Manager. |
Resource Manager for z/OS | |
PI61614 | Resource manager not recovering from abend correctly and getting OAM 34010200 and this continues for a while. |
PI64425 | Apache HTTP Server not handling German and other codepages for translation of orders from client code. |
Viewer | |
IO24434 | Selecting a Zoom Option in German locale does not change the scale. |
IO24764 | Thumbnails that are generated for TIFF documents are slow to generate. |
IO24780 | OutOfMemoryError during page manipulation of a document. |
Web Administration Client | |
IO24645 | Group assignment list for a user is incorrect in the Content Manager system administration web client plugin. |
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.