IBM Content Manager Version 8.7 Fix Pack 4 Readme

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.7.

Readme file for:
IBM Content Manager
Product or component release:
Version 8.7
Update name:
Fix Pack 4
Fix ID:
  • 8.7.00.400-ECM-CM-WIN-fixpack4
  • 8.7.00.400-ECM-CM-AIX-fixpack4
  • 8.7.00.400-ECM-CM-LNX-fixpack4
  • 8.7.00.400-ECM-CM-zLNX-fixpack4
Publication date:
February 21, 2025
Last modified date:
February 21, 2025
Online version of readme file: IBM Content Manager Version 8.7 Fix Pack 4 Readme
Important: The most current version of the readme file can always be found online.

Known problems, restrictions, and solutions

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.7 fix packs, use the following link to query the product support knowledge base: IBM Content Manager Enterprise Edition Version 8.7.0 or IBM Content Manager for z/OS Version 8.7.0. For IBM Content Manager for z/OS®, also read the cover letter that is shipped with the PTF.

Configuration user interface is not supported on SUSE Linux 12

In fix pack 4 and later, the configuration user interface is not supported on SUSE Linux 12. This is because the GTK version on SUSE Linux 12 is GTK+ 3.20, and IBM Content Manager requires GTK+ 3.22.0 or later.

Instead of using the configuration user interface, you must do one of the following:

Turkish locale: 'I' in database schema names and user IDs

When a client that runs in the Turkish locale tries to connect to IBM Content Manager, database schema names and user IDs that contain the English letter 'i' (lowercase 'I') might cause issues; this is because of a problem with the Java toUpperCase() function when used in the Turkish locale.

To resolve these issues:

  • Enter user IDs in IBM Content Manager in UPPERCASE.
  • In the cmbicmsrvs.ini file, specify the database schemas for servers in UPPERCASE; for example, ICMSCHEMA=ICMADMIN.

Changing the resource manager administration user

IBM Content Manager fix packs 2, 3 and 4

If you change the resource manager administration user in a resource manager server by using the system administration client, you must restart the system administration client before making any more changes to the resource manager.

Prerequisites for Version 8.7 Fix Pack 4

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.7.

Mandatory prerequisites

None.

Optional prerequisites

None.

More information

For more information about the hardware and software requirements for IBM Content Manager, see:

Installing IBM Content Manager Fix Pack 4

To install an IBM Content Manager Version 8.7 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.

About this task

A single installation program installs the fix pack. All of the components installed by the original installation program are updated by this fix pack installation program. You install the fix pack to the repository installation directory (IBMCMREPO) first, and then use the repository installation's updated version of Configuration Manager to update the target installation (IBMCMROOT) with the fix pack.

Restriction: If you install the fix pack on a reference computer without IBM Content Manager Version 8.7 installed to the repository directory, the updated Configuration Manager from the fix pack can only apply the fix pack on a target computer with previously installed and configured IBM Content Manager Version 8.7 components. It cannot install and configure new components. To install and configure new components at this fix pack level, both the fix pack and IBM Content Manager Version 8.7 must be installed to the repository installation directory on the reference computer. For IBM Content Manager for z/OS components, you must install IBM Content Manager for z/OS V8.7 using SMP/E first before the fix pack.

For information about supported component and product compatibility combinations, see IBM Content Manager V8.7 Component and Product Compatibility.

Before you install the fix pack on z/OS

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.

Recommendation: Before you apply the fix pack, back up the IBM Content Manager databases.

Before you install the fix pack on Windows

