IBM Rational Service Release 2003.06.13 Release Notes

Version 2003.06.13, September 2004

This file last updated: 08/09/2004

Material ID/Part Number: GI11-5918-03


© Copyright IBM Corporation. 1999, 2004. All Rights Reserved.

This documentation (the "Work") is protected under the copyright laws of the United States and/or other jurisdictions, as well as various international treaties. Any reproduction or distribution of the Work is expressly prohibited without the prior written consent of IBM Corporation.

Legal Notices Information


Scope

Product changes described in this document and contained within this service release apply if you are upgrading from:

These Service Release Notes include:

Go to rs_readme.html for a full description of the release, including enhancements, all supported platforms, and known issues.

Note: Some content from earlier versions of the IBM Rational Suite Service Release Notes has been removed from this document and included in the following IBM Rational guides that were updated in v2003.06.13:

Service release v2003.06.13 contains product fixes and new features for IBM Rational products. This release will update the following IBM Rational Suite products to v2003.06.13:

Note: For more information on which tools are typically included with each edition of IBM Rational Suite, see the IBM Rational Suite Release Notes.

For information on:

About this IBM Rational Service Release

This IBM Rational service release includes important product fixes, and may include new features. It is developed for a specific product version and does not affect the licensing of your products. Since there is no effect on licensing, the service release does not allow you to configure licensing while you apply it to the software. You will, however, be asked to accept the service release license agreement before installation.

This service release allows you to update selected IBM Rational components on your system. You do not have to find and select product-specific service releases. Because a service release is cumulative, you can apply the latest service release without applying earlier service releases. After you apply a service release, you may see new shortcuts or files. The service release updates the IBM Rational product's version number; for example, from 2003.06.00 to 2003.06.13. You can see the change in the "About <Rational Product> " dialog box accessible from the product's Help menu, or in the "Rational Installed Product Information" dialog box, which can be accessed from the Start menu.

Contents

What's New in This Service Release

Hardware/Software Information
Client Requirements
Server Requirements

Getting Started
Upgrades
Installation Information
Installation Issues

Installation Instructions

Product Documentation

Defects and Changes
Known Issues
Defects and Limitations In This Service Release
Defects Fixed In This Service Release

Contacting IBM Rational Software Support

 

What's New in this Service Release

These Release Notes are accurate at the time this product was prepared for release. The most recent version of this file is available in the IBM Publications at http://www.ibm.com/shop/publications/order. Search for GI11-5918-03 to find the latest version of these Release Notes in the IBM Publications Center. (To search for the IBM Publications Center, go to http://www.ibm.com and enter "IBM Publications Center" in the Search field.)

For information on "What's New" in this service release, see the IBM Rational Suite Release Notes.

Hardware/Software information 

Client requirements

For new information on client requirements, see the IBM Rational Suite Release Notes

Server requirements

For new information on server requirements, see the IBM Rational Suite Release Notes

Getting started

Keep the following current v2003 documents easily accessible during this installation:

Upgrades

For upgrade information, see the "IBM Rational Suite Upgrade Guide."

Installation information

For upgrade information, see the "IBM Rational Suite Upgrade Guide."

For installation information, see the installation guides for IBM Rational software desktop and server products.

Installation issues

For installation information, see:

XDE license management and enforcement

If you previously installed the XDE Floating License Enablement Kit, please ignore this section. License enablement of your XDE products is unaffected by this service release.

This service release enables you to manage v2003 IBM Rational XDE product use of floating license keys.

To enable XDE license enforcement:

  1. Install the Service Release.
  2. Run the command <rational_directory>\common\SetXDEFloating.exe. After running SetXDEFloating.exe, users will need a license key to use XDE.

