Documentation - release notes


1.0 Supported software and specifications
2.0 Limitations
   2.1 Error messages received when Mozilla is not installed
   2.2 *Welcome First Steps for optional features
3.0 Known problems
   3.1 Wizards and windows do not release focus to the online Help
   3.2 When upgrading a product the same set of electronic images is required
   3.3 *Online help topic "Migrating JavaServer Faces resources with Faces Client Components" may be missing information
   3.4 Instructions incorrect for installing Crystal Enterprise V10 Professional Edition on Linux
   3.5 Path for running site_prep and install_release is incorrect in the Linux ClearCase LT installation instructions

1.0 Supported software and specifications

Flash plug-in requirement

In order to properly view multimedia user assistance, such as Tours, Tutorials, and Show me viewlets, you need to have Flash Player for Linux version 6.0r69 or later installed.

2.0 Limitations

2.1 Error messages received when Mozilla is not installed

Mozilla 1.4 GTK2, or Mozilla 1.5 GTK2, or Mozilla 1.6 GTK2 with SWT3.0, or Mozilla 1.7 GTK2 and above with SWT3.1 V3104 must be installed. The version of Mozilla installed on your system will vary with your Linux distrubution. For more details on supported software and specification for Rational Developer, refer to the Installation Guide.

To find Mozilla download and installation instructions, refer to www.mozilla.org.

If Mozilla is not installed, you will receive the following error message when opening the online help:

An exception occurred while launching help. Refer to the log for more details.

If Mozilla is not installed you will receive the following error message when invoking RUP®:

An SWT error has occurred.
You are recommended to exit the workbench.
Subsequent errors may happen and may terminate the workbench without warning.
See the .log file for more details.

2.2 *Welcome First Steps for optional features

Due to differences in plugin loading behavior on different systems, links to wizards and information on optionally installable features may not be displayed in the Welcome.

Note: This has been fixed in V6.0.0.1.

3.0 Known problems

3.1 Wizards and windows do not release focus to the online Help

Some wizards and windows are modal, which means that until you finish working in them, you cannot switch to a different window in the product. This is an issue when you refer to help topics in the help browser, or tutorials in the Tutorials Gallery for guidance on how to complete a wizard.

To view the online help while you work in a modal window, either print the help information, or set the online help to open in an external browser.

To set the online help to open in an external browser:

  1. Click Windows > Preferences.
  2. Click Help.
  3. Select the Always use external browsers check box.
  4. Click Apply.
  5. Click OK.

Note: Some help information is available in PDF. You can view this information in Adobe Acrobat Reader while working with a modal window.

3.2 When upgrading a product the same set of electronic images is required

When upgrading from one Rational Software Development Platform product to another using the ESD images, ensure that you download and extract the same set of images for the new product that you downloaded and extracted for the original product. The same components installed in the original product will be automatically installed in the upgraded product.

For example, if the Language Pack was originally installed, when upgrading you will need to have the Language Pack downloaded and extracted into the new product installation image.

3.3 *Online help topic "Migrating JavaServer Faces resources with Faces Client Components" may be missing information

Information on the following items may be missing from early versions of the online help topic "Migrating JavaServer Faces resources with Faces Client Components":

If your online help topic "Migrating JavaServer Faces resources with Faces Client Components" is missing this information, refer the the html version of the Migration Guide, which is located at root of the first CD or under disk1/migrate.html of the electronic images.

Note: This has been fixed in V6.0.0.1.

3.4 Instructions incorrect for installing Crystal Enterprise V10 Professional Edition on Linux

The Installation Guide may have incorrect instructions for installing Crystal Enterprise V10 Professional Edition on Linux. To install the Crystal Enterprise V10 Professional Edition on Linux, follow these steps:

  1. Insert the Crystal Enterprise V10 Professional Edition disk for Linux and mount the cdrom.
  2. Open the install.html file located in the root directory of the installation disk. This file contains complete instructions for installing Crystal Enterprise V10 Professional Edition on Linux. You will need to refer to the instructions in this file to prepare your system and complete the installation process. You should also review the "Installation" section of the release.htm file, which is located in the root directory of the installation disk, prior to installing the product.
  3. Review the "Setting up your Linux system" section of the install.html file and perform all necessary actions before proceeding with running the installation script.
  4. Disable any antivirus software before installing the product.
  5. Follow the "Running the installation script" instructions in the install.html file to complete the installation process. It describes the procedure for a user installation.

    Notes®:

    1. In the "Running the installation script" instructions you are told to copy the licensetext file (included with your product distribution), and the files containing the Crystal Enterprise binaries (with the extension .gz) to your HOME directory. These files are located in the linux_x86 directory of the installation disk.

    2. In "Running the installation script" there is a step that indicates you should enter a product activation keycode. You can ignore this step.
  6. When the installation script completes, you must deploy the Crystal Enterprise Web desktop and the Crystal Enterprise Launchpads. Refer to the "Deploying the Crystal Enterprise web desktop" section in the install.html file.
  7. For information on deploying the Web Component Adapter (WCA), including information on deploying multiple WCAs, refer to the "Deploying the Web Component Adapter" section of the install.html file.
  8. Enable your antivirus software, if you disabled it prior to beginning the installation.

You can also install Crystal Enterprise V10 Professional Edition in Japanese. Follow the same instructions as listed above using the Japanese version of the Crystal Enterprise V10 Professional Edition Japanese on Linux CD.

3.5 Path for running site_prep and install_release is incorrect in the Linux ClearCase LT installation instructions

To run site_prep and install_release, you should change to the following directory:

cd /usr/ccase_lt_rls/rational_clearcase_lt/rhat_x86/clearcase/install

assuming /usr/ccase_lt_rls/ is the directory name for your release area.

Return to the main readme file