Before you run the fix pack installation program on Windows, you must prepare the environment.

  1. Perform these steps to prepare your Windows environment for fix pack installation:
    If the following statement is true Perform this step
    The library server monitor is running on Oracle Stop the monitor. Enter the following SQL statement:
    set serveroutput on
    execute icmlsmon.stopmonitor
    The library server monitor is running on Db2
    1. Stop the monitor.
    2. Stop the ICM LS Monitor dbname service.
    The library server uses UVU or Eligible Participant RVU license types Stop the ICM Usage Statistics Listener service.
    You are using Db2 Stop the Db2 instance where the IBM Content Manager databases are installed.
    1. Enter the following command to exit all Db2 applications:
      db2stop
    2. If you use Db2® Net Search Extender, enter the following command:
      db2text stop
    3. If you use Db2 Text Search, enter the following command:
      db2ts "STOP FOR TEXT"
    You are using Db2 Start the Db2 instance:
    1. Enter the following command:
      db2start
    2. If you use Db2 Net Search Extender, enter the following command:
      db2text start
  2. (Optional.) Recommendation: Create an index on the RMREPLICATION table to improve the fix pack installation and replication performance:
    Database Action
    Db2 Enter the command:

    CREATE INDEX IDX_REP1 ON RMREPLICATION (PROCESSTIMEOUT ASC, REP_REPLICATETYPE ASC)

    RUNSTATS ON TABLE schema_name.RMREPLICATION WITH DISTRIBUTION AND DETAILED INDEXES ALL

    Oracle Enter the command:

    CREATE INDEX IDX_REP1 ON RMREPLICATION(PROCESSTIMEOUT ASC, REP_REPLICATETYPE ASC);

    COMPUTE STATISTICS TABLESPACE REPLICAS;

    If there are many items and parts in your content management system (that is, many rows in these tables), the creation of the index might take a long time.

  3. (Optional.) Recommendation: Create an index on the RMOBJECTS table to improve the background performance:
    Database Action
    Db2 Enter the command:

    CREATE INDEX IDX_OBJ_STATUS ON RMOBJECTS (OBJ_STATUS ASC, OBJ_REFERENCEDDATE ASC, OBJ_STAGEDVOLUMEID ASC);

    RUNSTATS ON TABLE schema name.RMOBJECTS WITH DISTRIBUTION AND DETAILED INDEXES ALL;

    Oracle Enter the command:

    CREATE INDEX IDX_OBJ_STATUS ON RMOBJECTS (OBJ_STATUS ASC, OBJ_REFERENCEDDATE ASC, OBJ_STAGEDVOLUMEID ASC);

    COMPUTE STATISTICS TABLESPACE OBJECTS;

    If your content management system contains many items and parts (that is, there are many rows in these tables), creating the index might take a long time.

  4. (Optional.) Recommendation: Before you apply the fix pack, back up the IBM Content Manager databases.
  5. Important: Stop all resource manager services (purger/migrator/stager/replicator) by using the system administration client or the resource manager administration console.
  6. If you are using Oracle: Ensure that all of the connections to the IBM Content Manager servers are stopped but the listener and your Oracle instance are started. You or your Oracle DBA should quiesce all user activity or terminate all user sessions on the IBM Content Manager library server database (whether or not Oracle indicates that they are active). Additionally, extproc processes might still be alive even after user sessions are terminated. Make sure to stop them before installing the fix pack by completing the following steps:
    1. Open the Windows Task Manager.
    2. Click Processes.
    3. Click each process with the name extproc.exe, and then click End Process.
  7. If you have multiple active Oracle homes installed on the same Oracle server, make sure that the IBM Content Manager runtime environments can correctly access the IBM Content Manager databases. Verify that the IBM Content Manager processes are started with correct values for the intended Oracle home in such environment variables as ORACLE_HOME, PATH, and CLASSPATH.
  8. Configure debug logging.

    Follow the instructions in Enabling debug installation and configuration logging on Windows.

  9. If you are using Oracle: Log in as a user with SYSDBA authority to grant the required Content Manager Enterprise Edition database privileges to library server database users, and then run the Content Manager Enterprise Edition schema creation SQL script, icmlsschemas.sql.

    For example:

    sqlplus sys/change_on_install as sysdba
    icmlsschemas.sql icmadmin password icmconct password ICMLFQ32 TEMP
    icmadmin password
    The name and password for the library server administration database user.
    icmconct password
    The name and password for the library server connection database user.
    ICMLFQ32 TEMP
    The default table spaces for library server database users. You must include these values as shown, even though they are not actually used by the command.

    Alternatively, you can run the script as any database user with the privilege to grant all of the privileges that are in this script.

    The script detects the existence of your library server database users, and does not drop them or re-create them. It does not revoke any privileges, but it does revoke any Oracle default roles.

    Important:
    • Do not change icmlsschemas.sql. The script grants only the minimum database privileges required for the library server. If you change this script, the library server will fail during configuration and administration.
    • Use the script only on Content Manager Enterprise Edition users.
  10. Next, see Completing the installation worksheet for IBM Content Manager.

Before you install the fix pack on AIX or Linux

Before you run the fix pack installation program on AIX® or Linux®, you must prepare the environment.

Before you begin

