Rational Suite Patch 2001A.04.02 Release Notes
September 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.
This patch can be installed over Patch 1 or in place of Patch 1. You do not have to have Patch 1 installed in order to install this patch. This patch is inclusive of all fixes included in Patch 1.
This patch contains new fixes for Rational RequisitePro, Rational ClearCase LT, Rational Rose, Rational Rose RealTime, Rational TestStudio and Rational TestManager. This patch includes all ClearQuest fixes that were included in Patch 1. Please note that no updates have been made to the ClearQuest patch.
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.
IMPORTANT NOTE: Rational Suite Extensibility has been
incorporated into the Testing Products code and is no longer available as an
individual patch. If you have the
Rational Suite Extensibility patch on your system please install the new
Testing Products patch (in teststudio2001a.04.02.293.002.zip) to update your
code.
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 1 Includes Patches Which Are New To Patch Release 2001a.04.02
|
Product |
Patch Version |
File Names |
Size |
|
Rational ClearCase LT |
2001A.04.02.293.003 |
clearcase_lt_p2001a.04.00-3.exe clearcase_lt_p2001a.04.00-3.htm |
7,331 KB 105 KB |
|
Rational RequisitePro |
2001A.04.02.293.001 |
requisitepro2001a.04.02.293.001.zip rationalrequisitepro2001a.04.02.293.001_releasenotes.htm |
4,948 KB 14 KB |
|
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 RoseRT |
2001A.04.02.293.004 |
rationalroserealtime2001a.04.02.293.004.win32.tar.gz rationalroserealtime2001a.04.02.293.004.tar.gz rationalroserealtime2001a.04.02.293.004_releasenotes.htm |
4,961 KB 984 KB 127 KB |
|
Rational TestManager |
2001A.04.02.293.002 |
testmanager2001a.04.02.293.002.zip testmanager2001a.04.02.293.002_realme.htm |
10,442 KB 284 KB |
|
Rational TestStudio |
2001A.04.02.293.002 |
teststudio2001a.04.02.293.002.zip teststudio2001a.04.02.293.002_readme.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.02_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. 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.02.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.02.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.
Rational
Rose
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 section 3.
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.
To install this
patch, please perform the following steps:
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 tar files for your platform to your $ROSERT_HOME directory and untar them there.
·
On
Windows you would need RoseRealTime2001a.04.02.293.004.tar.gz and
RoseRealTime2001a.04.02.293.004.win32.tar.gz
· Use winzip to extract the files into %ROSERT_HOME% usually this is the directory "C:\Program Files\Rational\Rose RealTime". Note that winzip is able to read the .tar.gz file, but it may report that "Archive contains one file: RoseRealTime2001a.04.01.293.010.win32.tar.gz Should WinZip decompress it to a temporary folder and open it?", answering Yes will allow the process to proceed.
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.120.0. (If it is
6.3.114.0 or 6.3.112, 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
No additional steps needed
Rational Test Tools
There are 3 different files available for the Test Tools.
· TestStudio patch file to be used with
TestStudio and Enterprise. Can be used
with TeamTest and Robot.
*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.02_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.02_consolidated_patch
contained in the new folder you specified.
5. Go into
the rs_2001a.04.02_consolidated_patch folder in the folder that you specified
in Step 4. For example,
C:\Temp\TestStudio\rs_2001a.04.02_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.02_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.02_consolidated_patch contained in the new folder you specified.
5.
Go into the rs_2001a.04.02_consolidated_patch folder in the folder that
you specified in Step 4. For example,
C:\Temp\TestStudio\rs_2001a.04.02_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.003 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.
This defect list can also be located on:
http://www.rational.com/support/downloadcenter/upgrades/index.jsp,
on the right navigator, under “Rational Suite v2001A for Windows Patch 1 and 2
Defects (2001A.04.01 and 2001A.04.02) List”.
http://www.rational.com/support/downloadcenter/patches/2001apatchtable.jsp,
on the Rational Suite version 2001A Patch Guide Page under “Rational
Suite v2001A for Windows Patch 1 and 2 Defects (2001A.04.01 and 2001A.04.02)
List”.
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-201 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:
· Your name, telephone number, and company name
· Your computer’s make and model
· Your operating system and version number
· Product release number and serial number
· Your case ID number (if you are following up on a previously-reported problem)