Version 2003.06.13, September 2004
This file last updated: 08/09/2004
Material ID/Part Number: GI10-3259-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.
The complete listing of IBM Rational Legal Notices is automatically installed with IBM Rational Suite in <Install Path>\Rational\doc\legal_information.html. Optionally, the Legal Notices can be found on the "IBM Rational Solutions for Windows CD-ROM" at \doc\legal_information.html.
Product changes described in this document and contained within this service release apply to IBM Rational Solutions for Windows and other IBM Rational products from the following releases:
Go to the IBM Rational Service Release release notes if you are upgrading from:
The Service Release Notes includes:
These release notes provide information critical to installing and using IBM Rational products, including the list of supported platforms and known issues with this release.
Note: Some content from earlier versions of the IBM Rational Suite Release Notes has been removed from this document and included in the following IBM Rational guides that were updated in v2003.06.13:
- The "IBM Rational Software Desktop Products Installation Guide"
- The "IBM Rational Software Server Products Installation Guide"
- "IBM Rational Suite Upgrade Guide."
These release notes are for the following IBM Rational Suite products:
This table shows which tools are typically included with each edition of IBM Rational Suite. Tools that were localized to Japanese for v2003.06.10 appear in blue text.
Table 1. IBM Rational Suite Editions
|
|
|
Project Leaders/ Managers |
Analysts |
Developers |
Testers |
All Roles |
|||
|---|---|---|---|---|---|---|---|---|---|
Team Unifying Platform |
Analyst Studio |
DevelopmentStudio |
DevelopmentStudio RealTime Edition |
TestStudio |
Enterprise |
||||
|
|
|
Windows
|
Windows
|
Windows
|
UNIX
|
Windows
|
UNIX
|
Windows
|
Windows
|
|
Team Unifying Platform
|
IBM Rational Unified Process |
*
|
*
|
*
|
*
|
*
|
*
|
*
|
*
|
| IBM Rational RequisitePro |
*
|
*
|
*
|
*WEB
|
*
|
*WEB
|
*
|
*
|
|
| IBM Rational ClearQuest |
*
|
*
|
*
|
*
|
*
|
*
|
*
|
*
|
|
| IBM Rational SoDA |
* SW
|
* SW
|
* SW
|
* SW
|
* SW
|
* SW
|
* SW
|
* SW
|
|
| IBM Rational ClearCase LT |
*
|
*
|
*
|
*
|
*
|
*
|
*
|
*
|
|
| IBM Rational TestManager |
*
|
*
|
*
|
* TA
|
*
|
*TA
|
*
|
*
|
|
| IBM Rational ProjectConsole |
*
|
*
|
*
|
|
*
|
|
*
|
*
|
|
|
|
IBM Rational Rose |
|
* M
|
* E
|
* U
|
* RT
|
* RT/U
|
|
* E
|
|
|
IBM Rational PureCoverage |
|
|
*
|
*
|
*
|
*
|
*
|
*
|
|
|
IBM Rational Purify |
|
|
*
|
*
|
*
|
*
|
*
|
*
|
|
|
IBM Rational Quantify |
|
|
*
|
*
|
*
|
*
|
*
|
*
|
|
|
IBM Rational Robot |
|
|
|
|
|
|
*
|
*
|
|
|
IBM Rational TestFactory |
|
|
|
|
|
|
*
|
*
|
| E = Enterprise Edition M = Professional Data Modeler Edition RT = RealTime Edition SF = IBM Rational SoDA for FrameMaker SW = IBM Rational SoDA for Word TA = Used in conjunction with test agents U = UNIX Edition WEB = Accessed through Web interface only Additional IBM Rational Rose tools localized to Japanese in v2003.06.10: Professional Ada Edition Professional C++ Edition Professional J Edition Professional Visual Basic Edition |
|||||||||
For detailed information about individual products, see the product-specific release notes located on the IBM Rational Solutions for Windows CD-ROM in the \doc folder. These release notes are installed by default in C:\Program Files\Rational\doc\.
This release contains new features for the products in IBM Rational Suite. The release notes for the products in each IBM Rational Suite edition describe the new features for each product. See <Install Path>\doc\rs-release-notes.htm for a link to release notes for each IBM Rational Suite product. If you customized the documentation installation for your IBM Rational Suite product, this link will not work. The file that links you to point-product release notes is also available by clicking Start > Programs > Rational Software > Readme for all products.
What's New in This
Release
New and Changed
Features
Product
Documentation
Hardware
and Software Information
Client
Requirements
Server
Requirements
Installation,
Upgrading, and Licensing
Installation
Information
Upgrades
Licensing
Compatibility issues
With IBM Rational
Products
With Third-Party
Products
Restrictions and
guidelines on using IBM Rational Suite
Known issues and change
requests
Documentation updates
Defects and
Limitations
Contacting Rational
Customer Support
Rational Customer Support for Licensing
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 Center at http://www.ibm.com/shop/publications/order. Search for GI10-3259-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.)
This section contains information about new and updated features for products and components included in IBM Rational Suite versions 2003.06.00 through 2003.06.13. This section may not be exhaustive. For more information about what is new in a specific IBM Rational product, see the release notes for that product.
IBM Rational Suite uses the Microsoft Windows Installer technology, which provides new capabilities including:
The IBM Rational Administrator now supports:
The IBM Rational Administrator no longer supports Windows 98 or Windows ME.
IBM Rational ClearCase LT has been enhanced to include the following:
For more information about IBM Rational ClearCase, see the ClearCase release notes.
IBM Rational ClearQuest includes:
ClearQuest v2003.06.00 introduced the ClearQuest data code page. This setting controls the set of characters, based on code pages, that a client can enter into a ClearQuest database. This value must be explicitly set against schema repository by a ClearQuest administrator. If it is not set, ClearQuest defaults to the most restrictive setting (ASCII characters only). For information about the ClearQuest data code page, including instructions on how to set it, and how the page relates to your ClearQuest environment, review the documentation about the ClearQuest data code page in the "ClearQuest Administrator's Guide."
Note: Before you upgrade to 2003.06.13 from 2001A.04.10, you need to upgrade the software to 2003.06.10. Follow the instructions in the IBM Rational ClearQuest release notes for how to upgrade schema packages.
For more information about IBM Rational ClearQuest, see the ClearQuest
release notes.
IBM developerWorks Rational extends the reach of the development team with the expertise of an online community, providing useful information as well as an exchange of ideas and best practices. Content on the site has been edited for quality and relevance, and organized into technology and process containers for easy use. These resources, along with Web-based training, help individual team members to expand their professional skills and stay ahead of the technology curve. Use the site to:
IBM Rational ProjectConsole now includes:
For more information about IBM Rational ProjectConsole, see the ProjectConsole release notes.
See the "IBM Rational QualityArchitect Release Notes."
The IBM Rational RequisitePro and RequisiteWeb now include:
For more information about RequisitePro and RequisiteWeb capabilities, refer to the IBM Rational RequisitePro Release Notes.
IBM Rational Robot now includes:
For more information about IBM Rational Test products, see the Test products release notes.
This release of IBM Rational Rose includes these new features and enhancements:
For more information about IBM Rational Rose, see the Rose release notes.
Core Rose enhancements
Rose J Add-In enhancements
Rose VC++ Add-In enhancements
Rose Data Modeler enhancements
For more information, see the Rose release notes.
IBM Rational Rose RealTime Edition now includes:
For more information about IBM Rational Rose RealTime, see the Rose RealTime release notes.
IBM Rational SoDA for Microsoft Word now includes these features:
For more information about what is new in IBM Rational SoDA, see the SoDA release notes.
You can access the IBM Rational Suite Tutorial by clicking Start > Programs > Rational Software > Download Rational Suite Tutorial, or by going directly to http:/www.ibm.com/software/rational/support/documentation/.
See the "IBM Rational Testing Product Release Notes."
IBM Rational TestManager now includes these features:
This is a wizard-based user interface front-end for our current datastore utilities. Start this wizard from the IBM Rational Administrator.
Updated and new features include:
Users can concurrently select and delete multiple test logs from the Results view of the Test Asset Workspace. (Assets covered by this functionality include builds, test log folders, and test logs.)
For more information about any of these new features, see the v2003.06.13 IBM Rational TestManager release notes.
The products in IBM Rational PurifyPlus are: IBM Rational Purify, IBM Rational Quantify, and IBM Rational PureCoverage. Highlights of the current release include:
IBM Rational PurifyPlus, IBM Rational Purify, IBM Rational Quantify and IBM Rational PureCoverage now all have support for managed code (including VB.NET and C#) and unmanaged code (Visual C/C++ and VB). PurifyPlus is seamlessly integrated in the Visual Studio .NET IDE, allowing users to collect runtime data and analyze memory usage, profile performance, and monitor code coverage from Visual Studio .NET. With PurifyPlus, you get the best in runtime error detection and memory profiling, the most powerful tool for identifying and analyzing performance bottlenecks, as well as automatic identification of all untested code for Microsoft .NET and Visual Studio applications.
PurifyPlus now supports selective instrumentation for Java and .NET managed code. This powerful new facility allows users to easily select the classes they wish to instrument. By default, all classes are instrumented with the exception of a set of domain-specific classes that are typically not of interest. It is also possible to explicitly select a set of classes to instrument and exclude everything else.
The enhanced Java support new in PurifyPlus gives developers support for the very latest Standard Development Kit (SDK) from Sun.
ASP.NET Profiler is a technology preview module that lets users analyze .NET Web services without the tedious workarounds of setting up environmental variables and restarting the computer. After starting the Agent, users right-click the icon in the system tray and select one of the suggested options: Purify, Quantify, PureCoverage or None. The first three options attach the PurifyPlus tool to the running ASP.NET process and start collecting memory profiling data, performance profiling data, or code coverage.
IBM Rational Purify now includes support for class filtering in both Java and .NET managed applications. You can now open the Class Instrumentation dialog box to include or exclude classes during data collection. You can also filter classes to exclude and precisely control data collection.
IBM Rational Purify now supports:
The problem that prevented Purify from running inside the Microsoft Visual Studio 6.0 IDE after certain Windows 2000 upgrades (including SP3) has been resolved.
IBM Rational Quantify now includes support for class filtering in both Java and .NET managed applications. You can now open the Class Instrumentation dialog box to include or exclude classes during data collection. You can also filter classes to exclude and precisely control data collection.
IBM Rational Quantify now supports:
The problem that prevented Quantify from running inside the Microsoft Visual Studio 6.0 IDE after certain Windows 2000 upgrades (including SP3) has been resolved.
The code coverage merge facility has been enhanced to allow finer control over the displayed merge results. If the ActiveMerge checkbox in the Preferences dialog box is selected, Auto Merge datasets in the PureCoverage Navigator include a Layer subentry for each run that contributes to the merge. Users can then select and deselect these layers in any combination to easily determine how much each of the associated runs contributed to the merge results. In the annotated source window for merged runs, if a line is selected, the check box for each merge layer is color coded to reflect whether the associated test included the given line. When viewing the function list, if a function is selected, the checkboxes for each merge layer will be colored to indicate whether the associated test included the given function.
Command-line support for merging has been added. A user can merge multiple coverage data files using either of the following command lines:
coverage /MergeFileList=<filename1; filename2; filename3> /SaveMergeData=<merge-filename> /IncludeContribData=TRUE (default is FALSE)
In this case, the file list is directly supplied on the command-line by means of the /MergeFileList option. The files specified in filename2, filename3, and so on are merged into filename1. The results are stored in the merge-filename specified in the /SaveMergeData option. To save the data as text /SaveMergeTextData may be used instead of /SaveMergeData.
coverage /MergeMaster=<filename> /SaveMergeData=<merge-filename> /IncludeContribData=TRUE (default is FALSE)
In this case, the user specifies the merge files using a merge master file. The merge master file defines the merge contributors and has a simple format with one file per line separated by a carriage return/line feed pair. To save data as text /SaveMergeTextData may be used instead of /SaveMergeData. In both cases, if no merge-filename is specified, the default name used for the generated merge file is PUTName_UserMerge.cfy or PUTName_UserMerge.txt, depending on whether a binary or text file is requested. Also, the resulting merge could have either the details of all the contributing datasets stored in it or just the merge results. If the /IncludeContribData option is set, details regarding individual contributions to the merge are saved, enabling subsequent use of ActiveMerge within the user interface. If the option is not set (which is the default), details regarding individual contributions are not saved and the resulting file data will appear to come from a single run.
IBM Rational PureCoverage now includes support for class filtering in both Java and .NET managed applications. You can now open the Class Instrumentation dialog box to include or exclude classes during data collection. You can also filter classes to exclude and precisely control data collection.
IBM Rational PureCoverage now supports:
The problem that prevented PureCoverage from running inside the Microsoft Visual Studio 6.0 IDE after certain Windows 2000 upgrades (including SP3) has been resolved.
For more information about what is new in IBM Rational PurifyPlus, Purify, PureCoverage, and Quantify, see the release notes for those products.
The IBM Rational Unified Process now includes:
For more information about IBM Rational Unified Process, see the Rational Unified Process release notes.
Product documentation (including release notes) is available from:
Note: The following guides were updated in v.2003.06.13:
If you are installing IBM Rational products for the first time, read:
If you are upgrading to this release from an earlier version, read:
Note: Release Notes typically include information about new features and functionality, hardware and software requirements for installing IBM Rational products, and issues that may not be documented elsewhere. Service Release Notes supplement the Release Notes and typically include upgrade information, defects in the current service release, and a list of defects that have been fixed.
The installation guides for most point products have been eliminated in favor of combining the information into two guides:
Acrobat Reader 5.05 is supported for English and Japanese versions of this release.
As of v. 2003.06.00, the "IBM Rational Solutions for Windows Online Documentation CD-ROM" no longer includes a copy of Adobe Acrobat Reader. To view and print PDF versions of IBM Rational Software online documentation, you need Acrobat Reader version 4.0 or later, which you can download directly from the Adobe Web site at http://www.adobe.com/.
The English version of "IBM Rational Solutions for Windows Online Documentation CD-ROM" supports full-text searches of Adobe Acrobat PDF files. To use this feature, you need an English version of Acrobat Reader version 4.0 or later, including the option for searching Adobe PDF files. You can download this directly from the Adobe Web site at http://www.adobe.com/. To get started with this feature, see using_search.pdf on the English version of "IBM Rational Solutions for Windows Online Documentation CD-ROM."
The following sections outline the supported platforms and installation requirements for this version of IBM Rational Suite on client and server systems.
See the individual product release notes for a list of additional, product-specific requirements.
This table provides the recommendations and requirements for operating
Rational desktop products on your desktop. See the IBM Rational installation
guides for more information.
Table 2. Desktop requirements and recommendations
| Item | Requirements and recommendations | ||
|---|---|---|---|
| Operating systems |
|
||
|
Note:
|
|||
| Hardware |
|
||
|
Note:
512 MB RAM; 1 GB recommended for XDE Developer and Developer Plus
versions.
|
|||
| Remote access support | See the "Server Requirements and Recommendations" table in the IBM Rational Server Products Installation Guide or the IBM Rational Suite Release Notes. | ||
| Rational Suite disk space |
|
||
| Point Product disk space | ClearCase LT client file storage space:
Rational ClearCase LT needs enough disk space on the desktop to contain all files loaded into snapshot views and all view-private files added to the views. The amount of space required depends on the number and sizes of the files in the views. |
||
|
|||
| Integrations with 3rd party applications | |||
| ClearCase LT |
|
||
| ClearQuest |
|
||
| ProjectConsole |
|
||
| RequisitePro |
|
||
| SoDA |
|
||
| TestManager |
|
||
| IDEs, integrations with 3rd party development applications, and add-ins. Earlier versions of Eclipse, WebSphere Studio Workbench, and WebSphere Application Developer that were supported in v.2003.06.00 release are still supported in this release. | |||
| ClearCase LT |
|
||
| ClearQuest |
Note:
For more information about ClearQuest Eclipse Client platform support
and integrations, see the ClearQuest Eclipse Client documentation.
|
||
| Purify, PurifyPlus, PureCoverage, and Quantify | PurifyPlus supports WebSphere Studio Workbench 2.1.2 and WebSphere Application Developer 5.1.2. For the latest support information, see the PurifyPlus Family Release Notes. | ||
| Robot and TestManager |
|
||
| Rose | Rose C++ Professional, Rose Data Modeler
Professional, Rose Enterprise, Rose Web Modeler
|
||
Rose J supports the following Java IDEs.
Use the JDK appropriate to your IDE.
|
|||
| Rose Data Modeler | Rose Data Modeler can produce data models
for the following databases:
To reverse engineer Oracle and DB2 databases using Rose Data Modeler, an RDMS client must be installed. The Microsoft .NET Framework (v.1.1 or higher) is required to install the Rose Data Modeler and Rose Web Modeler add-ins. If you do not have the required .NET versions installed and choose to continue the installation, these add-ins will not be installed and previously installed versions of these add-ins will be disabled. You can install these add-ins at any time after you install the .NET Framework by using the Change option of your Rose installation in the Add/Remove Programs in the Control Panel. |
||
| Rose RealTime | For the latest support information, see the IBM Rational Rose RealTime Release Notes. | ||
| Rational Test Agent software | In addition to the platforms listed as
supported by all desktop products, you can install Test Agents on the
following operating systems:
Windows:
|
||
UNIX:
|
|||
|
|||
| XDE | For the latest support information, see the Release Notes for XDE Developer, XDE Modeler, and XDE Developer Plus in your product CD. | ||
| XDE Tester |
|
||
Integrated with the following IDE and
shell:
|
|||
| Web browsers on Windows |
|
||
|
Note:
|
|||
| Web clients on non-Windows platforms | ClearCase Web
Note:
ClearCase Web requires J2SE 1.4.1
|
||
ManualTest Web
|
|||
ProjectConsole
Note:
Netscape 7.0 and above and Mozilla 1.6 require the 1.4.2_05 version of
the Sun JRE. Netscape 7.1 and Mozilla 1.6 require the NS610-GCC32
version of the libjavapjugin_oji.so. Netscape 7.0 requires the NS610
version of the plug-in
|
|||
| RequisiteWeb and Rational Unified Process Netscape Navigator 4.72-4.78, 7.0 on Solaris 2.6, 7- 9, HP-UX 11.0 (QPK 1100), 11i v2, 11.11 GoldQPK11i, Bundle 11i, 11.23. | |||
Rose Web Publisher
|
|||
XDE Web Publisher
|
|||
| Microsoft JVM | The Rational Setup Wizard does not install the Microsoft JVMs with the products in this release, nor does it remove the Microsoft JVM from previous Rational installations. Look in the product-specific release notes for more information. | ||
| Automated license key requests | Internet Connection to request and receive license key files. For more information, see the IBM Rational Software License Management Guide. | ||
| Dual boot systems | Rational Suite and Rational Rose do not support dual boot systems where both operating systems are on the same partition. | ||
| IBM Rational documentation | Adobe Acrobat Reader 4.x or higher to read online PDF files. Download a free version of Adobe Acrobat Reader from http://www.adobe.com. | ||
| Language support | You can install IBM Rational products on
these international operating systems:
All displays, menus, controls, wizards, reports, and user documentation are in U.S. English with the following exceptions: most of Rational Suite v2003.06.10, v2003.06.12, and v2003.06.13 are translated into Japanese.
|
||
This table provides the recommendations and requirements for operating IBM
Rational server products in your environment. You may operate the software on
computers that may not meet all the hardware recommendations. The
recommendations in this table provide guidelines for good operating
performance. See the IBM Rational installation guides for more information.
Table 3. Server system and software requirements
| Item | Requirements and recommendations |
|---|---|
| Operating systems |
Note:
|
| Hardware |
Note:
For New ClearQuest Web minimum and recommended hardware requirements,
see the New ClearQuest Web Installation Guide.
|
| ClearCase LT Server file storage space requirements |
|
| Rational Suite disk space |
Note:
If Rational ProjectConsole is included in your Rational Suite, it
requires 1+ GB for its repository.
|
| Point product disk space |
|
| Databases | ClearQuest Databases
Note:
ClearQuest also supports databases on UNIX operating systems. For the most current information, see http://www.ibm.com/support/. Click Technical Support Search and enter "supported ClearQuest platforms and databases". |
| RequisitePro Enterprise Database
Supports the same database vendors listed in the ClearQuest section, except Sybase SQL Anywhere
Note:
RequisitePro supports the same vendor databases and UNIX operating
systems listed in the ClearQuest section.
|
|
Rational TestManager Database
|
|
Project Console
|
|
| Sybase SQL Anywhere | Sybase SQL Anywhere 8.0.2 is available on the
IBM Rational Solutions for Windows
installation CD or part of your IBM Web download package. It is
configured to work only with Rational products. Select SQL Anywhere from
the Product Selection list in the Rational
Setup Wizard. . If you have installed Sybase SQL Anywhere 5.5 from Sybase and also from any of these IBM Rational products: IBM Rational ClearQuest, TestFactory, Robot, ProjectConsole, TestManager or TestManager Agent, you may experience a DLL conflict error. We recommend that you upgrade to the most recent Sybase SQL Anywhere database. For more information, contact IBM Rational Customer Support. |
| Hosted development systems (remote sessions) | ClearCase, ClearQuest, RequisitePro, Robot, Rose, and
SoDA support hosted development on these platforms:
Note:
|
| Web servers |
|
For Rational ManualTest Web Execution:
We recommend that you use Windows 2000 Server, Windows 2000 Advanced Server, or Windows NT 4.0 Server as the Web server platform. You cannot use a shared or networked project on Windows XP Professional, Windows 2000 Professional, or Windows NT 4.0 Workstation. |
|
| Microsoft JVM | The Rational Setup Wizard does not install the Microsoft JVM with the products in this release nor does it remove the Microsoft JVM from previous Rational installations. Look in the product-specific release notes for more information. |
| Automated license key requests | Internet connection to request and receive license key files. For more information, see the IBM Rational Software License Management Guide. |
| Dual boot systems | Rational Suite does not support dual boot systems where both operating systems are on the same partition. |
| IBM Rational documentation | Adobe Acrobat Reader 4.x or higher to read online PDF files. Download the free Adobe Acrobat Reader from www.adobe.com. |
| Language support | You can install IBM Rational Suite on these
international operating systems:
All displays, menus, controls, wizards, reports, and user documentation are in U.S. English with the following exceptions: most of Rational Suite v2003.06.10, v2003.06.12, and v2003.06.13 are translated into Japanese.
|
Before you try to upgrade your IBM Rational products, you or your system administrator must see the "IBM Rational Suite Upgrade Guide" on the "IBM Rational Solutions for Windows Documentation CD-ROM."
Refer to the "IBM Rational Software Desktop Products Installation Guide" for details on all warnings and blocking messages given during v. 2003.06.00 product installation.
Large-scale installations are supported through the use of release areas in v. 2003.06.00 and later. Network or Minimal installation models are no longer available as of v. 2003.06.00.
To uninstall IBM Rational Suite from a client that used the Network or Minimal installation model, the original network location needs to be available during the uninstall process.
The IBM Rational Setup wizard now supports enterprise-level deployments through the use of release areas. The installation model, known as Network or Minimal installations, are no longer available. Refer to the "Installation Guide for IBM Rational Server Products" for details on enterprise-level deployments.
Before you install IBM Rational Suite, use the IBM Rational Site Preparation Tool to pre-configure product settings specific to your environment. Refer to the "IBM Rational Software Server Products Installation Guide."
The ClearCase LT Getting Started wizard will automatically run at the end of a ClearCase LT Server installation.
If you have earlier versions of IBM Rational products installed on your system, you will see a warning page during installation. If you are setting up a silent installation, pay attention to this message and take steps to ensure that users upgrade all IBM Rational products. Users who install silently do not see this warning message. The message is saved to a file called rational_install.log in the user's Temp folder, but the user may not remember to look at the log file after completing the installation.
The IBM Rational Installer will install the Microsoft Windows Installer Service if the version on the target host is earlier than v. 2.0, or if the Microsoft Windows Installer Service does not exist.
If you cancel installation or installation fails, Microsoft Office products may not start. If this occurs, restart your computer to resolve the problem.
When installing or downloading a JRE, do not select it as the default JRE for your Web browser.
IBM Rational Suite installation automatically installs MDAC 2.7 Service Pack 1 (SP1) on your system because MDAC is required for all IBM Rational products that use a database.
The following files from LEAD Technologies, Inc., are included in this release:
lfbmp13n.dll
lfcmp13n.dll
lflmb13n.dll
lfpng13n.dll
lfwmf13n.dll
ltdis13n.dll
ltefx13n.dll
ltfil13n.dll
ltimg13n.dll
ltkrn13n.dll
ltocx13n.ocx
lttwn13n.dll.
Before you try to upgrade your IBM Rational products, you or your system administrator must see the "IBM Rational Suite Upgrade Guide" on the "IBM Rational Solutions for Windows Online Documentation CD-ROM," or go to http://www.ibm.com/software/rational/support/upgrades/ and select a product.
Note: If you are upgrading from a
release that is earlier than IBM Rational Suite version 2002.05.20, review the
upgrade information from previous releases from the
IBM Publications Center and at:
http:/www.ibm.com/software/rational/support/documentation/.
If IBM Rational products are currently installed on your system, you can update the existing Rational product in the current location (or install additional products to the same location. You cannot change the installation directory during upgrades.
To install our products into a different location than currently on their system, you must uninstall the current Rational product version, then install to the new location.
For more information, see "IBM Rational Suite Upgrade Guide."
To learn more about the licensing issues for your IBM Rational products, you or your system administrator must read the "IBM Rational Software Desktop Products Installation Guide" and the "IBM Rational Licensing Administrator's Guide" on the "IBM Rational Solutions for Windows Online Documentation CD-ROM," or in the IBM Publications Center at http://www.ibm.com/shop/publications/order.
To launch your IBM Rational product, you will need a product or component license key. Your Passport Advantage software shipment or Passport Advantage software download contains a document called "Important Licensing and Installation Information." This document contains the following information:
List of product components
License key type required for each component, if applicable. For example, if you purchased an authorized user license, you will obtain either a node-locked or named-user license key, depending on the product.
The product account number
Instructions for obtaining your license key for each component
You can use either the "Important Licensing and Installation Information" document or the "Proof of Entitlement" certificate to obtain your license keys from IBM.
To find AccountLink:
You can also use the information in the "Proof of Entitlement" (PoE) that you should have received either by mail or in an e-mail message to obtain license keys. To find the e-mail message from IBM in your e-mail application, look for the following attributes:
|
If you bought your product from… |
From Email Account (Sender Email) |
Email Subject Line |
|
Passport Advantage |
Passport_Advantage@ibm.com |
IBM Passport Advantage Proof of Entitlement |
|
Passport Advantage |
Passport_Advantage@ibm.com |
Passport Advantage Express Proof of Entitlement |
|
Outside of Passport Advantage |
IBM_Software_Group@ibm.com |
IBM Software License Customer |
If you are a ClearCase, ClearDDTs, or Ada customer, see the instructions in ClearCase, ClearDDTS, and Ada Licenses.
If you purchased ClearCase, ClearDDTS, and Ada licenses, use the information from your "Proof of Entitlement" (PoE) document to order license keys.
For ClearCase products: Submit the ClearCase or ClearDDTS request or move form.
For Ada products: Click the link to the instructions page and fax or send an e-mail message with the required information to the IBM Rational Support team (http://www.ibm.com/software/rational/support).
The Authorized User license allows a single individual to use the product on multiple machines at the same time. If you purchased this type of license, you need a specific license key type to use the product. You can find this information in your "Important Licensing and Installation Information" document in your shipment or the "Proof of Entitlement" certificate.
|
Product or component |
License key to use |
|
XDE products |
No license keys needed |
|
Rose products |
Node-locked |
|
ClearQuest |
Node-locked |
|
Robot |
Node-locked |
|
RequisitePro |
Node-locked |
|
Team Unifying Platform |
Node-locked |
|
Rational Suite Enterprise |
Node-locked |
|
Purify for Windows |
Node-locked |
|
Purify for Linux and UNIX |
Named-User |
Note: Web products, such as RequisiteWeb and ClearQuest Web, require a floating license type.
If you need to use the product on multiple machines and are using a node-locked license key, use the same account number each time you order a node-locked key in AccountLink. Purify uses a named-user key, a floating license key type. You do not have to order multiple license keys to use this product on multiple machines.
This section identifies special considerations for using IBM Rational Suite with other products, including IBM Rational products and third-party software products.
For more detailed information about compatibility issues among IBM Rational products, go to the release notes for the specific IBM Rational products of interest to you.
If you are installing IBM Rational XDE, IBM Rational PurifyPlus, or a Suite product containing IBM Rational PurifyPlus, the IBM Rational Setup wizard will prompt you to select the IDE in which you want the product to run. The selectable list of IDEs is dependent on your system's IDE.
Because of an install directory change after IBM Rational E-Mail Reader version 2002.05.20, if you install RequisitePro as a point product, the complete IBM Rational E-Mail Reader files are not installed. If you attempt to open mailreader.exe, an error message states that expected .dll files are not present. In order to resolve this issue, install IBM Rational ClearQuest 2003.06.00 or later on your system. IBM Rational ClearQuest 2003.06.00 or later may be installed separately or as part of an IBM Rational Suite product. No license is required for ClearQuest. (RATLC00694844).
IBM Rational XDE 1.0 is not compatible with IBM Rational Suite 2002.05.20. IBM Rational XDE 1.1 is supported.
For more information about IBM Rational XDE, go to the IBM Rational Support Web site, http:/www.ibm.com/software/rational/support/ and read the IBM Rational XDE Release Notes.
For information about IBM Rational RequisitePro integration with Rational XDE, see the Rational RequisitePro release notes.
Some versions of IBM Rational Purify, IBM Rational Quantify, and IBM Rational PureCoverage are not compatible with XDE versions. For more information about IBM Rational XDE, go to the IBM Rational Support Web site, http:/www.ibm.com/software/rational/support/ and read the IBM Rational XDE Release Notes.
If you have installed an earlier version of IBM Rational Test RealTime on the same system with IBM Rational Suite, upgrade IBM Rational Test RealTime to version 2002.05. Earlier versions of IBM Rational Test RealTime will fail after installation of IBM Rational Suite version 2002.05. Upgrades are free to all IBM Rational customers with a current maintenance contract. Please contact your IBM Rational sales representative for additional information.
When you add test and requirements assets to source control or perform a Checkin All operation, system performance can be very slow for medium-to-large requirements and test projects.
IBM Rational Suite 2002 lets you place requirements and test assets under version control in an IBM Rational ClearCase VOB. This support uses two operations from the IBM Rational Administrator: Add to CM and Checkin All. Add to CM adds the assets to source control and Checkin All captures a snapshot of the assets. In both cases, if you have a large number of requirements or test assets, these operations may take a long time and could make these features unusable, depending on how often you perform these operations.
The time it takes to perform these operations directly depends on the number of files required to store the requirements and test assets. For requirements assets, the number of required files is independent of the number of saved views, requirement types, and documents. The number of files is not dependent on the number of requirements. For test assets, the number of files needed mostly depends on the number of scripts and the number of verification points in each script being managed.
Use the following information to estimate the time it will take for the Add to CM and Checkin All operations for existing requirements and test projects. Because there is a strong relationship between the performance of these operations and the number of file elements placed under source control, start by determining the number of file elements that will be involved in the operation.
To estimate the number of files added to source control or checkpointed for an IBM Rational RequisitePro project, use the following formula:
Number of
Files = 10 + 3 * (number of documents) + (number of saved views) + (number of
Requirement Types)
Estimated Operation Time in Minutes: 10 * number of files) / 60
seconds
Example:
Number of documents =
165
Number of saved views =
37
Number of Requirement Types =
12
The time required to add a RequisitePro project to source control is proportional to the number of requirement types, documents, and saved views in the project. Adding the above example (554 files) to source control initially took:
If you use IBM Rational ClearCase LT to baseline your IBM Rational RequisitePro project, here are some tips to improve performance of Checkin All operation:
To estimate the number of files added to source control or checkpointed for a Test project, use the following formula:
Number of GUI script files = (number of GUI scripts) * (2 + OP + (2 * OD))
Where:
OP = Average number of object property verification points + average number of low level scripts + average number of alphanumeric verification points
OD = Average number of object data verification points
Number of files = 200 + number of GUI script files + number of manual scripts
Estimated operation time in minutes:
(10 * number of files) / 60 seconds
Example:
Number of GUI scripts =
200
Estimated 3 object or
alphanumeric verification point and/or low-level scripts
Estimated
1 data verification point
Number of manual scripts =
100
Number of GUI script files = 200
* (2 + 3 + (2 * 1)) = 1400
The 10x factor in computing the time is based on an estimated five seconds for two ClearCase operations that must be performed on each file in this implementation. You may be able to improve performance of these operations with a high-powered and correctly configured ClearCase server.
You may see an error message about data code pages if your IBM Rational project is integrated with ClearQuest. For more information, see the "IBM Rational ClearQuest Documentation Supplement."
For more information, see the IBM Rational RequisitePro release notes.
For more information, see the IBM Rational RequisitePro release notes.
A possible problem has been identified in cases in which ClearCase 5.0 is installed on Windows NT 4.0. After you use the IBM Rational Administrator to perform a UCM datastore operation (such as create a datastore, Checkin All, add to or remove from source control), shut down and restart the IBM Rational Administrator before performing another such operation.
For more information, see the IBM Rational RequisitePro release notes.
For more information, see the IBM Rational RequisitePro release notes.
Under certain circumstances, file system corruption can result from installing IBM Rational Version 2003 products on Windows 2000 to an NTFS partition that has enabled the Windows "Change Journal" (log). This corruption is caused by a defect in Windows 2000. Before you install any IBM Rational Version 2003 product on a computer that is running Windows 2000:
Note: The production release of Windows XP SP2 was not available for final testing at the time this document was finalized. To obtain the latest information about Windows XP SP2 support, go to IBM Rational Support at http://www.ibm.com/software/rational/support/ and search for “Rational products and Windows XP SP2. The following information is based on testing done with Windows XP SP2 Release Candidate 2, released June 14, 2004.
Microsoft Windows XP SP2 includes security measures that may affect IBM Rational products as follows:
You may receive warnings when using online or extended help from IBM Rational products affected by this issue:
Online Help and Rational product HTML files on the hard disk of the
local machine
When using online help for one of these applications, or accessing Rational
product HTML files on the hard disk of the local machine, a warning dialog
might open informing you that the page has been restricted from running active
content that might be able to access your computer. When you are prompted to
do so, choose to allow the page to access your computer.
Note: The warning dialog opens the first time you select HTML active content on the local disk. The dialog notifies you about the new Information bar (in Internet Explorer, beneath the Address box). By default, "Do not show this message again" is selected, and this warning dialog will not be displayed again. Read the content in the Information bar and click anywhere in the bar to select the option that enables active content. Online help should now display.
Rational Unified Process and Extended Help
When using Rational Unified Process or Extended Help from one of these
applications, a warning dialog might open informing you that the page has been
restricted from running active content that might be able to access your
computer. When you are prompted to do so, choose to allow the page to access
your computer.
Note: If the correct Java JRE is not installed on your computer, another warning dialog might open, displaying the following message: “JRE required by RUP and Extended Help not found." If you are operating on Windows XP SP2, this dialog might not open. Still, the correct Java JRE must be installed on your computer for Rational Unified Process and Extended Help to display. For more information about this and any other warnings that may be displayed when using online or extended help from IBM Rational products, go to IBM Rational Support at http://www.ibm.com/software/rational/support/ and search for "Rational products and JRE with Windows XP SP2."
For more information about this issue with Windows XP SP2, click the following links:
Firewall Issues
Windows XP SP2 enables a firewall that might make it difficult for the IBM Rational product client and/or server to operate. You might receive warnings about network connections when using the following IBM Rational client applications:
You might receive warnings about network connections when using the following IBM Rational server applications installed on Windows XP SP2:
Allowing network traffic when using Windows XP SP2
If you are using one of the IBM Rational applications that are affected by XP
SP2, while making outgoing requests, a warning dialog might open to inform you
that an outgoing request is being made. If the firewall blocks network
traffic, then client/server applications will not operate. To ensure that IBM
Rational products operate with Windows XP SP2, you must allow network traffic
by doing one of the following:
IBM Rational License Server (FLEXlm-based) and Windows XP Service Pack 2
Communication ports on Windows XP SP2 are closed by default. For a License
Server installed on Windows XP SP2 to be able to serve licenses to clients
other than itself, it needs two open ports, one each for rational.exe
and lmgrd.exe.
To open the firewall for the IBM Rational License Server (FLEXlm-based) on Windows XP SP2 machines, go to the Rational/common directory and double-click WinXPSP2.reg. This file will import the changes to the registry and open up the firewall for rational.exe and lmgrd.exe to use any ports.
Note: If you did not use the default path (C:\Program Files\Rational\Common\) to install the Rational License Server, you must edit the WinXPSP2.reg file by replacing the C:\Program Files\Rational\Common in two locations in each line with the actual install path. Optionally, you can open the firewall for the IBM Rational License Server (FLEXlm-based) manually by following these instructions:
IBM Rational ClearCase Client or Server with MVFS and Windows XP Service
Pack 2
In order for ClearCase V2002.05 to operate on Windows XP SP2, the latest
V2002.05 patch must be installed.
In order for ClearCase V2003.06 to operate on Windows XP SP2, V2003.06.13 must be installed.
Note: For more information about ClearCase release, patch, and service release versions, go to IBM Rational Software Support at http://www.ibm.com/software/rational/support/, or see the "IBM Rational ClearCase Release Notes."
IBM Rational ClearCase Server including Client with local view and
Windows XP Service Pack 2
In order for ClearCase V2002.05 to operate on Windows XP SP2, the latest
V2002.05 patch must be installed.
In order for ClearCase V2003.06 to operate on Windows XP SP2, V2003.06.13 must be installed, otherwise, the dynamic views will not be accessible remotely even after registering ClearCase servers with the firewall. Also, the VOBs will not be accessible by UNIX clients. In certain cases, the earlier versions of ClearCase clients may not be able to access the VOBs.
Note: For more information about ClearCase release, patch, and service release versions, go to IBM Rational Software Support at http://www.ibm.com/software/rational/support/, or see the "IBM Rational ClearCase Release Notes."
You must register all ClearCase server processes (those from the albd_server and those listed in %CLEARCASEHOME%\config\services\albd.conf) with the firewall by using the Windows Firewall Control panel or netsh firewall add allowedprogram command. See the IBM Rational ClearCase Release Notes for sample batch scripts to register and unregister processes in all scopes and profiles.
IBM Rational TestManager, Robot, and Test Agent and Windows XP Service
Pack 2
The following programs attempt to communicate through the firewall and may
cause a firewall pop-up window requesting whether their communication should
be allowed through. These programs should be unblocked as a response to this
dialog and from then on will be allowed through the Microsoft firewall. The
known programs include: rtprvu.exe, rtpsvc.exe, rtprvd.exe,
rtasrv.exe, rtpsrv.exe, rtmanager.exe, rtrobo.exe,
and rtstsee.exe.
SQL Anywhere and Windows XP Service Pack 2
For more information about SQL Anywhere Studio and Windows XP Service Pack 2,
go to
http://www.ianywhere.com/developer/technotes/sas_xp_sp2.html.
If you have installed Sybase SQL Anywhere 5.5 from Sybase and also from any of these IBM Rational products: IBM Rational ClearQuest, TestFactory, Robot, ProjectConsole, TestManager or TestManager Agent, you may experience a DLL conflict error. IBM recommends that you upgrade to the most recent Sybase SQL Anywhere database. For more information, contact Rational Customer Support.
MDAC 2.7 is not supported on systems running Microsoft SQL Server in a clustered environment.
As
of May 1, 2002, licenses for IBM Rational Products no longer include a copy and/or
license of Crystal Reports. Licenses of IBM Rational Products acquired prior to
May 1, 2002 that included a copy and/or license of Crystal Reports are not
affected.
For instructions on how to license and install Crystal Reports, contact Business Objects at http://www.businessobjects.com. Any reference to Crystal Reports in the IBM Rational Product documentation applies only to copies and/or licenses of Crystal Reports that you have rightfully licensed.
ClearQuest and TestManager Support for Crystal Reports V10 With Rational ClearQuest and TestManager version 2003.06.13, the Crystal Report V10 files needed to run and view reports with ClearQuest Windows, New ClearQuest Web client, and TestManager are provided. ClearQuest Windows and TestManager will install the files automatically. A separate version of Crystal Enterprise Embedded Edition that you can install is provided for use with the New ClearQuest Web client. To install the Crystal Embedded edition, see the "IBM Rational New ClearQuest Web Installation Guide."
However, to author and edit reports, it is necessary to purchase a copy of Crystal Reports Professional edition or other Crystal Editions that contain Crystal Designer, version 10.0. To acquire a copy of Crystal Reports Professional Edition, contact Business Objects at http://www.businessobjects.com or http://www.businessobjects.com/products/reporting/crystalreports/java/rational/cr10.asp.
For more information about Crystal Reports and ClearQuest, including coexistence Between Crystal Reports Versions and the ClearQuest Windows Client, refer to the "ClearQuest Release Notes" and "IBM Rational New ClearQuest Web Installation Guide."
For more information about Crystal Reports and TestManager, refer to the "IBM Rational TestManager Release Notes."
The following English manuals were not revised for this release; however, their content is still correct.
Product Family |
Manual Title |
Version |
Part Number |
|---|---|---|---|
| IBM Rational PurifyPlus,
Purify, PureCoverage, Quantify |
"Getting
Started" |
2002.05.00 | 800-025734-000 |
| IBM Rational Rose |
"Guide to Team Development" | 2002.05.00 | 800-026111-000 |
| IBM Rational Rose |
"Using Rose" | 2001A.04.00 | 800-024462-000 |
| IBM Rational Rose |
"Using Rose Ada for Forward and Reverse Engineering" | 2001A.04.00 | 800-024465-000 |
| IBM Rational Rose |
"Using Rose Data Modeler" | 2001A.04.00 | 800-024463-000 |
| IBM Rational Rose |
"Using the Rose Extensibility Interface" | 2001A.04.00 | 800-024466-000 |
| IBM Rational Testing Products | "Using Rational TestFactory" | 2001A.04.00 | 800-024555-000 |
The following Japanese manuals were not revised for this release; however, their content is still correct.
Product Family |
Manual Title |
Version |
Part Number/ Material ID |
|---|---|---|---|
| IBM Rational Rose | "Using Rose" | 2001A.04.10 | 800-025182-000/G126-5348-00 |
| IBM Rational Rose | "Using Rose Data Modeler" | 2001A.04.10 | 800-025183-000/G126-5350-00 |
| IBM Rational Testing Products | "Using Rational TestFactory" | 2001A.04.10 | 800-025210-000/G126-5386-00 |
Unrevised manuals contain incorrect references to book titles that changed in recent releases.
Some documentation delivered with the Japanese version of IBM Rational Suite is available only in English.
Table 4 identifies known defects and limitations. In addition, review the release notes for the products included in your IBM Rational Suite edition.
For defects and limitations associated with IBM Rational products in this service release, see the service 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.
| Product | RATLC ID/APAR | Description |
| Doc CD |
RATLC00005862/ No APAR |
The integrations with
ClearQuest, including descriptions of packages, contents, dependencies and
prerequisites, the instructions for applying them to a schema, and the
run-time requirements of the integrations are documented in TechNote
#22314 on the IBM Rational Support Web site: http://www.ibm.com/software/rational/support/. |
| Doc CD |
RATLC00053080/ No APAR |
There are known issues with the autorun feature on a computer running VMWare. As a result, the Rational Solutions for Windows CD-ROM and "Rational Solutions for Windows Online Documentation CD-ROM" may not start automatically when you insert the CD-ROM. |
| Rational Suite Tutorial | RATLC00446955/ No APAR |
On page 62 of the "Rational Suite Tutorial" v. 2003.06.00, for the exercise "Start Rose," you do not need to complete Step 3. In v2003 of Rational Rose, CURDIR=& is already defined. Continue with Step 4. |
| Install | RATLC00008162/ No APAR | Users should not install their software to a network location under Windows 9.x. Sometimes the installation needs to restart in order to install files that have been locked by the OS during installation. Restarting the installation frees these files so that they can be replaced before they become locked again. Installing to a network location causes problems because the network connections are not ready when this replacement happens. As a result, the OS cannot replace the files and the old files remain. This will cause problems with the installed image. |
| Install |
RATLC00016358/ No APAR |
If you have difficulty using a Microsoft Access database with products in Rational Suite on a Japanese system, make sure that you have installed the most recent MDAC components for use on a Japanese system. |
| Install | RATLC00688306/ No APAR |
Microsoft Windows 2000 NTFS "Change Journal" defect can cause file system corruption during installation of IBM Rational products. Under certain circumstances, file system corruption can result from installing IBM Rational Version 2003 products on Windows 2000 to an NTFS partion that has enabled the Windows "Change Journal" (log). This corruption is caused by a defect in Windows 2000. Before you install any Rational Version 2003 product on a computer that is running Windows 2000:
|
| Install |
RATLC00019990/ No APAR |
Your installation of IBM Rational software products may fail unexpectedly if you have virus detection enabled on your system. Virus detection software must be disabled during a server installation. |
| Install |
RATLC00021314/ No APAR |
If you have installed an older version of Rational Test RealTime on the same machine with Rational Suite, please upgrade Test RealTime to version 2002.05. Older versions of Rational Test RealTime will fail after installation of Rational Suite version 2002.05. Upgrades are free to all IBM Rational customers with a current maintenance contract. Please contact your IBM Rational sales representative for additional information. |
| Install |
RATLC00021953/ No APAR |
Do not use Sybase Central, included with the Sybase SQL Anywhere Database Server installation, to create a SQL Anywhere database. Doing so may cause a crash in SCVIEW.EXE. Instead, follow the instructions provided in the IBM Rational Software Server Products Installation Guide for creating a SQL Anywhere Database Server. |
| Install | RATLC00024752/ No APAR | Application of Service releases is not supported for Beta software. |
| Install |
RATLC00028681/ No APAR |
IBM has removed some standard MSI Custom functionality so that "Install when needed" and "Install to run from a network" will not be available in the Rational MSI installer. |
| Install | RATLC00054623/ No APAR | If you cancel your installation, or if your installation fails, you should restart your machine. Your Office products may not run if installation is canceled or fails. |
| Install |
RATLC00055863/ No APAR |
At the end of an install,
users are prompted for both licensing information and to restart their
systems. After restarting your computer, select Start > Programs > Rational > Rational License Key Administrator. |
| Install | RATLC00028726/ No APAR | Space-required numbers are not correct for RequisitePro custom items. |
| Install | RATLC00229734/ No APAR | The Installer does not warn the user if the user does not have administrator privileges. |
| Install |
RATLC00236727/ No APAR |
The installer does not check to see if the destination install directory is a valid Windows directory. If a bad directory name is entered (for example, one with bad characters), the installation may complete, but the installed product will probably not work correctly. |
| Install | RATLC00236978/ No APAR | Release area path names should not contain multi-byte characters. |
| Install | RATLC00435320/ No APAR | There is an extra welcome screen during start up. |
| Install | RATLC00435356/ No APAR | No Install.log file gets created when doing a silent install of a product on an unsupported platform. |
| Install |
RATLC00436583/ No APAR |
ClearCase Doctor does not run at the start of every install of full ClearCase, whether from Rational Administrator, CD or install mode. |
| Install | RATLC00437778/ No APAR | The following components are
left behind after ClearCase is successfully uninstalled:
|
| Install |
RATLC00438349/ NO APAR |
Some keys remain after an
uninstall:
|
| Install |
RATLC00438351/ No APAR |
When you use the installer to modify features after an initial ClearCase (client or server) installation, the list of modifiable features may contain features that were not actually installed. |
| Install | RATLC00438804/ No APAR | SitePrep does not detect an invalid release area path. Users should create the path prior to running SitePrep. |
| Install |
RATLC00439071/ No APAR |
In TeamTest install, additional installation options are listed in the custom screen for Rational Test Samples Setup, but these are not supported. |
| Install |
RATLC00440003/ No APAR |
SitePrep description field does not handle new lines in installer. If the description field in a sitedefs file contains new line characters, there is no line wrap when that description is displayed by MSI in the installer. Instead, it shows a literal "\n" character. |
| Install | RATLC00440567/ No APAR | When installing Rational
Suite Enterprise, there is an error writing meta-file in Enterprise
Deploy. The workaround is as follows: After creating the release area, use the command line to launch setup.exe to install the product locally. The command line syntax is: setup.exe <insert path and file name for desired site defaults file>. This should allow users to manually specify the DAT file they want to use. |
| Install | RATLC00443343/ No APAR | The Rational Site Preparation Tool is not supported on Windows 9X systems. |
| Install |
RATLC00446666/ No APAR |
On Windows 9X systems with an earlier version of Windows Installer (MSI), the initial run of Setup will upgrade the MSI service and then prompt the user to restart. Subsequent runs of Setup will not allow installation to proceed until a restart is performed. |
| Install |
RATLC00449702/ No APAR |
Attempting to run a newly
created SQL Anywhere network service after installation may give the
following error: "A database server with that name has already started."
The service then fails to start. If this issue is encountered, do the following:
|
| Install |
RATLC00692368/ No APAR |
After creating a release area on the server using the Site Preparation tool, there are circumstances under which a shortcut cannot be created and a warning will be displayed. |
| Install |
RATLC00693301/
No APAR |
If you try to create a
network release area for Rational Suite Enterprise, or install a Suite
product, you may encounter errors related to the path length of the files
being installed. The maximum root path for the release area of an
Enterprise Deployment install is 35 characters. For more information, read the IBM Rational Installation Guides for Desktop and Server Products. |
| Install |
RATLC00692753/ No APAR |
The install
program sometimes fails with the error 1607: "Unable to install
InstallShield Scripting Runtime." Consult http://www.installshield.com/ for information about resolving this problem. |
| Install |
RATLC00694985/ No APAR |
You must install Rational
Suite from an account that has administrator privileges. If you attempt to
install from an account that does not have administrator privileges, you
may be prompted with an operating system dialog that suggests you can install regardless of
this by entering the userid and password of another account that does have
administrator privileges. Entering alternate account information in this manner does not seem to be effective. If you attempt to install, you may still get fatal errors that are caused by insufficient privileges. IBM recommends that you always log in to an account that has administrator privileges. |
| Install |
RATLC00695292/ No APAR |
If you are modifying the installation of any product available from the Rational Setup wizard, a fatal error occurs when you click the Space button in the Custom Setup page. To prevent the Setup Wizard from failing, do not click the Space button. |
| Install |
RATLC00028726/ No APAR |
Users should not use the number displayed in Custom Setup or the Space button on that page of the installation. The calculation of required disk space to install Rational Suite is not correct. For disk space requirements, refer to the "Hardware and software information." |
| Install |
RATLC00691428/ No APAR |
Users who tried to perform silent installs on machines that do not have administrator rights will not receive indication about why the product failed to install. This is due to the InstallShield components that do not install unless they have the correct rights. These components do not log any information. For more information, read the IBM Rational Installation Guides for Desktop and Server Products. |
| Licensing | RATLC00001792/ No APAR | When users stop the license server with services dialog on Windows 2000, this results in Dr. Watson error. |
| Licensing | RATLC00006106/ No APAR | Installing the license server to certain double-byte paths may prevent IBM Rational products from obtaining a license to run. |
| Rational Administrator | RATLC00013554/ No APAR | SQL Anywhere install may set
up service with the wrong connection information. Install sets .\Administrator as logon. This will not work on Win2K/WinNT/WinXP systems. Set logon as the Local System Account in order to properly start service. Steps:
|
| Rational Administrator | RATLC00014399/ No APAR |
The defect tracking schema cannot be associated in a Rational Administrator Project. It is also not available in an AnalystStudio installation. |
| Rational Administrator | RATLC00026354/ No APAR |
Using an activity name with double-byte Japanese characters causes an error in the ClearCase Checkin procedure. It is best to avoid using them. |
| Rational Administrator | RATLC00694601/ No APAR |
Selecting View > Refresh from the Rational Administrator menu may cause a general program failure if there are no test users or groups associated with the Rational project being refreshed. Restart the Administrator if this problem occurs. |
Note: These may also apply to other versions of IBM Rational products.
| Product | RATLC ID/APAR | Description | ||||||||||||||||||
| Install | RATLC00243823/ No APAR | Sometimes, an IBM Rational product is not updated when a service release is installed. For more information, see the "IBM Rational Suite Upgrade Guide." | ||||||||||||||||||
| Install | RATLC00702104/ No APAR | After installing one or more IBM Rational products, stray "msiexec" processes linger in memory. Users must restart their systems before applying the service release, even if product installation does not require this. | ||||||||||||||||||
| Install | RATLC00698818/ No APAR | Corrects a defect that causes the About box to not display the version of the product if multiple products are installed and the version of one of them does not match the others. For example, if different versions of IBM Rational products exist on a user's system and the user selects Help > About ... , UNKNOWN is displayed in the version field instead of a version number. The service release fixes this issue so that a version number is displayed, even if the user does not have the same version of different IBM Rational products on their machine. | ||||||||||||||||||
| Install | RATLC00240650/ No APAR |
An error message appears when doing Rose Data Modeler Site Preparation.
Workaround: If you are creating an enterprise deployment (release area) and the "Launch installation using these settings" checkbox
is selected, some
Windows 2000 users may see the product installation start before the release area has been
created, because the product installation task didn't wait for the release area task to finish.
|
||||||||||||||||||
| Install | RATLC00449702/ No APAR |
Attempting to run a newly created SQL Anywhere network service after
installation may give the following error: "A database server with that name has already started." The service then fails to start. If this issue is encountered, do the following:
|
||||||||||||||||||
| Install | RATLC00695603/ No APAR | There
are two licensing pages displayed in SitePrep:
Ignore the FlexLM licensing page in SitePrep and custom install. |
||||||||||||||||||
| Install | RATLC00698094/ No APAR | The original source must be available when patching or modifying an installation, otherwise a network share needs to be available containing the file. | ||||||||||||||||||
| Install | RATLC00447664/ No APAR | Dual processors cause permission error 1304 under v2003.06 install. For details on a workaround, see the "IBM Rational Suite Upgrade Guide." | ||||||||||||||||||
| Documentation | RATLC00698707/ No APAR | The material in Chapter 5 of the "Rational ClearCase Product Family Installation Guide" (Windows) is no longer correct. Instead, users should use the instructions in the IBM Rational ClearCase service release Release Notes. | ||||||||||||||||||
| Documentation | RATLC00698708/ No APAR |
The
"Modify/Repair/Remove" instructions for ClearCase in the "Rational ClearCase
Product Family Installation Guide"
(Windows) are no longer correct.
Instead, users should follow these instructions:
|
||||||||||||||||||
| Documentation | RATLC00695787/ No APAR, RATLC00450642/ No APAR | The instructions for upgrading packages for ClearQuest Version 2001A.04.10 to Version 2003.06.10 (International version) in earlier versions of the IBM Rational Suite Release Notes has been updated. Users can access this upgrade from http://www.ibm.com/software/support. Search for keywords Rational 195064672. | ||||||||||||||||||
| Documentation | RATLC00452083/ No APAR | Some PDF versions of IBM
Rational Suite manuals on the
"IBM Rational Solutions for
Windows Online Documentation CD-ROM" for
v2003.06.10 (Japanese version) display incorrect IBM Rational publication
numbers. To order these books through the IBM
Publications Center, please use the following publication numbers:
Note: The Installation and Upgrade guides were updated in v2003.06.13. See the "IBM Rational Suite Service Release 2003.06.13 - Defects Fixed" list to learn about the update.
|
||||||||||||||||||
| ProjectConsole Installation | RATLC00450993/ No APAR |
When installing Rational Suite to a network
release area, the ProjectConsole Web server components should not be
selected. If they are, every user who installs from that release area will
get the ProjectConsole Web server components (and Rational Web Platform)
software loaded and running on their computers. In addition, when applying a service release to a 2003.06.00 Rational Suite release, you may receive one or more "Source File Not Found" warnings about files in the ...\Classics\Projects\... folder. These warnings can safely be ignored, as they are only used by the ProjectConsole Web server components when accessing the ProjectConsole sample site. For more information, read the IBM Rational Installation Guides for Server and Desktop Products. |
||||||||||||||||||
| RequisitePro | RATLC00703134/ No APAR | In
certain configurations, such as Windows NT 4.0 SP6A with Security Patches,
the following error may occur when associating a RequisitePro project
using the IBM Rational Administrator:
To correct this, you should manually register the file using the
command prompt as follows: |
Note: These may also apply to other versions of IBM Rational products.
| Product | RATLC ID/APAR | Description |
| Install | RATLC00454398/ No APAR | When upgrading from a
previous 2003 version of an IBM Rational product using the 2003.06.13 CDs,
the following message may continue to display with Disk 1 in the CD drive: "Please insert the disk: Disk 1" This happens when the original installation was performed using a designated release area created through the "Enterprise Deployment" install option, or for a product that was downloaded from the Web. To work around this error, read the technical note. Go to http://www.ibm.com/software/rational/support/ and search for the text "upgrade insert disk 1," or tech note 1165296. |
| Install | RATLC00447664/ No APAR | When you install this service release on a multiprocessor machine, disable the additional processors before installing the service release. Consult your computer's manufacturer for information on how to disable additional processors. |
| Install | RATLC00696241/ No APAR | When you install Rational Suite Enterprise with the Shipping Server option (from the CD), the Shipping Server installation fails. For more information about a workaround, see the "IBM Rational Suite Upgrade Guide, or the "IBM Rational Software Server Products Installation Guide" |
| Install / Documentation | RATLC00452790/ No APAR | If the original IBM Rational product was installed from a CD image (directly to a desktop or client server), the upgrade must also be done using a CD. If the original IBM Rational product was installed using a release area, the upgrade must also be done using this release area. For more information, see the "IBM Rational Suite Upgrade Guide." |
| Install / SoDA | RATLC00245650/ No APAR | SoDA for Word will not
install successfully on a French Windows NT4 SP6a operating system unless
Internet Explorer (IE) 6.0 and the Microsoft Security Roll-Up Patch (SRP) -
Windows NT 4.0 Service Pack 6a (SP6a) Hotfix - are already installed.
If the following message appears while you are installing SoDA for Word,
follow the steps below:
|
| ProjectConsole | RATLC00375216/ No APAR | Before installing this service release, follow the ProjectConsole upgrade instructions in the "IBM Rational Suite Upgrade Guide" completely, backing up all the files listed. |
| IBM Rational Administrator | RATLC00453640/ No APAR | While configuring an
IBM Rational Administrator project after you have upgraded your IBM Rational software, you may encounter the error "IsPackageUpgradeNeeded
returned true." This error displays if you have failed to upgrade the
ClearQuest database associated with the IBM Rational Administrator project.
You can disregard this message and click OK to close the
dialog. |
| RSE | RATLC00447665/ No APAR | Due to licensing issues, we have removed RSE adapter support for the GIF and JPG image formats. Use PNG instead. |
| RSE | RATLC00372409/ No APAR | MS Project must not be running for ProjectConsole to collect from Project files. |
| RSE | RATLC00372168/ No APAR | XDE report generation and metrics collection is not supported by ProjectConsole in this release. An updated version supporting ProjectConsole is available from IBM developerWorks Rational. |
| XDE | RATLC00246155/ No APAR | With XDE license
enforcement activated, using an IBM Rational Suite license key for PurifyPlus in
a XDE Developer Plus for .NET environment causes .NET to crash on exit. There is no workaround. If the condition is of concern, please contact your IBM sales representative, who can investigate making an alternate license key available. |
| Rose RealTime | RATLC00517283/ No APAR | Upgrading from Rose
RealTime 2003.06.00
If you are installing Rose RealTime v2003.06.12 or greater as an upgrade to an existing installation of Rose RealTime 2003.06.00, the Rose RealTime TargetRTS files may not update (install) correctly. In order to avoid unpredictable results, uninstall Rose RealTime v2003.06.00 before installing Rose RealTime v2003.06.12 or greater. This is a known issue. |
Additional product information is available at the Rational Suite Web site: http://www.ibm.com/software/rational/.
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/.
To return redundant license keys, contact IBM Rational Customer Support. You cannot return redundant license keys through AccountLink.
If you have questions regarding the licensing of your IBM Rational Software products, contact IBM Rational Licensing Support in your area: http://www.ibm.com/software/rational/support/licensing. You can also find worldwide IBM Rational Licensing Support contact information in the IBM Rational installation and licensing guides, and in the Help for the License Key Administrator on Windows systems.