Restriction: After you install IBM Content Manager on AIX or Linux, the IBM Content Manager file sets do not reflect the current version of the product. To retrieve the correct product level and determine whether the target installation should be updated with the fix pack, enter this command on the target computer:
/opt/IBM/db2cmv8/bin/cmlevel -l
  1. Perform these steps to prepare your AIX or Linux environment for fix pack installation:
    If the following statement is true Perform this step
    The library server monitor is running on Oracle Stop the monitor. Enter the following SQL statement:
    set serveroutput on execute icmlsmon.stopmonitor
    The library server monitor is running on Db2 Stop the monitor.

    For AIX, enter the following command:

    /etc/rc.cmlsproc -shutdown

    For RHEL 7+ and SuSE 12+, enter the following command:

    systemctl stop cmlsmonitor

    For other systems, enter the following command:

    /etc/rc.cmlsproc -shutdown
    The library server uses UVU or Eligible Participant RVU license types For RHEL 7+ and SuSE 12+, enter the following command:
    systemctl stop cmlsus
    You are using Db2 Stop the Db2 instance where the IBM Content Manager databases are installed.
    1. Enter the following command, where the user ID of the Db2 instance is db2inst1 by default:
      su - user ID of the Db2 instance
      db2stop
      
    2. For AIX only: As root, enter the /usr/sbin/slibclean command to unload unused shared libraries from memory.
    3. If you use Db2 Net Search Extender, enter the following command:
      db2text stop
    4. If you use Db2 Text Search, enter the following command:
      db2ts "STOP FOR TEXT"
    You are using Db2 Start the Db2 instance.
    1. Log in as root, and then enter the following command:
      su -user ID of the Db2 instance
    2. Enter the following command:
      db2start
    3. If you use Db2 Net Search Extender, enter the following command:
      db2text start
    4. Enter the following command:
      exit
  2. Recommendation: Create an index on the RMREPLICATION table to improve the fix pack installation and replication performance:
    Database Action
    Db2 Enter the command:

    CREATE INDEX IDX_REP1 ON RMREPLICATION (PROCESSTIMEOUT ASC, REP_REPLICATETYPE ASC)

    RUNSTATS ON TABLE schema_name.RMREPLICATION WITH DISTRIBUTION AND DETAILED INDEXES ALL;

    Oracle Enter the command:

    CREATE INDEX IDX_REP1 ON RMREPLICATION(PROCESSTIMEOUT ASC, REP_REPLICATETYPE ASC);

    COMPUTE STATISTICS TABLESPACE REPLICAS;

    If there are many items and parts in your content management system (that is, many rows in these tables), the creation of the index might take a long time.

  3. Recommendation: Create an index on the RMOBJECTS table to improve the background performance:
    Database Action
    Db2 Enter the command:

    CREATE INDEX IDX_OBJ_STATUS ON RMOBJECTS (OBJ_STATUS ASC, OBJ_REFERENCEDDATE ASC, OBJ_STAGEDVOLUMEID ASC);

    RUNSTATS ON TABLE schema name.RMOBJECTS WITH DISTRIBUTION AND DETAILED INDEXES ALL;

    Oracle Enter the command:

    CREATE INDEX IDX_OBJ_STATUS ON RMOBJECTS (OBJ_STATUS ASC, OBJ_REFERENCEDDATE ASC, OBJ_STAGEDVOLUMEID ASC);

    COMPUTE STATISTICS TABLESPACE OBJECTS;

    If your content management system contains many items and parts (that is, there are many rows in these tables), creating the index might take a long time.

  4. (Optional.) Recommendation: Before you apply the fix pack, back up the IBM Content Manager databases.
  5. Important: Stop all resource manager services (purger/migrator/stager/replicator) by using the system administration client or the resource manager administration console.
  6. If you are using Oracle: Ensure that all of the connections to the IBM Content Manager servers are stopped but the listener and your Oracle instance are started. Terminate all outstanding extproc processes unless other applications other than IBM Content Manager require them. Oracle occasionally continues to run extproc processes to save time when reloading them. If Oracle reuses an old extproc process that did not pick up the changes to your tnsnames and listener configuration, a TNS error can result.

    On AIX:

    1. From a command prompt, enter the following command:
      /usr/bin/ps -ef | grep -i oracleSID
      where SID is associated with your IBM Content Manager library server database. The process ID number is displayed in the second column.
    2. For each process ID number, enter the following command:
      /usr/bin/kill -9 processID
      where processID is the process ID number. Ensure that you already stopped active database sessions against the library server (in the previous step) before you run the kill -9 command.
    3. Log in as root, and then enter the /usr/sbin/slibclean command to unload unused shared libraries from memory.
    On Linux:
    1. From a command prompt, enter the following command:
      /usr/ucb/ps -auxww | grep -i oracleSID
      where SID is associated with your IBM Content Manager library server database. The process ID number is displayed in the second column.
    2. For each process ID number, enter the following command:
      /usr/bin/kill -9 processID
      where processID is the process ID number. Ensure that you already stopped active database sessions against the library server (in the previous step) before you run the kill -9 command.
  7. If you have multiple active Oracle homes installed on the same Oracle server, make sure that the IBM Content Manager runtime environments can correctly access the IBM Content Manager databases. Verify that the IBM Content Manager processes are started with correct values for the intended Oracle home in such environment variables as ORACLE_HOME, PATH, CLASSPATH, and LIBPATH (AIX).
  8. Set up for debug logging.

    Follow the instructions in Enabling debug installation and configuration logging on AIX.

  9. If you are using Oracle: Log in as a user with SYSDBA authority to grant the required Content Manager Enterprise Edition database privileges to library server database users, and then run the Content Manager Enterprise Edition schema creation SQL script, icmlsschemas.sql.

    For example:

    sqlplus sys/change_on_install as sysdba
    icmlsschemas.sql icmadmin password icmconct password ICMLFQ32 TEMP
    icmadmin password
    The name and password for the library server administration database user.
    icmconct password
    The name and password for the library server connection database user.
    ICMLFQ32 TEMP
    The default table spaces for library server database users. You must include these values as shown, even though they are not actually used by the command.

    Alternatively, you can run the script as any database user with the privilege to grant all of the privileges that are in this script.

    The script detects the existence of your library server database users, and does not drop them or re-create them. It does not revoke any privileges, but it does revoke any Oracle default roles.

    Important:
    • Do not change icmlsschemas.sql. The script grants only the minimum database privileges required for the library server. If you change this script, the library server will fail during configuration and administration.
    • Use the script only on Content Manager Enterprise Edition users.
  10. Next, see Completing the installation worksheet for IBM Content Manager.

Completing the installation worksheet for IBM Content Manager

You can use an installation worksheet to gather the information needed to install the fix pack for IBM Content Manager.

This worksheet is valid only when configuring a library server and resource manager database. For the component or components that you are updating, gather the information listed in the following table. When the installation wizard runs, it prompts you to enter data for any setting that it cannot detect. The table is provided with blank spaces so that you can print it and enter your information.

Installation worksheet

Supply values for the following table:
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

(Needed only if application server security is enabled.)

 
Application server administration password

(Needed only if application server security is enabled.)

 
Application server node name

(Needed only if the deployment target is an application server.)

 
Resource manager Web server name

