 |
 |
Rational Suite for UNIX Release Notes Thank you for purchasing the Rational Suite for UNIX, version 2002.05.20. Once again, the suite is offered in two studio alternatives: the Rational Suite Development Studio and the Rational Suite Development Studio RealTime.
These release notes provide information on the following topics:
- What's New in This Release
- Installing, Upgrading, and Licensing
- Online Documentation
- Known Problems
- Contacting Rational Customer Service
- Accessing Additional Support Materials
- Receiving Important Product Announcements
If you encounter any problems while installing or running Rational Suite for UNIX, read the Known Problems section in these Release Notes first to see if you have encountered a known problem in Rational Suites for UNIX. Also, refer to the relevant point product Release Notes; these are listed under Point Product Release Notes.
If you find a problem that is not documented, contact Rational Customer Service so that we can investigate and provide you with a workaround. The problem will be tracked for future action. For more information, see Contacting Rational Technical Support.
What's New in This ReleaseRational Suite for UNIX, version 2002.05.20, is a full product release with the primary goal of quality improvement; however, many of the point products in the Suite have also incorporated new features.
Suite Content Changes
This section highlights the major content changes that have occurred in this release of Rational Suite for UNIX.
Crystal Reports Removed
As of May 1, 2002, Rational Suite for UNIX no longer includes a copy and/or license of Crystal Reports. Licenses of Rational Suite for UNIX (2002.05.00) acquired prior to May 1, 2002 are not affected.
This product is used in conjunction with Rational TestManager and Rational ClearQuest (Windows only) to create and customize new report formats from the standard output generated by these two applications.
New Features in the Suite Point Products
This section summarizes the new features in the Rational point products included in the Rational Suite for UNIX.
Rational ClearCase LT
Rational ClearCase LT, version 2002.05.20, is provided on a separate CD as an optional product for you to install. For details about the new features in Rational ClearCase LT, see the Rational ClearCase LT Release Notes (2002.05.20), and for a list of known problems in this release, read the Status of ClearCase LT Software Change Requests summary. Both files are available online on the Rational ClearCase LT CD.
Rational ClearQuest
Rational ClearQuest UNIX, version 2002.05.00, is included for use on HP-UX 11.00 and 11.11. For Solaris 2.6, 7, 8 and HP-UX 10.20 users, Rational ClearQuest UNIX, version 2002.05.01 is included.
Rational ClearQuest UNIX, version 2002.05.01 (the first 2002.05 service release), includes many quality enhancements for Solaris and HP-UX 10.20. For a list of defects fixed in this release, review the Rational ClearQuest Release Notes 2002.05.20 (Windows); 2002.05.01 (UNIX).
Rational PurifyPlusFamily: Purify, Quantify and PureCoverage
The version of the Rational PurifyPlusFamily of development tools (Purify, Quantify, PureCoverage) included in this release of Rational Suite for UNIX has many new features, and is the only point product being released with the advanced version number of 2002a.06.00.
Other than upgrades for compatibility with O/S patches, new features include:
- Upgraded compiler support.
- On Solaris: Forte 7 compiler (compiler version 5.4).
- On HP-UX: aCC 3.31 and 3.33 compilers.
- Enhanced HP-UX support:
- Support for ld/dld version 11.30
- Support for dlopen, dlclose, dlsym, dlget calls in 32-bit applications.
- Two new options -lib-path-length and -replace-path have been added to Purify. These options help one to relocate the cache.
- Purify_home and Quantify_home directory hierarchies have been re-organized so that 32-bit and 64-bit components reside in the same directory.
- Rational Quantify for Java, which provides Java programmers with the ability to collect performance data on their Java applications. JVM versions 1.3.1 and 1.4 are supported. For details, see the Rational Quantify for Java supplement to Quantify online help available on the Rational Solutions for UNIX product CD (launches from the product) and on the online documentation CD.
- In Purify and PureCoverage, modified support for Change Request Management Systems, including Rational's ClearQuest and ClearDDTS.
- An updated Installing and Getting Started: Rational PurifyPlus, Rational Purify, Rational PureCoverage, Rational Quantify guide, which is available online and in hardcopy.
Rational RequisitePro
This section outlines the new features in Rational RequisitePro and Rational RequisiteWeb, version 2002.05.20. For more information, see the Rational RequisitePro Release Notes.
- Integrated use-case management with Rational XDE.
- RequisitePro and RequisiteWeb include many quality enhancements in this release. For details refer to the product release notes available online.
- Two updated RequisitePro guides: Rational RequisitePro Installation Guide and Rational RequisitePro User's Guide, which are both available online and in hardcopy.
- Updated RequisiteWeb guide: Installing and Configuring Rational RequisiteWeb (Windows), which is available online.
Rational Rose
There are no new features for Rational Rose in this release. Many important quality improvements, however, have been made in Rose for Solaris (Solaris 2.6, 7, and 8) and it is highly recommended that you upgrade to Rational Rose, version 2002.05.20, if you have an existing Solaris installation. For HP users, Rational Rose, version 2002.05.00, is included on the Rational Solutions for UNIX CD. There were no updates made to Rose for HP-UX.
For details on the HP-UX releases of Rational Rose, read the Rational Rose Release Notes (2002.05.00; UNIX/Linux). For details on the Solaris release of Rational Rose, read the Rational Rose Release Notes (2002.05.20 for Solaris; UNIX/Linux). Both documents are available on the Rational Solutions for UNIX Online Documentation CD.
Rational Rose RealTime
Rational Rose RealTime (2002.05.20; Solaris) includes new user interface improvements. Rational Rose RealTime for HP-UX operating systems was not upgraded for 2002.05.20; the Rational Rose RealTime (2002.05.00; HP-UX) software is included on the Rational Solutions for UNIX CD.
New features in the 2002.05.20 version on Solaris include:
- Graphical User Interface improvements to enhance model navigation and simplify user workflow.
- Performance enhancements and improved test results overview in RQA-RT.
- Build and target enhancements, such as improved C-target support, new target reference configurations, and the ability to Show/Hide build warnings, all in addition to a new extensibility API.
- Documentation improvements, including new sample models and animated demonstrations, and enhanced document indexes. Also, find a new guide entitled, Customizing Rational Rose RealTime for Target Control and Observability (UNIX/Windows).
For details of this point product release, refer to the Rational Rose RealTime Release Notes (2002.05.20; UNIX/Windows) available on the Rational Solutions for UNIX Online Documentation CD, and be sure to read the Rose RealTime readme file (
rosert_readme.htm) installed in /Rational/Rose RealTime.Rational Rose RealTime Companion Products
The Rational Rose RealTime Companion Products CD (2002.05.20; UNIX) contains companion products software for Solaris only. The 2002.05.00 version of the Rational Rose RealTime Companion Products for HP-UX is available as a download from the Rational Customer Download Center at http://www.rational.com/support/downloadcenter.
The Rational Rose RealTime Companion Products include:
- Rational Quality Architect
- Rational Connexis
- Rational Target Deployment Package
For details of this point product release, refer to the Rational Rose RealTime Professional Edition Release Notes and Installation Guide (2002.05.20; UNIX/Windows) available on the Rational Solutions for UNIX Online Documentation CD, and be sure to read the Rose RealTime Professional readme file (
rosert_prof_readme.htm).Rational SoDA
There have been no changes made in Rational SoDA for FrameMaker (UNIX). The 2002.05.00 version of the SoDA software and documentation is included with this release of Rational Suite for UNIX.
Rational SoDA (2002.05.00) integration with Rational Rose (2002.05.20; Solaris) and with Rational Rose (2002.05.00; HP-UX) has been verified.
Rational TestManager and UNIX Test Agent
There are no new features for Rational TestManager and test agents in this release, however, many important quality improvements have been made to the product and it is highly recommended that you upgrade to version 2002.05.20.
For details, read the Rational TestManager Release Notes (2002.05.20) available on the Rational Solutions for UNIX Online Documentation CD.
Rational Unified Process
There have been no changes made to the Rational Unified Process (RUP) for UNIX since version 2002.05.00. The 2002.05.00 version of the RUP software and documentation is included with this release of Rational Suite for UNIX.
Installing, Upgrading, and LicensingSupported Platforms
The following platforms are supported by all Rational Suite for UNIX, version 2002.05.20, software products:
- Solaris 2.6, 7, and 8
- HP-UX 10.20, 11.00, and 11.11 (11i)
with the following exceptions:
- Rational Unified Process is not supported on HP-UX 10.20.
- Rational Rose RealTime is not supported on HP-UX 11.00 or 11.11. For more information, see "Installation Requirements for Rational Rose RealTime" in the Rational Suite Installation Guide.
Web Browser Requirements
Rational Rose RealTime requires Netscape 4.7 or 6.0 for viewing of online help.
Note: Netscape 4.7 for multiple UNIX operating systems is provided on the Rational Solutions for UNIX Online Documentation CD.
Installation Notes
This release should be installed as a full release of Rational Suite for UNIX. Complete instructions for installing the components of the Rational Suite for UNIX from the Rational Solutions for UNIX CD, the Rational ClearCase LT (UNIX) CD and Rational Solutions for Windows CD are available in the Rational Suite Installation Guide (UNIX).
The Rational Suite Installation Guide is included as a printed guide on both the Rational Solutions for UNIX media and upgrade kits, but can be also be found on the Rational Solutions for UNIX Online Documentation CD at the following location:
The remainder of this section highlights some important installation issues.
Point Product Install Directories
This table itemizes the UNIX point products, the directories into which they install, and the version numbers that they report in their "About" dialogs.
Installing Online Documentation
The rs_install program guides you through the entire software and documentation installation process in the correct sequence, but it is also possible to install the documentation separately. If you decide to do this, ensure the product software has already been installed, and then install the documentation into the product directory structure.
Note: The product software must be installed before the documentation.
Also, to support the links on the online documentation navigation page, you must install all the documentation files into the product directory structure. If some documents are not installed, then the links to those documents from the documentation navigation page (launched by rsdsu_help) will not work.
Installing Windows Components
Windows Components of the Rational Suite for UNIX must be installed on a Windows operating system, such as Windows NT or Windows 2000. The latest versions of the Windows Components software is available on the Rational Solutions for Windows CD included in the Rational Solutions for UNIX package. Installation instructions for Windows Components can be found in the Rational Suite Installation Guide (UNIX).
Back Up User Files First
Back up any user files before starting the Windows Components installation procedure. Backing up your data prior to installing any new software should be a regular practice.
Uninstall Existing Versions
You also need to uninstall any previous versions of Rational Suite for Windows software from the target system. To uninstall a Rational product, click Start > Settings > Control Panel. Double-click Add/Remove Programs. Select the Rational product you want to remove and click Remove. (Do not attempt to remove a product by just deleting program directories; there are many registry entries that need to be modified as well.)
Note: If you have uninstalled a Rational Suite product and plan to re-install the product or install a new version, we recommend that you reboot your system after you have removed the software. Once you have rebooted, proceed with the installation.
The Rational Software set-up program may install Microsoft Shared components into the Windows 9x System, and Windows NT System32 directories. These Microsoft components are not removed when you uninstall Rational Suite. Other programs may use these files; therefore, following Microsoft guidelines, we do not remove them from your system.
In addition, a minimal number of files will remain under the folder drive:\Program Files\Rational\. This is because our uninstall deliberately does not delete files that you have created while using the products. You may manually delete these files if you wish to remove them from your system. Do not delete the entire \Program Files\Rational folder itself unless you are certain that you have uninstalled all software originally installed from the Rational Solutions for Windows CD or other Rational windows product CDs.
Installing Rational Rose Using Ask Mode
When you install Rational Rose on HP-UX and use the rs_install Ask mode, you may be prompted to re-install several components of the HP-UX 11.00 version. This only happens if you choose to install both HP-UX versions of Rose. This is because Rational Rose shares many of the same files between the HP-UX 10.20 version and HP-UX 11.00 version. The install script installs all of the HP-UX 10.20 files followed by the HP-UX 11.00 files. You can answer No to re-installing these files.
Changes in PurifyPlusFamily Installation
There has been a recent change to rs_install to allow configuration of Rational Purify and Rational PureCoverage integration with ClearQuest.
In the Installing the Product chapter of the Rational Suite Installation Guide, step 20 on page 65 addresses the rs_install step that configures the cache directory for each of Rational Purify, Rational PureCoverage, and Rational Quantify.
As of 2002.05.20, follow-on steps for setting up the Rational ClearQuest integration are required during configuration for Purify and PureCoverage:
For Purify, after you indicate the cache directory by either selecting the default or specifying an alternate, you are then asked if you would like to configure a Rational ClearQuest integration with Purify. If you answer `yes', you are prompted for three additional pieces of information before proceeding with the self-test.
- 1 The Rational ClearQuest client interface (X Windows or web).
- 2 The Rational ClearQuest database name. The default provided is "none", meaning that the user will be prompted for the database name when they try to connect to the database.
- 3 The Rational ClearQuest Web URL, identifying your ClearQuest web server.
For PureCoverage, after you indicate the cache directory by either selecting the default or specifying an alternate, you are then asked if you would like to configure a Rational ClearQuest integration. If you answer `yes', you are prompted for the same three pieces of information as in the Purify set-up, but the values you entered for the Purify set-up become the default values provided in the PureCoverage set-up.
The instructions are presented clearly, but for additional details you can refer to the Installing and Getting Started: Rational PurifyPlus, Rational Purify, Rational PureCoverage, Rational Quantify guide, which is available online and in hardcopy.
Upgrade Notes
If you have a Rational Suite for UNIX upgrade media kit and are upgrading to version 2002.05.20 from a previous version of the suite, refer to the Quick Start for Upgrade Installations (2002.05.20; UNIX). This is a printed insert letter included in the upgrade kit and on the Rational Solutions for UNIX Online Documentation CD in the following location:
General upgrade information is also available in the Rational Suite Installation Guide.
Licensing Notes
This section provides some licensing reminders. Complete instructions for licensing the components of the Rational Suite for UNIX are available in the Rational Suite Installation Guide (UNIX).
With your software media kit, you received an envelope containing your Startup License Key Certificates for this product. You need these keys to run your software. The startup license keys will expire a few weeks after shipment. Be sure to request your permanent license keys as soon as they are available. The availability date for your permanent keys is indicated in the top section of your Startup License Key Certificate.
Versions 2002.05.20, 2002.05.00 and 2001A.04.00 will run with version 2000.02.10 license keys. If you are an existing customer and are using version 2000.02.10 of Rational Suite for UNIX, you do not need to obtain new license keys.
If you are an existing customer and are using a version of Rational Suite for UNIX prior to version 2000.02.10, you need to return your old license keys and request new ones. For more information, see "Requesting License Keys" in the Rational Suite Installation Guide.
Online DocumentationRational Suite documentation is provided on the Rational Solutions for UNIX Online Documentation CD. You can access the electronic documentation directly from the CD or from the product installation area if it was installed along with the product software. Generally, guides are provided in either HTML or PDF format, but some guides are available in both formats.
If you prefer printed copies, the complete Rational Suite for UNIX product documentation kit or individual documents can be ordered from Rational Press or by contacting your Rational Sales Office.
- To link to Rational Press online, go to the Rational web site Product Documentation area at http://www.rational.com/support/documentation.
- To find contact information for your closest Rational sales office, go to http://www.rational.com/shop.
The
README.docsASCII text file located in the root directory on the Rational Solutions for UNIX Online Documentation CD provides information about the contents of the CD, and how to launch the online documentation viewer.The
READMEASCII text file located in the root directory of the Rational Solutions for UNIX CD provides reminder installation information, outlines the CD contents, and details last-minute problems that are found after the Rational Suite Release Notes (2002.05.20; UNIX) are printed. The README file also provides path information for locating PDF files for those customers who may not have access to a Web browser.Viewing Documentation Online
You can view the Rational Suite documentation directly from the CD or from the installed product area.
Prerequisites
A standard Web browser (Netscape 4.7 or higher) is required to view HTML documents. Adobe Acrobat is required to view the PDF files. Netscape Navigator 4.7 and Adobe Acrobat 4.0 can be installed from the Rational Solutions for UNIX Online Documentation CD.
The version of Netscape provided with Rational Suite is configured to launch the Adobe Acrobat Reader automatically when you click a link to a PDF file from the online documentation page.
If you choose not to install the version of Netscape provided with Rational Suite, you can configure your own browser to do this, or access the PDF files independently with the Adobe Acrobat Reader (acroread) executable. Also, if you are using your own HTML browser to read the documents, you should point your browser to the following location to access the Rational Suite for UNIX online documents navigation page (an HTML page that organizes links to all the Rational Suite for UNIX electronic document files):
where rational_dir is the installation path for the Suite.
Note: If installed from the Rational Solutions for UNIX Online Documentation CD, Netscape Navigator and Adobe Acrobat Reader reside in the rational_dir/base/cots directory.
Viewing Documentation from the CD
To view documents directly from the CD, run the command rs_help from the CD's root directory.
Viewing Documentation from the Installation Area
To view documents from the installed product area, run the command rsdsu_help.
Note: You must set up your Suite environment for the shell that you are using by running rs_setup.csh or rs_setup.ksh, as appropriate for your shell, before you can use this command.
Point Product Release Notes
The Release Notes for each point product provide important feature and defect information specific to each product. These release notes are available online:
- Rational ClearQuest Release Notes 2002.05.20 (Windows); 2002.05.01(UNIX)
- Rational PureCoverage 2002a.06.00 Release Notes (HP-UX, Solaris)
- Rational Purify 2002a.06.00 Release Notes (HP-UX, Solaris)
- Rational Quantify 2002a.06.00 Release Notes (HP-UX, Solaris)
- Rational RequisitePro 2002.05.20 Release Notes (Windows)
- Rational Rose 2002.05.20 Release Notes (UNIX/Linux)
- Rational Rose RealTime 2002.05.20 Release Notes (UNIX/Windows)
- Rational Rose RealTime Professional Edition Release Notes and Installation Guide (UNIX/Windows)
- Rational SoDA for Frame 2002.05.00 Release Notes (UNIX)
- Rational TestManager 2002.05.20 Release Notes
- Rational Unified Process 2002.05.00 Release Notes (UNIX/Windows)
The ClearCase LT Release Notes and list of issues can be found on the Rational ClearCase LT (UNIX) CD.
Additional Documentation
Rational ClearCase LT online documentation can be found on the Rational ClearCase LT (UNIX) CD. Rational Windows Components online documentation can be found on the Rational Solutions for Windows CD. Both CDs are included in the Rational Suite for UNIX media kits.
Find information on additional materials and support available for Rational products under Accessing Additional Support Materials.
Known ProblemsThe following section contains the known problems associated with this release. Further information about point product issues can be found in the product-specific release notes.
Table 1 lists known problems with the Suite.
Contacting Rational Customer ServiceCustomer Service contacts for all products in the Rational Suite for UNIX are listed here.
Contacting Rational Licensing Support
If you have questions about acquiring or using license keys for your Rational Software products, contact Rational Customer Service - Licensing Support for your location.
Note: For Rational Rose RealTime licensing contact information, refer to the Rational Rose RealTime Release Notes (UNIX/Windows).
Your Location
Telephone
Facsimile
Asia Pacific +61-2-9419-0111 +61-2-9419-0123 license@apac.rational.com
Asia Pacific (Japan) +61-2-9419-0111 +61-2-9419-0123 license@japan.rational.com
Asia Pacific (Korea) +82-2-556-9420 +82-2-556-9426 license@apac.rational.com
Asia Pacific
(Mainland China, Hong Kong, and Taiwan)+61-2-9419-0111 +61-2-9419-0123 license@china.rational.com
Europe,
Middle East,
Africa+31 20-4546-200 +31 20-4546-201 license@europe.rational.com
North America (East Coast),
South America800-433-5444
(toll free)781-676-2460 license@rational.com
North America (West Coast),
Central America800-433-5444
(toll free)408-863-4001 license@rational.com
Contacting Rational Technical Support
If you have questions about installing, using, or maintaining this product, contact Rational Customer Service - Technical Support for your location.
Your Location
Telephone
Facsimile
North America (800) 433-5444
(toll free)
(408) 863-4000
Cupertino, CA(781) 676-2460
Lexington, MAsupport@rational.com
Europe, Middle East, Africa +31 (0) 20-4546-200
Netherlands+31 (0) 20-4545-201
Netherlandssupport@europe.rational.com
Asia Pacific +61-2-9419-0111
Australia+61-2-9419-0123
Australiasupport@apac.rational.com
Note: Please be prepared to supply the following information:
- Your name, telephone number, and company name.
- Your operating system and version number.
- Your case ID number (if you are following up on a previously-reported problem).
- Details of how to recreate the problem.
Accessing Additional Support MaterialsOnline Support on the World Wide Web
Online support can be found on the World Wide Web at the following location: http://www.rational.com/support/
This location includes any updates not available at the time of printing of the Rational Suite for UNIX materials.
This website also includes such information as:
- Technical Application Notes (TAN)
- Frequently Asked Questions (FAQ)
Rational Developer Network
The Rational Developer Network provides guidance to implement and deepen your knowledge on Rational tools and best practices. It includes immediate access to white papers, artifacts, code, discussions, training, and documentation. For more information, see http://www.rational.net.
Receiving Important Product AnnouncementsGo to the Rational Suite web site for the latest release notes, patches, and announcements: http://www.rational.com/products/rs.
To receive automatic notification of new releases, patches, and critical technical information, subscribe to the following e-mail distribution list.
- 1 Send an e-mail to majordomo@rational.com.
- 2 In the body of your message, type:
- 1 Send an e-mail to majordomo@rational.com.
- 2 In the body of your message, type:
| Rational Software Corporation
http://www.rational.com support@rational.com techpubs@rational.com Copyright © 1997-2002, Rational Software Corporation. All rights reserved. |
| |
|