Rational Suite Patch 2001A.04.03 Release Notes
December 2001
Copyright © 2001 Rational Software Corporation. All Rights Reserved.
The patches described in this document are applicable to Rational Suite and other Rational products on the Rational Solutions CD version 2001A.04.00.
If you have multiple Rational products installed, please install all applicable product fixes supplied in this file. This will ensure that product integrations continue to operate properly. For example, if you have Rational Suite Enterprise installed, you will need to apply all fixes contained within this patch with the exception of RoseRT.
If you have already installed Rational Suite Patch Release 2001a.04.01 or 2001a.04.02, this patch can be installed in addition to 2001a.04.01 and/or 2001a.04.02. It is not necessary to install Rational Suite Patch Release 2001a.04.01 or 2001a.04.02 prior to installation of this patch. This patch is inclusive of all fixes included in patch release 2001a.04.01 and 2001a.04.02.
This patch contains new fixes for Rational RequisitPro, Rational ClearCase LT and Rational Rose RealTime. This patch is inclusive of all Rational ClearQuest, Rational Rose, Rational TestStudio, Rational TestManager fixes that were included in previous patches.
Please
note that the Rational ClearQuest,
Rational Rose, Rational TestStudio and Rational TestManager patches have
not been updated since their previous release.
For a complete list of all fixes included in this patch please go to http://www.rational.com/support/documentation/release/v2001A/rs_patch_defects.htm.
Contacting Rational Technical Support
There are no changes to the supported platforms in this
release. For information on
supported platforms, please see the Rational Suite Release Notes, Version
2001A.04.00.
There are no changes to the hardware requirements in this
release. For information on
hardware requirements, please see the Rational Suite Release Notes, Version
2001A.04.00.
This file includes the following patches:
Table 3 Includes Patches Which Are New To Patch Release 2001a.04.03
|
Product |
Patch Version |
File Names |
Size |
|
Rational ClearCase LT |
2001A.04.03.293.002 |
clearcase_lt_p2001a.04.00-5.exe clearcase_lt_p2001a.04.00-5.htm |
8,009 KB 115 KB |
|
Rational RequisitePro |
2001A.04.03.293.001 |
requisitepro2001a.04.03.293.001.exe rationalrequisitepro2001a.04.03.293.001_releasenotes.htm |
4,836 KB 15 KB |
|
Rational Rose RealTime |
2001A.04.03.293.003 |
rationalroserealtime2001a.04.03.293.003.exe rationalroserealtime2001a.04.03.293.003.target.tar.gz rationalroserealtime2001a.04.03.293.003_releasenotes.htm |
14,004 KB 6 KB 193 KB |
Table 2 Includes Patches Which Were Part Of Patch Release 2001a.04.02
|
Product |
Patch Version |
File Names |
Size |
|
Rational Rose |
2001A.04.02.293.005 |
rationalrose2001a.04.02.293.005.exe rationalrose2001a.04.02.293.005_releasenotes.htm |
14,004 KB 47 KB |
|
Rational TestManager |
2001A.04.02.293.002 |
testmanager2001a.04.02.293.002.zip testmanager2001a.04.02.293.002_releasenotes.htm |
10,442 KB 284 KB |
|
Rational TestStudio |
2001A.04.02.293.002 |
teststudio2001a.04.02.293.002.zip teststudio2001a.04.02.293.002_releasenotes.htm |
10,443 KB 296 KB |
|
Product |
Patch Version |
File Names |
Size |
|
Rational ClearQuest |
2001A.04.01.293.012 |
clearquest2001a.04.01.293.012.exe clearquest2001a.04.01.293.012_releasenotes.html |
1,902 KB 44 KB |
|
Rational Suite Extensibility |
2001A.04.01.293.009 |
Rse2001a.04.01.293.009.zip Rse2001a.04.01.293.009_releasenotes.html |
822 KB 41 KB |
If you have multiple Rational products installed, please install all applicable product fixes supplied in this file. This will ensure that product integrations continue to operate properly.
a. Create a temporary directory on your system.
b.
Unzip the file called
"rs_2001a.04.03_consolidated_patch.zip" into this directory.
When you unzip the file, it will create a directory structure and unzip patch
files and Readme files for each product into the appropriate directory.
Patch files for individual products are either a zip file or a self-extracting
executable file.
c. Install the patches you need by following the directions in each product’s Release Note file. If you have multiple Rational products installed, please apply all product fixes supplied in this file. This will ensure that any product integrations continue to operate properly.
·
To determine what version of Rational products you
currently have installed, please go to “Start” à “Programs” à
“Rational <Product Title>” à “Rational Software Installed Product Information”.
·
Please note that the instructions listed in the following
sections are general instructions.
Please refer to the individual product Release Note documents for
specific instructions.
·
Release notes for all products can be accessed via http://www.rational.com/support/documentation/index.jsp
go to “View Documentation OnLine”, go to the “Documentation” drop down
box. Choose “View all Rational
Release 2001A Release Notes”. All
release notes pertaining to this patch are identified by the word “Patch” in
their description.
Rational ClearQuest Service Release 2001A.04.01.293.012 is designed to be installed directly on top of ClearQuest v2001A.04.00. This service release comprises this release notes file and a self-extracting executable.
To
install this patch, please perform the following steps:
1. If the ClearQuest web is
installed on your machine you must ensure that the ClearQuest\WWW folder is not
read-only.
2.
Run the self-extracting executable ‘clearquest2001a.04.01.293.012.exe’.
3. Enter the location of your existing
ClearQuest or Rational Suite installation in the ‘Unzip to folder:’ field.
Please be sure to provide the name of the folder that contains the ClearQuest
folder.
4. Press the ‘Unzip’ button
to extract the service release into your installation.
No other configuration is necessary.
Users may immediately begin running the ClearQuest client.
To install this
patch, please perform the following steps:
1.
Manually back up the existing requisitepro.exe file, the RqDatatransportWiz.exe,
and the rqprores.dll files that the patch will overwrite. It is
important that you backup these files by copying them to another location.
Renaming the files or removing them will cause the installation to fail. The
default location for all these files is the [drive]\Program
Files\Rational\RequisitePro\bin directory. Complying with this directive
will ensure that you can quickly restore your system in the event that a failure
occurs while you are installing the patch.
2.
Ensure that RequisitePro is not running. Run the RequisitePro2001a.04.03.293.001.exe
file.
3. Start RequisitePro.
The patch is installed. The new RequisitePro User's Guide (requisitepro_using.pdf)
can now be found in [installation
folder]/Rational/doc. The default installation location is C:\Program Files\Rational\doc, but if you have installed to a
custom location, the RequisitePro2001a.04.03.293.001.exe file will locate the doc folder
and install the User's Guide there automatically. If you are working in a team
environment, you may copy the document to a more convenient location on your
network later.
Check that there is a valid Rational Rose 2001a installed and ensure that file and directory permissions allow writing to the file listed in section 3.
Files Modified for
this Patch
In this zip file you will find the following files:
1. rose.exe
2. roseres.dll
3. RoseDataModeler.Dll
4. RoseDataModelerResources.Dll
5. RoseDataModeler.zip
6. j2eemd.bmp
7. wm-xml.dll
8. rjava_addin.dll
9. rjava_addinres.dll
10. cppcvtk2.dll
11. cppcvtk2res.dll
12. cppdll.dll
13. cppevent.dll
14. cppres.dll
15. resources.dll
16. cppstereotypes.ini
17. RforteLink.jarContent
18. RforteLink.jar
19. RJBuilderLink.jar
20. 67 Framework files to improve the frameworks for Java.
To install this
patch, please perform the following steps:
If you have installed Rose Enterprise Edition you will need all of the files in this patch zip and should install them using the following steps:
1. Extract the self-extracting zip file. The default location is C:\Program Files\Rational. If you have installed Rose to a different location then you will need to change the default location.
From the command line, register the following dll’s using regsrv32 with the commands:
C:\Program Files\Rational\Rose\Java> regsvr32 rjava_addin.dll
C:\Program Files\Rational\Rose\Ansi C++> regsvr32 cppevent.dll
C:\Program
Files\Rational\Rose\datamodeler> regsvr32 RoseDataModeler.Dll
C:\Program Files\Rational\Rose\Web Modeler> regsvr32 wm-xml.dll
If you have installed Rose Java Professional Edition. Follow the install instructions for the Rose Enterprise Edition.
From the command line, register the Rjava_addin.dll and rjava_addinres.dll using regsrv32 with the commands:
C:\Program Files\Rational\Rose> regsvr32 rjava_addin.dll
If you have installed Rose Data Modeler Professional Edition, you do not need any of the files except the Data Modeler files. However, you should not encounter any errors if you extract all the files to the proper location. To install the patch on this installation, simply extract the files and register your RoseDataModeler.dll.
C:\Program Files\Rational\Rose\datamodeler> regsvr32 RoseDataModeler.Dll
If you have installed any other edition of Rose, then you will only need to follow steps for the Enterprise section. You will not need to register any files.
What to do After
Installation:
Reboot the machine to ensure Windows handled
everything ok.
What to do Before
Installation:
Check that there is a valid Rose RealTime
v2001A.04.00 installed and ensure that file and directory permissions allow
writing to the file listed in the defects and changes section.
If Rose RealTime has been network/admin installed, the patch applies to the server machine only. Please contact your administrator to install the patch.
Some Windows virus checking software will warn about the gzip'ed files (those files with the .gz extension). This warning can be safely ignored. There should be no virus's reported during the extraction of the patch files when using winzip.
How to Install
this Patch:
1. Ensure there is no running instance of Rose RealTime on the system to update.
2. Ensure that you DELETE ALL EXISTING .chw files from your $ROSERT_HOME/Help directory.
Any existing .chw files that you may have will not correspond to the new help files.
3. Copy the appropriate files for your platform to your $ROSERT_HOME directory.
·
On Windows you would need RoseRealTime2001a.04.03.293.003.exe which will
use winzip to extract the files into %ROSERT_HOME% -- usually this is the
directory "C:\Program Files\Rational\Rose RealTime”
4. (optional). This patch includes changes to the C++ TargetRTS source files. These changes are included in RoseRealTime2001a.04.03.293.003.target.tar.gz.
·
If you are having problems with the Target Observation feature and
missing messages, you should untar this fix into the TargetRTS directory and
rebuild the configurations that you use.
·
If
you are not having these problems -- which are generally described as RQART
incorrectly reports missing messages, then it is not necessary to install these
files.
What to do After Installation:
The accompanying tar files are no longer needed. However, if you wish to retain them if
a re-installation is required, place these tar files in $ROSERT_HOME/specials.
Run the toolset and ensure that the build number is 6.3.137.0. (If it is
not, then the patch was not applied correctly.)
To verify the online help, start Rose RealTime, from the Help menu,
click
contents, then click the Index tab. If the Index crashes or is blank,
then
the patch was not applied correctly.
Reload and Rebuild Java Models
No additional steps needed
Rebuild C++ models
Run the toolset and ensure that the build number of
RQA is 6.3.150.0. . (If it is
not, then the patch was not applied correctly.)
Rational Test Tools
There are 3 different files
available for the Test Tools.
·
The TestStudio patch file to be used with Rational
TestStudio or Rational Suite Enterprise.
This patch can also be used with Rational TeamTest or Rational Robot.
·
The TestManager patch file to be use with Rational
DevelopmentStudio, Rational AnalystStudio or Rational TestManager only
installs.
·
The UNIX Test Agent patch file is available for all products
that contain TestManager. This
patch contains updates for the UNIX Test Agent CD.
*Please
note that the UNIX Test Agents patch is a separate patch. To access this patch please refer to www.rational.com
Before you install this patch, please follow these steps:
1. Stop all Rational products.
When you are
installing on the TestStudio host (non-agent) computer, you must stop the ProxyServer
Service (rtpxsr.exe) if it is running. Do the following:
·
For NT servers:
a) Select Start->Settings->Control Panel->Services.
b) Select ProxyServer Service.
c) Click Stop.
· For Windows 2000:
a) Select Start->Settings->Control Panel->Administrative
Tools->Computer Management.
b) Click Services and Applications.
c) Click Services.
d) Select ProxyServer Service.
e) From the Action menu, click Stop.
2. To stop the Agent process for NT and Windows 2000 test agents:
a) Open Task Manager.
b) Select the Task Manager Processes tab.
c) End the agent process called rtprvd.exe.
3. If you will do DCOM recording, unregister
your existing version of rtxcomspy.dll:
a) Select Start->Run and then type cmd. A command prompt appears.
b) Change (cd) to the folder that contains your existing
Rational Test installation (%RATL_RTHOME%).
c) Type the
command: regsvr32 -u
rtxcomspy.dll
4. If you
have previously installed Service Release 1, you can skip Step 4. If you did not install Service Release
1 and if you have previously done DCOM recording, your registry contains two
keys related to DCOM recording, Exclude CLSID Set and PreCache
Typelib Set. If
these keys exist, use regedit to rename
them.
a) Select Start->Run and then type regedit. The Registry Editor appears.
b) In the Registry Editor, navigate to the
selection:
HKEY_CURRENT_USER\Software\Rational
Software\Rational Test\8\Robot\VU Recording\API Recording
c) Rename the “Exclude CLSID Set” entry to “RTM Exclude CLSID Set” by right clicking on the “Exclude CLSID Set” entry.
d) Rename the “PreCache Typelib Set” entry to “RTM PreCache Typelib Set” by right clicking on the “PreCache Typelib Set” entry.
The
keys are automatically re-generated with updated values the next time you
record.
To install this patch, please follow these steps:
1. If you have downloaded the service release consolidated patch zip
file, rs_2001a.04.03_consolidated_patch.zip, you must then extract
teststudio2001A.04.02.293.002.zip from it. If you already have the teststudio2001A.04.02.293.002.zip
file, skip Steps 2 through 5 below and go to Step 6.
2. Go to the folder in which you downloaded the service release
consolidated patch zip file.
3. Open the consolidated patch zip file and select
teststudio2001A.04.02.293.002.zip.
4. Extract teststudio2001A.04.02.293.002.zip by clicking on Extract
and specifying a new folder, such a C:\Temp\TestStudio. This extracts
teststudio2001A.04.02.293.002.zip to the folder rs_2001a.04.03_consolidated_patch
contained in the new folder you specified.
5. Go into
the rs_2001a.04.03_consolidated_patch folder in the folder that you specified
in Step 4. For example,
C:\Temp\TestStudio\rs_2001a.04.03_consolidated_patch.
6. Extract
the files from teststudio2001A.04.02.293.002.zip into a new
folder named SR2.
7. When the
extraction is complete, select Start->Run and then type cmd. A command prompt
appears.
8.
Change (cd) to the
SR2 folder that contains the extracted files.
9.
Install the service release from either the Windows
or Windows_Agent folder.
· Change (cd) to the
Windows folder to install the service release for a local (non-agent) computer
and type the following command:
xcopy /e /s *.*
"C:\Program Files\Rational"
This command copies all service release files into their
corresponding Rational folders. If you originally installed in a folder other
than C:\Program Files\Rational, use that folder name in the xcopy command.
· Change (cd) to the Windows_Agent
folder to install on a
Windows Test Agent computer and type the following command:
xcopy /e /s *.* "C:\Program Files\Rational"
This command copies all service release files into their
corresponding Rational folders. If you originally installed in a folder other
than C:\Program Files\Rational, use that folder name in the xcopy command,
10. If you will do DCOM recording, you must register
the updated version of rtxcomspy.dll:
a) Select Start->Run and then type cmd. A command prompt appears.
b) Change (cd) to the folder that contains your existing
Rational Test installation (%RATL_RTHOME%).
c) Type the command: regsvr32 rtxcomspy.dll
Note: On Windows NT
and Windows 2000 hosts, both the ProxyServer Service and agent process are
configured by default to start at boot time. If you do not reboot after
installing the service release, restart the ProxyServer Service on local hosts
and the agent process on agent hosts.
Before you install this patch, please follow these steps:
1.
Stop all Rational products.
When you are installing on the
TestStudio host (non-agent) computer, you must stop the ProxyServer
Service (rtpxsr.exe) if it is running. Do the following:
·
For NT servers:
a) Select
Start->Settings->Control Panel->Services.
b) Select
ProxyServer Service.
c) Click
Stop.
·
For Windows 2000:
a) Select Start->Settings->Control Panel->Administrative
Tools->Computer Management.
b) Click Services and Applications.
c) Click Services.
d) Select ProxyServer Service.
e) From the Action menu, click Stop.
2.
Stop the Agent process for NT and Windows
2000 test agents:
a) Open Task Manager.
b) Select the Task Manager Processes tab.
c) End the agent process called rtprvd.exe.
.
To install this patch, please perform the following steps:
1. If you have downloaded the service release consolidated patch zip
file, rs_2001a.04.03_consolidated_patch.zip, you’ll need to first extract
teststudio2001A.04.02.293.002.zip from it. If you already have the teststudio2001A.04.02.293.002.zip
file, skip Steps 2 through 5 below and go to Step 6.
2. Go to the folder in which you downloaded the service release
consolidated patch zip file.
3. Open the consolidated patch zip file and select
teststudio2001A.04.02.293.002.zip.
4. Extract teststudio2001A.04.02.293.002.zip by clicking on Extract
and specifying a new folder, such a C:\Temp\TestStudio. This extracts
teststudio2001A.04.02.293.002.zip to the folder
rs_2001a.04.03_consolidated_patch contained in the new folder you specified.
5. Go into
the rs_2001a.04.03_consolidated_patch folder in the folder that you specified
in Step 4. For example, C:\Temp\TestStudio\rs_2001a.04.03_consolidated_patch.
6. Extract
the files from teststudio2001A.04.02.293.002.zip into a
new folder named SR2.
7. When the
extraction is complete, select Start->Run and then type cmd.
A command prompt appears.
8.
Change (cd) to the
SR2 folder that contains the extracted files.
9.
Install the service release from either the Windows or Windows_Agent
folder.
·
Change (cd) to the Windows folder to install the service
release for a local (non-agent) computer and type the following command:
xcopy /e /s *.* "C:\Program Files\Rational"
This command copies all service release files into their
corresponding Rational folders. If you originally installed in a folder other
than C:\Program Files\Rational, use that folder name in the xcopy command.
·
Change (cd) to the
Windows_Agent folder to install on a
Windows Test Agent computer and type the following command:
xcopy /e /s *.* "C:\Program Files\Rational"
This command copies all service release files into their
corresponding Rational folders. If you originally installed in a folder other
than C:\Program Files\Rational, use that folder name in the xcopy command,
Note: On Windows NT
and Windows 2000 hosts, both the ProxyServer Service and agent process are
configured by default to start at boot time. If you do not reboot after installing
the service release, restart the ProxyServer Service on local hosts and the
agent process on agent hosts.
Rational ClearCase LT Service Release 2001A.04.02.293.002 is intended to update a host that is running Rational ClearCase LT Release 2001A.04.00. This service release includes all fixes distributed in earlier service releases for Rational ClearCase LT Release 2001A.04.00. This service release comprises this release notes file and a self extracting executable. Follow these steps to install this service release:
Please
refer to each individual Release Note for information on Product Documentation.
Please
refer to each individual Release Note for a list of defects fixed by this patch
and a list of files changed by this release. A complete list of all fixes contained within this patch can
be found on http://www.rational.com/support/documentation/release/v2001A/rs_patch_defects.htm.
The following table lists the products included in each Suite.
|
SUITE COMPONENT PRODUCTS |
Rational Suite Enterprise |
Rational Suite AnalystStudio |
Rational Suite Development Studio |
Rational Suite TestStudio |
Rational Suite Team Unifying Platform |
Rational Suite Development Studio RealTime Edition |
|
Team Unifying Tools |
||||||
|
Rational ClearQuest (includes ClearQuest Web) |
* |
* |
* |
* |
* |
* |
|
Rational Unified Process |
* |
* |
* |
* |
* |
* |
|
Rational RequisitePro (includes RequisiteWeb) |
* |
* |
* |
* |
* |
* |
|
Rational SoDA for Word |
* |
* |
* |
* |
* |
* |
|
Rational ClearCase LT |
* |
* |
* |
* |
* |
* |
|
Rational TestManager |
* |
* |
* |
* |
* |
* |
|
Practitioner-Specific Tools |
||||||
|
Rational Rose |
*(Enterprise) |
*(Modeler) |
*(Enterprise) |
|
|
RealTime Edition |
|
Rational Robot |
* |
|
|
* |
|
|
|
Rational TestFactory |
* |
|
|
* |
|
|
|
Rational Purify |
* |
|
* |
* |
|
* |
|
Rational PureCoverage |
* |
|
* |
* |
|
* |
|
Rational Quantify |
* |
|
* |
* |
|
* |
If you have questions about installing, using, or maintaining this product, contact Rational Technical Support as follows:
|
Your Location |
Telephone |
Facsimile |
E-mail |
|
North
America |
(800)
433-5444 (toll
free) (408)
863-4000 Cupertino,
CA |
(781)
676-2460 Lexington,
MA |
support@rational.com
|
|
Europe,
Middle East, Africa |
+31
(0) 20-4546-200 Netherlands |
+31
(0) 20-4545-202 Netherlands |
support@europe.rational.com
|
|
Asia
Pacific |
+61-2-9419-0111 Australia |
+61-2-9419-0123 Australia |
support@apac.rational.com
|
When you contact Rational Technical Support, please be prepared to supply the following information: