IBM Support

Rational Change Fix Pack 6 (5.3.2.6) for 5.3.2

Download


Release Date

31 July 2023

Abstract

IBM Rational Change 5.3.2.6 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

Prerequisites include:

Rational Synergy 7.2.2.6

Rational License Key Server 8.1.1 or any later versions

Rational Directory Server 5.1.1.2 (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.

Back to top

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. After the patch installation is successful, stop and re-start Rational Change.
  5. To upgrade Jetty version 9.4.51 in Rational Change, refer the document "How_to_upgrade_Jetty.zip".
  6. To Configure Log4j2 in Rational Change ,refer the document “Log4j2_Configure.zip”.
  7. A Perl upgrade was delivered in Fix Pack 5.3.2.4. If the Perl upgrade has not yet been installed then download Perl_upgrade_5.16.1.zip and apply the Perl upgrade with Fix Pack 5.3.2.6.Download the Perl upgrade and installation instructions here: https://ak-delivery04-mul.dhe.ibm.com/sar/CMA/RAA/0a5vc/1/Perl_upgrade_5.16.1.zip
Note: 
  • Follow the given steps for the below APAR’s
APAR ID Description Steps to be followed
PH30617 ANY PRIVILEGE ADDED TO ECP_PROCESS WILL NOT BE AVAILABLE UNDER
RATIONAL CHANGE USER MANAGEMENT
  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.6\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.
PH09743 THE 'INSERT NAME AND TIMESTAMP' BUTTON IN RATIONAL CHANGE ECP ENTERS DATA TO WRONG LOCATION WHEN USING INTERNET EXPLORER 11"
  1. Install the Rational Change Fix pack 5.3.2.6.
  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.
PH49560 RATIONAL CHANGE 5.3.2.4 - ENHANCED EDIT FIELD: CURSOR IS PLACED AT START OF TEXT
Please refer the document “PH49560_manual_fix.zip”.
  • 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 5.3.2.1, you must configure Rational Change to use RDS for authentication.
    Example:
    If LDAP is configured in the file ../WEB-INF/wsconfig/pt.cfg, then update value to false.
    [CCM_SYSTEM] [LDAP_ENABLED] false[/LDAP_ENABLED] [/CCM_SYSTEM]
  4. Stop and start Rational Change.

Back to top

[{"INLabel":"Installing Rational Change","INLang":"English","INSize":"1","INURL":"http://www.ibm.com/support/knowledgecenter/SSYQQ2_5.3.1/com.ibm.rational.change.install.doc/topics/ch_c_ig_install_change.html"}]

Download Package

Download options
Click the link in the Download Options column:
Download RELEASE DATE LANGUAGE
Download Options
  • Rational Change 5.3.2.6 downloads and fixes

31-JULY-2023

 English FC

Back to top

How critical is this fix?

Impact Assessment
Impact Description

Recommended

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

Close [x]

Definitions

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

Notes:
  • 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.

Back to top

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.
Known Issues in Rational Change 5.3.2.6 on Linux platform

Known Issue
Problem/Workaround
User profile page not showing Fax, Phone, and email address on the user login page. Not Available
In Central Server Mode Change installation, on submitting the CR, secondary DB ID may be selected in the CR details. Select the Central DB and change back to the DB where you are submitting CR from the right-side drop-down of Change user page.
Deleting a Project under User management shows message undefined. Not Available
Able to configure the same AD/ADS as Primary and Secondary server. No duplicate entry for Primary and Secondary LDAP server supported.
IE browser is not supporting for CR specific Help. Please use Chrome, Edge, or Firefox browser to check CR specific Help.
‘LOG DEBUG MESSAGE’ Checkbox setting does not persist or work in Rational Change in Linux platform. Modify the following line in $CHANGE_HOME/jetty/webapps/change/WEB-INF/classes/log4j2.xml
from:
    <Root level="info" additivity="false">
to:
    <Root level="debug" additivity="false">
Then load the configuration data in the Change Admin interface under the System Administration > General tab.
Alternatively, log out and back into the Change Admin interface.

Known Issues in Rational Change 5.3.2.6 on Windows platform

Known Issue
Problem/Workaround
User profile page not showing Fax, Phone, and email address on the user login page. Not Available
In Central Server Mode Change installation, on submitting the CR, secondary DB ID may be selected in the CR details. Select the Central DB and change back to the DB where you are submitting CR from the right-side drop-down of Change user page.
Deleting a Project under User management shows message undefined. Not Available
Able to configure the same AD/ADS as Primary and Secondary server. No duplicate entry for Primary and Secondary LDAP server supported.
IE browser is not supporting for CR specific Help. Please use Chrome, Edge, or Firefox browser to check CR specific Help.
‘LOG DEBUG MESSAGE’ Checkbox setting does not persist or work in Rational Change in Windows platform. Modify the following line in $CHANGE_HOME/jetty/webapps/change/WEB-INF/classes/log4j2.xml
from:
    <Root level="info" additivity="false">
to:
    <Root level="debug" additivity="false">
Then load the configuration data in the Change Admin interface under the System Administration > General tab.
Alternatively, log out and back into the Change Admin interface.

Known Issues in Rational Change 5.3.2.6 on AIX platform

Known Issue
Problem/Workaround
User profile page not showing Fax, Phone, and email address on the user login page. Not Available
In Central Server Mode Change installation, on submitting the CR, secondary DB ID may be selected in the CR details. Select the Central DB and change back to the DB where you are submitting CR from the right-side drop-down of Change user page.
Deleting a Project under User management shows message undefined. Not Available
Able to configure the same AD/ADS as Primary and Secondary server. No duplicate entry for Primary and Secondary LDAP server supported.
IE browser is not supporting for CR specific Help. Please use Chrome, Edge, or Firefox browser to check CR specific Help.
‘LOG DEBUG MESSAGE’ Checkbox setting does not persist or work in Rational Change in AIX platform. Modify the following line in $CHANGE_HOME/jetty/webapps/change/WEB-INF/classes/log4j2.xml
from:
    <Root level="info" additivity="false">
to:
    <Root level="debug" additivity="false">
Then load the configuration data in the Change Admin interface under the System Administration > General tab.
Alternatively, log out and back into the Change Admin interface.

Back to top

Change History

What's new
  • Jetty is upgraded to 9.4.51 in RATIONAL CHANGE
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
9.6.1		 N/A N/A
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 (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.
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 pam_nologin.so 
    auth include system-auth 
    account include system-auth

Back to top

Off
[{"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":"LOB67","label":"IT Automation \u0026 App Modernization"}}]

Problems (APARS) fixed
PH50619;PH49560;PH49561;PH49562;PH51128;PH51541;PH53167;PH53169;PH30101

Document Information

Modified date:
26 March 2024

UID

ibm16856045

Page Feedback