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_ifeature001/readme_612_ifeature001.html
1.0 About this release
2.0 Installation information
2.1 Software requirements
2.2 Licensing
2.3 Installing the interim feature
2.4 Local installations
2.4.1 Installing the OCR software locally
2.4.2 Installing the OCR software on remote systems
2.5 Creating a local mirror of the update server
2.5.1 Downloading and extracting updates
2.5.2 Creating and updating site.xml files
2.5.3 Creating a policy.xml file
2.5.4 Installing updates from the local mirror of the update server
2.6 Uninstalling the interim feature
3.0 Problems and workarounds
4.0 Contacting customer support
5.0 Notices and trademarks
This interim feature contains the IBM Rational Performance Tester Extension for Citrix Presentation Server. This protocol extension allows you to test the performance of Citrix Presentation Server applications on Windows platforms.
Information about Citrix performance testing is included in the on-line help. To access the help, click Help > Contents and start with the help topic "Citrix performance testing overview."
IBM Rational Performance Tester Extension for Citrix Presentation Server supports Citrix Presentation Server client version 9.0 or later and runs on Windows XP SP1 or SP2 and Windows 2000 Professional for recording, and Windows XP SP1 or SP2, Windows 2000 Professional, Windows Server 2000 SP3 or SP4, and Windows Server 2003 for test execution. This extension does not run on Linux or z/OS.
This interim feature contains translated versions of these release notes in the following languages:
| Brazilian Portuguese | Chinese - Simplified | Chinese - Traditional |
| French | German | Italian |
| Japanese | Korean | Spanish |
The Citrix extension uses software that has to be installed manually before using the optical character recognition (OCR) feature. If this software is not installed properly, an error message ("RNAPI.dll not found") will be displayed when you try to use the OCR feature. For detailed instructions about installing the OCR software, see sections 2.4.1 Installing the OCR software locally and 2.4.2 Installing the OCR software on remote systems.
This section describes how to install IBM Rational Performance Tester Interim Feature 6.1.2.01 by using the IBM Rational Product Updater. This interim feature is provided as an update. Use IBM Rational Product Updater to install the interim feature directly from the IBM update server; however, you can also download a ZIP file that contains this interim feature and then use IBM Rational Product Updater to perform local installations.
Note: You do not need to install the interim feature on remote agent computers. You only need to install it on the workbench.
The IBM Rational Performance Tester Extension for Citrix Presentation Server requires that the Citrix Presentation Server client version 9.0 or later is installed on local and remote computers for recording and running performance tests.
Before you can install this interim feature, you must install the IBM Rational Performance Tester Interim Fix Pack 6.1.2.001. For information about installing the 6.1.2.001 fix pack, see the release notes for that product at http://www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rpt/61/html/612_ifix001/readme_612_ifix001.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 interim feature.
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 interim feature.
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 IBM Rational Performance Tester. To check the current version of the IBM 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 IBM Rational Performance Tester Extension for Citrix Presentation Server requires a Citrix protocol license.
IBM Rational Performance Tester lets you run up to five concurrent HTTP virtual users without a license. On Citrix, you can run one virtual user without a license. 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 interim feature with the same user account that installed the product. You must use an account with Administrator privileges.
To install the interim feature directly from the IBM Rational update server, complete the following steps:
You can install the interim feature directly from the IBM update server; however, it is also available for download. You might want to download and install the interim feature in the following situations:
To download the interim feature, complete the following steps:
To install the interim feature, complete the following steps:
On local computers, add the directory containing the OCR software to the PATH environment variable:
On remote computers, copy the OCR directory and ocr.dll file to a directory on each remote computer, and then add the directory to the PATH variable:
To create a local mirror of the update server, you perform the following steps.
Note: You must have the IBM Rational Performance Tester Fix Pack version 6.1.2.001 installed before you can install the interim feature.
To create a local mirror of the IBM Rational Performance Tester update server, you must
Generally, an update site and a discovery site exist for each product. The update site contains product fixes, such as interim features and fix packs, and the discovery site contains optional features.
Each downloaded product fix contains a site_identifier.xml file in the product\612\<update_install_location>\ directory, and each downloaded feature contains a site_identifier.xml file in the product\612\<discovery_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 and the discovery site each require a separate site.xml file. To create each 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.
Uninstall the interim feature with the same user account that installed IBM Rational Performance Tester. Refresh pack 6.1.2 cannot be uninstalled.
Restrictions:
To uninstall the interim feature, complete the following steps:
Restrictions
You must use an account with Administrator privileges.
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:
This section lists the workarounds for problems in this interim fix release.
Citrix text input actions that contain the Euro currency symbol (€) are not replayed correctly. This is because of the way Windows handles this character internally.
A workaround for entering the € character in a Citrix performance test is to use a keyboard input action instead of a text input action.
In some cases, the test execution history incorrectly reports loops and conditions in Citrix performance tests at the test level even when they are located at a lower level in the test suite.
If you try to insert a new recording into a test suite that uses datapools, the automatic replay option does not work. You must use the manual replay option to put the Citrix session into the correct context before proceeding to enable the recording.
When a test suite loop contains the entire session, the test execution produces a memory leak that can cause an out of memory error. You should place the test suite in a schedule loop instead of placing the session in a test suite loop.
When the trace detail level is high, for example when logging settings are set to "All" and a short sampling interval is used, the test execution history can display incomplete information. To avoid the problem, reduce the logging detail level or increase the sampling interval.
If a Citrix performance test ends while an application has a modal dialog box open, the End program dialog box causes the test to take up to 40 seconds to terminate.
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.