(Needed only if the deployment target is an application server.)

 
Application server cluster name

(Needed only if the deployment target is a cluster.)

 

Installing the fix pack for IBM Content Manager Enterprise Edition

To install the fix pack for IBM Content Manager Enterprise Edition, run the installUpdate fix pack installation wizard.

Before you begin

  1. You must first install the fix pack to the IBM Content Manager repository on the reference computer, and then use the updated Configuration Manager on this reference computer to update each target computer with the fix pack. The target computers are any computer where one of these system components is installed. A target computer can also be the same as the reference computer. The Configuration Manager starts the fix pack configuration wizard for a target computer after you select a target computer, and then click Configuration > Update configuration. The fix pack configuration wizard updates only those system components and components that are local to the computer on which it runs. For example, if your IBM Content Manager library server and resource manager components are installed on different computers, you must run the fix pack configuration wizard for both computers.
  2. If you changed any of the files that are in the db2cmv8/java directory, back them up. The files in this directory include certificates that you have imported into CACERTS. You should back up the files because they are overwritten by the installation program; the installation program does back up the files itself (to the db2cmv8/fixpack/cm/8.7.00.400/backup directory), but you should make your own back up copies as well. After completing the installation, you can restore the files from the back up (or re-import the certificates into CACERTS).

About this task

Complete the following steps to install IBM Content Manager.

Important: The more component views that exist in the library server, the longer that the fix pack installation can take to run because of the need to regenerate the access statements for those component views. Although the generation of an individual access statement for a component view can take only subseconds, the actual time that the installation takes can vary according to your environment, your content management setup, and the number of component views that you have configured.

If you have a large number of component views, such as thousands of views, and if the fix pack upgrade is slow, inspect the installation log file during the installation to 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 computer as defined by the IBMCMREPO environment variable and version is the fix pack version.

Procedure
  1. Do one of the following:

    UNIX: Log in as root.

    Windows: Log in as a user who is a member of the administrators group.

  2. Run the installUpdate program to start the installation.
    Operating system Command
    AIX and Linux installUpdate
    Windows installUpdate.bat
    The installation wizard detects which IBM Content Manager system components and components are installed on the computer on which it is running and displays the components that will be updated with this fix pack.
    Attention: If you close the Configuration Manager before installing the fix pack, you can reopen it by launching the Configuration Manager shortcut or by running the cmcfgmgr_CM script at IBMCMREPO\VERSION\bin\. Then click Configuration > Update configuration.
  3. Follow the onscreen instructions.

    Enter the data that is in the installation worksheet.

    Important: If you use SUSE Linux 12, choose to not start the configuration manager at the end of the installation wizard; instead, use Silent installation and configuration for Content Manager Enterprise Edition.

    This is because fix pack 4 and later do not support the configuration user interface on SUSE Linux 12. For more information, see Known problems, restrictions, and solutions.

  4. After you enter all configuration information, click Next to install the fix pack.
  5. After you click Finish, IBM Content Manager displays a list of any processes that are running under IBMCMROOT (for example, Java or icmplsap). Do one of the following:
    • To tell IBM Content Manager to stop the processes, click Yes.
    • To stop the processes manually, click No, and then click Finish to complete the installation.

Results

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

For more information about the locations of the log files, see Log file locations.

Generating response files for the installation program and configuration manager

To record the information that you enter in the installation program

Run the following command:
installUpdate -r [path/]install.rsp
Replace path/install.rsp with the full path and name of the file in which you want to record the information. The default path is the local directory.

This command installs only the repository files into IBMCMREPO; the product files are installed into IBMCMROOT when you perform the configuration step. For more information, see Silent installation and configuration for Content Manager Enterprise Edition.

To record the information that you enter in the configuration manager

You can generate a response file for the configuration by using the user interface or the command line. For more information, see Generating response files for the installation and configuration.

Installing the fix pack in silent mode

To run a silent installation, enter the following command:
installUpdate -i silent -f path/install.rsp
where 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.
To run a silent configuration, enter the following command:
IBMCMREPO/VERSION/bin/cmcfgmgr_CM -f path/config.rsp
where 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.
For remote configuration, you must also specify the login user's password for the target computers:
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.

After you install the fix pack

  1. Restart the resource manager application server. If the resource manager is deployed in a cluster, restart the cluster.
  2. If the library server uses UVU or Eligible Participant RVU license types, do the following:
    Operating system Do this
    Windows Start the ICM Usage Statistics Listener service.
    RHEL 7+ and SuSE 12+ Enter the following command:
    systemctl start cmlsus
    AIX
    1. Enter the following command:
      ps -ef | grep LSListener

      where LSListener is associated with your IBM Content Manager Usage Statistics Listener.

      Note the process ID number that is displayed in the second column.

    2. For each process ID number, enter the following command:
      kill -9 processID

      where processID is the process ID number.

    3. Log in as root, and then enter the following command to unload unused shared libraries from memory:
      /usr/sbin/slibclean

    The usage stat service on AIX is set to respawn when it is killed, so killing the process causes it to restart.


  3. If you changed the files that are in the db2cmv8 directory before applying the fix pack, restore them from the backup (see step 2 in Before you begin).

Removing the fix pack

