Rational Suite® Release Notes
Copyright ©2002, Rational Software Corporation and its subsidiaries. All rights reserved.
Version 2002.05.20
Part No. 800-025083-000
Legal Notices
Thank you for choosing a Rational Suite® product!
Please read this document to learn about important tips, other Rational Suite product information, and known product issues. Release Notes for each product are located on the Rational Solutions for Windows CD-ROM in the \doc folder and are installed by default in C:\Program Files\Rational\doc\.
Contents
Objectives 1
Scope 2
References 2
About This Release 2
Supported Hardware and Software Platforms 3
New and Changed Features 9
Getting Started 19
Compatibility Issues 23
Late Changes to Documentation 29
Known Defects and Change Requests 31
Third-Party Components Used in Common Install 34
Rational Technical Support for Licensing 35
Contacting Rational Technical Support 36
Objectives
These release notes provide information critical to installing and using Rational products, including the list of supported platforms and known issues with this release.
Scope
These release notes are for the following Rational Suite products:
- Rational Suite Enterprise
- Rational Suite AnalystStudio
- Rational Suite DevelopmentStudio
- Rational Suite TestStudio
- Rational Suite DevelopmentStudio-RealTime Edition
- Rational Team Unifying Platform
For detailed information about individual products, see the product-specific release notes.
References
All Rational Suite documentation is available on the Rational Solutions for Windows Online Documentation CD-ROM and on the Rational Software documentation Web site: http://www.rational.com/documentation/.
Additional product information is available at the Rational Suite Web site: http://www.rational.com/products/rs/.
About This Release
This release contains new features for the products in Rational Suite. The release notes for the products in each 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 Rational Suite product. Note that if you customized the documentation installation for your Rational Suite product, this link will not work. The file is also available by clicking Start > Programs > Rational Suite > Readme for all products.
Supported Hardware and Software Platforms
The following sections outline the supported platforms and installation requirements for this version of Rational Suite on client and server systems. In addition, the release notes for each point product lists specific requirements for the product. For Rational TestManager and Agent requirements, see the Rational Testing Products Installation Guide.
Upgrading Rational Suite Products
For information about upgrading, see the chapter "Upgrading from Earlier Versions of Rational Suite" in the Rational Suite Installation Guide.
New and Changed Features
This sections contains information about new and updated features included in this release.
Note: As of May 1, 2002, licenses for Rational Products no longer include a copy and/or license of Crystal Reports. Licenses of Rational Products acquired prior to May 1, 2002 that included a copy and/or license of Crystal Reports are not affected.
Any reference to Crystal Reports in the Rational Product documentation applies only to copies and/or licenses of Crystal Reports you have rightfully licensed.
Please contact Crystal Decisions, Inc. for information concerning purchasing Crystal Reports Professional Version 8.0 for use with Rational Products. You can purchase Crystal Reports Professional Version 8.0 from the Crystal Decisions, Inc. web site at www.crystaldecisions.com or by contacting them directly:
Crystal Decisions Contact Information
Crystal Decisions, Inc.
Vancouver, BC
Canada
www.crystaldecisions.comAnnouncing Rational RobotJ
This version of Rational TeamTest, Rational Suites TestStudio, and Rational Suites Enterprise contains Rational RobotJ, a new automated testing product. RobotJ is an object-oriented automated testing tool that tests Java and Web applications. RobotJ:
- Performs functional testing of Java and HTML applications.
- Uses Java as the scripting language.
- Lets you create verification points to test properties and data of objects in your application.
- Uses ScriptAssure technology to provide robust and flexible scripts. This technology minimizes the need for script maintenance and allows for testing GUI functionality before the interface design is finalized. You can also tune the level of sensitivity of your scripts by assigning relative importance of an interface component's properties.
- Creates an object map that lets you update object properties from a central location and propagate the updates to all scripts that use that map.
- Includes integration with Rational ClearCase LT (in Rational Suites TestStudio and Rational Suites Enterprise).
- Records and plays back on Windows NT, Windows 2000, and Windows XP platforms.
- Uses the IBM Eclipse integrated development environment and Java Editor.
- Performs cross-browser record and play back.
Important Note: The RobotJ Release Notes are separate from the other readme files in this release, and contain important information about RobotJ, including known technical issues. To access the RobotJ Release Notes, click Start > Programs > Rational Product > Readme for Rational RobotJ.
RobotJ Netscape Support
See the RobotJ Release Notes for an important update about RobotJ's Netscape support.
Network Installation of RobotJ
In order to install RobotJ from the network using the Network Install installation type, you cannot install from the UNC path. RobotJ will not work if you install it from the network using the UNC path. To work around this issue, map the network location to a drive letter first and then do the installation from the network.
Rational Developer Network
New Rational Developer Network Menu Option
The Rational Developer Network provides guidance to implement and deepen your knowledge of Rational tools and best practices. It provides access to white papers, artifacts, code, discussions, training, and documentation. For more information, see http://www.rational.net.
Rational Developer Network is also available from Let's Go RequisitePro.
- To start the Rational Developer Network from the Rational Rose menu, click Help > Rational Developer Network.
- To start the Rational Developer Network from the Rational RequisitePro menu, click Help > Rational on the Web > Rational Developer Network.
Rational Rose
Rational RequisitePro
- From the Create New Model window in Rational Rose, click the Rational Developer Network link at the bottom of the window. This link takes you directly into the Rational Rose knowledge center of the Rational Developer Network.
- From the Let's Go window, click the Rational Developer Network link at the bottom of the window. This link takes you directly into the RequisitePro knowledge center of the Rational Developer Network.
Rational Suite
Synchronizer Final Release as Part of Default Install
Rational Suite 2001A was the last release that contained the Rational Synchronizer in its default installation path. Most functionality provided by the Rational Synchronizer has been included in the Rational Suite Extensibility (RSE) APIs. The Rational Synchronizer is now an RSE client application. In this and future releases, the Rational Synchronizer is available to existing customers upon request.
Tutorial
You can access the Rational Suite Tutorial by clicking Start > Programs > Rational Suite > Rational Suite Tutorial Download, or by going directly to http://www.rational.com/documentation.
Licensing
When you import named-user license keys on a Windows Rational license server, the License Key Administrator lets you configure the file needed to specify users for those keys.
Rational Administrator
Rational Administrator changes include:
- Sybase SQLAnywhere references have been removed and replaced with references to the appropriate features in Sybase Central.
- Synchronizer is no longer supported by Rational Administrator.
- Upgrading the Test Datastore and Rational RequisitePro is now one procedure.
Rational ClearCase LT
Rational ClearCase LT supports enhanced UCM capabilities and usability improvements.
Unified Change Management changes include:
- Composite baselines
- Sub-VOB components
- Change flow enhancements
- Support for Rational ClearQuest MultiSite
- Full UCM trigger support
- Permissions enhancements
Usability improvements include:
- Enhanced Web browser client interface
- Expanded integrations
- Support for new operating system platforms
Rational ProjectConsole
Rational ProjectConsole is a new product in Rational Suite. The main product features are:
- Automated metrics that enhance decision-making capabilities and save time
- Trend analysis improves future project performance
- Metrics analysis across product domains enables one comprehensive view of project status; an "at-a-glance" snapshot
- Project Web site for project information increases team efficiency
- Consistent information structure facilitates cross-project communication
Rational QualityArchitect
See the Rational QualityArchitect Release Notes.
Rational TestManager
See the Rational TestManager Release Notes.
Rational Robot, Rational SiteCheck, Rational TeamTest, and Rational TestFactory
See the Rational Testing Product Release Notes.
Rational PurifyPlus Family
The products in the Rational PurifyPlus Family are: Rational Purify, Rational Quantify, and Rational PureCoverage.
Rational PurifyPlus Version 2002.05.20 for Windows
New Features at a Glance
Full support and integration of PurifyPlus in Visual Studio.NET
- Full support and integration of PurifyPlus in Visual Studio.NET
- Selective Instrumentation for native applications
- PurifyPlus now supports Sun's SDK 1.4.
- ASP.NET Profiling Agent technology preview
Rational PurifyPlus, Rational Purify, Rational Quantify and Rational PureCoverage now all have support for managed (including VB.NET and C#) and unmanaged (Visual C/C++ and VB) code. PurifyPlus is seamlessly integrated in the Visual Studio.NET IDE allowing users to collect runtime data and analyze memory and performance profiling and code coverage within the 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, and automatic identification of all untested code for Microsoft .NET and Visual Studio applications.
Selective instrumentation for native applications.
Selective instrumentation is a feature in Quantify and PureCoverage that enables data collection for only a portion of the whole application. The user can specify the components for analysis. Selective instrumentation significantly increases the performance of data collection for the analysis of native web applications. Selective instrumentation is available for native compiled C/C++ and Visual Basic applications.
PurifyPlus now supports Sun's SDK 1.4.
The enhanced Java support new in PurifyPlus gives developers support for the very latest Standard Development Kit (SDK) from Sun.
ASP.NET Profiling Agent technology preview.
ASP.NET Profiler is a technology preview module that enables users to analyze .NET web services without tedious workarounds of setting up environmental variables and rebooting the machine. After starting the Agent all users have to do is to right click the icon in the system tray and select one of the suggested options: Purify, Quantify, PureCoverage or None. The first three options will attach the PurifyPlus tool to the running ASP.NET process and start collecting memory profiling data, performance profiling data, or code coverage.
Rational Purify
- VC7 compiler for applications built with unmanaged code.
- Memory profiling for .NET applications built with managed code.
- Running Rational Purify without administrative privileges.
Sun JDK1.3.1 includes support for the Hotspot version of the Virtual Machine.
Rational Quantify
Rational Quantify now supports:
- Users without administrative privileges can run Rational Quantify.
- VC7 compiler for applications built with unmanaged code.
Sun JDK1.3.1 includes support for the Hotspot version of the Virtual Machine.
Rational PureCoverage
Rational PureCoverage now supports:
- Users without administrative privileges can run Rational PureCoverage.
- VC7 compiler for applications built with unmanaged code.
Sun JDK1.3.1 includes support for the Hotspot version of the Virtual Machine.
Rational Rose
- Context menu (available in the browser) allows you to select which diagram is the main diagram of the package
- After selecting an icon on a diagram, you can make small changes in the position of the icon by using the arrow keys
- The PageUp, PageDn, and arrow keys can be used to scroll through a diagram
See the Rational Rose Release Notes for information about Rational Rose Add-Ins.
Rational Rose RealTime Edition
Rational Rose RealTime Edition now includes:
- Support for Microsoft Windows CE
- Support for additional targets
- Deeper IDE integration
- Usability enhancements
Rational ClearQuest
Rational ClearQuest now includes:
- Reference lists in reports
- Displays only valid actions for any state
- Rational ClearQuest window and control sizes are saved
- Correct record count when viewing a result set
- Results set updated automatically
- Displays multiline field in a results set
- Improved Import tool
- Support for multiple schema repositories
- Redesigned maintenance tool
- One-button package upgrade
- Redesigned user administration in Rational ClearQuest Designer
Rational ClearQuest Web
There are no significant changes to Rational ClearQuest Web in this release.
Rational ClearQuest MultiSite
Rational ClearQuest MultiSite now includes:
- Administration on UNIX (Oracle only)
- Visual mastership cue in query result set and record form
- Allocating variable size ID blocks
- GUI support for changing mastership of queries, charts, and reports
Rational SoDA for Word
Rational SoDA for Word now supports Word XP.
Rational Rational RequisitePro and Rational RequisiteWeb
Enhanced Rational RequisitePro Environment
After you start Rational RequisitePro, the Open Project dialog box appears, which enables you to select a project to work with or to create a new project. To select an existing project, click the Existing tab. To create a new project, click the New tab.
The Explorer is the primary navigation window for Rational RequisitePro. In this window, project artifacts (documents, requirements, views, and packages) are displayed hierarchically in a tree browser. Project information is organized in packages, which are units of related artifacts. When you select an artifact, a description of it appears in the window below the Explorer.
You can use the Explorer to access, view, and edit your project artifacts. For example, you can double-click or right-click a view or a document to open it; you can select requirements and edit them; and you can drag and drop artifacts between packages. The Explorer reflects saved changes made to an open document, view, or requirement.
You can use the Explorer in both Rational RequisitePro and Rational RequisiteWeb.
Open Existing Projects
The Open Project dialog box lists all projects; those most recently opened are listed first.
New Project Template Structure
This release of Rational RequisitePro provides a new project template structure, which is designed to accelerate your organization's requirements management strategy. The Use-Case, Traditional, and Composite templates provide new organizational structure, queries, and documents in accordance with the principles of the Rational Unified Process. Each template contains a Glossary document and a Requirements Management Plan document. These documents save time for project managers by providing base content common to most requirements management needs, including descriptions of project artifacts, common terms, and roles. These templates can be modified, manipulated, customized, and enhanced as the project evolves.
Querying by Document Position
As you create queries on the Location attribute, you can select the Sort by document position check box to sort the requirements in the same order as they are sorted in the document that contains them.
New Quick Tour
Quick Tour provides a quick introduction to Rational RequisitePro. It walks you through the basic tasks that you perform in a requirements project, such as how to create projects, documents, and requirements, and how to set requirement attributes and establish traceability. You can open Quick Tour from the Let's Go RequisitePro Help screen or from the Help menu.
Rational RequisitePro Extensibility Interface Changes
The following new features have been added to the Rational RequisitePro Extensibility Interface:
- New classes support the new package-based organizational scheme in Rational RequisitePro. They are RootPackage, Package, iPackage, and iPackageable.
- The Project Class has new methods: GetRootPackage and GetPackage.
- The Requirement Class, the View Class, and the Document Class will implement the iPackageable interface by adding these new properties: ElementType, Package, and PackageKey.
In addition, the following constants have been added to support the methods and properties of the new and existing classes:
Rational Unified Process
Rational Unified Process now supports:
- RUP Builder
- RUP plug-ins are installed using RUP Builder (instead of the Rational Suite installer).
- Restructured Test Discipline including:
- Improved Developer Testing Guidance
- Added Using XP Practices with RUP roadmap
- Enhanced key concepts
- Added white paper ("Content Management Defined"), sample configuration for Small Project, new tool mentors
- Removed artifacts (Test Model, Test Procedure, Test Package, and Test Subsystem) and activities (Plan Test and Test Design)
Getting Started
Compatible Products
Rational produces synchronized releases of all its products. If you install multiple Rational products on a single system, or on multiple systems on the same networked environment, they must all be at the same version number. This is necessary because of the tight integration between products.
Note: Currently, the Rational ClearQuest Web server cannot coexist on the same system with Microsoft Windows Terminal Server. When installing Rational ClearQuest Web on a Microsoft Windows 2000 system, if the system is also a host for Windows Terminal Server (regardless of whether ClearQuest is being used under Terminal Server), then the ClearQuest Web interface fails to check out a license and the user interface always displays in "Restricted" mode. The workaround is to use a system that is not a Windows Terminal Server host as the ClearQuest Web server.
Rational XDE 1.0 is not compatible with Rational Suite 2002.05.20. Rational XDE 1.1 is supported. See the Rational Support web site, http://www.rational.com/support/index.jsp, for additional information about Rational XDE.
Caution - Before You Install
In most cases, when you upgrade to Rational Suite Version 2002 from Version 20001A or Version 2001, it is not necessary to uninstall your Rational Suite software. For more information, read the chapter "Upgrading from Earlier Versions of Rational Suite" in the Rational Suite Installation Guide. For administrator and network installations, you must uninstall your Rational Suite software.
Warning: If you plan to install a Rational Suite product over an earlier version of that product, you must back up your data before you install.
In some instances, the Rational installation program displays information regarding possible conflicts between files that are being installed and existing files on the system that have the same name. Messages referencing files that exist within a Rational directory are generally benign. However, if any file in question resides in the Windows system directory, we recommend that you investigate that file. One version of the file may be more compatible with existing software on the system. For more information, contact Rational Technical Support.
If, in addition to a Rational Suite product, you have Rational point products (as opposed to a Suite) installed on your system, you must remove those point products. To remove a standalone Rational product, use the Add/Remove Software function in your Control Panel.
It is possible to install a Rational product inadvertently in more than one location through the Silent Install. This can happen if your administrator creates a new response.ini file that directs the installation to a location other than the one in which a Rational product is currently installed. Continuing with such an installation causes two Rational products to be installed in different locations, leading to unstable or unusable products. This corrupts your existing and new installations, and prevents the Rational uninstall from working correctly. You and the system administrator should ensure that the installation path specified in the response.ini file matches any pre-existing installation path on the local system.
Before removing any Rational product with the Windows Control Panel Add/Remove Software function, make sure that you:
- Close all running Rational applications.
- Return any permanent licenses for the products you are removing.
If you do not close all applications and return your licenses, the setup procedure may not remove all files associated with your installation.
Installation and licensing information is available in the License Key Administrator Help and in the Rational Suite Installation Guide included on the Rational Solutions for Windows - Online Documentation CD.
After installing a Rational product on a system with Microsoft Windows NT 4.0 or Windows 2000, you may need to restart your system. After restarting, log in using the same username as the one you used when you started the installation.
A common scenario for Rational ClearCase installers is that the system administrator performs the installation and the end user subsequently logs on and completes the installation. If you install Rational Suite and include Rational ClearCase LT, you are prevented from logging on as another user to complete the installation. A significant part of the Rational ClearCase installation work occurs after the restart, so a failure to complete the installation as the same user can cause severe problems.
For Windows 9x, double-byte characters are not supported in the installation pathname. Therefore, your install directory name must not contain double-byte characters.
If You Are Setting Up a Silent Install
If you have earlier Rational products installed on your system, you will see a warning page during your installation. If you are setting up a silent installation, pay particular attention to this message and take steps to ensure that users upgrade all Rational products. Users who install silently will not see this warning message. The message will appear in the user's installation log file, but the user may not remember to look at the log file after completing the installation.
Upgrading from Version 2000 or Earlier
This section outlines special information regarding installation and upgrade of your Rational Suite product.
If you have Rational software installed on your computer from Version 2000 or earlier, read this note carefully before you install Version 2002. If you install Version 2002 directly over Version 2000, you can damage the software or Rational repositories that you use with Rational products.
To protect your Rational Suite environment, and Rational point-product environments, first upgrade your software and repositories to Version 2001A, then upgrade software and repositories to the current version. For more information, see "Upgrading from Earlier Versions of Rational Suite" in the Rational Suite Installation Guide.
If you are not installing Rational Suite, it may be safe to proceed with the installation. Before installing, however, verify that your administrator has spoken to Rational Technical Support about error number 200201.
Network Installations
If you are installing a Rational product from a network location, make sure the installation image directory has read-only permissions.
When you select a Network installation option, use a UNC pathname such as \\server\share\directory, rather than a mapped drive letter. This ensures that the network location remains constant, even if drive letter mappings change.
To ensure that your network installation works correctly, check to make sure that your network drive mapping reconnects at logon.
Message About Required Internet Explorer (IE) Upgrade (TestManager)
You may see a message that indicates you must upgrade to IE 5.0 Service Pack 2 before you can install Rational testing products. This message is incorrect. Testing products support IE versions 5.0 and 4.0. Click Ignore, and you will not be prevented from installing.
Upgrading from the Previous Release of TestManager
If you are upgrading to this release (2002.05) from the previous release of TestManager, you must remove the Nutcracker executable and restart your computer before installing the current version.
To remove the Nutcracker executable:
- Click Start > Settings > Control Panel.
- Click Add/Remove Programs.
- Select Nutcracker, and click Remove.
- Click OK.
- Restart your comptuer before installing the current version.
Licensing Information
If you are using floating licenses, make sure that the license server system is running before you start the Rational License Key Administrator on your desktop. Otherwise, if the License Key Administrator is directed to get a license, it will return an error.
Web Components
The following table lists each Rational Suite product that includes a Web component and points to the documentation for that component.
Creating the Rational Test Data Store
After installation, when creating the Rational test data store from Rational Administrator, do not specify a path containing non-ASCII characters. Also, do not use non-ASCII characters when naming any projects or log folders. If your test data store path contains non-ASCII characters, you will experience problems of varying severity, including abnormal test script termination, datapool access anomalies, and problems with verification points.
This is a particular issue when installing and using Rational products in non-English environments. This problem will be fixed in a patch.
For More Information
For more information about interactions between specific products, visit http://www.rational.com/support/. Click Upgrades and Patches and select a product to upgrade.
Compatibility Issues
The following sections outline known compatibility issues with Rational products and between Rational and third-party software products. See also the "Compatible Products" in this document.
Important Installation Notice Regarding PowerBuilder Incompatibility with Microsoft MDAC 2.6
MDAC 2.6 is not supported on systems running Microsoft SQL Server in a clustered environment.
Installing Rational Software in a Windows Terminal Server Environment
You can install and run Rational software (except ClearQuest Web) on a Windows Terminal Server console system as you would on any other supported Windows NT Server or Windows 2000 Server system.
To use Rational products on a Terminal Server client, you must configure your console system to use floating licenses.
Conflict Between Some Rational Products and Some Anti-Virus Software
Some virus scanners check each file as software is installed or launched. The scanners check all .dll and .ini files as they are being read and loaded. This activity can significantly increase the time it takes for software to load.
Until another solution is found, we recommend that you turn off your anti-virus software when installing Rational Rose or other Rational software. After the software is loaded and running, restart your anti-virus software.
Installing Rational Suite Enterprise on a System with Rational Test RealTime
If you have installed an earlier version of Rational Test RealTime on the same system with Rational Suite, upgrade Rational Test RealTime to version 2002.05. Earlier versions of Rational Test RealTime will fail after installation of Rational Suite version 2002.05. Upgrades are free to all Rational customers with a current maintenance contract. Please contact your Rational Sales representative for additional information.
Rational Suite Extensibility
- The Project artifact in the Microsoft Project adapter has a new property. This property, ReadOnly, is a read-only Boolean property and is not modifiable. The default value is True, in order to discard changes to the project.
- The following relationships of the TeamTest TestCase have been renamed for clarity:
Performance Issues for Source Control Operations for Medium to Large Projects
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.
Rational Suite 2002 lets you place requirements and test assets under version control in a Rational ClearCase VOB. This support uses two operations from the 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 at a point in time. 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 needed to store the requirements and test assets. For requirements assets, the number of files needed depends on 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.
Requirements Assets
Estimate the number of files added to source control or checkpointed for a Rational RequisitePro project by using 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
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:
- 83 minutes using Access as the database on a 667 Mhz 256 MB RAM server
- 90 minutes using Oracle or SQL Server on a 333 Mhz 128 MB RAM server
Additional Tips for Rational RequisitePro
If you use Rational ClearCase LT to baseline your Rational RequisitePro project, here are some tips to improve performance of the Check in All operation.
- Always execute the Checkin All from the system on which the snapshot view storage is located. Depending on your network configuration, this system may also be the ClearCase LT server, or it could be a separate file server.
- Try to keep the size of individual RequisitePro project documents below 1 MB.
Test Assets
Estimate the number of files added to source control or checkpointed for a Test project using the following formula:
Number of GUI Script Files = (Number of GUI Scripts) * (2 + OP + (2 * OD))
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
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 5 seconds for two ClearCase operations that must be performed on each file in this implementation. You may be able to improve the time it takes for these operations by having a high-powered and correctly configured ClearCase server.
Using Rational ClearQuest with Rational RequisitePro
- When implementing the Rational ClearQuest/Rational RequisitePro integration in a Rational ClearQuest MultiSite environment, each user must connect to only one master schema repository using the default (2002.05.00) alias. If the alias is modified to point to another site, the Rational ClearQuest/Rational RequisitePro integration will not work properly.
Rational ClearCase UCM/Baseline Issues
- The time required for adding a Rational RequisitePro project to source control is proportional to the number of requirement types, documents, and saved views in the project. Subsequent check-in operations will be faster. Performance may be slower on Windows XP operating systems.
- If you are using full Rational ClearCase, we recommend using dynamic views for faster performance.
- If you use Rational ClearQuest to manage UCM activities, and you place a Rational RequisitePro project under configuration control, make sure that you do not set the UCM policy, "Check Assignment Before Work On." (The default is for the policy not to be set.) When you set the policy, you cannot work on an activity unless you are the owner of that activity. In the current implementation of UCM for Rational RequisitePro, an entire team of workers share the same activity, so if the policy is set, only one person - not the entire team - can work in a Rational RequisitePro project.
- A project created from a baseline does not maintain the cross-project traceability links, discussions information, and associations with Rational ClearQuest and Rational Rose from the original baselined project.
- When opening a Rational RequisitePro document in a project that was created from a baseline, you are notified the document was modified outside of Rational RequisitePro. You can accept this message and then save the document.
- If you have deleted a document, the first time you run the Check In All procedure for a Rational RequisitePro project, you receive an error message. You can ignore this message.
- The UCM/Rational RequisitePro integration does not work with a full Rational ClearCase client and server that is configured for case sensitivity.
UCM on Windows NT with ClearCase 5.0
A possible problem has been identified on Windows NT 4.0 when ClearCase 5.0 is installed. After performing a UCM datastore operation from the Rational Administrator (such as create a datastore, check-in all, add to or remove from source control), we suggest you shut down and restart Rational Administrator before attempting another such operation.
Rational ClearCase LT Issues
- Archiving Rational RequisitePro projects with Rational ClearCase LT
When you create a snapshot view in Rational ClearCase LT, initially there is no default activity for that view. An activity needs to be created before you archive a Rational RequisitePro project.- Creating a baseline of a Rational RequisitePro project with Rational ClearCase LT
To improve performance, consider the following recommendations:Using Rational Rose with Rational RequisitePro
- If a "remote server machine does not exist" error message occurs when creating a requirement from Rational Rose, you can ignore the message. The requirement is still created. To avoid other error messages, close and reopen Rational Rose.
Using Rational Rose RealTime with Rational RequisitePro
The Rational Rose RealTime/Rational RequisitePro integration does not support the association of a Rational Rose RealTime package with a Rational RequisitePro project. Use case and model association is supported.
Rational RequisitePro/Rational ClearQuest Integrations
For information on upgrading Rational Suite or the RequisitePro/ClearQuest integration, refer to the Rational Suite Installation Guide. For information on configuring the integration, refer to the Rational Suite Administrator's Guide.
The following are issues when using Rational ClearQuest with Rational RequisitePro:
- When setting up Rational RequisitePro/Rational ClearQuest integrations, you must make sure that the command line argument to ASCQISetup.bat file is 255 characters or less.
You may need to use a shorter project name to ensure that the command line argument is within the 255 character limit.- After you have changed associations in Rational ClearQuest, or deleted requirements, manually refresh any open views in Rational RequisitePro (click the Refresh button) to make sure updated information appears in the Associate Enhancement Requests dialog box. From within Rational ClearQuest, errors will result if you remove an association to a requirement, then change the Rational Administrator Project reference and add another requirement for the new project in the same session. Instead, delete the requirement and commit the changes before changing the project reference and adding a new requirement.
- When you are setting a ClearQuest query in the Query field of the Associate Enhancement Requests dialog box, you must choose a query that contains a ClearQuest ID for the integration with Rational RequisitePro to work correctly.
- Using the Rational ClearQuest/Rational RequisitePro integration when you have selected multiple records in Rational ClearQuest will cause errors. Use the Rational ClearQuest/Rational RequisitePro integration with one Rational ClearQuest record at a time.
- When using Microsoft Project, to successfully use the same Microsoft Project schedule with both Rational RequisitePro and Rational ClearQuest, do not select Text4, Text5, or Text6 for Assign Custom Fields in the Rational ClearQuest Project Tracker.
Late Changes to Documentation
Manual Titles
Many manuals in this release have new or changed titles, so the unrevised documentation may contain discrepancies and inconsistencies in the references to those titles.
Manual Versions
Some manuals were not revised for this release, therefore, the manuals in your documentation set may have different version numbers.
Rational Suite Installation Guide
In the Rational Suite Installation Guide, the supported platforms table incorrectly states that Rational ProjectConsole supports Microsoft Word 97. ProjectConsole supports Word 2000 and Word XP.
In the Rational Suite Installation Guide, in the chapter, "Upgrading from Earlier Versions of Rational Suite," in the section, "Applying Package Upgrades," the instructions tell you to validate your work in the ClearQuest Designer by clicking File > Test Work. The correct menu item is File > Validate.
Legal Notices
The products in this release use some or all of the following copyrighted information:
Design Patterns: Elements of Reusable Object-Oriented Software, by Erich Gamma, Richard Helm, Ralph Johnson, and John Vlissides. Copyright ©1995 by Addison-Wesley Publishing Company, Inc. All rights reserved.
This software product contains part of the GNU C Library, and those portions are copyrighted as follows:
catgets.c:
Copyright (c) 1996, 1997, 1998, 1999 Free Software Foundation, Inc.
This file is part of the GNU C Library.
Contributed by Ulrich Drepper, <drepper@gnu.org>.
gnu_getopt.c:
Copyright (c) 1987, 88, 89, 90, 91, 92, 93, 94 , 95, 96, 97 Free Software Foundation, Inc.
catgetsinfo.h:
Copyright (C) 1996, 1997 Free Software Foundation, Inc.
This file is part of the GNU C Library.
Contributed by Ulrich Drepper, <drepper@gnu.ai.mit.edu>.
nl_types.h:
Copyright (C) 1996, 1997 Free Software Foundation, Inc.
This file is part of the GNU C Library.
gnu_getopt.h:
Copyright (c) 1989, 90, 91, 92, 93, 94, 95, 96, 97 Free Software Foundation, Inc.
The GNU C Library and its use are covered under the terms of the GNU Library General Public License, a copy of which may be found in <INSTALLDIR>\Rational\Rational Test\opensrc\GNU_LGPL.txt.
See the README.wri file in the same directory for additional information.
This software product includes a copy of rtcpp.exe, an executable program based on GNU cpp.
Portions of this executable are copyrighted as follows:
prefix.c:
Copyright (C) 1997 Free Software Foundation, Inc.
pcp.h:
Copyright (C) 1990 Free Software Foundation, Inc.
gansidecl.h:
Copyright (C) 1996, 1997 Free Software Foundation, Inc.
obstack.h:
Copyright (C) 1988,89,90,91,92,93,94,96,97 Free Software Foundation, Inc.
cccp.c:
Copyright (C) 1986, 87, 89, 92-96, 1997 Free Software Foundation, Inc.
Written by Paul Rubin, June 1986
Adapted to ANSI C, Richard Stallman, Jan 1987
rtcpp.exe and its use is covered under the terms of the GNU General Public License, a copy of which may be found in <INSTALLDIR>\Rational\Rational Test\opensrc\GNU_GPL.txt.
See the README.wri file in the same directory for additional information,
including disclaimer of warranty.
This software product includes a copy of executables which use:
pthreads-win32 - POSIX Threads Library for Win32.
Copyright (C) 1998
The pthreads-win32 library and its use are covered under the terms of the GNU Library General Public License,
a copy of which may be found in <INSTALLDIR>\Rational\Rational Test\opensrc\GNU_LGPL.txt.
See the README.wri file in the same directory for additional information.
This software product includes a copy of executables which use the W3C libwww library.
Copyright (c) 1994-2000 World Wide Web Consortium, (Massachusetts Institute of Technology,
Institut National de Recherche en Informatique et en Automatique, Keio University).
All Rights Reserved. http://www.w3.org/Consortium/Legal/
The W3C libwww library and its use are covered under the terms of the
W3C Software Notice and License, a copy of which may be found in
<INSTALLDIR>\Rational\Rational Test\opensrc\W3C_IPR_SOFTWARE_NOTICE.htm.
See the README.wri file in the same directory for additional information.
This software product includes libiiop.dll, which is based on an implementation of the Object Management Group's "Internet Inter-ORB Protocol" of Sun Microsystems, Inc.
Copyright (c) 1995 Sun Microsystems, Inc. Printed in the United State of America.
All rights reserved.
The libiiop.dll library and its use are covered under the terms of the Sun Microsystem Inc.'s Copyright and License, a copy of which may be found in <INSTALLDIR>\Rational\Rational Test\opensrc\InterOrbEngine_License.txt.
See the README.wri file in the same directory for additional information.
Known Defects and Change Requests
The following table identifies known bugs and limitations in this release. In addition, review the release notes for the products included in your Rational Suite edition. See the release note Readme for All Products. You can use this link if you have specified the default installation path; if you have customized that path, this link will not work.
Product
ID
Description
Doc CD
RATLC00005862
The integrations with ClearQuest, including descriptions of packages, contents, dependencies and prerequisites, the instructions for applying them to a schema, and the runtime requirements of the integrations, are documented in TechNote #22314 on the Rational Support web site:
http://www.rational.com/support/.
Doc CD
RATLC00019751
The manual "Using Rational TestFactory" (testfactug.pdf) on the Rational Solutions for Windows Online Documentation CD is listed as version 2001A.04.00. This is the most current version of this document.
Doc CD
RATLC00019759
The manual "Using UCM with Rational Suite" on the Rational Solutions for Windows Online Documentation CD is listed as version 2001A.04.00. This is the most current version of this document.
Install
RATLC00008162
Users should not install their software to a network location under Windows 9.x. The reason for this is the following: Sometimes the installation needs to reboot in order to install files that have been locked by the OS during installation. The reboot 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. The result is that the OS can't replace the files and the old files remain. This will cause problems with the installed image.
Install
RATLC00016358
If you have difficulty using a Microsoft Access database with products in Rational Suite on a Japanese system, make certain that you have installed most recent MDAC components for use on a Japanese system.
Install
RATLC00019990
Your installation of Rational software products may fail unexpected if you have virus protection enabled on your system. Virus detection software must be disabled during a server installation.
Install
RATLC00021314
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 Rational customers with a current maintenance contract. Please contact your Rational Sales representative for additional information.
Install
RATLC00021953
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 Rational Test Installation guide for creating a SQL Anywhere Database Server.
Install
RATLC00052543
The Rational XDE Release Notes will be viewable in the readme.htm file only if you are installing from an XDE CD.
Install
RATLC00052543
The Rational XDE Release Notes are not viewable from the Rational Suite Readmefor All Products. You can view the XDE release notes in the Rational\XDE directory.
Rational Administrator
RATLC00013554
- 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:
-------------------------------
- In the Control Panel, go to the Services applet.
- Scroll down to SQL Anywhere Server and then double-click on it.
- On the Properties Dialog, go to the Logon tab.
- For the field: Set logon as - choose Local System Account.
- Click Apply.
Rational Administrator
RATLC00014399
- The Defect Tracking Schema cannot be associated in a Rational Administrator Project. It is also not an available option in an Analyst Studio installation.
RDSI
RATLC00011577
The following selector has been added to the TestCase artifact:
ImplementingManualScript.
The following renamings in the TestCase artifact have been done for clarity:
ImplementingScript -> ImplementingAutomatedScript
ImplementingSuite -> ImplementingAutomatedSuite
Script -> AutomatedScript
RDSI
RATLC00019277
The ExternalProjects relationship of the RequisitePro Project does not function correctly. It is not supported in the current release.
Third-Party Components Used in Common Install
Rational Technical Support for Licensing
If you have questions regarding the licensing of your Rational Software products, contact Rational Licensing Support in your area: http://www.rational.com/support/contact. Worldwide Rational Licensing Support contact information can also be found in the Rational installation and licensing guides, and in the online Help of the License Key Administrator on Windows systems.
Contacting Rational Technical Support
If you have questions about installing, using, or maintaining this product, contact Rational Technical Support as follows:
Note: When you contact Rational Technical Support, please be prepared to supply the following information: