IBM® Rational® Service Release 2003.06.01 Release Notes

Version 2003.06.01

October 2003

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 apply to:

• Rational products on the v2003.06.00 Rational Solutions for Windows CD-Rom
• Other v2003.06.00 Rational products. 

Specifically, this service release contains product fixes for Rational:

• ClearCase
• ClearCase LT
• ClearQuest
• PureCoverage
• Purify
• Quantify
• RequisitePro
• Rose
• Rose RealTime
• Rational Unified Process
• XDE Developer for Java

Note: This service release will update all Rational products to v2003.06.01.

For information on:

• Upgrading Rational product databases, refer to the Rational Suite Upgrade Guide on the Rational Solutions for Windows Online Documentation CD-Rom, or at http://www.rational.com/docs/v2003/win_solutions/rational_suite/rs_upgrade.pdf.
• Product changes included in this service release, go to http://www.rational.com/support/documentation/release/v2003/rs_sr_defects.htm.

• V2003.06.00 Rational products, refer to the v2003.06.00 Release Notes.

About a Rational Service Release

A 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 installing.

A service release detects the products on your system and updates the program components. 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 Rational product’s version number from, for example, 2003.06.00 to 2003.06.01. You can see the change in the "About <Rational Product> " dialog in the product’s Help menu, or in the "Rational Installed Product Information" dialog on the Start menu.

Contents

What's New in This Service Release

Hardware/Software Information
Client Requirements
Server Requirements

Getting Started
Installation Information
Installation Issues

Installation Instructions

Product Documentation

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

Contacting Rational Customer Support

What's New in This Service Release

Rational Rose

Core Rose Enhancements

• Rose 2003.06.01 includes a new petal version due to changes in relation to the Rose J Model Closure Autoload Feature.

Rose J Add-In Enhancements

• Rose J Model Closure Autoload Feature
  The Rose J Model Closure Autoload Feature automatically helps you determine the correct model closure necessary for successful forward and reverse engineering.  Utilizing this feature, Rose will ensure the necessary units are loaded.

• Enhanced Rose J Fundamental Type Support
  Rose J Fundamental Types are now shareable across teams or the organization, as they are now saved with the model. Rose J context menus have been added for both class diagram and browser to allow for quick addition to the Fundamental Type List.

Rose VC++ Add-In Enhancements

• Automatic Source File Updates in IDE
  Enabling this feature (by default this feature is not enabled) will allow files that are already open in the IDE to be modified directly by the IDE preventing the need for reload dialogs.

Rose Data Modeler Enhancements

• Data Model-Object Model Comparison Wizard
  Rose Data Modeler now supports comparison between the Data Model and its Transformed Object Model.
  

• Transformation Synchronization Options
  Synchronization between Data Model and Object Model during Transformation.
  

• Enhanced DDL Elements Generation Order
  Rose Data Modeler now generates DDL commands organized by table instead of by command types.
  

• Limited DDL Round-Trip Engineering Support for IBM DB2 OS390 Version 7
  Rose Data Modeler now supports DDL Round-Trip Engineering for Database Type IBM DB2 OS390 version 7 on specific DDL statements as described in the Rose 2003.06.01 Release Notes.
  

• Enhanced Constraint Generation in DDL for IBM DB2 OS390
  Unique constraints and Primary Key constraint are now generated as ALTER TABLE statements immediately after the CREATE INDEX statement rather than being generated together with CREATE TABLE statement.

Hardware/Software Information

Client Requirements

There are no changes to the client requirements for v2003.06.00 Rational products in this service release. For information on client requirements, see the v2003.06.00 Rational Suite Release Notes.

Server Requirements

There are no changes to the server requirements for v 2003.06.00 Rational products in this service release. For information on server requirements, see the v2003.06.00 Rational Suite Release Notes.  

Getting Started

This service release applies only to v2003.06.00 Rational products. Do not install this service release if you are using another version of Rational products.

Before installing the service release, you should:

• Ensure that the Build ID (version number) for all Rational products installed on your system is 2003.06.00.436.000: Select Start > Programs > Rational Software > Rational Software Installed Product Information. If it is not version 2003.06.00.436.000, click here to learn more.
• Read the service release Release Notes for each Rational product you are updating with this service release. 
• Review the v2003.06.00 Release Notes for each Rational product you are updating with this service release. Release notes can be accessed from http://www.rational.com/support/documentation/manuals/v2003/index.jsp. 
• Back up your data before you install the service release.