To remove IBM Content Manager V8.7 Fix Pack 4, complete the following steps:

  1. Do one of the following:

    UNIX: Log in as root.

    Windows: Log in as a user who is a member of the administrators group.

  2. If the resource manager cloud object storage (COS) server uses a virtual hosted-style hostname, and by removing the fix pack, the resource manager will go back to version 8.7.00.000 (GA), you must change the COS server to use a path-style hostname.

    If you remove the fix pack without changing the COS server, the resource manager at version 8.7 cannot connect to it; you must then change the COS server hostname to a path-style hostname.

    For more information, see Hostname.

  3. If you have created item types or extended item types that contain more than 250 attributes, you must either delete the item types or reduce them to 250 attributes before you can uninstall the fix pack. For more information, see Other updates.
  4. Open the Configuration Manager on the reference computer by running the cmcfgmgr_CM script at IBMCMREPO\VERSION\bin\, or by double-clicking the Configuration Manager shortcut.
  5. Expand the profile, right-click the computer from which you want to remove the fix pack, and then click Connect and Validate. Enter your user ID and password to start the validation process.

    When the validation process completes, click Finish.

  6. In the Configuration Manager menu bar, click Configuration > Remove Operations. The fix pack update wizard opens.
  7. Click Remove the fix pack configuration, and then click Next. Follow the onscreen instructions.

Checking server entries in the cmbicmenv.ini file

  1. After removing the fix pack, check the entries for servers in the cmbicmenv.ini file.

    Entries for servers work with IBM Content Manager V8.7 GA only if they do not have $v2- in front of the server name.

    Server names with $v2- in front do not work with IBM Content Manager V8.7 GA.

  2. To add the entries that are needed to work with IBM Content Manager V8.7 GA, use the com.ibm.mm.sdk.util.cmbenvicm utility or the system administration client.

Using TLS 1.3 with earlier versions

If you use TLS 1.3 with IBM Content Manager 8.7 fix pack 2 or later, and then revert to a version that is earlier than V8.7 fix pack 2, TLS 1.3 will be unsupported. For more information, see Configuring Transport Layer Security for IBM Content Manager.

Additional updates

IBM Content Manager V8.7 Fix Pack 4 includes the following additional updates.

Administration

  • Fix pack 4: Improvements to the administration of IBM Content Manager by using IBM Content Navigator: Support Manage Database Connection ID for New Database Connection ID and Delete Database Connection ID.
  • Fix pack 3: Improvements to the administration of IBM Content Manager by using IBM Content Navigator:
    • Query performance monitoring trace options for the library server configuration.
    • Ability to save the logging configuration for the resource manager and the library server.
    • Support for item type subsets.
  • Fix pack 2: You can update text indexes in the Java system administration client and the administration client using IBM Content Navigator. Use this feature only if the text search index update has failed and you need to capture the error for diagnostic evaluation.
  • Fix pack 2: The administration using IBM Content Navigator supports the new character length checking features that were added in fix pack 1.
  • Fix pack 2: When setting up a cloud storage volume in the Java system administration client, the Path property is now labeled Region. For more information, see Path or Region.
  • Fix pack 1: Improvements to administration of IBM Content Manager by using IBM Content Navigator:
    • Support for the retrieve token duration for an item type relation. The document management tab of an item type includes the token duration column. Creating or modifying an item type relation includes the field for retrieve token duration.
    • Support for the Webhooks integration type defined for an item type event subscription.
    • The last logon time is displayed when a user logs onto a desktop. The last logon time and the number of retries is available in the general settings for a user.

Cloud storage

  • Fix pack 4: The resource manager supports other cloud object storage servers that comply with Amazon S3 API. For more information, see Configuring cloud storage volumes.
  • Fix pack 2: The resource manager supports IBM Cloud Object Storage (ICOS) with object lock enabled as cloud storage. For more information, see Configuring cloud storage volumes.
  • Fix pack 2: The resource manager supports Hitachi Content Platform for Cloud Scale (HCP for cloud scale) with object lock enabled as cloud storage. For more information, see Configuring cloud storage volumes.
  • Fix pack 1: The resource manager supports Hitachi Content Platform for Cloud Scale (HCP for cloud scale) and Dell EMC Elastic Cloud Storage (Dell EMC ECS) as cloud storage. For more information, see Configuring cloud storage volumes.
  • Fix pack 1: The resource manager supports deleting objects by version ID from cloud object storage servers. For more information, see the COS_ALWAYS_USE_NON_VERSIONED_DELETE parameter in the RMCONFIGURATION table.
  • Fix pack 1: The resource manager supports multiple part upload to non-retention cloud object storage server buckets. This feature enables you to upload objects that are bigger than the maximum size that is allowed in a single request. For more information, see these parameters in the RMCONFIGURATION table:
  • Fix pack 1: The resource manager supports virtual hosted-style URL access type hostnames for cloud object storage servers. To use this feature, select Enable virtual hosted-style requests in the resource manager server definition. For more information, see Enable virtual hosted-style requests.

REST Services

Web Services

