IBM Support

Rational Change Fix Pack 5 ( for 5.3.2


Release Date

30 September 2022


IBM Rational Change has been made generally available and contains new features as well as fixes for client-reported and internally found defects.

Download Description

Table of Contents
Sections Description

The Change history section provides an overview on what is new in this release with a description of any new functions or enhancements when applicable.

This section provides information related to the impact of this release to allow you to assess how your environment may be affected.

This section provides important information to review prior to the installation of this release.

This section provides the direct link to obtain the download package for installation in your environment.

This section provides the installation instructions necessary to apply this release into your environment.

The Known side effects section contains a link to the known problems (open defects) identified at the time of this release.

Supporting Documentation
Document Description

Click to review the detailed system requirements information for a complete list of hardware requirements, supported operating systems, prerequisites and optional supported software, with component-level details and operating system restrictions.

The information center provides you with user assistance for the product. You can view, browse, and search online information related to the product. You can also visit IBM Product information page to browse for additional information centers.

Click to review a complete list of the defects (APARs) resolved in this release including a list of resolved defects for the entire version family.


Prerequisites include:

Rational Synergy

Rational License Key Server 8.1.1 or any later versions

Rational Directory Server (Apache) or Rational Directory Server 5.2.1 (Tivoli)

A supported application server (or use the bundled one) on the server machine.

A supported browser on each of the client machines.

Installation Instructions

Where to Apply this Fix Pack
Apply this Fix Pack to all Change installation (CHANGE_HOME), clients and cache servers. 
Installation instructions
  1. Log in to the machine where Rational Change is installed as the user who installed Rational Change.
  2. Unzip (Windows) or untar (UNIX) the patch file into <CHANGE_APP_HOME>/WEB-INF/packages. The resultant directory will have the name rc<patch version>. 
        For example, on UNIX:
            $ cd <CHANGE_APP_HOME>/WEB-INF/packages
            $ tar xvf <file path>
  3. Install the Fix Pack:
    Login to Rational Change Admin interface and click the System Administration link in the action panel.
    Click the Package Installer tab, select this Fix Pack from the Available Packages list box, and click the Install button.
  4. Copy the attached Fix Pack file "log4j2.xml" (for the relevant platform) from "" into the path <CHANGE_APP_HOME>/WEB-INF/classes/    
    Note: If context path is other than "change" while installation of Rational Change, then set the "event.log" and "velocity.log" path accordingly in "log4j2.xml".        
    For example: 
        <Property name="eventfile">../webapps/<context path>/logs/event.log</Property>
        <Property name="velocityfile">../webapps/<context path>/logs/velocity.log</Property>
  5. After the patch installation is successful, stop and re-start Rational Change.
  6. To upgrade Jetty version 9.4.48 in Rational Change, refer the document "".
  7. A Perl upgrade was delivered in Fix Pack If the Perl upgrade has not yet been installed then download and apply the Perl upgrade with Fix Pack the Perl upgrade and installation instructions here:
  • Follow the given steps for the below APAR’s
APAR ID Description Steps to be followed
  1. Stop Rational Change instance
  2. Backup the file “ECP_template” in $CHANGE_HOME\WEB-INF\package_templates\ECP_template\wsconfig\
  3. Copy the file “ECP_template” from $CHANGE_HOME\WEB_INF\packages\rc5.3.2.5\package_templates\ECP_template\wsconfig\ECP_template to$CHANGE_HOME\WEB-INF\package_templates\ECP_template\wsconfig\
  4. Start Rational Change.
  5. Add Privilege in the ECP process and save the package.
  6. Install the newly created package.
  1. Install the Fixpack 5325.
  2. Uninstall the already installed ECP process or any process installed.
  3. Edit the ECP process in lifecycle editor, Save the ECP_Process and create package.
  4. Install the newly created ECP process from package installer.
  5. While submitting/editing the CR, verify the insert timestamp in IE.
  • CR Specific Help on Change user page.
User CR Process Specific Help file content will be updated only after installing a process in the Rational Change Admin interface. After installing the Fix Pack, rebuild and install the current process package to generate the Process Specific Help. After doing so, if the Process Specific Help is not updated in the user's browser it is advised to clear browser cache.
Reversing the Fix Pack
If it is necessary to remove the Fix Pack after it was installed, perform the following:
  1. Login to Rational Change as Admin and click the System Administration link in the action panel.
  2. Uninstall the Fix Pack:
    Click the Package Installer tab, select the Fix Pack from the Installed Packages list box, and click the Uninstall button.
  3. If you are reverting the installation to 5.3.2 or, you must configure Rational Change to use RDS for authentication.
    If LDAP is configured in the file ../WEB-INF/wsconfig/pt.cfg, then update value to false.
  4. Stop and start Rational Change.

[{"INLabel":"Installing Rational Change","INLang":"English","INSize":"1","INURL":""}]

Download Package

Download options
Click the link in the Download Options column:
Download Options


English FC

How critical is this fix?

Impact Assessment
Impact Description

This is a service release of Rational Change. It contains new features as well as fixes for client-reported and internally found defects.

Test Results


Regression: An error in the Maintenance Delivery Vehicle (MDV) that produces incorrect or unexpected behavior causing a supported feature to stop functioning as designed.
This includes:

  • Coding errors that cause a regression
  • Documentation or packaging problems that cause a regression
  • Errors reported in a new function delivered in a MDV that cause a regression

Incomplete: An error in the MDV has not regressed, but does not work as designed.
This includes:

  • Fixed APARs which did not solve the original problem but did not break anything new
  • APARs reporting documentation errors, such as readme errors, that cause problems applying an MDV but do not lead to a regression

  • Regression and incomplete APARs are considered fix-in-error or MDV-in-error
  • Definitions above apply only to valid APARs that result in product fixes (APARs returned as working-as-designed are not assessed for being fix-in-error)
  • Issues in major releases due to new functionality do not apply in this definition

There are no known issues to report.

Problems Solved

Click the Fix List link in the table of contents above to review a list of the problems solved in this release.

Known Side Effects

The following defects were not resolved in this release:

Important known problems new to version 5.3.1 are described below. Review the known problems from previous release, as they may still be applicable.

Review the following list of open defects.

Change History

What's new
  • Jetty is upgraded to 9.4.48 in RATIONAL CHANGE
  • Log4j upgraded to 2.17.2 in RATIONAL CHANGE
  • AIX 7.3 support
Rational Change 5.3.2 which comes bundled with Japanese and Chinese language packs includes the following enhancements:

Dynamic required attribute
The dynamic required attributes feature allows users to mark some of the attributes to be required dynamically when a particular value is selected for another attribute.

Treating numeric fields as integers
Treating numeric fields as integers allows CCM_NUMBER attribute types to be set as integers. They can hold only integer values and users can query on them using mathematical operators. This can be used for queries which need to filter and sort based on criteria.

Database specific Home Pages
Database specific Home Pages allows the users to manage their home page content that is relevant to the database that they log in to.
Replatform of the following O/S and S/W upgrades
Operating System Upgrades:
  • Windows Server 2012 (32-bit and 64-bit) Standard and Above.
  • Windows Server 2016 (32-bit and 64-bit) Standard and Above.
  • Red Hat® Enterprise Linux Server 6.10 and 7.6 (32-bit or 64-bit)
  • SUSE® Linux Enterprise Server 12 SP4
  • AIX 7.2 TL4
Software Upgrades:
  • Jetty is upgraded to version 9.4.14
  • IBM Java and JRE is upgraded to 8.0 
Change-Plugin integration
Synergy and Change Integrations Eclipse Visual Studio Rational Doors PowerBuilder Rational Team Concert
Change 5.3.1 N/A* N/A* 9.5, 9.5.1
9.5.2, 9.6
Change 5.3.2 N/A* N/A* Deferred N/A N/A
DOORS-Change integration is developed by Persistent and supported by IBM (DOORS Support Team)
N/A* : We are not directly integrating Change alone with Eclipse/Visual Studio, But ‘Change view’ is tested in Eclipse/Visual Studio.
N/A : Not Applicable
Other Enhancements
  • Collapsible and expandable home page reports
  • Cryptographic functionality is enhanced to meet “NIST SP800-131a” standards.
  • Documentation updates for installation in a Windows secure environment
  • Documentation updates on security rules for lifecycle customization
  • Rational Change now has Jetty 8.1.3 embedded.
  • Upgraded dojo version to 1.8.4 and Birt version to 4.1.2
  • Supports browser versions IE 10 and FF 17
  • Redesigned user interface URLs and action links - user tokens are no longer displayed.

Below are some of the new Prerequisite:
For Windows
  • Obtain the required licenses.
  • JRE 1.8 should be installed and it should be in the system path.
  • By default, Rational Change is installed in English.
  • To install the software in a language other than English:
  1. From IBM Fix Central, download one of the available language packages ( file).
  2. Copy the file to the change\windows directory.
  3. Ensure that you have set the system locale to support the language package installation. If the system locale is not set, the dialog boxes might not show the proper characters.
For Linux
  • Obtain the required licenses.
  • JRE 1.8 should be installed.
  • By default, Rational Change is installed in English. To install the software in a language other than English:
  1. From IBM Fix Central, download one of the available language packages (a .zip file).
  2. Copy the file to the change\windows directory.
  3. Ensure that you have set the system locale to support the language package installation. If the system locale is not set, the dialog boxes might not show the proper characters.
  • export IBM_JAVA_OPTIONS=-Djdk.crypto.KeyAgreement.legacyKDF=true
  • Add below entries in cd /etc/pam.d/cmsynergy
    auth required 
    auth include system-auth 
    account include system-auth

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSYQQ2","label":"Rational Change"},"ARM Category":[{"code":"a8m0z000000bm3vAAA","label":"Change"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Version(s)","Line of Business":{"code":"LOB45","label":"Automation"}}]

Problems (APARS) fixed

Document Information

Modified date:
07 March 2023