Thank you for choosing a Rational Suite® product!
Please read this document to learn about known product issues, important tips, and other Suite product information. Release Notes for each individual product are located on the Rational Solutions for Windows CD-ROM (Disc 1 or Disc 2) in the \doc folder and are installed by default in C:\Program Files\Rational\doc\ when you install the product.
The release notes for all products in Rational Suite are available in <Install Path>\doc\rs-release-notes.htm. Note that this link (and all links contained in these Release Notes) is designed to work with the default installation path of the release notes file. If you customized this path during installation, this link will not work.
Updated release notes and other product information is available on http://www.rational.com/documentation/.
These release notes provide information critical to installing and using Rational products, including supported platforms and known issues with this release.
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
All Rational Suite documentation is available on the Rational Solutions for Windows Online Documentation CD-ROM.
Additional support information is available at the Rational Suite web site: http://www.rational.com/products/rs/.
This release contains new functionality 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 each Rational Suite product's release notes. Note that if you customized your documentation installation for your Rational Suite product, this link will not work, but the file is available by clicking on Start > Programs > Rational Suite > Readme for all products.
Table 1 outlines the supported platforms and installation requirements for this version of Rational Suite. Each component product in the Suite lists specific requirements in its own release notes.
h
- Enterprise Suite (no tutorial) - 1.3 GB
- AnalystStudio - 650 MB
- DevelopmentStudio - 775 MB
- DevelopmentStudio- RealTime Edition - 775 MB
- TestStudio - 675 MB
- DevelopmentStudio on UNIX - 1.0 GB
- Developer Kit - 175 MB
- Web Components - 350 MB
- ClearCase LT server - 70 MB
The ClearCase LT server also needs enough disk space to contain the files and databases under source control. The amount of space required depends on the characteristics and use of the VOBs and views.
If you do not have Internet Explorer, you can download it from the Microsoft Web site: http://www.microsoft.com/windows/ie. If the Rational installer does not detect that Internet Explorer 4.01 is already installed on your system, it does not allow the installation to proceed.
- ClearCase - IIS 5, 4, Apache, Netscape
Note: In addition to enough free disk space to load ClearCase LT server, the server needs 0.5 to 1.0 MB for each user who will use the ClearCase Web interface through the ClearCase LT server.- ClearQuest - IIS 5, 4
- RequisitePro - IIS 5, 4, Apache
- TestManager - IIS 5, Microsoft Personal Web Server from Windows NT 4.0 Option Pack
- Microsoft Access 2000
- Microsoft SQL Server 7.0 Service Pack 2 or 2000
- Oracle server 7.3.4, 8.1.6, or 8.1.7
Oracle client 7.3.4, 8.1.6, or 8.1.7
Note: If you are using a version 7.3.4 server, we recommend that you use a version 7.3.4 client.- 96 MB disk space
- 128 MB minimum memory; for projects with approximately 50,000 requirements, 256 MB memory is recommended.
Memory requirements vary depending on the number of concurrent users, the amount of data being requested, and the size of the database.
- VisualCafe in Studio 4 Professional Edition
- VisualCafe 4 Enterprise Edition
- VisualCafe 4 Expert Edition
- IBM VisualAge for Java Professional Edition
- IBM VisualAge for Java Enterprise Edition
- Forte for Java Internet Edition 2.0
- Forte for Java Community Edition 2.0
- JBuilder 4.0 Enterprise Edition
- JBuilder 4.0 Professional Edition
- JBuilder 4.0 Foundation Edition
Rational does not provide support for most products on the Windows 95 platform. The Installer will issue an error message if you attempt to install a product other than Rational Robot, TestManager, or Test Agents on Windows 95. You will not be able to proceed with your installation if you try to install any other product on a Windows 95 system.
For more information about installing the software, refer to the manual entitled Installing Rational Suite.
For information about upgrading, refer to the chapter entitled "Upgrading from Earlier Versions of Rational Suite" in the manual entitled Installing Rational Suite.
The following new and updated features are included in this release.
Rational Suites 2001A is the last release that will contain the Rational Synchronizer in its default installation path. Functionality provided by the Rational Synchronizer has been largely included in the Rational Suite Extensibility (RSE) APIs, to the extent that the Rational Synchronizer is now an RSE client application. In future releases, the Rational Synchronizer will be available to existing customers, but will be packaged as an example of using the RSE function to extend and customize Rational Suite.
The Rational Suite Tutorial is available online at http://www.rational.com/documentation.
When creating a snapshot view, users can now specify a storage location in any local directory. Previously, users were required to accept a default view storage location under the view root directory.
A new utility, clearfsimport, allows you to place source files under ClearCase LT version control. You can use this utility in Unified Change Management (UCM) or base ClearCase LT.
For information about these new command options, see the manual, What's New in Rational Suite V2001A.04.00.
With this release Rational QualityArchitect now includes support for WebLogic 5.1 and the Sun J2EE Reference Server.
Both the EJB and COM Query Builders now contain an options tab that lets you specify the options you want when inserting a verification point. Previously, these options could only be inserted manually into the generated test script. These options include:
- DATABASEOPTION_TRIM_WHITESPACE. Specifies that captured values should have whitespace trimmed from the right and left sides.
- VPOPTION_COMPARE_CASEINSENSITIVE. Specifies that the verification should be case insensitive. By default, text comparisons are case sensitive.
- VPOPTION_EXPECT_FAILURE. Specifies that the verification point's expected result is failure. If the comparison fails and this option is set, the verification point succeeds.
- VPOPTION_USER_ACKNOWLEDGE_BASELINE. Specifies that the first run of a static verification point should display the captured data for the tester to validate before storing it as the expected (baseline) data object.
The Rational QualityArchitect Options dialog now contains three tabs, one for setting logging options, one for setting Visual Basic (VB) options, and one for setting Java options.
- A new logging option lets you turn logging off and on from stub generation.
- From the new VB options tab you can specify the location of the Visual Basic resource compiler and specify command line options for the resource compiler. The resource compiler is required for COM script generation.
- URL and the Initial Context Factory. From the new Java options tab you can specify the Java Runtime Environment (JRE). You can specify the URL Provider, the Initial Context Factory for the EJB Session Recorder. You can specify additional items to add to the classpath, such as required JAR files and application server classes. See "Additional Classpath Option for Java" topic (below) for details.
This new option, which is accessed from Java tab of the Rational QualityArchitect Options dialog box, simplifies the process of launching the EJB Session Recorder from the Rational QualityArchitect Console by ensuring that the order of included JAR files for the deployed EJBs is correct.
The following classes must be referenced in the following order, either in the additional classpath for the EJB Session Recorder or in the user classpath.
- The home and remote interface classes for the deployed EJBs. These classes can be referenced in a directory or in a JAR file.
- The required application server classes. Consult your application server documentation for information about the required application server classes.
- The path to the installed J2EE SDK. This path must appear in the J2EE_HOME system environment variable.
If this order is not followed, the EJB Session Recorder will be unable to connect to and interact with the deployed EJBs on the application server.
Lets you easily import a manual test script from a test design, using the Implementation tab of the Test Case Properties dialog box or the Configured Test Case Properties dialog box.
Several new icons have been added to the Test Plan window, the Test Inputs window, and the Suite window. These icons indicate:
Implements tsscmd, which lets you log into a project and run a TestManager Suite from the command line.
- You can run a script completely from the command line without having to enter user input into Robot. The command line has the following form:
Rtrobo <script name> /user <user> /password <password> /project <full path to project> /play /log <log name> /build <build name> /logfolder <log folder name>
- In the Start Browser Dialog you can pick recently used URLs. These URLs are added to the list by entering them either from the edit box of the combo box or through the browse dialog accessible through the browse button. The maximum number of items in the list is 5. When items are picked from the list, they are placed at the top of the list. When the list is already full and another item is added through the edit box or browse as stated above, the last entry in the list is removed from the list.
- You can add filters to the registry. If the filter is in the registry, then it does not use the filter string in the string table. You need to add the new registry setting manually. The new registry setting is "SQABasic Filter". This new registry setting is located under HKEY_CURRENT_USER\Software\Rational Software\Rational Test\8\Robot\Robot. You must manually add this setting.
Filter1 Description:filter1 pattern1; filter1 pattern2; etc.|Filter2 Description:filter2 pattern1; filter2 pattern2; etc.| etc.
- Support for profiling memory usage in Java has been enhanced to include detail for Java objects. You can now inspect allocated memory for a function to see the objects it comprises and the relationships between different objects. Refer to the "Purify for Java" section of the online Help for details.
- Sun JDK 1.3 support has been enhanced to eliminate the manual step for specifying the Classic version of the VM. Purify will now add this option automatically.
- Support has been added for "managed" applications in the Microsoft .NET platform. Quantify supports applications running on VS.NET Beta 1. To collect performance data for these applications, select the "Managed Code" radio button in the "Run Program" dialog.
- Quantify is integrated into the VS.NET shell.
- Support has been added for reading and displaying performance trace data formatted in XML. See XMLTrcReader.html in the Quantify installation directory for details.
- The Quantify Interpreter Interface is now publicly available. Third-party language vendors can use this set of APIs to gather performance data from their applications and display the results in the Quantify GUI. See QProf.html in the Quantify installation directory for details.
- Sun JDK1.3 support has been enhanced to eliminate the manual steps described in the notes for Quantify 2001.03.00.
- Support has been added for "managed" applications in the Microsoft .NET platform. PureCoverage supports applications running on VS.NET Beta 1. To collect coverage data for these applications, select the "Managed Code" radio button in the "Run Program" dialog.
- PureCoverage is integrated into the VS.NET shell.
- Support has been added for reading and displaying coverage trace data formatted in XML. See XMLTrcReader.html in the PureCoverage installation directory for details.
- The PureCoverage Interpreter Interface is now publicly available. Third-party language vendors can use this set of APIs to gather coverage data from their applications and display the results in the PureCoverage GUI. See QProf.html in the PureCoverage installation directory for details.
- Sun JDK1.3 support has been enhanced to eliminate the manual steps described in the notes for PureCoverage 2001.03.00.
- Support for Automated Testing
- Support for additional Platforms and Languages
- Team Development Improvements
- Usability Improvements
- Security Enhancements
- Ability to hide change request records based on user group membership
- New User Privileges
- Dynamic Choice List Administrator - enables authorized users to create and modify dynamic choice lists. This includes the ability to add, delete, and modify entries in dynamic choice lists.
- Public Folder Administrator - enables authorized users to manage the public folder. This enables certain users to move queries, charts, report formats and reports to the public folder without Super User privileges.
- SQL Editor - enables authorized users to view and edit the SQL code that is generated for queries. Users without this privilege can view but cannot modify the SQL code.
- Security Administrator - enables specified users to view all data in a database since the security checks are not enabled for users with this privilege. This enables the administrator to grant one or more users in a specific group access to all data in the system, even if other members of that group are restricted from viewing certain records in the database. However, users with this privilege can not administer users or update schema repositories.
- Integration with Microsoft Project 2000
Rational ClearQuest now provides an integration with Microsoft Project 2000. This is enabled through Rational ClearQuest Project Tracker, a Microsoft Project 2000 add-in. It provides an integration with ClearQuest, by creating a two-way association between project plan tasks in Microsoft Project 2000 and defects (and/or other change requests) in ClearQuest.
With Rational ClearQuest Project Tracker, tasks can be exported from a Microsoft Project 2000 project plan to automatically create new database records in Rational ClearQuestand records can also be imported from Rational ClearQuest to create new project plan tasks in Microsoft Project 2000.
In order to offer ClearQuest customers another reporting option, (in addition to Crystal Decisions Crystal Reports) an integration with SoDA has been added to this release. Users can choose to run a SoDA report directly from the ClearQuest menu.
Rational ClearQuest now upgrades schema repositories and user databases more efficiently, reducing the upgrade time.
Rational ClearQuest now supports downward compatibility between different releases of the product. This enables users to upgrade to a newer version of the product in a staged manner by first upgrading all the client machines to the new version and then upgrading the databases.
Note: If taking advantage of ClearQuest integrations with ClearCase or Rational Suite, some additional steps are required. See the Rational ClearQuest Installation Guide for details.
ClearQuest can now be run on a terminal server machine (Citrix or Windows Terminal Server). Other clients can then connect to the terminal server and use ClearQuest.
Rational ClearQuest's database support has been extended to include Oracle 8.1.7 (on Windows and UNIX) and IBM DB2 7.1 (Windows).
- Easier email notification setup
- Ability to pick query at start-up
- Support for multiple schema repositories on a single Web server
- Ability to view and edit SQL code associated with a query
Based on the proven technology in Rational ClearCase MultiSite, ClearQuest MultiSite will be an optional add-on solution for Rational ClearQuest that supports synchronous development efforts across geographically distributed sites. Rational ClearQuest MultiSite helps geographically distributed project teams to work together more efficiently by providing local access to replicated defect and change tracking data and enabling automatic synchronization of those databases.
A beta release of Rational's new ClearQuest MultiSite product is included in this release. If you would like to participate in the beta test of this product, please contact your Rational Account team and ask them to nominate you for the beta program. Once you are signed up for the beta, you will receive a license key to run the ClearQuest MultiSite beta software.
- Prompt for Filter. Gives users the option to be prompted for a filter which allows that single template to be used for different searches at different times.
- SoDA/ClearQuest Tight Integration. Users are able to launch ClearQuest Reports directly from the ClearQuest tool. We provide out-of-the-box templates with SoDA that use our Prompt for Filter feature to allow for the templates to be useful with the customer's dynamic schemas.
The Rational RequisitePro Tutorial is an online tutorial designed to introduce you to key features of RequisitePro that will help you manage projects successfully. You will have an opportunity to use the software to create a project and to work with an existing sample project. You can open the RequisitePro Tutorial from the Let's Go RequisitePro Help screen (available from Help > Let's Go RequisitePro), click the RequisitePro Tutorial icon.
In RequisitePro documents, you can include Microsoft Word linked files as requirement text. If you change the linked file, any traceability or hierarchical relationships with the requirement are marked as suspect.
If you currently use Rational Suite Enterprise Version 2001, you can install and use Enterprise Version 2001A with the same license key. You do not need to get a new key from Rational.
You can now configure a client to ask two license servers for a floating license key. When you run a product, the client will first ask license server A for the key. If license server A is unreachable or is out of product license keys, the client will automatically ask license server B for the key.
- The License Key Administrator automatically writes the license usage mapping information to the appropriate area on the web server system.
You can more easily change the order of license key acquisition for ClearQuest Web and Requisite Web from a Suite license to a point-product license and vice versa. In version 2001, you had to manually force the License Key Administrator to push the information to the correct spot on the web server. You no longer need to do this.
Rational Process Workbench is no longer a separate product. To run Rational Process Workbench, you must Rational Suite Enterprise. Existing Rational Process Workbench customers have been upgraded to Rational Suite Enterprise.
In previous releases, TeamTest included Rational ClearQuest/TeamTest edition of ClearQuest. Existing TeamTest license keys will automatically allow you to access ClearQuest. You do not need a new TeamTest license key to access ClearQuest. Existing ClearQuest/TeamTest customers have been notified and offered Rational ClearQuest licenses.
- Rational Solutions for Windows Version 2001A is delivered as a set of three CD-ROMs - two product CD-ROMs and an online documentation CD-ROM. Check the CD-ROM label for the products on each disc.
- Network installations are available again with Version 2001A. This option was not available with Version 2001.
- In Version 2001A, you can launch the License Key Administrator directly from the Installer. This allows you to more easily configure licensing during the installation process.
- The Installer behaves as follows on the following unsupported Windows platforms:
The Installer does not allow you to install products from the Rational Solutions for Windows Version 2001A CD-ROMs on Whistler 64.
If you are running on Windows XP Home and Windows XP Professional, the Installer warns you that products on the Version 2001A Rational Solutions for Windows CD-ROMs do not officially support that platform. You may choose to continue the installation or cancel.
The Rational Administrator provides access to many features of Rational Unified Change Management (UCM). UCM is the Rational Software approach to managing change to requirements, design models, documentation, components, test cases, source code, and more.
UCM is unique because it links the activities used to plan and track project progress to the artifacts undergoing change. UCM is based on two key concepts: activity-based Configuration Management (CM) and parallel development.
You can place the information in a Rational project under configuration management using Rational Administrator by associating a Rational project with a UCM project. Use Rational ClearCase to create a UCM project first, and then create a Rational project and UCM-enable it. ClearCase LT ships with Rational Suite software.
- TestManager Tool Mentors:
- "Core Workflow" has been changed to "Discipline" throughout.
- Tree browser changes:
- Addition of hyperlinked "Tree Path" at the top of each page to indicate location in RUP® treebrowser.
- Upgraded graphics on buttons and icons.
- Addition of new roadmap for Usability Engineering.
- Incorporated new example Organization Web and example Project Web, based on the previous Wylie College artifact example set.
- C sports example artifacts are now installed directly, instead of requiring a separate "unzip" installation.
- The following new white papers have been added:
Rational produces synchronized releases of all its products. This is necessary because there are tight integrations between products.
Note: At this point, the Rational ClearQuest Web server cannot coexist with Windows Terminal Server. When installing ClearQuest Web on a 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 Rational ClearQuest Web interface fails to check out a license and the user interface always comes up in "Restricted" mode. The workaround is to use a system which is not a Windows Terminal Server host as the Rational ClearQuest web server.
Warning: If you are installing a Rational Suite over an earlier Rational Suite product, you must back up your data before you proceed with your installation.
In general, when you upgrade to Rational Suite Version 2001A from Version 2000 or Version 2001, you do not need to uninstall your Rational Suite software. There are some exceptions for which you do need to uninstall; for more information, carefully read the chapter entitled Upgrading from Earlier Versions of Rational Suite in the manual entitled Installing Rational Suite. Uninstalling is required for administrator and network installations.
On occasion, 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 than the other. Contact Rational Technical Support for additional information.
If you have additional, earlier, individual Rational products (as opposed to a Suite) installed on your system, you need to remove those earlier individual products. Use the Add/Remove Software function in your Control Panel to remove the earlier version.
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 install, pay particular attention to this message and take steps to ensure that users upgrade all Rational products. Users who install silently will not see an error message. A message will appear in the user's error log file, but the user may not remember to look at the log file after completing the installation.
If you run the response.ini file for a silent install, the licensing options specified in the response.ini file will not override any licensing options already installed on your system. If your system has no licensing installed, the response.ini file will install the licensing options specified in it.
Before installing any Rational product, make sure that no other applications, including Internet Explorer, are running.
If you are installing a Rational product from a network location, make sure the installation image directory has read-only permissions.
Installation and licensing information is available in the License Key Administrator online Help and in the manual entitled Installing Rational Suite included on the Rational Solutions for Windows Online Documentation CD-ROM.
Installing a Rational product under Windows NT 4.0 or Windows 2000 may require restarting your system. After restarting you must log in using the same USERNAME as the one you used when the installation was originally started.
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 install. If you install Rational Suite and include Rational ClearCase LT, you may not log on as another user to complete the install. 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. To work around this, install into a directory that does not contain double-byte characters in the directory name.
While the Installer does not support editing of the installation path in the response.ini file, the situation could arise where a pre-existing response.ini file specifies a path different from a pre-existing Rational product installation on a local system. This would cause two Rational products to be installed in different locations, and could lead to instability or unusability. The system administrator and the user should be careful to ensure that the installation path specified in the response.ini file and any pre-existing installation path on the local system are the same.
Rational Software Setup Help reports that Microsoft Internet Explorer 4.x or higher must be installed on your system to run Rational Software products. See the Software Requirements section of these release notes for the required version of Internet Explorer. Users who are testing or developing on earlier platforms and using Internet Explorer 4.0 or earlier, or users who do not have Internet Explorer installed on their system, will have to install Internet Explorer 4.01 SP1 or higher. Otherwise, the latest release of Rational products may not work correctly on their system.
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.
It is possible to install a Rational product inadvertently in more than one location through the Silent Install if the response.ini file directs the installation to a location different from where you presently have a Rational product. This can happen if you directly edit the response.ini file. Rational Software does not support directly editing the response.ini file. However, you can run into this problem if the administrator issues a new response.ini file for your company and you are instructed to use that new file for future company installations. In other words, you don't have to edit the Rational file to cause this problem to occur. Not only does this corrupt your existing and new installations, but it prevents Rational's uninstall from working correctly.
Before removing any Rational product through the Windows Control Panel add/remove feature, make sure that you:
- Close all running Rational applications.
- Return any permanent licenses for the products you are removing (if you plan to reinstall on another system/location).
Four DLLs required for Rational Robot Session Generation are missing in the typical Enterprise installation.
The workaround to this problem is:
1 Bring up a command prompt and change directories to your Rational Test directory (in a default installation, that directory is c:\Program Files\Rational\Rational Test):
Be sure your network drive mapping reconnects at logon for the network installation to work correctly.
If you are using floating licenses, it is recommended that the license server system be up and running before launching the Rational License Key Administrator. Otherwise, the License Key Administrator will return an error if it is directed to get a license from the server system.
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.
The following table lists each Rational Suite product with a web component and references the documentation for that component.
Visit http://www.rational.com/support/ for more details about interactions between specific products. Click Upgrades and Patches, then select a product to upgrade, then click Compatibility Matrix.
The following sections outline known compatibility issues with software products produced by Rational and other companies. See also the "Compatible Products" section.
If you are a PowerBuilder 5, 6, or 6.5 developer or user, and if your applications use ODBC to connect to Microsoft data sources, such as SQL Server 7 or Microsoft Access, read the following caveat carefully before installing Rational Suite:
There is a known incompatibility between the Microsoft Data Access Controls (MDAC) Version 2.1, which are part of the Suite installation, and the PowerBuilder ODBC connectivity to Microsoft data sources. After MDAC 2.1 is installed on a system, any PowerBuilder 5.0, 6.0, or 6.5 applications on that system that use ODBC to connect to a Microsoft Access or Microsoft SQL Server database will be unable to retrieve data from those databases. The reported error is "[Microsoft][ODBC Driver Manager] Program Type Out of Range".
Sybase is aware of this incompatibility and has resolved this problem in the 6.5.1 maintenance release of PowerBuilder. Contact Sybase technical support for this maintenance release or for further information on the incompatibility. For more information, visit http://support.sybase.com.
You can install and run Rational software 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, your console system must be configured to use floating licenses.
When some software is installed or launched, some virus scanners check each file, including .dll and .ini files, being read and loaded, as part of their normal process. However, this functionality can significantly increase the amount of time it takes for some software to load. This is a result of the interaction between the loading software's dynamic extensibility functionality and the virus checking mechanism used by the anti-virus software.
This functionality of certain anti-virus software could affect the performance of Rational Rose and of the Rational Installer.
Until another solution is found, we suggest you turn off your anti-virus software when loading Rational Rose or installing Rational software. You should, when the software is loaded and running, restart your anti-virus software.
Netscape 6.0 is not supported in Rational Suite. Not all products in the Suite support Netscape 6.0. See the TestManager and RequisiteWeb release notes for restrictions regarding Netscape 6.0.
The performance of adding test and requirements assets to source control and subsequent checkin-all operations can be very slow for medium-size to large-size requirements and test projects.
Rational Suite 2001A supports the ability to place requirements and test assets under version control in a ClearCase VOB. The support for this is done using 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 there is a large number of existing requirements or test assets, the time it takes for both of these operations may be very long and could make these features unusable in this release, depending on how often you plan to 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 requirement 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 largely depends on the number of scripts and the number of verification points in each script being managed.
The following information will allow you to estimate the time it will take for the Add to CM and Checkin-All operations for existing requirements and test projects. Performance testing has shown there is a strong relationship between the performance of these operations and the number of file elements placed under source control. Therefore, to estimate the time these operations will take, you need to determine the number of file elements that will be involved in the operation.
The number of files involved in a RequisitePro project that is added to source control or checkpointed can be estimated 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:
The time required for adding 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
The number of files involved in a Test project that is added to source control or checkpointed can be estimated 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 Alpha Numeric Verification Points
OD = Average Number of Object Data Verification Points
In short, the number of files is 2 per GUI Script + 1 for each verification point or low level script + 2 for each data verification point.
Number of Files = 200 + Number of GUI Script Files + Number of Manual Scripts
Number of Minutes = (10*Number of Files) / 60 seconds
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 further improve the time it takes for these operations by having a high powered and correctly configured ClearCase server. Be sure to allocate enough time if you chose to use this feature.
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:
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.
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.
The pthreads-win32 library and its use are covered under the terms of the GNU Library General Public License,
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.
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.
Rational ProjectConsole software components were removed from all Rational Suite editions after some documents had gone to press.
The follow information replaces Step 3 on page 154 of Installing Rational Suite:
If you are upgrading the integration between ClearQuest and RequisitePro, delete all RequirementMap records from your ClearQuest user database before running the ASCQISetup batch file:
d At the command line, change the directory to \Program Files\Rational\Common and type ASCQISetup.
As the batch file runs, it pauses every time it creates an association and prompts you to Press any key to continue.
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 entitled Readme for All Products. This link is designed to be used if you have followed the default installation path for your release notes files; if you have customized that path, this link will not work.