Resource manager Enterprise Edition

  • Fix pack 4: The resource manager now uses IBMJCEPlusFIPS cryptographic provider. In earlier releases, the resource manager used IBMJCEFIPS provider. The IBMJCEPlusFIPS provider supersedes the IBMJCEFIPS provider.
  • Fix pack 4: The resource manager includes the following new parameters:
    JMS_TOPIC_PUBLISHER_FIRST_CONNECT_MAX_WAIT_TIME
    Specifies the maximum time to wait and retry to connect to the JMS server before giving up when publishing an event for the first time connection when the resource manager starts. For more information, see JMS_TOPIC_PUBLISHER_FIRST_CONNECT_MAX_WAIT_TIME.
    LDAP_AUTO_SET_TRUSTSTORE_TO_CACERTS
    Specifies whether the resource manager automatically sets the Java trust store to the Java's cacerts file when using the resource manager for SSL communication with the LDAP server. For more information, see LDAP_AUTO_SET_TRUSTSTORE_TO_CACERTS.
  • Fix pack 4: You can build and run a container image for the resource manager application. You can run the image in either a standalone container or a container cluster. For more information, see https://www.ibm.com/support/pages/node/7168358.
  • Fix pack 3: You can run the resource manager application in WebSphere Liberty. For more information, see Running the resource manager application in IBM WebSphere Liberty.
  • Fix pack 2: The resource manager administrator password can now be changed only in the Resource Manager Properties dialog in the system administration client.

    In earlier releases, you had to first change the Password field in the resource manager server definition; in fix pack 2 and later, that field is disabled.

  • Fix pack 2: The resource manager (Enterprise Edition) includes the following new parameters:
    JMS_TOPIC_SUBSCRIBER_CONNECT_MAX_WAIT_TIME
    Specifies the maximum time to wait to reconnect to JMS when there is a JMS connection issue.
    REPLICATOR_SKIP_IMPORT_REPLICA_ON_ERROR
    Specifies whether to omit the import replica step in the current replication cycle when an error occurs in import replica to the library server.
    RUN_SERVICE_CONTROLLERS_ON_NONMANAGED_THREADS
    Specifies whether controller threads of resource manager background services are run on a non-managed thread, so that they are not reported as "hung" in the WebSphere Application Server SystemOut.log file when they run for a long time.
    VAL_USE_TRUNCATE_TO_CLEAR_VU_TABLES
    Specifies whether to use TRUNCATE to clear the two validation utility tables, RMLSITEMS and RMVALREPORT.

    For more information about these parameters, see RMCONFIGURATION.

Other features

  • Fix pack 4: Support for Minimum TLS 1.3. For more information, see Configuring Transport Layer Security for IBM Content Manager.
  • Fix pack 4: If you integrate IBM Content Manager with Microsoft Active Directory, you can make LDAP authentication over SSL and TLS more secure by using channel binding: set the LdapEnforceChannelBinding registry entry. For more information, see Enabling Secure Sockets Layer (SSL) and Transport Layer (TLS) for LDAP server communication.
  • Fix pack 3: You can now generate a response file for configuring silently by using the command line instead of the user interface, and you can do this on a different computer from the one that you are configuring. For more information, see Silent installation and configuration for Content Manager Enterprise Edition.
  • Fix pack 3: The maximum number of user-defined attributes and system-defined attributes for a component is 415. Earlier versions of IBM Content Manager support only 250 attributes for a component. If you want to uninstall fix pack 3, you must delete the items from the item types which have one or more component types with more than 250 attributes, and then delete these item types. You can then uninstall fix pack 3.

    z/OS: To identify the excess attributes, use the following query:

    select keywordname, keywordcode from icmstnlskeywords c where keywordclass=2
      and languagecode='ENU' 
      and exists(select 1 from (select itemtypeid from (select componenttypeid,
        count(attributeid) attr_number from icmstcompattrs
    group by componenttypeid having count(*) > 250) a, icmstcompdefs b
    where a.componenttypeid=b.componenttypeid) d where c.keywordcode=d.itemtypeid);

    If you try to uninstall fix pack 3 when any component type has more than 250 attributes, the uninstallation fails; the uninstallation log contains messages similar to the following one:

    com.ibm.cm.dbutil.ICMDBUtilsException: Failed to valid the attribute number for item types.
    The following item types have one or more component types which have more than 250 attributes. You cannot uninstall Content Manager to 8.7.00.100
    before you delete these item types.
    S_with251Attrs(id: 1161)
    S_with415Attrs(id: 1163)
  • Fix pack 3: Additional support for TLS 1.3:
    • Db2 text search fetching content from the resource manager
    • Library server communication to LDAP servers by using the LDAP user exit
    • Resource manager communication with LDAP servers
    • System administration client communication with LDAP servers
    • REST Services
    • Web Services

    For more information, see Configuring Transport Layer Security for IBM Content Manager.

  • Fix pack 2: Support for TLS 1.3. For more information, see Configuring Transport Layer Security for IBM Content Manager.
  • Fix pack 2: This release includes two new trace points to monitor the performance of user XQPE queries. For more information, see Query performance monitoring and data capture.
  • Fix pack 1: IBM Content Manager checks the length of values that you specify for string attributes. In the API and the system administration client, you can specify:
    • the maximum number of characters for character attributes that are associated with an item type
    • the minimum and maximum number of characters for variable character attributes that are associated with an item type.
    When you add or update an item type, the API checks that:
    • character and variable character attribute values do not have more than the maximum number of characters that is specified in the attribute definition for that item type
    • variable character attribute values have at least the minimum number characters that is specified in the attribute definition for that item type.

    For more information, see Adding attributes and attribute groups to the item type.

  • Fix pack 1: Improvements in handling LDAP user exits:
  • Fix pack 1: Additional information in the update event for update content: The library server generates more information for the update event type when a part is added, updated or deleted from a document, or the content of a resource item is updated. The event monitor passes this information in the update event.

    To get this information, use the CMBEMCMEvent.getCONTENTCHG method in the event handler toolkit API.

    The payload for event monitor webhooks contains additional content change information: The text format for UPDATE contains (CONTENTCHG=T|F), and the JSON UPDATE format contains ("cmevent_content_change":TRUE | FALSE). For more information, see Format of the payload for event monitor webhooks.

  • Fix pack 1: The Configuration Manager now displays running processes that have files locked, so that you can stop them before continuing with configuration.