After you configure XDE to use license keys:

  1. Get your license keys from AccountLink. Go to http://www.ibm.com/software/rational/support/licensing. Register with the IBM Web Management and click Request and Manage License Keys. Passport Advantage customers can obtain XDE license keys by referring to the "Important Licensing and Installation Information" document in your shipment or the "Proof of Entitlement" certificate. If you are not a Passport Advantage customer, you can obtain your XDE license keys from your local IBM Rational sales representative or from Customer Service.
  2. Install the IBM Rational License Server. If you do not have the license server software, you can either install it from the "IBM Rational Solutions for Windows CD-ROM" or download it from https://www6.software.ibm.com/reg/rational/rational-i. Refer to the "IBM Rational Software License Management Guide" on the "IBM Rational Solutions for Windows Online Documentation CD-ROM" for instructions on installing and operating the IBM Rational License Server.
  3. Launch the IBM Rational License Key Administrator and point the client machine at your IBM Rational License Server.

When license enforcement has been activated, XDE behaves as follows:

A valid XDE license key is required throughout the duration of any XDE session, which is initiated when a model is opened and terminated when all models are closed. When the session begins, an attempt is made to check out a license key from the license server. If a license is available, XDE checks out the key for the duration of your session. If no XDE license keys are available on the server, a warning message appears informing you that you do not have a valid key.  XDE will continue to operate, and you will continue to see this message while using XDE until a valid license key is acquired.

Installation instructions

For upgrade information, see the "IBM Rational Suite Upgrade Guide."

For installation information, see the installation guides for IBM Rational software desktop and server products.

Product Documentation

Once you install an IBM Rational service release:

Note: You will only be able to access the release notes using the links below if those products were contained on your installation media.

IBM Rational ClearCase IBM Rational Rose RealTime

IBM Rational ClearCase LT

IBM Rational SoDA
IBM Rational ClearQuest IBM Rational Suite
IBM Rational ProjectConsole IBM Rational Testing Products
IBM Rational PureCoverage IBM Rational TestManager
IBM Rational Purify IBM Rational Unified Process
IBM Rational PurifyPlus IBM Rational XDE Modeler for .NET
IBM Rational QualityArchitect IBM Rational XDE Developer for .NET
IBM Rational Quantify IBM Rational XDE Developer Plus for .NET
IBM Rational RequisitePro IBM Rational XDE Modeler for Java
IBM Rational Requisite Web Install IBM Rational XDE Developer for Java
IBM Rational Rose IBM Rational XDE Developer Plus for Java

Compatibility issues

See the IBM Rational Suite Release Notes.

With IBM Rational Products

See the IBM Rational Suite Release Notes.

With Third-Party Products

See the IBM Rational Suite Release Notes.

Late changes to documentation

References to the Rational Download Manager in version 2003.06 documentation are no longer relevant. You may choose to keep it on the hard disk, but if it is uninstalled, it will not effect the proper functioning of Rational Suite. 

These Release Notes are accurate at the time this product was prepared for release. The most recent version of this file is available in the IBM Publications at http://www.ibm.com/shop/publications/order.

Restrictions and guidelines on using IBM Rational Suite

See the IBM Rational Suite Release Notes.

Defects and changes

Known issues

See the IBM Rational Suite Release Notes.

Defects and limitations in the Service Release

This section identifies additional defects and limitations associated with IBM Rational products that were not included in earlier versions of IBM Rational Release Notes. For detailed, product-specific defects and limitations, read the release notes and service release notes for the product(s) of interest to you. 

Table 1. Known Defects and Limitations in IBM Rational Suite in v2003.06.13

Note: These may also apply to other versions of IBM Rational products.

Product RATLC ID/APAR Description
Install RATLC00247828/ No APAR When performing an Upgrade installation of v2003.06.13, extraneous message boxes may obscure the progress bar.

If a message box with a window caption of "Windows Installer," text message of "Preparing to install …," and a single Cancel button appears over the main install window, click on the main install window to bring it to the front such that the progress bar is visible.

Install RATLC00700938/ APAR IC38809 At the end of a Rational product installation, the Done or Finish button is always enabled now. Previously, the user could not click the Done or Finish button until all the required information was entered. Now, if all of the required information is not entered, an error message will inform the user that information is missing and indicate what pages and sections missing this information look like.
Install RATLC00724843 IBM/Rational has provided customers with two types of media, CDs and Downloads. You must upgrade your systems using the same type of media as the original install. This affects all desktop installs (and installs from release areas).

