Skip to content

Apply Combined Cumulative Fix

The Combined Cumulative Fix is a package of HCL Digital Experience (DX) fixes. You can only apply cumulative fixes (CF) to an existing functional version of the HCL Portal Version or an HCL Portal Version with a previous cumulative fix applied.

Applying the cumulative fix is a multi-step process. You must first update the product files using IBM Installation Manager, and then use the Portal ConfigEngine tool to apply the changes to each profile in your system. The update is not complete until you have performed both steps.

Likewise, to roll back a fix, you must first use IBM Installation Manager to restore the older product files and then use ConfigEngine to apply the rollback to each profile.

Refer to Installing the HCL Digital Experience software for more information on how to install according to your operating system.

About Version 9.5 Cumulative Fixes

Beginning with HCL DX CF219, the upgrade process is modified to include the installation of v9.5 for easier transition to DX v9.5.

Currently, the installation of DX v9.5 with a CF upgrade is optional.

To opt in and install DX v9.5, refer to the following instructions:

Note

Make sure that Installation Manager is not running when installing DX v9.5 with the CF upgrade.

  1. Provide the ConfigWizard administrator name and password values to the ConfigEngine.

    Add the following two parameters to the /ConfigEngine/properties/wkplc.properties file. 

    config.wizard.profile.name=<config_wizard_administrator_name>
config.wizard.profile.password=<config_wizard_administrator_password>

    Alternatively, you can add these parameters to the command line when running applyCF using the -D format. 

    -Dconfig.wizard.profile.name=<config_wizard_administrator_name>
-Dconfig.wizard.profile.password=<config_wizard_administrator_password>

  2. Run the applyCF script with the install_95 flag.

    • For Unix/Linux: Pass the install_95 parameter to the command to upgrade the Portal profile.

      From the /PortalServer/bin/ directory:

      install_95=true ./applyCF.sh -DPortalAdminPwd=<password> -DWasPassword=<password>

    • For Windows: Set the install_95 environment variable in the command prompt window where you will upgrade the Portal profile.

      set install_95=true

      From the /PortalServer/bin/ directory:

      applyCF.bat -DPortalAdminPwd=<password> -DWasPassword=<password>

After the v9.5 installation, your WebSphere_Portal server is at v9.5 CF219 but v9.5 UI features are not yet enabled. To enable 9.5 UI features, refer to How to enable Practitioner Studio.

To opt out and upgrade to CF219 without installing v9.5, run the applyCF script without setting the install_95 parameter.

The following video resource is for HCL DX 9.5 CF17 and higher.

Apply these instructions on an HCL DX system running either 8.5 or 9.0. CF17 is used as a prerequisite fix for users to move up to 9.5 level.

Video: HCL Digital Experience - Installing HCL DX 9.5 CF18

Note

Each release of a maintenance package is included in your HCL Digital Experience offering.

What's new

  1. To view the list of software fixes included in the HCL DX 9.5 CF and Container Update releases, visit the HCL Software Support article Fixes integrated in HCL Digital Experience 8.5.0.0, 9.0 and 9.5 Combined Cumulative Fixes.
  2. Effective in 8.5 CF08, the update and rollback processes have been streamlined for easier customer application. The previous CF instructions detailing "PRE-APPLY-FIX" and "APPLY-FIX" upgrade commands have now been integrated into the single applyCF command. Correspondingly, the rollback instructions for "PRE-ROLLBACK-FIX" and "ROLLBACK-FIX" have been integrated into the single "rollbackCF" command.
  3. To assist you with your upgrade, HCL is now providing a Health Checker tool that you can use to validate your Portal installation before applying a cumulative fix. Simply execute this tool on the target system and review the report that is generated to see if there are any issues you need to resolve before installing the update. See the Health Checker in this topic directory or the README text in the Combined Cumulative Fix ZIP file.
  4. The HCL Script Application was made available as V1.3 and earlier by the catalog. It was developed further and included with Portal Version 8.5 CF09 and later, then also renamed to "Script Application" for Portal 8.5 CF11. When customers have the old HCL Script Application catalog version 1.3 AND then install CF09 or later, the security settings need to be obtained BEFORE installing the CF. The detailed information can be found under the first optional step of the procedure in The Script Application security overview section in the 8.5 documentation.
  5. The Ephox EditLive! Java based Rich Text Editor has been deprecated as of CF11 and replaced by Textbox.io. More details about CF11 can found in CF11 topic page in the Version 8.5 documentation.
  6. Due to security vulnerabilities in the Apache Axis library (JAR file), the "axis.jar" will be removed from the HCL DX class path effective in CF12. For inquiries, go to HCL Software Support page.
  7. Portal Version 8.5 CF12 introduces support for JDK8 in conjunction with WAS 8.5.5.10. This will also require WAS iFix PI67166 on top of WAS 8.5.5.10 (scheduled for inclusion in WAS 8.5.5.11.)
  8. Support for IBM Rich Media Edition (RME) has been removed effective with HCL DX and Web Content Manager Version 8.5 CF14, and will not be supported in future releases. For more information about this IBM Rich Media Edition support lifecycle announcement, go to HCL Software Support page.
  9. Ephox EditLive! has been removed effective in Version 8.5 CF14 and is no longer supported. This change follows the steps taken above in Version 8.5 CF11 to deprecate Ephox EditLive! and replace it with Textbox.io as the new advanced rich text editor for HCL Web Content Manager. Customers that have manually installed and configured EditLive! as a Third Party editor option can continue to use EditLive! but will no longer be able to receive support and updates via HCL. Also effective with Version 8.5 CF14, the Textbox.io supports the applicable web browsers/levels.
  10. CF16 for Portal Versions 8.5 and 9.0 contain security fix PH01459 for CVE-2018-1736. It introduces a configurable white list for external hosts, which are allowed as redirects via the CategoryProfileUpdater Module. Server relative redirects are continuously working. Redirects to external hosts not specified in the white list are blocked. The white list is enabled per default, and needs to be filled in with appropriate values, if this functionality is used in your installation. For inquiries, go to HCL Software Support page.
  11. CF16 for Portal Versions 8.5 and 9.0 changes the behavior of Cumulative Fix installation related to out of the box resources to address CVE-2018-1420. Prior to CF16, access control settings of out of the box resources were reset to their out of the box access control settings, overriding potential customizations. This has been changed such that the Cumulative Fix installation leaves the access control settings at their current values. A side effect of this change is, that out of the box resources introduced in a Cumulative Fix after the initial version of Portal Version 8.5 or Version 9.0 will not receive any access control settings, if CF16 or later is installed on top of a CF level prior to introduction of an out of the box resource. In such a case the resource will not have any access control configured, and will have to be set manually to your security requirements. See the HCL Digital Experience 8.5 documentation on how to manage the access control and get an overview of initial access control settings.

HCLSoftware U learning materials

For an introduction and a demo on how to upgrade your HCL Digital Experience deployment to the latest Cumulative Fix, go to Upgrade the HCL Digital Experience software.

Related information