Installation - release notes


1.0 Known problems
   1.1 Out-of-memory exceptions occur during the product installation
   1.2 Product might not display properly on a GNOME desktop
   1.3 RUP configuration path might point to an incorrect location
   1.4 Installation might stop responding
   1.5 Error message might display when you start the product
   1.6 Canceling an upgrade might uninstall your Rational Software Development Platform product
   1.7 The product might not install properly if you previously canceled an installation
   1.8 RPM package is missing from the product installation
   1.9 RUP configuration directory might not be removed if you uninstall the product
   1.10 The product installation programs might not open properly in your native language
   1.11 The Rational Product Updater launchpoint might not be removed if you uninstall the product
   1.12 CDT might not run on a Simplified Chinese or Traditional Chinese system locale
   1.13 The product does not install if a blank space occurs in the path to the installation files
   1.14 The extractor does not install the product if a blank space occurs in the path to the installation files
   1.15 Translation-related issues should be corrected by using the Rational Product Updater
   1.16 Pop-up menu options might not be available
   1.17 General public licensed Chinese input method might prevent you from typing in the product

1.0 Known problems

1.1 Out-of-memory exceptions occur during the product installation

To avoid out-of-memory exceptions when you install the product, close all other applications before you start the installation. Also, before you start the installation, ensure that your computer meets the minimum hardware requirements.

1.2 Product might not display properly on a GNOME desktop

If you use a GNOME desktop on a SuSE Linux operating system, you must have a minimum screen resolution of 1280 x 1024 for the product to display properly. This issue does not occur if you use a KDE desktop on a SuSE Linux operating system.

1.3 RUP configuration path might point to an incorrect location

If you install but do not open Rational Application Developer, and then you install Rational Software Architect to a location other than the default, the Rational Unified Process® (RUP®) configuration path points to an incorrect location.

To correct the RUP configuration path:

  1. Click Window > Preferences.
  2. Click Process.
  3. Under RUP Configurations, change the path to install_dir/RUP Configuration/architect, where install_dir is your Rational Software Architect installation directory.

1.4 Installation might stop responding

When you install the product on a Linux operating system, the installation might stop responding. To work around this issue, complete the following steps:

  1. To remove the partial installation, in the install_dir/rsa_prod/_uninst directory, open uninstall.bin.
  2. Start a terminal session.
  3. Enter LD_ASSUME_KERNEL=2.2.5 in the terminal session.
  4. Enter export LD_ASSUME_KERNEL in the terminal session.
  5. In the same terminal session, navigate to your disk1 directory and open launchpad.bin.

1.5 Error message might display when you start the product

If you have multiple Rational Software Development Platform products installed on your computer, and you uninstall one of those products, an error message might display when you start one of the remaining products. The error message is only displayed if your workspace contains projects that relate to the uninstalled product.

To work around this issue, create a new workspace and import your old projects into this workspace.

1.6 Canceling an upgrade might uninstall your Rational Software Development Platform product

If you upgrade from one Rational Software Development Platform product to another, and you cancel the upgrade while files are copying to your computer, the original product might be uninstalled from your computer. To work around this issue, reinstall the original product or install the new product.

Note: The projects in your workspace are not affected if you uninstall the original product.

1.7 The product might not install properly if you previously canceled an installation

If you cancel an installation of a Rational Software Development Platform product after files are copied to your computer, and your computer already has a Rational Software Development Platform product installed that you are not upgrading, the next time that you install the new product, various product menus are missing and certain plug-ins are registered but not available.

To work around this issue, you must uninstall and then reinstall the new product without canceling the installation after files are copied to your computer.

1.8 RPM package is missing from the product installation

To use the product on Red Hat Enterprise Linux, Version 3.0, you must install the following Red Hat Package Manager (RPM) package that comes with your operating system installation media: compat-libstdc++-7.3-2.96.122.i386.rpm (or higher).

1.9 RUP configuration directory might not be removed if you uninstall the product

If you install the optional Language Pack, and then uninstall the product, the Rational Unified Process (RUP) configuration directory might not be removed. You must remove this directory before you reinstall the product.

1.10 The product installation programs might not open properly in your native language

On SuSE Linux Enterprise Server (SLES) Version 9, the product installation programs might not open properly in your native language. For example, the Launchpad might open momentarily and then close before you choose to install the product, or setup.bin and extractor.bin might open in English.

To work around this issue, you must set your computer's LC_ALL environment variable to one of the values that is listed in the following table:

Language LC_ALL
Brazilian Portuguese pt_BR.UTF-8
Chinese - Simplified zh_CN.gb18030
Chinese - Traditional zh_TW.Big5
French fr_FR.UTF-8
German de_DE.UTF-8
Italian it_IT.UTF-8
Japanese ja_JP.UTF-8
Korean ko_KR.UTF-8
Spanish es_ES.UTF-8

1.11 The Rational Product Updater launchpoint might not be removed if you uninstall the product

On French versions of Red Hat Enterprise Linux, Version 3.0, if you uninstall the product, the Rational Product Updater launchpoint might not be removed from the main menu under Programming.

If you remove the launchpoint, the next time that you log on to your computer, the launchpoint reappears.

1.12 CDT might not run on a Simplified Chinese or Traditional Chinese system locale

To run the C/C++ Development Toolkit (CDT) on SuSE Linux Enterprise Server (SLES) Version 9, with a Simplified Chinese or Traditional Chinese system locale, you must set your computer's LANG environment variable to one of the following values:

Language LANG
Chinese - Simplified zh_CN.UTF-8
Chinese - Traditional zh_TW.UTF-8

1.13 The product does not install if a blank space occurs in the path to the installation files

If you download and extract the product's electronic installation images into a directory whose path contains a blank space, when you open launchpad.bin and click to install the product, the product does not install.

This issue also occurs if you install the product from a network drive and a blank spaces occurs in the path to the installation files on that network drive.

To work around this issue, ensure that there are no blank spaces in the path to your installation files and open launchpad.bin.

1.14 The extractor does not install the product if a blank space occurs in the path to the installation files

If you download and extract the product's electronic installation images into a directory whose path contains a blank space, and you do not clear the Start installation check box before you click Finish, an error occurs and the product does not install.

To work around this issue, ensure that there are no blank spaces in the path to your installation files and open launchpad.bin.

1.15 Translation-related issues should be corrected by using the Rational Product Updater

Currently, there are known issues with translations in the national language fragments that are included with the product. These issues do not affect product functionality.

You can correct these translation-related issues by using the Rational Product Updater.

To update your product, on the product's main menu, click Help > Software Updates > IBM Rational Product Updater.

1.16 Pop-up menu options might not be available

In some cases, when you install multiple Rational Software Development Platform products on the same computer, certain pop-up menu options are not available.

To work around this issue, complete the following steps:

  1. Log on to your computer as the root user.
  2. Open a terminal session.
  3. Navigate to the product's installation directory.
  4. Enter rationalsdp.bin -clean

1.17 General public licensed Chinese input method might prevent you from typing in the product

For operating systems that use a simplified Chinese system locale, after you press and hold the backspace key, you might not be able to type in the product. To work around this issue, ensure that your version of miniChinput is equivalent to version v.3-56. To check which version of miniChinput you are using, at a command prompt, type the following command:

rpm -q gtk2 glib2 pango miniChinput

If the command returns a version earlier than v.3-56, upgrade to version v.3-56.

Return to the main readme file