Included software updates

IBM Content Manager Version 8.7 Fix Pack 4 includes the following updated software:

  • IBM Semeru Runtime Open Edition 17.0.12.0
  • IBM Global Security Toolkit (GS Kit) 8.0.60.1
  • IBM Data Server Driver for JDBC 4.33.31 (11.5.9.0) (no change from fix pack 3)

Supported software and operating systems

  • Fix pack 4: Support for Db2 12 added
  • Fix pack 4: Support for Windows, AIX, and zLinux for resource manager running on Liberty
  • Fix pack 4: Support for Windows, AIX, and zLinux for web services running on Liberty
  • Fix pack 4: Support for REST and Web Services on Liberty using Java 21
  • Fix pack 3: Support for Red Hat Enterprise Linux (RHEL) Server versions 9
  • Fix pack 1: Windows Server 2022
  • Fix pack 1: AIX 7.3

Behavior changes

IBM Content Manager Version 8.7 fix packs include the following behavior changes.

Fix pack 4: Configuration user interface is not supported on SUSE Linux 12

The configuration user interface is not supported on SUSE Linux 12. For more information, see Known problems, restrictions, and solutions.

Fix pack 4: The Threshold cycle has been removed from the Cycles tab

The Threshold cycle has been removed from the Cycles tab in the resource manager application configuration in the system administration client. There is no change in how threshold migration works in the resource manager application.

In earlier versions of IBM Content Manager, you could set the threshold cycle in the system administration client, but it was not used. The actual threshold cycle in the resource manager application uses the migrator cycle that is set in the Migrator section of the Cycles tab.

Fix pack 4: The Outside In viewer engine (CMBOutsideInViewerEngine) is deprecated

The Outside In export engine is still supported.

Fix pack 4: If you try to update a decimal attribute to a value that is out of range, an error is returned.

Fix pack 4: GSKit is no longer installed when using Db2

GSKit is no longer installed by IBM Content Manager when using Db2. It will be removed if it was installed by an earlier version. IBM Content Manager must always use the version of GSKit that is shipped with Db2.

For IBM Content Manager on Oracle, GSKit is still installed.

Fix pack 3: REST Services requires WebSphere Application to use Java version 8.0.7 or above

Fix pack 3: Running multiple components in one application server

Running multiple components (resource manager, REST Services, or Web services) in one application server and running components with other applications is deprecated.

Fix pack 3: Configuring the resource manager application component requires successful connection to the resource manager database and library server database

To configure the resource manager application component, the configuration program must be able to connect to the resource manager database and the library server database.

If an error occurs when the configuration program tries to connect to the databases, the configuration fails. You must correct the error, and then run the configuration program again.

In earlier releases, if the configuration program could not connect to the databases, it put an error message in its log file, and then continued with the configuration; if no other errors occurred, the configuration was shown as successful.

Fix pack 2: Validating variable character attributes

During item type creation, the IBM Content Manager API and the system administration client check variable character attributes added to an item type where the minimum number of characters is greater than zero and the maximum number of characters is greater than zero and the minimum number of characters is less than or equal to the maximum number of characters. Earlier versions did not perform this checking.

Fix pack 2: Generic Web Services is deprecated

Generic Web Services is based on JAX-RPC, which has been removed from the Java EE standard starting with version 6. JAX-RPC is not available in WebSphere Liberty. For more information about generic and specific web services, see Comparison of the IBM Content Manager web service interfaces.

Fix pack 2: Resource manager administrator password

  • The logon process requires that the system administration client can connect to the resource manager, and the resource manager can connect to the library server database.

    In earlier releases, the logon process required only that the system administration client could connect to the resource manager; the resource manager did not have to connect to the library server database.

  • Changing the resource manager administrator password in the Resource Manager Properties in the system administration client now requires that the system administration client can connect to the resource manager, and the resource manager can connect to the library server database.

    In earlier releases, changing the password did not require the system administration client to connect to the resource manager, or the resource manager to connect to the library server database.

  • When you change the password in the Resource Manager Properties window, the password must comply with the password rules.

    In earlier releases, IBM Content Manager checked whether the password complied with the password rules when you changed it in the resource manager server definition. The password field for the resource manager server definition is now disabled.

Fix pack 1: log4j jar files: Change of name

In fix pack 1 and later, the names of the log4j .jar files do not include the version numbers. For example, the log4j-api-2.17.1.jar file in V8.7 is now called log4j-api.jar; the new file is version 2.18.0, but this does not appear in its filename. This means that the application class path does not have to change every time that the .jar files are updated.

Fix pack 1: Cloud object storage: Deleting object versions when versioning is enabled

In fix pack 1 and later, if versioning is enabled, object versions are deleted from the COS server when they are deleted from IBM Content Manager.

