© Copyright International Business Machines Corporation 2000, 2007. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
The latest version of this document is available at http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/v7/rpt/7002/docs/readme/readme.html.
In addition, see the release notes for version 7.0 of this product to learn about its new features and any limitations or problems known at the time of its release. The release notes for version 7.0 are available at http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/v7/rpt/70/docs/readme/readme.html.
This release contains defect fixes and the following updates:
- Rational Performance Tester is now Vista tolerant. More information on Vista tolerance is available in the installation and limitations sections below.
- The response time breakdown feature now supports WebSphere Application Server Version 6.1.
- Recording tests with Firefox 2.0 is now supported.
- The Citrix extension now supports the Citrix Web Interface. See the limitations section below for more details.
- Shell sharing is now supported. Rational Performance Tester can now share a single common Eclipse instance with other Rational software products.
For information about installing Rational Performance Tester, Version 7.0, including installation prerequisites, see the Installation Guide online at http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/v7/rpt/70/docs/install_instruction/install.html.
- Important note about upgrading from Microsoft® Windows® XP to Windows Vista:
- If you plan to upgrade your Microsoft Windows XP operating system to Windows Vista and IBM Rational Performance Tester, Version 7.0 or 7.0.0.1 is currently installed, refer to the instructions on the Support Web site, http://www.ibm.com/support/docview.wss?uid=swg21257411.
Before you can install this fix pack, you must install IBM Installation Manager, Version 1.0.0.3. In Installation Manager, if you have not disabled the default setting to search the linked repositories during installation and update, IBM Installation Manager, Version 1.0.0.3 is automatically installed on your computer when you attempt to update or install packages using an earlier version of Installation Manager.
For additional information about Installation Manager, Version 1.0.0.3, refer to http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/v7/im/1003/docs/readme/readme.html.
If you are extending an Eclipse IDE, then before you install this fix pack you must install version 3.2.2 or higher of the Eclipse IDE and one of the following Java runtime environments:
- For Windows: IBM 32-bit Runtime Environment for Windows, Java 2 Technology Edition, Version 5.0 service release 4; Sun Java 2 Platform Standard Edition Runtime Environment Version 5.0 Update 11 for Microsoft Windows
- For Linux: IBM 32-bit Runtime Environment for Linux on Intel® architecture, Java 2 Technology Edition, Version 5.0 service release 4; Sun Java 2 Platform Standard Edition Runtime Environment Version 5.0 Update 11 for Linux x86 (not supported for SUSE Linux Enterprise Server [SLES] Version 9)
If you have already extended Eclipse with a 7.0 or 7.0.0.1 version of a product, do the following to update Eclipse prior to updating to 7.0.0.2:
- Start the product.
- Click Help > Software Updates > Manage Configuration.
- Open the folder where you have the original Eclipse shell in the Manage Configuration dialog.
- Click on the feature titled: Eclipse Project SDK 3.2.1.r321*
- Click on "Scan for updates" in the right panel of the Manage Configuration dialog.
- Select an update site mirror to install from, then click OK and install the updates.
- Close the product once the update is complete, then run Installation Manager to update the product to 7.0.0.2.
Installing Rational Performance Tester, Version 7.0.0.2 for the first time on a Windows Vista computer
The steps for Installing Rational Performance Tester, Version 7.0.0.2 on a Windows Vista computer are essentially the same as installing on other Windows computers. However, there are some important differences that are summarized below.
For additional details and installation scenarios, see the Installation Guide.
Installation notes for Windows Vista:
- You must run Installation Manager as administrator. (Right-click the program shortcut and click Run as administrator.)
- If you are starting the installation of Rational Performance Tester from the launchpad program, then you must run the launchpad program as administrator.
- Note:
- If the launchpad program starts automatically (for example, if you are installing from a CD), stop the launchpad program and then restart it using the Run as administrator command; navigate to the CD or disk image, right-click on launchpad.exe (at the top level of the CD or image) and click Run as Administrator.
Sample installation steps for Rational Performance Tester, Version 7.0.0.2 on Windows Vista
- Start the launchpad program as administrator. (Right-click the launchpad program and click Run as administrator.)
- If you have not done so already, read the release information by clicking Release notes.
- When you are ready to begin the installation, click Install IBM Rational Performance Tester.
- A message window opens to inform you whether the program IBM Installation Manager is detected on your workstation.
- If IBM Installation Manager is not detected on your system, then you are informed that you must install it before you can continue.
- Click OK to install IBM Installation Manager. The IBM Installation Manager installation wizard starts. Follow the on-screen instructions in the wizard to complete the installation of IBM Installation Manager.
- When the installation of IBM Installation Manager completes successfully, click Finish to close the wizard.
- Read the message that opens and click OK. Installation Manager starts and automatically opens the Install Packages wizard.
- If IBM Installation Manager is detected on your system, click OK and Installation Manager starts and automatically opens the Install Packages wizard.
- On the Install page, click Check for updates.
- If a new version of Installation Manager is found, you are prompted to confirm that you want to install it before you can continue. Click OK to proceed. Installation Manager automatically installs the new version, stops, restarts, and resumes.
- Click "Check for new updates and extensions" to find the newer version of the product.
- Select the latest version of the product (7.0.0.2).
- Follow the on-screen instructions in the Install Packages wizard to complete the installation.
Installing on Linux
The path name where you install Rational Performance Tester must not contain spaces.
This fix pack resolves these problems:
- (APAR PK39459) Playback works correctly on non-English versions of Windows XP running on the workbench.
- (APAR PK34709) Playback works correctly using a proxy server that requires Basic authentication to connect to a Web site that requires NTLM authentication.
- (APAR PK33495) You can now record and play back large (5-10 MB) file uploads.
- (APAR PK36895) Rational Performance Tester now handles terminating CR/LF characters correctly when calculating Content-Length.
- (APAR PK33808) Rational Performance Tester now includes translated online help topics.
- (APAR PK35990) The online help now documents the -Xmx parameter correctly.
You can now record a Citrix session from the Citrix Web Interface to use the load balancing feature provided by this connection method. You do this by recording an HTTP performance test that contains session information recorded with the Web interface, and then by recording a Citrix performace test that uses this information. When you have finished recording the session, the wizard generates a Citrix performance test.
An HTTP performance test provides the session information to connect to a Citrix farm for a user and an application. The same HTTP performance test can be re-used to record different Citrix performance tests.
Citrix performance tests recorded with this method can only be run within a schedule. After recording, you must set up a schedule that runs the HTTP test and then the Citrix test.
To record a Citrix test from the Citrix Web Interface:
- First, record an HTTP performance test. Click File > New > Test from Recording, and then select HTTP Recording and click Next.
- On the Select Location for Test Suite page, select a project. In Test file name, type a name for the HTTP performance test, and then click Finish.
- In the Web browser, type the URL of the Citrix Web Interface server.
- On the Citrix Web Interface page, enter your user name, password, and domain to open a session. The Citrix Web Interface displays the list of applications published on a server and available to the user.
- Click on the application that you want to test.
- Close the application and the Web browser. This stops the recording and generates a new HTTP performance test that ends with a custom code test element named StoreICA.
- Now, record the Citrix performance test. Click File > New > Test from Recording, and then select Citrix Recording and click Next.
- On the Select Location for Test Suite page, select a project. In Test file name, type a name for the Citrix performance test, and then click Next.
- On the Citrix Connection Settings page, select Through a Web interface and in Connection scenario, click Browse and select the HTTP performance test that contains the Citrix Web Interface session.
- Click Finish to start the recording immediately or click Next to specify other recording options, and then click Finish.
- In the Citrix Presentation Server client, perform the tasks that you want to test.
- When you have completed the sequence of actions to be tested, close the session cleanly and stop the recorder by closing the Citrix Presentation Server client. A progress window opens while the test is generated. On completion, the Recorder Control view displays the message Test generation completed, the Test Navigator lists your test, and the test opens in the test editor.
To run a Citrix Web Interface test, you must create a new schedule, add the HTTP performance test, and then add the Citrix test performance test.
If you are using Firefox to record an HTTP test, ensure that there are no Firefox browser processes, even minimized ones, running when you start to record. The HTTP Recorder will automatically open one instance of the Firefox browser to allow you to begin recording the test.
If you attempt to record a test with an instance of Firefox already running, you will immediately receive a message that there is no data to record, and your test will be "empty."
The supported versions of IBM Tivoli Monitoring Agents are:
Agent Version Linux 6.1.0 OS/390 3.1.0 SNMP MIB2 6.0.0 WebSphere Application Server MQ 3.6.0 Windows 6.1.0 Oracle 6.1.0 Citrix 1.0.0 DB2 6.1.0 UNIX 2.0.0 WebSphere Application Server 1.3.0 IBM Tivoli Monitoring for WebSphere 6.0.0
On Linux, the Application Server Instrumenter requires write access to several directories owned by the root user. If you attempt to run the Application Server Instrumenter from a user account that does not have access to these directories, the program will not start. To work around this, on Linux run the Application Server Instrumenter as root.
Instrumenting a WebSphere Application Server will fail if Rational Performance Tester and WebSphere Application Server are installed on different hard drives or partitions. Even though instrumentation fails, the Application Server Instrumenter will report success.
For example, if Rational Performance Tester is installed on C: and WebSphere Application Server is installed on D:, the instrumentation scripts will not instrument the WebSphere Application Server, but they will report that the server was instrumented successfully. This means that the response time breakdown feature will be unavailable.
There is no workaround currently, other than uninstalling Rational Performance Tester and reinstalling it on the same drive as WebSphere Application Server.
If you attempt to record a performance test on Linux as a non-root user, the error message "Unable to find control agent" displays. The workaround is to log in as root to record performance tests on Linux.
Rational Performance Tester requires administrative privileges to run. This is true whether you install the product into a virtualized directory (such as "Program Files") or into a directory that is not virtualized. To run the application as administrator, right-click the application and choose "Run as administrator."
In addition, Rational Agent Controller needs to run either as a service or from a command prompt that was launched with Administrator authority (right-click and choose "Run as administrator"). To record Citrix tests, you must run the Rational Agent Controller from a command prompt launched as administrator. The Rational Agent Controller service is not allowed to create UI on the desktop, which is a requirement for Citrix testing.
Unsupported Features
The response time breakdown feature is not supported on Vista.
SAP is not supported on Vista.
Siebel data correlation is not supported on Vista.
To enable the resource monitoring feature on Vista, you must start the Remote Registry service, disable the remote User Account Control, and configure the firewall.
Start the Remote Registry service
The Remote Registry service is disabled by default on Vista. This service must be running in order for to collect resource monitoring data. To enable the Remote Registry service:
- Open the Administrative Tools control panel
- Open Services
- Click Start on the Remote Registry service entry
- Optionally, to launch the Remote Registry service automatically every time Vista starts, do the following: right-click the Remote Registry service and select Properties. Set the Startup type to Automatic.
Disable the remote UAC
When users remotely authenticate, the UAC (User Account Control) will grant only the user standard privileges, even if the supplied credentials are in the Administrators group. To work around this, modify the LocalAccountTokenFilterPolicy registry key:
- Open the Registry Editor (Start > Run, then type "regedit")
- Navigate to HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Policies\System
- Right-click the LocalAccountTokenFilterPolicy key and select Modify. Change the value to 1.
If the LocalAccountTokenFilterPolicy key does not exist, right-click the right window and select "New > DWord". Enter the name "LocalAccountTokenFilterPolicy" and set its value to 1.
NOTE: To reset these remote authentication settings to their original state, set this key to 0.- Restart the computer
Configure the firewall
The Vista firewall will block remote administrative requests by default. To enable this support, complete the following steps:
- Open the Windows Firewall control panel
- Click Change settings
- Click the Exceptions tab
- Select the Remote Administration option
- Restart the computer
The Samples Gallery and Tutorials Gallery do not support the new high resolution display setting "Larger scale(120DPI)- make text more readable" on Windows Vista operating system. The gallery content does not display if this option is set.
This setting enables through the following steps:
- Open the Control Panel.
- Click Ease of Access Center > Make Computer easier to see > Change the size of text and icon.
- Select Larger scale(120DPI)- make text more readable.
- Click Save settings.
If you changed to the new high resolution display option, change to a lower resolution setting (for example, the default 90 DPI setting).
On the Japanese version of the Windows Vista operating system, the Samples Gallery and Tutorials Gallery require Mozilla Firefox as the Web browser preference; the gallery content does not display on other Web browsers. To work around this problem, install Mozilla Firefox, and then set the Web Browser preference (click Window > Preferences > General > Web Browser) to Mozilla Firefox.
IBM Rational Software Support provides you with technical assistance.
For contact information and guidelines or reference materials that you will need when you require support, read the IBM Software Support Handbook.
For product information about Rational Performance Tester, visit the product home page at www.ibm.com/software/awdtools/tester/performance/.
For FAQs, lists of known problems and fixes, and other support information, visit the product support page at www.ibm.com/software/awdtools/tester/performance/support/index.html.
For personalized support, including notifications of significant upgrades, register at http://www.ibm.com/support/mysupport/.
For Rational software product news, events, and other information, visit the IBM Rational Software Web site.
Before you contact IBM Rational Software Support, gather the background information that you will need to describe your problem. When describing a problem to an IBM software support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:
- What software versions were you running when the problem occurred?
- Do you have logs, traces, or messages that are related to the problem?
- Can you reproduce the problem? If so, what steps do you take to reproduce it?
- Is there a workaround for the problem? If so, be prepared to describe the workaround?
© Copyright IBM Corporation 2000, 2007.
The XDoclet Documentation included in this IBM product is used with permission and is covered under the following copyright attribution statement: Copyright © 2000-2004, XDoclet Team. All rights reserved.
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.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, Massachusetts 02421-3112
U.S.A.
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.
Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:
© (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. © Copyright IBM Corp. 2000, 2007.Trademarks and service marks
The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:
AIX
CICS
ClearCase
developerWorks
IBM
IMS
OS/400
Rational
Tivoli
Tivoli Enterprise
WebSphere
z/OS
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.
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.