For more information, see the IBM Rational Suite Upgrade Guide.

Licensing RATLC00716852/ No APAR In order to open the firewall for the IBM Rational License Server on WinXP SP2 machines, a registry file (WinXPSP2.reg) has been provided in the <Install Path>\Rational\common directory. Import the changes to the user's registry by double-clicking this file. This action will open the firewall for rational.exe and lmgrd.exe to use any ports.

You need to edit the WinXPSP2.reg file if you did not install the IBM Rational License Server to the default path of C:\Program Files\Rational\common\. This file can be edited with any typical editor (such as Notepad). To do this, replace the C:\Program Files\Rational\common in two locations in each line with the actual install path.

Licensing RATLC00455276/ No APAR The "IBM Rational License Management Guide" should state that IBM Rational supports redundant server environments of heterogeneous operating systems:
  • Different Windows operating systems,
  • Different UNIX operating systems, or
  • A mix of Windows and UNIX operating systems.
Licensing RATLC00722629/ No APAR The IBM "Rational Software License Management Guide" refers to "License Key Certificate." This is no longer used for license fulfillment.

For more information on licensing, see the IBM Rational Suite Release Notes "Licensing" section.

Licensing RATLC00719580/ No APAR

RATLC00441932/ No APAR

Rational License Key Administrator v2003.06.13 enables you to import license keys on computers with multiple NIC cards.
Licensing RATLC00458025/ No APAR Enhancements to floating license disconnected use

If your product uses floating license keys, IBM Rational products can run under certain conditions if you do not have network connectivity to your license server. The IBM Rational product will go into "disconnected use mode" if the product tries to acquire a floating license key and cannot find the license server within 3 days of the last time the user ran the product on that host. This feature is ideal for mobile users who use floating licenses in the office and then wish to use the product at home or away from the office shortly thereafter.

As of v2003.06.13, if you have purchased a component of a Rational Suite product, you only have to launch one Suite component using a Suite License to be able to use all Rational Suite components in a disconnected manner.

Viewing disconnected use status:
While you are disconnected from the network, the Rational License Key Administrator (LKAD) v2003.06.13 displays which products or components can be launched in disconnected use mode. If you activated disconnected use for a product and it is not displayed in the LKAD, click View > Show > Floating Licenses.

Changing the time-out to delay disconnected use:
The Rational License Key Administrator v2003.06.13 allows you to change the time-out period the IBM Rational product will wait for a floating key before it goes into disconnected use mode. The default setting is 5 seconds. If you have a slow network, your software automatically goes into disconnected use mode if it does not receive a response from the license server within 5 seconds. You then see a dialog box that states you are in disconnected use mode after the 5 seconds.

To change the time-out:

  1. Click Settings > Disconnect Timeout
  2. Enter a value from 5-25 in the Disconnect Timeout dialog box.
  3. Click OK.
Licensing RATLC00716852 License Server cannot communicate with client on WinXP SP2 by default. For more information, read the section called "Microsoft Windows XP Service Pack 2 (SP2) Security Measures" in the IBM Rational Suite Release Notes.
Licensing RATLC00459146/ No APAR New download location for Rational UNIX License Server

The download location for the Rational UNIX license server has changed from an ftp site to a Web download site. Use the following Web address to download the UNIX version of the Rational license server.

  1. Log into the Rational Download and Licensing Center at https://www6.software.ibm.com/reg/rational/rational-i.
  2. Click Full Product Versions under Download.
  3. Click Rational License Server.
  4. Select the appropriate UNIX platform.

After you have downloaded the licensing executable files, follow the instructions in Chapter 9 "Configuring a UNIX license server" in the "Rational Software License Management Guide". When you are ready to install the server software, go to Step 2 in the "Installing the server software and floating license keys" section.
 

Licensing RATLC00457793/ No APAR The v2003.06.13 Rational License Server is based on FLEXlm version 9.2. This upgrade resolves several customer reported defects at the FLEXlm level. You can use this version of the Rational License Server to service Rational products at earlier release levels.

If you are upgrading the UNIX version of the Rational license server, log into the Rational Download and Licensing Center at https://www6.software.ibm.com/reg/rational/rational-i. For installation instructions, see "New download location for Rational UNIX license server"