In IBM Content Manager V8.7 GA, object versions were deleted from only Amazon S3 with object lock enabled. For other types of COS server buckets or containers, object versions were not deleted from the COS server when they were deleted from IBM Content Manager.

For more information, see Configuring cloud storage volumes.

Fix list (APARs)

The fix list contains all APARs that are fixed in IBM Content Manager Version 8.7 Fix Pack 4.

Important: For some APARs, such as security-related APARs, information about that APAR is not made available to customers to avoid compromising customer and product security.
Table 2. Fix list for IBM Content Manager Version 8.7 Fix Pack 4
APAR Shipped in Description
Connectors
IO29314 Fix pack 3 Special characters not handled properly in Db2 text search queries
IO29246 Fix pack 2 Parsing error when the shared database connection ID password has a parenthesis, which causes the datastore connection to fail.
IO29152 Fix pack 2 Error when trying to connect to the resource manager with System Administration after installing Content Manager version 8.7 or upgrading to version 8.7 on Linux.
IO29230 Fix pack 2 ICMEventLaunch.sh on UNIX uses javaw, which does not exist in the installed JDK.
IO28869 Fix pack 1 Event monitor table purge process ArrayIndexOutOfBoundsException exception.
IO28921 Fix pack 1 Query with a lot of views run slower after upgrade from Content Manager V8.5 to V8.6.
IO28948 Fix pack 1 Query case-insensitive search has poor performance for LIKE operator on z/OS library server.
IO28999 Fix pack 1 DKLobICM.getOrgFileName() return null after part content retrieve if pound in library server original file name.
IO29025 Fix pack 1 Content retrieval fails when content-length is not set when chunk transfer is enabled.
Install and upgrade
IO29466 Fix pack 4 IBM Content Manager version 8.7 should not install Visual C++ 2013 Redistributable Package.
IO29312 Fix pack 3 Configuration fails if the password includes ! (exclamation mark).
Library Server Enterprise Edition
IO29452 Fix pack 4 After upgrading to IBM Content Manager V8.7.0.3, LDAP user exit authentication returns error 81 when using non-default port for non-SSL connection.
IO29327 Fix pack 3 Some LDAP users imported with the import scheduler cannot be authenticated anymore.
IO29295 Fix pack 3 Max duration of the retention automatic deletion service is checked incorrectly.
IO29335 Fix pack 3 The usage statistic task/job failed execution with the database error rows not found.
IO29435 Fix pack 3 Systemflag3 bit 3 failed to keep CREATETS for new version after upgrading to version 8.7.
PH56877 Fix pack 3 Library server unconditionally logs data entries when event subscription is used.
IO29155 Fix pack 2 Missed removing normal folder links when deleting an item which is in autofolder and normal folders.
IO28670 Fix pack 1 Routing an item yields Db2 error SQL0911 deadlock after upgrading Db2 version.
IO28960 Fix pack 1 Unable to reactivate Net Search Extender after activating Db2 Text Search.
Library Server for z/OS
PH56877 Fix pack 3 Library Server unconditionally logs data entries when event subscription is used.
PH51610 Fix pack 2 Logon intermittently crashes after upgrading to Content Manager V8.7.
PH51714 Fix pack 2 Logon returns SQL error SQL-450 after upgrading to Content Manager V8.7.0.1.
PH49975 Fix pack 1 Command cmcfglsi -t comptypes against Unicode Library Server version 8.7 fails with error "invalid parameter".
Resource Manager Enterprise Edition
IO29168 Fix pack 2 Error when store to resource manager after update IBM Java in WebSphere Application Server to V8.0.7.20 or later.
IO29201 Fix pack 2 Error ICM9661 is returned when resource manager is configured to use IBM Cloud Object Storage (COS) V3.17.2 or later server buckets that have retention protection disabled.
IO28982 Fix pack 1 Cannot retrieve object from Spectrum Protect Server after an update if the object was missing in Spectrum Protect server before the update.
Resource Manager for z/OS
PH48591 Fix pack 1 CM RM returns secondary OAM reason code upon store error instead of primary.
PH50935 Fix pack 1 CM RM HEAP damage.
REST Services
IO29450 Fix pack 4 DGL5065A error updating a time/timestamp attribute using CM 8.7 FP3 REST APIs
System Administration Client
IO29434 Fix pack 4 Using "Directly to another server" option to export an item type with varChar attribute from CM86 to CM87FP1 (start to enable min/max length for string) encounters DGL0818A string type has no constraint error.
IO28867 Fix pack 1 LDAP import utility doesn't add users to the last group when empty groups exist in LDAP server.
Viewer
IO28814 Fix pack 1 The CMBCMAnnotationEngine cannot load an annotation set with a text annotation without a GAD tag.
IO28823 Fix pack 1 CMBSnowbound document engine write not saving annotation set after page manipulation.
IO28689 Fix pack 1 The system administration web client feature cannot display the list of item types.
Web services
IO29137 Fix pack 2 Web services truncate base64-encoded stream at the first linefeed character when storing documents on Linux.
IO29199 Fix pack 2 CMBGetPIDUrl returns "$lt;" instead of "<" in XML responses.
IO28736 Fix pack 1 Upgrade web services changes properties to default.

Copyright and trademark information

IBM, the IBM logo, and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at http://www.ibm.com/legal/copytrade.shtml.

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.