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_ifix002/readme_612_ifix002.html
1.0 About this release
2.0 Installation information
2.1 Software 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 Emulating network traffic from multiple hosts
4.0 Generating standard deviation information in reports
5.0 Fixes in this release
6.0 Problems and workarounds
7.0 Contacting customer support
8.0 Notices and trademarks
The IBM Rational Performance Tester Interim Fix Pack 6.1.2.002 contains defect fixes and the following updates:
IP aliases can be enabled for network connections to systems under test. For more information, see 4.0 Emulating network traffic from multiple hosts.
Standard deviation is now supported. For more information, see section 5.0 Generating standard deviation information in reports.
The defects that have been fixed are listed in 6.0 Fixes in this release.
This section describes how to install IBM Rational Performance Tester Interim Fix 6.1.2.002 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 location 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 changed 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 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 following sections explain how to use Performance Tester for z/OS.
You must have the following software installed on your z/OS system:Perform the following steps:
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_dir/IBM/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 be 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.002 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:
By default, when you run a schedule, each virtual user has the same IP address. However, you can make each virtual user appear as though it is running on its own host. To do this, you configure IP aliases on the host computer, and enable IP aliasing for the locations in the schedule. When you run the schedule, the network traffic will appear to be generated by multiple hosts.
To configure IP aliases for a Windows remote location computer
To configure IP aliases on a Linux remote location computer
Verify that the /etc/sysconfig/network-scripts/ifcfg-eth0 file does not have a GATEWAY= parameter in it. If it does, remove it and add that parameter to etc/sysconfig/network.
Copy the /etc/sysconfig/network-scripts/ifcfg-eth0 file to a new file called: /etc/sysconfig/network-scripts/ifcfg-eth0:1:
cp /etc/sysconfig/network-scripts/ifcfg-eth0 /etc/sysconfig/network-scripts/ifcfg-eth0:1
In /etc/sysconfig/network-scripts/ifcfg-eth0:1, change DEVICE=eth0 to DEVICE=eth0:1
In /etc/sysconfig/network-scripts/ifcfg-eth0:1, modify IPADDR= to specify the additional TCP/IP address to use.
Start the secondary interface: ifup eth0:1.
If you wish to create a large number of aliases or a range of aliases, follow the instructions in the file /etc/sysconfig/newtork-scripts/ifup-aliases. It describes a method to create a range of aliases.
To configure IP aliases on an AIX remote location computer
Use the ifconfig command to create an IP alias. To have the alias created when the system is booted, add the ifconfig command to the /etc/rc.net script.
The following example creates the alias 9.37.207.29 on the en1 network interface. The alias must be defined on the same subnet as the network interface.
# ifconfig en1 alias 9.37.207.29 netmask 255.255.255.0 up
The following example deletes the alias:
# ifconfig en1 delete 9.37.207.29
To set up the virtual users to use IP aliases
After you have configured the IP aliases, you set up which locations in the schedule will use which IP alias. To do this, complete the following steps:
a) Type –DrptIPAlias=true to query every network interface on the agent computer and collect IP addresses for each interface.
b) Type –DrptIPAlias=<comma separated list of device names>, for example, –DrptIPAlias=eth0, eth1 to specify individual devices. You can use a comma-separated list to exclude any network interfaces that should not be used. For example, if a remote location computer has network interfaces eth0, eth1, eth2, and eth3, but only eth0 and eth3 should be used, you would specify –DrptIPAlias=eth0, eth3.
Example: retrieving the IP address of a virtual user
This example shows how to retrieve the local IP address of a virtual user. Retrieving IP addresses is particularly useful if your virtual users are using IP aliases.
import java.net.InetAddress;
import com.ibm.rational.test.lt.kernel.IDataArea;
import com.ibm.rational.test.lt.kernel.services.ITestLogManager;
import com.ibm.rational.test.lt.kernel.services.IVirtualUserInfo;
public String exec(ITestExecutionServices tes, String[] args) {
IVirtualUserInfo vui = (IVirtualUserInfo) tes.findDataArea
IDataArea.VIRTUALUSER).
get(IVirtualUserInfo.KEY);
ITestLogManager tlm = tes.getTestLogManager();
if (vui != null) {
String localAddr = null;
InetAddress ipAddr = vui.getIPAddress();
if (ipAddr != null)
localAddr = ipAddr.toString();
tlm.reportMessage("IPAlias address is " + (localAddr != null ? localAddr :
"not set"));
return localAddr;
}
else
return ("Virtual User Info not found");
}
The tlm.reportMessage() method is affected by the setting of the execution history level, which must be set at a level that is granular enough to include the IP address. The display of the message from the custom code example depends on the following:
You can also verify the IP address by looking at the Properties view. If the Execution History/Logging level is set to Secondary Test Actions, Action Details, or All, and IP aliasing is enabled, you can look at the Properties view to see various properties for a selected HTTP request. One of the properties is titled "Local IP Address". This property is only present when IP aliasing is enabled.
To generate standard deviation information, drag a standard deviation counter from the Performance Test Runs view onto any report that lists an average response time. The standard deviation for that average is displayed in the report. The standard deviation tells you how tightly the data is grouped around the average response. The larger the standard deviation, the greater the variation in response time.
The following list shows the standard deviation counters and where, in the Performance Test Runs view, they are located. Some counters are for an entire run. Other counters are for a sample interval. To set this interval, set the Statistics sample interval value in the schedule.
{project name}>{results name}>{node name}>Pages>Response Time>All Pages>Standard Deviation [for
Interval]
The standard deviation for a specific page within a sample interval.
{project name}>{results name}>{node name}>Pages>Response Time>All Pages>Standard Deviation [for Run]:
The standard deviation for a specific page within the entire run.
{project name}>{results name}>{node name}>Pages>Response Time>Standard Deviation For All
Page Elements [for Interval]
The standard deviation for all page elements within a sample interval.
{project name}>{results name}>{node name}>Pages>Response Time>Standard Deviation For All
Page Elements [for Run]
The standard deviation for all page elements in the entire run.
{project name}>{results name}>{node name}>Pages>Response Time>Standard Deviation For All
Pages [for Interval]
The standard deviation for all pages within a sample interval.
{project name}>{results name}>{node name}>Pages>Response Time>Standard Deviation For All
Pages [for Run]
The standard deviation for all pages in the entire run.
This fix pack resolves the following problems. If an APAR number exists, the number is included.
In order to have a request redirected to a different host/port than it was recorded on, the following fields need to be changed to be consistent:
Use the 'Test Search' feature to perform the following steps:
If the address cannot be resolved, the connection time may be delayed by as much as 8 seconds, depending on the network configuration of the computer.
The simplest way to fix this delay is to add an entry to the /etc/hosts file (C:\windows\system32\drivers\etc\hosts on Windows XP and Windows 2K) specifying the IP address and a host name.
Due to restrictions on US exports of strong encryption products, this
release of IBM Rational Performance Tester does not support the testing of secure, Web-based systems
that use
the following cipher suites:
SSL_RSA_WITH_AES_256_CBC_SHA
SSL_DHE_RSA_WITH_AES_256_CBC_SHA
SSL_DHE_DSS_WITH_AES_256_CBC_SHA
SSL_DH_anon_WITH_AES_256_CBC_SHA
Encryption strength will automatically be downgraded to 128-bit versions
of these cipher suites.
If a server is configured to accept only 256-bit cipher suites, an error
message will appear in the execution history indicating this condition for each attempted
connection to the server.
There is known incompatibility between the Citrix Protocol Extension (version 6.1.2 iFeature 001) and this release. If both of these releases are installed on the same machine, tests that include the Citrix protocol will not be functional. Contact IBM customer support for a hot-fix which eliminates the incompatibility.
IBM Rational Performance Tester enables users to capture user-instance data in execution histories. The amount of data collected can exceed the amount of available JVM heap allocated to the workbench. When this happens, the workbench crashes. To process the data that results, you can request a utility from IBM Customer Support that enables the data to be viewed. The data is presented in a flat format without the hierarchical organization present if the same data were to be viewed in the Execution History Viewer.
When you contact customer support, the support representative will require the versions of the installed products or interim features on your system.
To determine the versions:
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.
IBM World Trade Asia Corporationn
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.