Keep the following v2003.06.00 documents easily accessible during this installation:

• Release Notes:

• Service release Release Notes for each Rational product you are updating. 
• V2003.06.00 Release Notes for each Rational product you are updating. (To access this site, you must have a Rational Member Profile and be logged in using that profile.)

• Manuals (available on the v2003.06.00 Rational Solutions for Windows Online Documentation CD-Rom, or online:

• The Installation Guide for Rational Desktop Products.
• The Installation Guide for Rational Server Products.
• Rational Suite Upgrade Guide.

Installation Information

Rational Software Service Release Requirements

The following general requirements are necessary to run the Rational Software Service Release on your system.

• To download software from the Rational Web site, you must have a Rational profile.
• Ensure that all Rational products on your system are upgraded to the same version, otherwise, you cannot apply the service release.
• Make sure you have administrator privileges before you update your Rational products. 
  To use the Rational Software Setup program on a Windows NT, 2000, or XP system, you must have Windows administrator privileges on the local system. Log in as one of the following users:  
  • Local administrator 
  • Member of the local administrator’s group (example: domain administrator)
• Backup your Registry and system directories.  
• Disable all virus protection software. These programs often run in the background and interfere with the installation and file decompression process.

We also recommend that you:  

• Disable any user interface managers or desktop environments that run on top of Microsoft Windows.  
• Change to a standard VGA video driver while the setup program is running, or disable video features such as virtual screens or screen switching. 
• Change to a standard mouse driver, or disable special mouse features that perform tasks such as leaving pointer trails or changing pointer sizes. 

Finally:  

• Ensure that your computer meets the system requirements as described in the Rational Suite Release Notes.
  Tip: Ensuring that a greater amount of memory is available may result in a shorter install time.
• After you install a Rational product, you must restart your system before applying this service release. Do not apply this service release until you have restarted your system after installing a Rational product.

Supported Configurations 

You can apply this service release to the following v2003.06.00 Rational product configurations:

• Directly to a desktop client and servers  

• Release areas created with the Enterprise Deployment install option

Unsupported Configurations 

You cannot apply a Rational service release to:

• A Rational product-version for which it was not intended.
• Only one Rational product if you have multiple Rational products on one computer.
• Multiple versions of Rational Software (but no service releases) on the same system.
• A computer that has had a more current service release applied to it. That is, applying an earlier service release to a later service release is not supported.

If the service release detects an unsupported configuration, it cannot update the components. The program displays a generic warning message indicating that it did not find any suitable product for updating.

Installing an Additional Product to an Updated System

When you install any Rational product to a system that already has had a service release applied to it, the setup program warns you that the products on your system are updated. Continue with the installation and then re-apply the service release to update the additional product.

Ensuring Version Compatibility

Before you can apply this service release, you must determine that v2003.06.00 Rational products are installed on your system. 

1. Select Start > Programs > Rational Software > Rational Software Installed Product Information. 

2. Ensure that, for each Rational product listed, the Build ID (version number) is 2003.06.00.436.000 If it is not 2003.06.00.436.000, remove or upgrade as follows:

   • Remove the product all-together: Select it, then click Add/Remove. Use the Windows Add/Remove Programs feature to remove the Rational product.
   • Upgrade the product to version 2003.06.00: For details on upgrading, refer to the Rational Suite Upgrade Guide on the Rational Solutions for Windows Online Documentation CD-Rom, or at http://www.rational.com/docs/v2003/win_solutions/rational_suite/rs_upgrade.pdf. 
3. Continue with the service release installation. 

Note: Once a service release is applied, you cannot uninstall the updates it makes. To revert to your previous Rational product configuration:

1. Uninstall all Rational products for which the service release was applied.
2. Install your preferred Rational product version again.

Using the Rational Software Setup Program

Rational service release, version 2003.06.01 includes: 

Verifying Authentication of Service Release 

This service release download includes a security utility that verifies publisher authenticity (Rational). You should verify the authenticity of the file before installing the service release:

1. Download the .msp file to your computer.
2. If you do not have the Microsoft Authenticode utilities kit, go to http://www.microsoft.com/downloads and enter the keyword "authenticode". 
3. Install the Authenticode utilities for Internet Explorer, and note the location where the kit was installed.
4. Open a DOS window and enter the command: C:\<path to authenticode utilities kit directory> >chktrust.exe <path to .msp file>
   (example: C:\inetsdk\bin>chktrust.exe c:\rationalsr1.msp)

   Wait 5-15 minutes, depending on how many programs are running on the system. Eventually, you will see either: 

   • The Security Warning window if the service release is authentic, or 
   • A window that states: "The publisher cannot be determined due to the problems below: Authenticode signature not found," if it is not authentic.
5. If:
   • It is not authentic, click No to cancel service release installation. You will see " <path to .msp file>: Failed: The subject is not trusted for the specified action." 
   • It is authentic, click No anyway. You will see " <path to .msp file>: Failed: The subject is not trusted for the specified action." You will still be able to install the service release.
6. Once the file is downloaded, follow these instructions to install the service release.

Installation Issues

Registry Size

You need to increase the size of your Windows registry if you encounter the following system error during installation of this service release:

"Your maximum registry size is too small. To ensure that Windows runs properly, increase your maximum registry size. For more information, see Help."

Let the service release installation complete, then increase your system’s registry size by 10MB. For instructions, use your operating system's Help system.

Service Release Log File

If you want to keep a record of all installation activities for this service release, you should create a service release log file for this service release. For information on how to do this, refer to the Installation Guide for Rational Server Products.    

Installation Instructions

Make sure that you have read the Getting Started and Installation Information before:

1. Installing this service release:

   • Directly to a desktop client or server. 
   • Using a release area.
2. Removing a service release.
3. Canceling installation of a service release.

Installing the Rational Service Release Directly to a Desktop Client or Server

1. Before you begin, decide whether or not to create a Rational service release log file.
   The service release setup program does not display an error summary and it does not automatically create a log file. You can have the service release setup program create a log file that records installation activities, often used to trace installation errors.

2. Then, install the service release using one of the following methods and proceed with step 3:

   • If you do not want to create a log file, double-click the .msp file.
   • To create a log file, use the command msiexec /p <path to service release.msp> /l*v <mylog>.log. 

   • <path to service release.msp> is the location of the service release mechanism you downloaded. Map a network drive to this location. For instructions on how to do this, refer to your Windows Help system.
   • The last portion /l*v <mylog>.log creates a service release log file. 
   • If multiple products are on your system, use /l*v+ <mylog>.log to ensure that the log which patches all individual products is appended to the log file.
     You should name the file something other than Rational_install.log, so as not to overwrite your installation log from Rational v2003.06.00 installation (if it was created in the same location as your service release installation log). 
     You will also need to select a location for this log file and include the path here. 

   Notes: 
   For each Rational product installed on your system, and for which you are applying this service release, you need to complete the following steps in these instructions. 
   To cancel installation of this service release, click Cancel at any time.

3. When the Welcome dialog box launches, click Update
4. Read the Product Warnings and perform the required tasks, then click Next.

5. Read the License Agreement.

   • If you reject the agreement, the program ends. 
   • If you accept the agreement, the service release update continues. Proceed with these instructions.
6. Click Next and then Install. 

7. The setup program may prompt you to restart your system if:

   • Files required for the update are in use during the setup program. 
   • The program needs to install shared components on your system. 

   Note: You may need to restart your system to complete the service release installation process. 

8. At the end of the installation, click Finish. The Installation Complete window offers:

   • A link to the Rational Developer Network. 
   • The option to view Rational release notes.

9. Ensure that the installation was successful by checking for one or more of the following:

   • Check the service release log to and search for this text in the log file: "Product: Rational <Product Name> - - Configuration completed successfully." 
   • Installation windows for each product updated.
   • Verify that each product included in this update is now v2003.06.01 (Rational Software Installed Product Information).

Note: The version number 2003.06.01 will appear for all Rational products, regardless of whether or not a product change was applied to them in this service release. Click here for a list of products included in this service release. 

Applying the Rational Service Release Using a Release Area

For reference information on release areas and silent installations, refer to the Installation Guide for Rational Server Products on the Rational Solutions for Windows Online Documentation CD-Rom, or online. 

Applying this Service Release to a Release Area

1. Download the service release mechanism.
2. Look in the Setup folder in the release area for the product's . msi file. For example, Rational Quantify would be quantifyNT.

3. Use the command msiexec /p <path to service release.msp> /a "<path to product.msi in release area>" /l*v <mylog>.log, where:

   • <path to service release.msp> is the location of the service release mechanism you downloaded. Map a network drive to this location. For instructions on how to do this, refer to your Windows Help system.
   • <path to product.msi in release area> is the location of the release area and the <product>.msi file (for example, quantifyNT.msi). 
   • The last portion /l*v <mylog>.log creates a service release log file. 
     You should name the file something other than Rational_install.log, so as not to overwrite your installation log from Rational v2003.06.00 installation ( if it was created in the same location as your service release installation log). 
     You will also need to select a location for this log file and include the path here. 
     Notes: 
     You can leave out this portion of the command if you do not want to create a service release log file.
     To cancel installation of this service release, click Cancel at any time.
4. When the Welcome dialog box launches, click Update
5. Read the Product Warnings and perform the required tasks, then click Next.

6. Read the License Agreement.

   • If you reject the agreement, the program ends. 
   • If you accept the agreement, the service release update continues. Proceed with these instructions.
7. Click Next and then Install. 

8. The setup program may prompt you to restart your system if:

   • Files required for the update are in use during the setup program. 
   • The program needs to install shared components on your system. 

   Note: You may need to restart your system to complete the service release installation process. 

9. At the end of the installation, click Finish. The Installation Complete window offers:

   • A link to the Rational Developer Network. 
   • The option to view Rational release notes.

10. Ensure that the installation was successful by checking for one or more of the following:

    • Check the service release log to and search for this text in the log file: "Product: Rational <Product Name> - - Configuration completed successfully." 
    • Installation windows for each product updated.
    • Verify that each product included in this update is now v2003.06.01 (Rational Software Installed Product Information).

11. Repeat these steps for each product in the release area. If you are updating a Rational Suite, it should have its own .msi file in the Setup folder (for example, wsbuEnterprise.msi).
    

Note: The version number 2003.06.01 will appear for all Rational products, regardless of whether or not a product change was applied to them in this service release. Click here for a list of products included in this service release. 

Installing in Silent Mode from a Patched Release Area

Silent mode is an unattended installation arranged by administrators wherein client users are not required to select options or make decisions about their product installations. This ensures that all users have the same defaults and options on their desktops. For more information on silent installations, refer to the Installation Guide for Rational Server Products. 

Note: The Rational Software Setup program for service releases does not support post-installation commands. Users must run the silent installation using the following procedure.

We recommend that you back up Rational install log files before performing a silent installation. For more information on how to do this, refer to the Installation Guide for Rational Server Products.

To apply a service release from a release area in silent mode: 

1. Make sure that your system administrator applied the service release to the release area you will use.
2. Use the following command to install the service release to your desktop client: <local drive>:\setup.exe /g <C:\sitedefs.dat>.

Removing a Rational Service Release

Once a service release is applied, you cannot uninstall the updates it makes from your computer. To revert to your previous Rational product configuration:

1. Uninstall all Rational products for which the service release was applied.
2. Install your preferred Rational product version again.

Canceling Installation of a Service Release 

To cancel installation after saving the .msp file to your hard disk, and beginning installation, click Cancel at anytime. 

Product Documentation

For detailed, product-specific information included in this service release, read the service release Release Notes (also available online at http://www.rational.com/support/documentation/manuals/v2003/index.jsp): 

Defects and Changes

• Defects and limitations associated with v2003.06.00 Rational products can be found in the v2003.06.00 Release Notes. (To access this site, you must have a Rational Member Profile and be logged in using that profile.)
• Defects, limitations, and product fixes for this service release can be found in the Rational service release Release Notes. 
• Product fixes contained within this service release are available at http://www.rational.com/support/documentation/release/v2003/rs_sr_defects.htm. 
  

Defects and Limitations in This Service Release

This section identifies additional defects and limitations associated with v2003.06.00 Rational products that were not included in the v2003.06.00 Rational Release Notes. 

Defects Fixed in This Service Release

Product fixes contained within this service release are available at  http://www.rational.com/support/documentation/release/v2003/rs_sr_defects.htm. 

Contacting Rational Customer Support

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

Voice Support is available to all current contract holders via a telephone number in your country (where available). For specific country phone numbers, please refer to the IBM Software Support Handbook, Appendix B: Contact Information, found at www.ibm.com/software/support.