Rational Change 22.214.171.124 release information
The release information for IBM Rational Change 126.96.36.199 contains information about fixes, pointers to important documentation and provides a list of known problems.
This release information includes the following content about Rational Change version 188.8.131.52
- About this release
- Fixed APARs in this release
- Product documentation
- Software and hardware requirements
- Access the software
- Installation information
- Known problems
- IBM Rational Software Support
About this release
Rational Change version 184.108.40.206 addresses a number of issues in version 5.3 and its previously delivered fix packs. This fix pack is translated in Japanese and Chinese as well.
Rational Synergy Fix Pack 220.127.116.11 is required for the OSLC related fixes,
For details, refer to Software and hardware requirements
Fixed APARs in this release
APARs that are fixed in this release are in the Fix list document.
For complete documentation, including installation instructions for 5.3, review the Information Center.
For more information, review the following resources:
- Rational Change Integrations Documentation
- Rational Change Customization Reference Guide
- Rational Synergy 7.2 Release Information
Review the detailed system requirements document at Detailed System Requirements for Rational Change 18.104.22.168 (this information is the same for 22.214.171.124).
Access the software
Access the Rational Change 126.96.36.199 at Download document.
- This fix pack may only be applied to Rational Change 5.3 or any of its previous fix packs which must be installed and operational.
- Rational Synergy Fix Pack 188.8.131.52 is a must requirement for the OSLC related fixes to work.
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 184.108.40.206
- 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.2.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. For this, first take a manual backup of the file <CHANGE_APP_HOME>/WEB-INF/lib/32Bit (or 64Bit) directory (Choose the directory according to the bitness of your OS). From the unzipped location (in step2), copy the license_api/32Bit (or 64Bit) directory and replace <CHANGE_APP_HOME>/WEB-INF/lib/32Bit (or 64Bit) directory.
d. If this fix pack is installed on Change running on WASCE, the WASCE server might not start. The work around for this is to extract the jar file <CHANGE_APP_HOME>/WEB-INF/lib/rcl_telelogic.jar and copy its contents directly under <CHANGE_APP_HOME>/WEB-INF/classes. This will start WASCE server and Change.
Note: To see the fix pack components, traverse the directory structure of the fix pack package once it has been expanded.
4. Installing the language packs
There are 2 approaches to install the language pack.
A. Install Change 5.3 directly in Japanese and Chinese language using the installer
B. If you already have Change 5.3 installed, install the fix pack, and then the desired language pack.
A. Installing Rational Change 5.3 in a specific locale from the installer:
a. Install Rational Change
- Download Rational Change 5.3 (For more details look into Rational Change 5.3)
- Run the installer by running setup.exe / setup.sh, choose the desired language from the 'Choose Setup Language' dialog box. Then continue with the installation wizard (For more details on this, look into Installation instructions on Rational Change 5.3)
b. Uninstall language pack
c. Install fix pack
d. Install Language pack
B. If you already have Change 5.3 installed, then follow the below steps to install the language packs:
a. Install fix pack
b. Install the Language packs
5. Installing Rational Change Help:
You can manually deploy the changehelp.war from the unzipped Rational Change 220.127.116.11 location (in step 2 ) directly in your web server or you can follow the below instructions to install it from Rational Change installer:
- Download Rational Change 5.3 (For more details look into Rational Change 5.3)
- Follow the installation instructions on Rational Change 5.3 to install the Local Help application.(For more details on this, look into installation instructions on Rational Change 5.3)
Note: Help content has been completely translated in Japanese. In Chinese, only "Installing and upgrading" section and the "Help Home page" are translated. So if you are looking at the Simplified Chinese translation, you will see a mixture of English and Simplified Chinese.
6. 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.
- 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.2.fxtag' from the directory <CHANGE_INSTALLED_DIRECTORY>/properties/version.
Important known problems new to version 5.3 are discussed below. See also known problems from previous releases, as they may still apply.
|R#38490||Server 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#38474||Windows 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#38401||release.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".
|R#42402||Add OSLC consumer behaviour to Change 5.3
Rational Change 18.104.22.168 behaves as a OSLC consumer as well. However this is currently validated with ClearQuest 22.214.171.124 version only. There might be issues with this feature in the later versions of ClearQuest and RTC, which will be addressed in the next fix pack.
IBM Rational Software Support
IBM Rational Software Support Communities
Helpful Hints For Obtaining Technical Assistance:
Before you contact IBM Rational Software Support, gather the background information that you need to describe the problem. When you describe a problem to an IBM software support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:
If you have helpful information to diagnose or identify the problem on your system, you can provide this data by following the instructions to exchange information with IBM Technical Support.
More support for:
Software version: 126.96.36.199
Operating system(s): AIX, Linux, Solaris, Windows
Reference #: 7024339
Modified date: 16 March 2012