Rational Change 5.3.0.2 iFix001 release information

Content

This release information includes the following content about Rational Change version 5.3.0.2_iFix001:

• 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

This iFix is intended for the Japanese and Chinese customers who need Rational Change in their native languages. This iFix is optional for English customers. It contains the following three components:
1. Change patch - Enables Rational Change to support language packs.
2. Japanese and Chinese language packs - Translated Chinese and Japanese product files and installer files.
3. Change Help war - Updated Change help war file.
It has been validated with Rational Synergy 7.2.0.1 iFix001,

---

Fixed APARs in this release

APARs that are fixed in this release are in the Fix list document.

---

Product documentation

For complete documentation, including installation instructions for 5.3, review the Information Center.

For more information, review the following resources:

• Rational Change Documentation Library
• Rational Synergy 7.2 Release Information

---

Software and hardware requirements

Review the detailed system requirements document at Detailed System Requirements for Rational Change 5.3.0.2.

---

Access the software

Access the Rational Change 5.3.0.2_iFix001 Download document.

---

Installation information

Prerequisites:

• This iFix may only be applied to Rational Change 5.3.0.2 which must be installed and operational.
• Rational Synergy 7.2.0.1 iFix001 .

Installation instructions:

1. Log in to the machine where Rational Change is (or needs to be) installed as the user who installed (or needs to install) Rational Change.

2. Unzip (Windows) or untar (UNIX) the patch file into a temporary location.

For example, on UNIX:
$ cd /temp
$ tar xvf <file path>

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 required fix pack, patch and 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)
• From the unzipped Rational Change 5.3.0.2 iFix001 location (in step 2), copy the desired language pack .zip files directly under the installer at the same level as setup.exe / setup.sh
• 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

• After installing Change 5.3 in the desired language, login to Rational Change as Admin, and click the "System Administration" link in the action panel
• Click on the "Package Installer" tab. Select the installed language pack from the "Installed Packages" listbox and click "Uninstall" button. (Language packs needs to be re-installed after all the Fix pack and patch installations are complete.)

c. Install Fix pack and patch

• Download the Fix pack 5.3.0.2 and install it (For more details on this, look into Rational Change 5.3.0.2)
• From the unzipped Rational Change 5.3.0.2 iFix001 location (in step 2), copy the directory named "rc5.3.0.2-01" to <CHANGE_APP_HOME>/WEB-INF/packages.
• Login to Rational Change as Admin, and click the "System Administration" link in the action panel.
• Click on the "Package Installer" tab, select this iFix package from the "Available Packages" listbox, and click the "Install" button.
• After the patch installation is successful, stop and re-start Rational Change.

d. Install Language pack

• Login to Rational Change as Admin, and click the "System Administration" link in the action panel.
• Click on the "Package Installer" tab, select the desired 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.

B. If you already have Change 5.3 installed, then follow the below steps to install the language packs:

a. Download the Fix pack 5.3.0.2 and install it (For more details on this, look into Rational Change 5.3.0.2)

b. Install rc5.3.0.2-01 patch

• From the unzipped Rational Change 5.3.0.2 iFix001 location (in step 2), copy the directory named "rc5.3.0.2-01" to <CHANGE_APP_HOME>/WEB-INF/packages.
• Login to Rational Change as Admin, and click the "System Administration" link in the action panel.
• Click on the "Package Installer" tab, select this iFix package from the "Available Packages" listbox, and click the Install button.
• After the patch installation is complete, stop and start Rational Change.

c. Install the Language packs

• From the unzipped Rational Change 5.3.0.2 iFix001 patch (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.

Installing Rational Change Help:

You can manually deploy the changehelp.war from the unzipped Rational Change 5.3.0.2 iFix001 location (in step 2 of Installation instructions) directly in your web server or you can follow the below instructions to install it from Rational Change installer:

1. Login to the machine where Change help needs to be installed.
2. Uninstall any already installed Change help server.
3. Download Rational Change 5.3 (For more details look into Rational Change 5.3)
4. From the unzipped Rational Change 5.3.0.2 iFix001 location (in step 2 of Installation instructions), copy the changehelp.war file to Rational Change 5.3 installer at the same level as setup.exe / setup.sh
5. 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.

Uninstalling the iFix and the language pack:

If it is necessary to remove the patch and language pack after it was installed, follow these steps.

1. Login to Rational Change as Admin, and click the "System Administration" link in the action panel.
2. Uninstall the language package: Click on the "Package Installer" tab, select the language pack from the "Installed Packages" listbox, and click the "Uninstall" button.
3. Uninstall the patch package: Click on the "Package Installer" tab, select the patch package from the "Installed Packages" listbox, and click the "Uninstall" button.
4. Stop and start Rational Change.

---

Known problems


Important known problems new to version 5.3 are discussed below. See also known problems from previous releases, as they may still apply.

ID	Problem/Workaround
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#41635	Installer issues 1. Issue with the installer on Solaris : The "Ok" and "Cancel" buttons on the Language selection dialog box may not be completely visible. Workaround is to press the Enter key. 2. Untranslated buttons in the installer : "OK", "Back", "Next", "Install", "Finish" buttons in the installer dialogs may not appear translated. 3. Some of the installer dialogs may not be aligned properly in AIX. Workaround is to type the inputs and press Enter key to proceed to the next dialog. 4. Choosing Synergy home and Synergy database in the dialogs, warning messages shall be shown saying "CRCHI0000E <Synergy home> version is not compatible. Click Yes to accept this IBM Rational Synergy installation." and "CRCHI0001E <database path> version is not compatible. Are you sure that you want to accept this database path?" respectively. Workaround is to click 'Yes' and continue with the installation.

---

IBM Rational Software Support