IBM Support

Rational Change Fix Pack 4 (5.3.0.4) for 5.3

Download


Abstract

IBM Rational Change 5.3.0.4 has been made generally available and contains fixes to version 5.3 including all predecessor fix packs.

Download Description

Table of Contents
Sections Description
This section provides an overview on what is new in this release with a description of any new functionality 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.
This section contains a link to the known problems (open defects) identified at the time of this release.
Supporting Documentation
Document Description
Click the link to navigate to the system requirement report page. To run the report, select your Product, Version and Operating System. 
Note: Choose the parent version of your product to see the system requirements for fix pack releases.
Click to browse for the version of your product information center available on the product information library page.
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

Rational Change 5.3.
Rational Synergy 7.2.0.3


Note: This Synergy Fix Pack is shipping a new JRE. If Rational Change is configured in HTTPs mode, then its SSL certificates will be lost. To overcome this, please refer to How to retain SSL certificates of Rational Change.
Rational Synergy Fix Pack 7.2.0.3 is a must requirement for the OSLC related fixes to work.

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. Installing the fix pack 5.3.0.4

  • Login to Rational Change as Admin, and click the "System Administration" link in the action panel.
  • Click on the "Package Installer" tab, select this fix pack from the "Available Packages" listbox, and click the "Install" button.
  • Follow the below manual steps which are needed for some of the fixes to work.
    a. The 'services' directory delivered with the fix pack is not automatically installed. For this, first take a manual backup of the file <CHANGE_APP_HOME>/WEB-INF/services/ChangeService/META-INF/ChangeService.wsdl and then replace it with the file 'services/ChangeService/META-INF/ChangeService.wsdl' from the fix Pack.
    b. If Change is installed on Tomcat and when there is a directory in the Change installation path which is same as the context, then manually copy file 'Rational_Change.5.3.FP0.4.fxtag' from the fix pack under '/properties/version' directory into <CHANGE_INSTALLED_DIRECTORY>/properties/version.
    c.The "license_api" directory delivered with the fix pack is not automatically installed. This needs to be copied manually. Follow the instruction given below to install the license library

    • 1. Take a backup of 2 directories '32bit' and '64bit' from “/WEB-INF/lib” through cut and paste.
    2. From "license_api/<platform>" directory, copy both '32bit' and '64bit' sub-directories and paste them into "/WEB-INF/lib" path.
  • After the patch installation is successful, stop and re-start Rational Change.

4. Installing the language packs
From the unzipped Rational Change 5.3.0.4 (in step 2), unzip the relevant language pack .zip file.
  • Copy the "change_<locale>" directory to <CHANGE_APP_HOME>/WEB-INF/packages and the contents from "package_templates" directory to <CHANGE_APP_HOME>/WEB-INF/package_templates.
  • Login to Rational Change as Admin, and click the "System Administration" link in the action panel.
  • Click on the "Package Installer" tab, select the language pack from the "Available Packages" listbox, and click the "Install" button.
  • Click the "Lifecycle Editor" link in the action panel and regenerate the required locale specific process package and install it.

5. Uninstalling the fix pack and the language pack:
If it is necessary to remove the fix pack and language pack after it was installed, follow these steps.
  • Login to Rational Change as Admin, and click the "System Administration" link in the action panel.
  • Uninstall the fix pack. Click on the "Package Installer" tab, select the fix pack from the "Installed Packages" listbox, and click the Uninstall button.
  • Follow the below manual steps which are needed to remove the files added manually while installing the fix pack.
    a. Replace the file ChangeService.wsdl from the path <CHANGE_APP_HOME>/WEB-INF/services/ChangeService/META-INF/ChangeService.wsdl with the backed up file during installation.
    b. If Change is installed on Tomcat and when there is a directory in the Change installation path which is same as the context, then delete the file 'Rational_Change.5.3.FP0.4.fxtag' from the directory <CHANGE_INSTALLED_DIRECTORY>/properties/version.
  • Uninstall the language package: Click on the "Package Installer" tab, select the language pack from the "Installed Packages" listbox, and click the "Uninstall" button.
  • Manually replace the directory <CHANGE_APP_HOME>/WEB-INF/lib/32Bit (or 64Bit) with the backed up file during installation
  • Stop and start Rational Change.

Download Package

The following sections provide detailed information related to this release.

How critical is this fix?

Impact Assessment
Impact Description
This release is a maintenance release of Rational Change 5.3. It contains fixes for client reported and internally found defects.

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

ID

Problem/Workaround
R#38490Server registration must be initiated from the central server when mixed releases are used
Registration from a pre-5.3 remote server to a 5.3 central server fails if the server encodings are different (which is usually the case unless the remote server is using the Synergy Asian line). The workaround is to perform the registration from the central server.
R#38474Windows service may not start in a timely fashion when using local help
The Rational Change service on Windows may not start in a timely fashion when Rational Change and Help are deployed together on Jetty, resulting in the following message:
"Could not start the IBM Rational Change 8600 service on Local Computer.
Error 1053: The service did not respond to the start or control request in a timely fashion."
In fact, the service does start, but not within the 125 seconds expected by the Windows service, hence the message. Possible workarounds include:
1. Ignore this error
2. Install Rational Change and Help separately (on different web servers)
3. Use the public Information Center for help rather than a local help server
R#38401release.js script removed
The example external listbox script "release.js", and the internal APIs it relied on, have been removed in release 5.3. Version 5.3 automatically updates the release listbox when defined as a "Database Listbox" fetching values from "active_releases", so the script is unnecessary. Remove any references to release.js and set release listbox properties to "Database Listbox".

Change History

This Fix Pack supports meta group feature for Rational Change and also enables Rational Change to run with Jetty web server version 8.1.3.

Back to top

On
[{"DNLabel":"Link to Fix Central","DNDate":"20 Sep 2012","DNLang":"English","DNSize":"1","DNPlat":{"label":"Windows","code":"PF033"},"DNURL":"http://www.ibm.com/support/fixcentral/swg/selectFixes?parent=ibm~Rational&product=ibm/Rational/Rational+Change&release=5.3&platform=All&function=all","DNURL_FTP":" ","DDURL":null}]
[{"Product":{"code":"SSYQQ2","label":"Rational Change"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"5.3.0.4","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Problems (APARS) fixed
PM33010;PM48131;PM48167;PM55315;PM62337;PM62968;PM64395;PM65747;PM66049;PM70687;PM69384;PM69643;PM68494

Document Information

Modified date:
20 July 2018

UID

swg24032966

Page Feedback