When you upgrade the license server, you must restart it. To restart the license server:

  1. In the license_setup script, select option 2 in the License Check menu.
  2. To ensure that the license server automatically restarts when it reboots, the license_setup script directs you to become root and copy the server start-up script to the directory under /etc. The correct location for placing the start-up files are based on the operating system that you are using. The file is renamed as it is copied. The name has to begin with a capital S and it is recommended that you use 98 to make sure it starts toward the end of the other services that come up. The start file is called start_lmgrd_on_server, where server is the name of the license server. A copy of the file is placed in the rational-dir/config directory.

The following sections provide the start-up script commands for the UNIX operating systems that IBM Rational supports:

AIX
Edit the /etc/inittab file and add this line:
lmgr:234:once:/bin/sh rational-dir/config/start_lmgrd_on_server
Add an entry with the full-path name to the start-up script. This start-up script could be copied to the local file system on the license server machine.

HP-UX
cp start_lmgrd_on_server /sbin/init.d/S98Rational
ln -s /sbin/rc2.d/S98Rational /sbin/rc2.d/S98Rational

IRIX
cp start_lmgrd_on_server /etc/init.d/S98Rational
ln -s /etc/rc2.d/S98Rational /etc/rc2.d/S98Rational

Linux
cp start_lmgrd_on_server /etc/rc.d/rc3.d/S98Rational
cp start_lmgrd_on_server /etc/rc.d/rc4.d/S98Rational
cp start_lmgrd_on_server /etc/rc.d/rc5.d/S98Rational

Tru64 UNIX
cp start_lmgrd_on_server/sbin/init.d/S98Rational
ln -s /sbin/init.d/S98Rational/sbin/rc3.d/S89Rational

Solaris
cp start_lmgrd_on_server /etc/rc2.d/S98Rational
 

ClearQuest RATLC00723156/ No APAR Japanese users will notice English text mixed in with Japanese when using Crystal Reports. This is a known issue.
Rational Web Platform RATLC00726460/ No APAR Certain Rational Web Platform files differ in a v2003.06.13 installation, depending upon whether the installation was a result of an upgrade from an earlier version, or a new installation.

In the case of a new IBM Rational Suite Enterprise installation with Web Server feature selected, the common/rwp/conf/include/ccweb.conf file will have unsubstituted _CC_HOME_ placeholders. Users must manually replace all occurences of _CC_HOME_ with the actual physical path of ClearCase installation, for example: C:/Program Files/Rational/ClearCase.

TestManager Install RATLC00459258/ No APAR The Crystal runtimes will not be installed on Win9x operating systems. Users need to install the product on Win NT and above to run reports.
Site Preparation Tool RATLC00721041/ No APAR Previously, the Done button in the Site Preparation Tool window was disabled until you entered all the information required on the page. Now, the Done button is always enabled. If you click the Done button and some information has not been entered, an error message is displayed informing you that some information is still required.
Documentation RATLC00368352/ No APAR The instructions for using Full-Text Search on the Rational Solutions for Windows Online Documentation CD may not be accurate for versions of Adobe Acrobat later than 5.0. To set up full-text search, users may need to follow the instructions below for step 1, instead of those listed in the using_search.pdf.
  1. Select Edit > Search, then click Use Advanced Search Options
  2. LookIn:SelectIndex..., then click Add
  3. Browse to the Documentation CD-ROM and select index.pdx
  4. Check Documentation CD and click OK.

 

Defects fixed in this Service Release

Product fixes contained within this service release are available at http://www.ibm.com/software/rational/support/documentation/. For detailed, product-specific information about defects fixed, read the release notes and service release notes for the product(s) of interest to you. 

Contacting IBM Rational Software Support

The IBM software support Internet site provides you with self-help resources and electronic problem submission. The IBM Rational Software Support Home page can be found at http://www.ibm.com/software/rational/support/.

Voice Support is available to all current contract holders by dialing a telephone number in your country (where available). For specific country phone numbers, go to http://www.ibm.com/planetwide/.