To view the latest version of this file, see the readme at
http://www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rpt/61/html/612_ifix001/readme_612_ifix001.html
1.0 About this release
2.0 Installation information
2.1 Software requirements
2.1.1 Siebel requirements
2.1.2 z/OS requirements
2.2 Using Performance Tester for z/OS
2.2.1 z/OS environment configuration
2.2.2 Starting and stopping IBM Rational Performance Tester for z/OS
2.3 Licensing
2.4 Installing the interim fix pack
2.5 Local installations
2.6 Creating a local mirror of the update server
2.6.1 Downloading and extracting updates
2.6.2 Creating and updating site.xml files
2.6.3 Creating a policy.xml file
2.6.4 Installing updates from the local mirror of the update server
2.7 Uninstalling and reinstalling IBM Rational Performance Tester
3.0
Fixes in this release
4.0 Problems and workarounds
5.0 Contacting customer support
6.0 Notices and trademarks
The IBM Rational Performance Tester Interim Fix Pack 6.1.2.001 contains translated versions of the IBM Rational Performance Tester (RPT) online Help and translated versions of the release notes for the IBM Rational Performance Tester Refresh Pack version 6.1.2. It also contains fixes for several defects. The defects that have been fixed are listed in 3.0 Fixes in this release.
This fix pack contains translated versions of the Refresh Pack 6.1.2 Help in the following national languages:
This fix pack contains translated versions of the release notes for version 6.1.2 in the following languages:
| Brazilian Portuguese | Chinese - Simplified | Chinese - Traditional |
| French | German | Italian |
| Japanese | Korean | Spanish |
This section describes how to install IBM Rational Performance Tester Interim Fix Pack 6.1.2.001 by using the IBM Rational Product Updater. This fix pack is provided as an update. Use IBM Rational Product Updater to install the fix pack directly from the IBM update server; however, you can also download a ZIP file that contains this fix pack and then use IBM Rational Product Updater to perform local installations.
Note: You do not need to install the fix pack on remote agent computers. You only need to install it on the workbench.
Before you can install this fix pack, you must install the IBM Rational Performance Tester Refresh Pack 6.1.2. For information about installing the 6.1.2 refresh pack, see the release notes for that product at http://www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rpt/61/html/612/readme_612.html. If you change the default update site preferences by clicking Preferences > Update Sites, you must restore the default settings before you can install the fix pack.
If you disabled any product features by modifying the feature.xml files or by clicking Help > Software Updates > Manage Configuration, you must enable them before you install this fix pack
If you are performing a silent install, you must first install IBM Rational Product Updater 6.0.1 (if it is not already installed). If you do not, you are likely to corrupt Rational Performance Tester. To check the current version of the Rational Product Updater, click Help>About IBM Rational Product Updater. The current version is the last entry in the list. You can obtain IBM Rational Product Updater 6.0.1 from http://www3.software.ibm.com/ibmdl/pub/software/rationalsdp/updater/60/update/. Note that if you are performing a regular install using the graphical user interface, IBM Rational Product Updater is automatically updated.
The Siebel testing features require the Siebel-supplied data correlation library, ssdtcorr.dll (this file is provided in the Siebel Test Automation (STA) framework). You must obtain this library from Siebel and manually copy it on the local computer (where IBM Rational Performance Tester 6.1 has been installed), in this path: ...\SDP\6.0\rpt_prod\external_files\deployable\siebel\.
The correlation library must be present on every computer that runs a Siebel test. However, you do not need to copy it to remote computers because after you install the correlation library on the local computer, it is automatically copied as needed to any remote computer on which you deploy a Siebel test.
The Siebel-supplied correlation library depends on the Microsoft® C++ runtime library, which is implemented by the file msvcr70.dll. The Windows computer on which you want to run a Siebel test might contain no C++ runtime library or may contain a different version. In this case, you must obtain msvcr70.dll from the Microsoft Web site and copy it into the siebel folder. The siebel folder with the msvcr70.dllfile will be automatically copied as needed to any remote computer on which you deploy a Siebel test. Although this procedure is not necessary in some installations, putting a copy of msvcr70.dll into the siebel folder ensures that you will not have to worry about it being missing if you add an additional remote computer in the future.You must have the following software installed on your z/OS system:
The following sections explain how to use Performance Tester for z/OS. You must:
Have the system programmer set ASSIZEMAX to 2147483647.
Place the following export commands in the .profile of the user ID who will be starting Performance Tester for z/OS:
export RASERVER_HOME=install_dir/IBM/AgentController
export LIBPATH=$LIBPATH:install_dir/IBM/AgentController/lib:java_install_dir/bin:java_install_dir/bin/classic:xml_parser_dir/lib
export PATH=$PATH:install_dirIBM/AgentController/bin
Set the _BPX_SHAREAS environment variable to NO:
export _BPX_SHAREAS="NO"
The z/OS RAC must be started before you run a test. To start it, change the directory to install_dir/IBM/AgentController/bin and issue the following command:
./RAStart.sh.
To stop the z/OS RAC, issue the following command:
install_dir/IBM/AgentController/bin/RAStop.sh
IBM Rational Performance Tester lets you run up to five concurrent virtual users on Windows, Linux, or both. To run more users, however, virtual tester pack licenses are required. For example, you can run IBM Rational Performance Tester with up to five virtual users without a license, but to run ten virtual users, you must purchase a license for a virtual tester pack supporting five or more additional virtual users. Licenses come in sizes of 5, 50, 100, 250, 500, 1000, 2500, 5000, 10,000, 20,000, 50,000, and 100,000 virtual testers.
A virtual tester pack license is not divisible; only one user can use a particular virtual tester pack at any given time. For example, user A and user B cannot split a 50 virtual tester pack to each run a 25-user test. Rather, the 50 virtual tester pack license lets single user run a test emulating up to 50 virtual users.
A virtual tester pack license is additive; a single user can combine multiple virtual tester pack licenses to run a test supported by the combination of those licenses. For example, a single user can use two 50 virtual tester pack licenses to run a test simulating up to 100 virtual users.
Install the fix pack with the same user account that installed the product. On Windows operating systems, you must use an account with Administrator privileges. On Linux operating systems, you must log in as root.
To install the fix pack directly from the IBM Rational update server, complete the following steps:
Note: On Red Hat Enterprise Linux 3.0 and SuSE Linux Enterprise
Server 9.0, if you use a desktop environment other than the default, the
product shortcuts might not appear in the default location. In this case,
start IBM Rational Product Updater by running
install_dir/updater/eclipse/rpu.
You can install the fix pack directly from the IBM update server; however, it is also available for download. You might want to download and install the fix pack in the following situations:
To download the fix pack, complete the following steps:
To install the fix pack, complete the following steps:
Note: On Red Hat Enterprise Linux 3.0 and SuSE Linux Enterprise Server 9.0, if you use a desktop environment other than the default, the product shortcuts might not appear in the default location. In this case, start IBM Rational Product Updater by running install_dir/updater/eclipse/rpu.
To create a local mirror of the update server, you perform the following steps.
Note: You must have the IBM Rational Performance Tester Refresh Pack version 6.1.2 installed before you can install the fix pack.
To create a local mirror of the IBM Rational Performance Tester update server, you must
An update site exists for each product. The update site contains product fixes, such as interim fixes and fix packs.
Each downloaded product fix contains a site_identifier.xml file in the product\612\<update_install_location>\ directory, where identifier identifies the product fix or feature and product identifies the product. The site_identifier.xml files for updates to the IBM Rational Product Updater are located in the <update_install_location>\60\update\ directory.
The update site requires a site.xml file. To create a site.xml file, you must combine the <feature/> information from the appropriate site_identifier.xml files.
To create or update a site.xml file, complete the following steps:
Your rpt\612\update\site.xml
will look similar to the following:
<?xml version="1.0" encoding="UTF-8" ?>
<site>
<feature patch="true"
id="com.ibm.rational.performance.tester.612"
version="1.0.0"
url="features/com.ibm.rational.performance.tester.612_1.0.0.jar"/>
<feature
id="updater.rpt.common.plugins.612" version="1.0.0"
url="features/updater.rpt.common.plugins.612_1.0.0.jar"/>
<feature
id="updater.rpt.common.wb.plugins.612" version="1.0.0"
url="features/updater.rpt.common.wb.plugins.612_1.0.0.jar"/>
<feature
id="updater.rpt.common.nl.plugins.612" version="1.0.0"
url="features/updater.rpt.common.nl.plugins.612_1.0.0.jar"/>
<feature
id="updater.rpt.common.doc.plugins.612" version="1.0.0"
url="features/updater.rpt.common.doc.plugins.612_1.0.0.jar"/>
</site>
Each downloaded product fix and feature contains a product\policy_identifier.xml file that references its site_identifier.xml file. You must combine all of the policy_identifier.xml files into a single policy.xml file and edit the URL maps. After you create this file, you can use it for all product updates and reference the site.xml file that you created in the previous section.
To create the policy.xml file, complete the following steps:
After the local mirror of the update server is available, you can install updates by completing the following instructions.
Note: On Red Hat Enterprise Linux 3.0 and SuSE Linux Enterprise Server 9.0, if you use a desktop environment other than the default, the product shortcuts might not appear in the default location. In this case, start IBM Rational Product Updater by running install_dir/updater/eclipse/rpu.
Uninstall the fix pack with the same user account that installed IBM Rational Performance Tester. Refresh pack 6.1.2 cannot be uninstalled. Only Interim Fix 6.1.2.001 will be uninstalled.
Restrictions:
To uninstall the fix pack, complete the following steps:
Restrictions
On Windows operating systems, you must use an account with Administrator privileges. On Linux operating systems, you must use the root user account.
Uninstalling on Windows
To uninstall IBM Rational Performance Tester on a Windows system:
Note: To completely uninstall the product in order to ensure a clean re-install, remove the following:
Uninstalling on Linux
To uninstall IBM Rational Performance Tester on a Linux system:
This fix pack resolves the following problems. If an APAR number exists, the number is included.
-DrptLoadHistory=false ensures that the execution history events are not delivered to the workbench by the Rational Agent Controller.
-DrptSaveTempFiles=true ensures that the events are not
loaded and keeps the historyCache.tmp (and the annotation) file(s) in the
deployment directory on the local computer.
This section lists the workarounds for problems in this interim fix release.
Starting in 6.1.2 fix pack 001, the IBM Rational Performance Tester HTTP playback
engine supports peer close detection. This enables RPT to handle the low-level
TCP situation that occurs when a Web server closes its side of the socket
connection while a virtual user is in a sleep state, for example, in a paced
loop. The virtual user does not close its side of the TCP socket connection
until it awakes from its sleep state. This causes the TCP socket to be in the
half-closed state “close wait” longer than normal, which ties up system
resources on both the client and server systems. To resolve this, the
client-side of the TCP socket connection must close as soon as the Web server
socket-close is detected, regardless of the virtual user’s state.
To enable peer close detection,
add the property RPT_VMARGS with value
-DrptHTTPPeerCloseDetection=true to the location of a remote computer. This
causes RPT to close the client-side of the TCP socket connection as soon as the
Web servers’s socket-close is detected, regardless of the virtual use’s state.
The current side effect of enabling this option is a degradation of RPT
performance, which occurs when large numbers of users are being emulated.
To add the RPT_VMARGS property to the location of a remote computer:
The product home page for IBM Rational Performance Tester is www.ibm.com/software/awdtools/tester/performance/index.html. For FAQs, lists of known problems and fixes, and other support information, visit the Support page on the product home page.
U.S. Government Users Restricted Rights - Use, duplication or disclosure
restricted by GSA ADP Schedule Contract with IBM Corp.
This information
was developed for products and services offered in the U.S.A. IBM may not offer
the products, services, or features discussed in this documentation in other
countries. Consult your local IBM representative for information on the products
and services currently available in your area. Any reference to an IBM product,
program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right
may be used instead. However, it is the user's responsibility to evaluate and
verify the operation of any non-IBM product, program, or service.
IBM may
have patents or pending patent applications covering subject matter described in
this documentation. The furnishing of this documentation does not give you any
license to these patents. You can send license inquiries, in writing,
to:
IBM Director of Licensing
IBM
Corporation
North Castle Drive
Armonk, NY
10504-1785
U.S.A.
For license inquiries regarding double-byte
(DBCS) information, contact the IBM Intellectual Property Department in your
country or send inquiries, in writing, to:
IBM World Trade Asia Corporation
Licensing
2-31
Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law: INTERNATIONAL
BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY
OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OR CONDITIONS OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this statement may not
apply to you.
This information could include technical inaccuracies or typographical
errors. Changes are periodically made to the information herein; these changes
will be incorporated in new editions of the publication. IBM may make
improvements and/or changes in the product(s) and/or the program(s) described in
this publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web
sites. The materials at those Web sites are not part of the materials for this
IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the
purpose of enabling: (i) the exchange of information between independently
created programs and other programs (including this one) and (ii) the mutual use
of the information which has been exchanged, should contact:
Intellectual Property Dept. for Rational Software
IBM Corporation
20
Maguire Road
Lexington, MA
02421-3112
USA
Such information may be available, subject to appropriate terms and
conditions, including in some cases, payment of a fee.
The licensed program described in this documentation and all licensed
material available for it are provided by IBM under terms of the IBM Customer
Agreement, IBM International Program License Agreement or any equivalent
agreement between us.
Any performance data contained herein was determined in a controlled
environment. Therefore, the results obtained in other operating environments may
vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be the same on
generally available systems. Furthermore, some measurements may have been
estimated through extrapolation. Actual results may vary. Users of this document
should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of
those products, their published announcements or other publicly available
sources. IBM has not tested those products and cannot confirm the accuracy of
performance, compatibility or any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products should be addressed to the
suppliers of those products.
All statements regarding IBM's future direction or intent are subject to
change or withdrawal without notice, and represent goals and objectives
only.
This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples may
include the names of individuals, companies, brands, and products. All of these
names are fictitious and any similarity to the names and addresses used by an
actual business enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrates programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.
Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:
(C) (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. (C) Copyright IBM Corp. 2000, 2006. All rights reserved.
If you are viewing this information softcopy, the photographs and color
illustrations may not appear.
Programming interface information is intended to help you create application software using this program.
General-use programming interfaces allow you to write application software that obtain the services of this program's tools.
However, this information may also contain diagnosis, modification, and tuning information. Diagnosis, modification and tuning information is provided to help you debug your application software.
Warning: Do not use this diagnosis, modification, and tuning information as a programming interface because it is subject to change.
The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:
Java® and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.
Intel® is a trademark of Intel Corporation in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Linux is a trademark of Linus Torvalds in the United States, other countries, or both.
Other company, product, or service names may be trademarks or service marks of others.