Rational Suite Patch 2001A.04.01 Release Notes
July 2001, Updated August 28, 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.
Hardware/Software Information. 1
Contacting Rational Technical
Support 10
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:
|
Product |
Patch Version |
File Names |
Size |
|
Rational ClearCase LT |
2001A.04.01.293.005 |
clearcase_lt2001a.04.00-2.exe clearcase_lt2001a.04.01.293.005_releasenotes.html |
5,982 KB 35 KB |
|
Rational ClearQuest |
2001A.04.01.293.012 |
clearquest2001a.04.01.293.012.exe clearquest2001a.04.01.293.012_releasenotes.html |
1,858 KB 55 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 |
|
Rational Requisite Pro |
2001A.04.01.293.008 |
requisitepro2001a.04.01.293.008.zip requisitepro2001a.04.01.293.008_releasenotes.html |
136 KB 14 KB |
|
Rational Rose |
2001A.04.01.293.011 |
rose2001a.04.01.293.011.zip rose2001a.04.01.293.011_releasenotes.html |
7,774 KB 36 KB |
|
Rational RoseRT |
2001A.04.01.293.010 |
roserealtime2001a.04.01.293.010.win32.tar.gz roserealtime2001a.04.01.293.010.tar.gz roserealtime2001a.04.01.293.010_releasenotes.html |
4,452 KB 960 KB 99 KB |
|
Rational TestTools |
2001A.04.01.293.004 |
testmanager2001a.04.01.293.004.zip testmanager2001a.04.01.293.004_releasenotes.html teststudio2001a.04.01.293.004.zip teststudio2001a.04.01.293.004_releasenotes.html |
5,953 KB 104 KB 5,952 KB 120 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.
·
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
Under “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. Follow these steps to
install this service release:
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 backup the existing
RqDatatransportWiz.exe file that the patch will overwrite. This file’s
default location is in the Program Files\Rational\RequisitePro\bin directory.
Complying with this directive will ensure that you can quickly restore your
system in the event a failure occurs while the patch is installing.
2. Ensure RequisitePro is not running. Unzip
the patch file and copy the extracted RqDataTransportWiz.exe file over
the existing one.
3. Start RequisitePro. The patch is
installed.
To install the patch,
please perform the following steps:
1. Manually backup
any files that the patch will overwrite.
2. Ensure that SoDA
for Word is not loaded in memory. If SoDA for Word is loaded in memory, be sure
to exit it before launching the patch.
3. Unzip the patch
file from the directory (<Install_Dir>) where the Rational Suite is
installed (such as C:\Program Files\Rational).
4. Extract the files
to the following paths:
<Install_Dir>\common\RSETeamTest.dll
<Install_Dir>\Rational
Test\rttestserver.dll
<Install_Dir>\Rational
Test\rtcomtestserver.dll
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. RforteLink.jarContent
8. rjava_addin.dll
9. rjava_addinres.dll
10. RforteLink.jar
11. RJBuilderLink.jar
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 zip file to a directory
2. Copy rose.exe and roseres.dll to C:\Program Files\Rational\Rose (or your installation area if the default was not used).
3. Copy the
RoseDataModeler.dll, RoseDataModelerResources.dll, and the RoseDataModeler.zip
(do NOT unzip this file) into the C:\Program Files\Rational\Rose\datamodeler
4. Copy the j2eemd.bmp,
rjava_addin.dll, rjava_addinres.dll into the C:\Program Files\Rational\Rose\java
directory
5. If you have Forte
installed, copy the RforteLink.jarContent and RforteLink.jar to the
<forte_install_dir>\modules
6.
If you have Jbuilder 4 installed, copy the RJBuilderLink.jar to the
<jbuilder_install_dir>\lib\ext, typically C:\Jbuilder4
From the command line, register the Rjava_addin.dll and RoseDataModeler.dll using regsrv32 with the commands:
C:\Program Files\Rational\Rose\Java> regsvr32 rjava_addin.dll
C:\Program Files\Rational\Rose\datamodeler> regsvr32 RoseDataModeler.Dll
If you have installed Rose Java Professional Edition, you do not any files except for the ones listed in step 4 above. Copying these files to your install area will not cause any problems, but also will not add any features to your installation of Rose. 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 the rjava_addin.dll and rjava_addinres.dll files. It is not recommended that you copy these files or register them on your computer as doing so will partially install features from the Rose Java Professional Edition, but will result in errors in the execution of Rose. To install the patch on this installation, simply copy the rose.exe and roseres.dll files to your Rational Rose installation area, typically C:\Program Files\Rational\Rose. Then copy RoseDataModeler.dll, RoseDataModelerResources.dll, and the RoseDataModeler.zip files to your Data Modeler directory, typically C:\Program Files\Rational\Rose\datamodeler.
C:\Program Files\Rational\Rose\datamodeler> regsvr32 RoseDataModeler.Dll
If you have installed any other edition of Rose, you only need to replace the rose.exe and roseres.dll files. Copying the other files to your system is not recommended as this may cause errors in the execution of Rose. To install the patch on this installation, simply copy the rose.exe, and roseres.dll files to your Rational Rose installation area, typically
C:\Program Files\Rational\Rose
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 RT v6.3 installed and ensure that file and directory permissions
allow writing to the file listed in section 3.
If Rose Real Time has been network/admin installed, the patch applies to the server machine only. Please contact your administrator to install the patch.
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.gz files for your platform to your $ROSERT_HOME directory and untar them there.
on Windows you
would need RoseRealTime2001a.04.01.293.010.tar.gz and
RoseRealTime2001a.04.01.293.010.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.114.0. (If it is
6.3.112.0, then
the patch was not applied correctly.)
There are 3 different files available for the
Test Tools.
·
TestStudio
patch file to be used with testStudio and Enterprose. 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
Rational
TestManager
Installation
Information
1. Stop
all Rational products.
2. When
you are installing TestManager, you must stop the ProxyServer
Service (rtpxsr.exe) if it is running on your computer. Do the
following:
·
For
NT servers:
a)
Select
Start->Settings->Control Panel->Services.
b)
Select
ProxyServerService.
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
ProxyServerService.
e) From
the Action menu, click Stop.
3. 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.
1. If
you have downloaded the service release consolidated patch zip file,
rs_2001a.04.01_consolidated_patch.zip, you’ll need to first extract
testmanager2001A.04.01.293.004.zip from it. If you already have the
testmanager2001A.04.01.293.004.zip file, skip Steps 2 through 4 below and go to
Step 5.
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 testmanager2001A.04.01.293.004.zip.
Extract testmanager2001A.04.01.293.004.zip by clicking on Extract and specifying
a new folder, such a C:\Temp\TestManager.
This extracts testmanager2001A.04.01.293.004.zip to the folder
rs_2001a.04.01_consolidated_patch contained in the new folder you
specified.
4. Go into
the rs_2001a.04.01_consolidated_patch folder in the folder that you specified in
Step 3, for example,
C:\Temp\TestManager\rs_2001a.04.01_consolidated_patch.
5. Extract
the files from testmanager2001A.04.01.293.004.zip into a
new folder named SR1.
6. When the
extraction is complete, select Start->Run and then type cmd. A
command prompt appears.
7. Change
(cd) to the
SR1 folder that contains the extracted files.
8. Install
the service release.
· To
install the service release for a local (non-agent) computer, change
(cd) to the
Windows folder 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.
· To
install on a Windows Test Agent computer, copy the contents of the Windows_Agent
directory to the Rational installation directory. Change (cd) to the
Windows_Agent folder 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.
1. Stop
all Rational products.
2. When
you are installing TestStudio, you must stop the ProxyServer
Service (rtpxsr.exe) if it is running on your computer. Do the
following:
·
For
NT servers:
a)
Select
Start->Settings->Control Panel->Services.
b)
Select
ProxyServerService.
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
ProxyServerService.
e) From
the Action menu, click Stop.
3. 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.
4. If
you are going to be doing DCOM recording, you should 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
5. If you
have previously done DCOM recording, your registry will contain two keys related
to DCOM recording, Exclude
CLSID Set and
PreCache
Typelib Set. These keys must be replaced. If these keys are not present in your
registry, skip this step. If the
keys do exist, use regedit to
rename them
a)
Select Start->Run and
then type regedit. The Registry
Editor will appear.
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 will be automatically re-generated
with updated values the next time you record.
1. If
you have downloaded the service release consolidated patch zip file,
rs_2001a.04.01_consolidated_patch.zip, you’ll need to first extract
teststudio2001A.04.01.293.004.zip from it.
If you already have the teststudio2001A.04.01.293.004.zip file, skip
Steps 2 through 4 below and go to Step 5.
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.01.293.004.zip.
Extract teststudio2001A.04.01.293.004.zip by clicking on Extract and specifying
a new folder, such a C:\Temp\TestStudio.
This extracts teststudio2001A.04.01.293.004.zip to the folder
rs_2001a.04.01_consolidated_patch contained in the new folder you
specified.
4. Go into
the rs_2001a.04.01_consolidated_patch folder in the folder that you specified in
Step 3, for example,
C:\Temp\TestStudio\rs_2001a.04.01_consolidated_patch.
5. Extract
the files from teststudio2001A.04.01.293.004.zip into a
new folder named SR1.
6. When the
extraction is complete, select Start->Run and then type cmd. A
command prompt appears.
7. Change
(cd) to the
SR1 folder that contains the extracted files.
8. Install
the service release.
· To
install the service release for a local (non-agent) computer, change
(cd) to the
Windows folder 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.
· To
install on a Windows Test Agent computer, copy the contents of the Windows_Agent
directory to the Rational installation directory. Change (cd) to the
Windows_Agent folder and type the following command:
xcopy
/e /s *.* "C:\Program Files\Rational"
This
will copy 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,
9. If
you are going to be doing 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.
This
patch is a self extracting executable.
To
install this patch, please perform the following steps:
1. Run the self extracting executable
"clearcase_lt_p2001A.04.00-2.exe".
2. Optionally view the patch
readme
3. Verify that the location of where
ClearCase_LT is installed on the system is correct.
4. Answer "yes" to restart your
computer
No
other configuration is necessary.
Once the machine reboots it is ready to run ClearCase_LT.
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.
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)