Cumulative Fix Health Checker

These instructions are for the HCL WebSphere Portal Combined Cumulative Fix Health Checker.

To assist you with your upgrade, HCL is now providing a Health Checker tool that we can use to validate the 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 we need to resolve before installing the update. The tool can't catch everything, but it scans for some of the most common pitfalls and will help to ensure a smoother upgrade experience.

We suggest running the tool a few days before you plan to apply the cumulative fix so that we have time to reconcile any problems it finds. The tool will be installed with Cumulative Fix 03 or later and will be available for use with all future updates. To use it before applying CF03, simply unzip the archive from the maintenance package into your (PortalServer_root) directory. By default, this is:

• Windows: C:\IBM\WebSphere\PortalServer
• Unix/Linux: /opt/IBM/WebSphere/PortalServer
• IBM i: /QIBM/ProdData/WebSphere/PortalServer/V85/Server

This will overwrite two or possibly three existing files:

• installer/wp.config/bin/wp.config.jar
• installer/wp.update/config/includes/upgrade_health_check.xml
• installer/wp.update/config/was/wp_TestPortalScripting.jacl

Once the tool is installed, execute the following ConfigEngine command from within the path of the profile to run it:

<profile_root>/ConfigEngine/ConfigEngine.sh health-check-update -DPortalAdminPwd=<password> -DWasPassword=<password>

We can run this tool safely on any system that you plan to update. It is designed not to make any changes to the environment or to interfere with any running processes.

After the command completes, we will find an output report in the ConfigEngine/log directory named HealthCheck-.log. A new report with a new timestamp will be generated every time we run the tool. If the tool found any conditions that would interfere with a successful update, they will be described in the report. You should remediate these problems and re-run the tool until you get a clean report before applying the cumulative fix.

Parent topic: Combined Cumulative Fix (CF) strategy