IBM Rational Performance Tester, Version 8.3 and
IBM Rational Performance Tester Agent, Version 8.3
Installation Guide
Note
Before using this information and the product it supports, read
the information in Notices.
First edition, November 2012
This edition applies to IBM Rational Performance
Tester Version 8.3, IBM Rational Performance
Tester Agent Version 8.3, and to all subsequent releases and modifications
until otherwise indicated in new editions.
Copyright International Business Machines Corporation 2000, 2012. US Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Installing Rational Performance Tester and Rational Performance Tester Agent
Installing and updating the product involves verifying
requirements, planning, managing licenses, and configuring web-based
help. IBM® Rational® Performance Tester and IBM Rational Performance Tester Agent.
Note:
Before installing, consult the IBM Rational Performance Tester Release Notes for late-breaking installation issues.
Product Overview
This installation guide covers two independent products: Rational Performance Tester and
the Rational Performance Tester Agent.
The Rational Performance Tester Agent
is a tool that you use with Rational Performance Tester.
It is included as part of the Rational Performance Tester product
kit.
Rational Performance Tester Agent
consists of two features:
Load Generation Agent - This feature is used to generate load
for the application under test by using the virtual users. You can
increase load generation capacity by installing additional agents
on remote computers.
Rational Agent Controller - This feature is used to gather data
for the Response Time Breakdown feature and in support of the startup
and control of web services stubs in the SOA protocol.
Note:
The Rational Performance Tester workbench
and Agent products are separate offerings and must be installed separately.
If you have the Rational Performance Tester workbench
version 8.2.x.x currently installed, use the Update function
of IBM Installation Manager (using
the Rational Performance Tester 8.3
repository) to upgrade to the Rational Performance Tester workbench
version 8.3. See Important
rollback information later in this topic.
If you have Rational Performance Tester Agent
version 8.2.x.x installed, use the Update function
of Installation
Manager (using
the Rational Performance Tester Agent
8.3 repository) to install Rational Performance Tester Agent
version 8.3.
Important rollback information:
To update from a version of one of the following Rational Performance Tester releases
and maintain the ability to roll back to the earlier release, you
must complete the instructions that follow:
8.2
8.2.0.1
8.2.0.2
8.2.0.4
8.2.0.4
8.2.0.5
You must update your product to Rational Performance Tester version
8.2.0.6 before you update to 8.2.1. For technical reasons, you cannot
roll back version 8.2.1 directly to a version other than 8.2.0.6.
If you have updated to 8.2.0.6, and then update to 8.2.1, you can
then roll back to version 8.2.0.6 and to any of the listed versions
that are prior to 8.2.0.6.
Understanding these terms and conventions can help you
take full advantage of the installation information and your product.
The following conventions are used in this
installation information:
The default installation directory is written as C:\installation_directory\product\inst.file.
The default log location for installation information is C:\log_file_dir\log.txt.
These
terms are used in the installation topics.
Installation directory
The location of product artifacts after the package is installed.
Package
An installable unit of a software product. Software product packages
are separately installable units that can operate independently from
other packages of that software product.
Package group
A package group is a directory in which different product packages
share resources with other packages in the same group. When you install
a package using Installation Manager, you can create a new package
group or install the packages into an existing package group. Eclipse-based
packages installed in the same package group are able to use the shell-sharing
features of Eclipse. Some packages cannot share a package group, in
which case the option to use an existing package group is unavailable.
Repository
A storage area for installable software packages. A repository
can be disc media, a folder on a local hard disk, or a server or web
location.
Shared directory
In some instances, product packages can share resources. These
resources are located in a directory that the packages share.
Planning the installation
Read all the topics in this section before you begin to install
or update any of the features of your product. Effective planning and an understanding
of the key aspects of the installation process can help ensure a successful
installation.
Installation Manager overview
IBM Installation
Manager is a program for installing, updating, and modifying packages.
It helps you to manage the IBM applications, or packages, that it installs on your computer. Installation
Manager also helps you to keep track of what you have installed, determine
what is available for you to install, and to organize installation
directories.
Installation Manager provides features that help you keep packages
up to date, modify packages, manage the licenses for your packages,
and uninstall packages.
Installation Manager includes six wizards that make it easy to
maintain packages:
The Install wizard walks you through the
installation process. You can install a package by simply accepting
the defaults or you can modify the default settings to create a custom
installation. Before you install, you get a complete summary of your
selections throughout the wizard. Using the wizard you can install
one or more packages at one time.
The Update wizard searches for available
updates to packages that you have installed. An update might be a
released fix, a new feature, or a new version of the product. Details
of the contents of the update are provided in the wizard. You can
choose whether to apply an update. The Update wizard searches connected repositories for updates. If you are not
connected to the Internet, you may not see newly available updates
for your installed products. To apply an update to a computer that
is not connected to the Internet, you must download the update and
extract it to a local repository.
The Modify wizard helps you modify certain
elements of a package that you have already installed. During the
first installation of the package, you select the features that you
want to install. Later, if you require other features, you can use
the modify packages wizard to add them to your package. You can also
remove features and add or remove languages.
The Manage Licenses wizard helps you set
up the licenses for your packages. Use this wizard to change your
trial license to a full license, to set up your servers for floating
licenses, and to select which type of license to use for each package. Rational Performance Tester requires runtime floating license keys to run tests with
multiple virtual users and to use product extensions such as protocols.
Runtime floating license keys are not managed using IBM Installation Manager. Use the License Key Administrator program, installed
with the Rational License
Server, to manage runtime floating license keys.
The Roll Back wizard helps you to revert
to a previous version of a package.
The Uninstall wizard removes a package from
your computer. You can uninstall more than one package at a time.
Installation requirements
Installation requires the correct hardware, software, server
environment, operating systems, and user privileges for installing
and running your software.
Before you can install the product, you must verify that
your system meets the following minimum hardware requirements. These
requirements apply to IBM Rational Performance Tester and the Rational Performance Tester Agent.
Hardware
Requirements
Processor
Minimum: 1.5 GHz Intel Pentium 4 (or higher for
best results). For best results with large test runs, use a 2 GHz
or higher Intel Pentium dual-core processor.
Memory
Minimum for the Rational Performance Tester workbench: 1 GB of RAM; minimum for just the Agent: 500
MB of RAM. For best results with large test runs, use 2 GB of RAM.
Disk space
Minimum: 1.5 GB of disk space for the product package
installation. Additional disk space is required for the resources
that you develop.
Note:
Disk space requirements can be reduced or increased depending
on the features that you install.
Additional disk space is required if you download the product
package to install this product.
Additional disk space is required if you use
FAT32 instead of NTFS.
An additional 500 MB of disk space is required
in the directory that you specify in the TEMP environment
variable.
An additional 500 MB of disk space is required
in the /tmp directory.
Large test runs can store several gigabytes of data. Make sure
that you have adequate disk space before attempting a large test run.
Display
Minimum: 1024 x 768 resolution using 256 Colors or higher
for best results.
For just the Agent: 800 x 600 display minimum
using 256 Colors or higher for best results.
Other hardware
Microsoft mouse
or compatible pointing device.
Software requirements
Before you install the product, verify that your system
meets the software requirements.
Operating system
The following operating
systems are supported for this product.
Operating system
Rational Performance Tester workbench
Rational Performance Tester Agent
AIX® 6.1
and 7.1
No
Yes
Red Hat Enterprise Linux (RHEL) Desktop Editions (on Intel platforms):
Yes
Yes
Version 4, updates 1 through
9
Yes
Yes
Version 5, updates 1 through
7
Yes
Yes
Version 6, update 1
Yes
Yes
Red Hat Enterprise Linux (RHEL) Advanced Platform Version 5 updates
1 through 7 (on Intel platforms)
Yes
Yes
Red Hat Enterprise Linux (RHEL) AS/ES updates 1 through 9 (on Intel platforms)
Yes
Yes
SuSE Linux Enterprise
Desktop (SLED) Version 9.0 SP3, Version 10.0 to SP4, Version 11.0
to SP1 (on Intel platforms)
Yes
Yes
SuSE Linux Enterprise
Server (SLES) Version 9.0 to SP4, Version 10 to SP4, Version 11 to
SP1 (on Intel platforms)
Yes
Yes
Microsoft Windows Server 2003 Enterprise/Standard
Edition with Service Pack 1, 2, or 3
Yes
Yes
Microsoft Windows Server 2008 R2 Enterprise
Edition with Service Pack 1
Yes
Yes
Microsoft Windows Server 2008 SP1 and SP2
Yes
Yes
Microsoft Windows XP with Service Pack
1, 2 or 3
Yes
Yes
Microsoft Windows Vista with Service Pack
1 and 2
Yes
Yes
Microsoft Windows 7 with Service Pack 1
Yes (see note)
Yes
IBM WebSphere® Application Server 64
bits
Yes
Yes
z/OS® 1.4,
1.5, 1.6, 1.7, 1.8, 1.9 System Z
No
Yes (see note)
Note:
Data collection and response time breakdown functions are not
supported by the Rational Performance Tester Agent
on z/OS.
The listed operating systems support all the languages that are
supported by Rational Performance Tester.
The SAP and Citrix extensions are supported only on Microsoft Windows operating
systems.
The 64-bit versions of Red Hat Desktop, Red Hat Enterprise Linux, Microsoft Windows Server
2003, Microsoft Windows Server 2008, and Microsoft Windows XP are supported, but run only in
32-bit mode.
Java™ requirements
for Rational Performance Tester Agent
on z/OS
Rational Performance Tester supports
Citrix Presentation Server Version 4 or 4.5, running on Windows Server 2003 Standard Edition or Windows Server 2003 Professional
Edition and XenApp5 with Citrix Client versions 9.0 to 11.0 running
on Windows Server 2008. Although
the client for Citrix Presentation Server is available on Linux, Rational Performance Tester does
not support the Citrix extension on Linux.
Rational Performance Tester also
supports Windows Terminal
Server 2003 and later.
To reduce the likelihood of connection
problems caused by firewalls between the workbench computer and the
agent computers, locate the workbench computer and the agent computers
on the same local network, and then use Remote Desktop to access the
workbench computer. Do not use virtualized agent computers. Agent
computers require full, real-time access to the hardware platform
for accurate load generation and measurement.
Additional software requirements
The GNU Image Manipulation Program Toolkit (GTK+),
Version 2.2.1 or later, and associated libraries (GLib, Pango).
One of the following web browsers to record tests and to support
the Standard Widget Toolkit (SWT) browser widget:
Microsoft Internet
Explorer 8.0 or 9.0
Apple Safari 5.1.2
and
Firefox 3.5 or
later
Note:
On Red Hat Enterprise Linux Workstation
Version 4.0, set the MOZILLA_FIVE_HOME environment
variable to the folder that contains your Firefox or Mozilla installation.
For example, enter this command: setenv MOZILLA_FIVE_HOME
/usr/lib/firefox-1.5.
To support the SWT browser widget, your Firefox browser must have
been compiled with linkable Gecko libraries. Firefox downloads from
mozilla.org currently do not satisfy this criteria, but Firefox installations
that are included in major Linux distributions
often do.
and
Google Chrome 18.0
and
Opera 11.0
To view reports on a web browser:
Microsoft Internet Explorer version 8 or later
Mozilla Firefox version 3.6 or later
Note:
If both Internet Explorer and Firefox is installed on a machine,
Firefox is used.
For better performance of reports on a Windows XP or Windows 7
32-bit machine, use the latest Firefox browser. If you are using a
Windows 7 64-bit machine, use Internet Explorer 9.
To view multimedia user assistance, such as tours, tutorials,
and demonstration viewlets, you must install Adobe Flash Player.
Adobe Flash
Player Version 6.0 release 65 or later
Adobe Flash
Player Version 6.0 release 69 or later
User privileges requirements
You must have a user ID that meets the following requirements
to install Rational Performance Tester, Rational Service Tester, Rational Performance Tester Agent.
Your user ID must not contain double-byte characters.
You must have a user ID that belongs to the
Administrators group.
You must be able to log in as root.
Installation considerations
Part of planning entails making decisions about installation locations,
working with other applications, extending Eclipse, upgrading, migrating,
and configuring help content.
Installation locations
IBM Installation
Manager retrieves product packages from specified repositories and
installs the products into selected locations, which are referred
to as package groups.
Package groups
During installation, you specify a
package group into
which to install a product.
A package group represents a directory in which products share
resources.
When you install a product by using Installation Manager, you
either create a package group or install the product into an existing
package group. A new package group is assigned a name automatically;
however, you choose the installation directory for the package group.
After you create a package group you cannot change the installation
directory. The installation directory contains files and resources
that are shared by the products that are installed into that package
group.
Product resources that are designed to be shared with other packages
are installed in the shared resources directory. Not all products
can share a package group, in which case the option to use an existing
package group is disabled.
When you install multiple products at the same time, all products
are installed into the same package group.
Important:
When installing products
on the Windows Vista operating
system, do not create package groups in the Program Files directory (C:\Program Files\). Otherwise, users
without Administrator privileges will be unable to use the product.
Shared resources directory
The
shared
resources directory is where product resources are installed
so that they can be used by multiple product package groups. You define
the shared resources directory the first time that you install the
first product package. For best results, use your largest disk drive
for shared resources directories. You cannot change the directory
location unless you uninstall all product packages.
Important:
When installing products on the Windows Vista operating system, do not create the shared resources
directory in the Program Files directory (C:\Program Files\). Otherwise, users without Administrator
privileges will be unable to use the product.
Coexistence
Some products are designed to coexist and share functions
when they are installed in the same package group. A package group
is a location where you can install one or more software product packages.
Offering coexistence considerations
When you install each product package, you select whether to install
the product package into an existing package group or to create a
package group. IBM Installation
Manager prevents you from installing products into package groups
products that are not designed to share or do not meet version compatibility
and other requirements. To install more than one product at a time,
the products must be able to share a package group.
Any number of eligible products can be installed to a package group.
When a product is installed, the product functions are shared with
all the other products in the package group. If you install a development
product and a testing product into one package group, when you start
either of the products, you have both the development and testing
functions available to you in your user interface. If you add a product
with modeling tools, all the products in the package group have the
development, testing, and modeling functions available.
Installing with your Eclipse instance
The product package that you install using IBM Installation Manager comes with a version
of Eclipse, which is the base platform of this product package. If
you already have Eclipse installed on your workstation, you can add
your product package directly to that Eclipse installation and extend
the functions of the Eclipse integrated development environment (IDE).
Extending an
Eclipse IDE adds the functions of the newly installed product, but
maintains your IDE preferences and settings. Previously installed
plug-ins are also still available.
In most cases, your current Eclipse IDE must be the same version
as the Eclipse that the product you are installing uses. Installation
Manager checks that the Eclipse instance that you specify meets the
requirements for the installation package and helps you install the
latest updates from eclipse.org, if required.
Increasing the number of file handles on Linux workstations
For best product performance, increase the number of file
handles above the default setting of 1024 handles.
About this task
Important:
Before you work with
your Rational product,
increase the number of file handles. Most Rational products use more than the default
limit of 1024 file handles per process. A system administrator might
need to make this change.
Exercise caution when using
the following steps to increase your file descriptors on Linux. If the instructions are not followed
correctly, the computer might not start correctly.
Procedure
To increase your file descriptors:
Log in as root. If you do not have root access, you must
obtain it before continuing.
Change to the etc directory.
Attention: If you decide to increase the number of file handles
in the next step, do not leave an empty initscript file
on your computer. If you do so, your computer will not start up the
next time that you turn it on or restart.
Use the vi editor to edit the initscript file
in the etc directory. If this file does not
exist, type vi initscript to create it.
On the first line, type ulimit -n 30000.
The point is that 30000 is significantly larger than 1024, the default
value on most Linux computers.
Important:
Do not set the number of handles too
high, because doing so can negatively impact system-wide performance.
On the second line, type eval exec "$4".
Save and close the file after making sure that you have
completed steps 4 and 5.
Note:
Ensure that you follow
the steps correctly. If this procedure is not completed correctly,
your computer will not start.
Optional: Restrict the number of handles available
to users or groups by modifying the limits.conf file
in the etc/security directory. Both SUSE Linux Enterprise Server (SLES)
Version 9 and Red Hat Enterprise Linux Version
4.0 have this file by default. If you do not have this file, consider
using a smaller number in step 4 in the previous procedure (for example,
2048). Do this so that most users have a reasonably low limit on
the number of open files that are allowed per process. If you use
a relatively low number in step 4, it is less important to do this.
However, if you set a high number in step 4 earlier and you do not
establish limits in the limits.conf file, computer
performance can be significantly reduced.
The following
sample limits.conf file restricts all users,
and then sets different limits for others afterwards. This sample
assumes that you set handles to 8192 in step 4 earlier.
* soft nofile 1024
* hard nofile 2048
root soft nofile 4096
root hard nofile 8192
user1 soft nofile 2048
user1 hard nofile 2048
Note that the * in
the preceding example sets the limits for all users first. These limits
are lower than the limits that follow. The root user has a higher
number of allowable handles open, while the number that is available
to user1 is between the two. Make sure that you read and understand
the documentation that the limits.conf file contains
before making changes.
What to do next
For more information on the ulimit command,
see the main page for ulimit in the Linux documentation.
Installing Rational Performance Tester or Rational Performance Tester Agent on Windows or Linux
The Setup disk includes the launchpad program, which provides
you with a single location to start the installation process.
About this task
Use the launchpad program to start the installation of software
in these cases:
Installing from product CDs
Installing from an electronic image on your local file system
Installing from an electronic image on a shared drive
For products that are installed by IBM Installation Manager for
the Rational Software Delivery
Platform, starting the installation process from the launchpad
program causes Installation
Manager to be automatically installed if it is not already on
your computer. Furthermore, the installation process is already configured
with the location of the repository that contains the installation
package. If you install Installation
Manager separately, you must configure the repository preferences
manually. Also, you can start the installation of a number of supporting
software items from the launchpad.
To install Rational Performance Tester as a non-administrator, you cannot use the launchpad program
to start the installation process. Instead, you must manually run
the userinst program from the Setup disk. Running the userinst program
provides the same functions as starting the installation of Rational Performance Tester from the launchpad.
Starting the launchpad
To install the product, start the launchpad program.
Procedure
Depending on the source of the product installation, follow
one of these procedures to start the launchpad program;
If you are installing from the CDs, complete these steps:
Insert the Setup CD into your CD drive.
Mount the CD drive.
If autorun is enabled on your computer, the launchpad program
starts automatically. If the launchpad does not start automatically,
complete one of these steps:
Run the launchpad.exe command,
which is located in the root directory of the CD.
Run the launchpad.sh, which
is located in the root directory of the CD.
If you are installing from electronic disks that you downloaded
from IBM Passport Advantage®, open a command
line, and change to the directory where you extracted the disk images;
and then at the command prompt, complete one of these steps:
Enter RPT_SETUP\launchpad.exe.
Enter RPT_SETUP/launchpad.sh.
Results
The launchpad program starts.
Install the product software
Use these instructions to install Rational Performance Tester.
About this task
By starting the installation process from the launchpad program, IBM Installation Manager is
automatically installed if it is not already on your computer, and
it starts preconfigured with the location of the repository that contains
the product package. If you install and start Installation
Manager directly,
then you must set repository preferences manually.
If you are installing from compressed files, such as
.zip or ISO files, extract the files into a common directory. Navigate
to Common_Directory/RPT/disk1/Platform_Directory and
double click install.exe.
If you are installing from a CD, insert the first product
disc into your CD drive. If autorun is enabled on your workstation,
then the launchpad starts automatically. Otherwise, start the launchpad
program manually.
Run the launchpad.exe command,
which is located in the root directory of the Setup disk installation
image.
Run the launchpad.sh command,
which is located in the root directory of the Setup disk installation
image.
Optional: Select a language in which to run
the launchpad and Installation
Manager.
Select the product to install from the launchpad menu. The Install Packages window opens.
Click a product package to highlight it. The
description of the package is displayed in the Details pane
at the bottom of the screen.
To search for updates to the product packages, click Check
for Other Versions, Fixes, and Extensions. If updates
for a product package are found, then they are displayed in the Installation
Packages list on the Install Packages page
below their corresponding products. Only recommended updates are displayed
by default.
To view all updates that are found for the available packages,
click Show all versions.
To display a package description in the Details pane,
click the package name. If additional information about the package
is available, such as a readme file or release
notes, a More info link is included at the
end of the description text. Click the link to display the additional
information in a browser. To fully understand the package that you
are installing, review all information.
Note:
For Installation
Manager to
search the predefined IBM update
repository locations for the installed packages, the Search
the linked repositories during installation and updates preference
on the Repositories preference page must be selected.
This preference is selected by default. Internet access is also required.
A progress indicator shows that the search is taking place. You can
install updates at the same time that you install the base product
package.
Select the product package and any updates to the package
to install. Updates that have dependencies are automatically selected
and cleared together. Click Next to continue.
Note:
If you install multiple packages at the same time, then
all the packages are installed into the same package group.
On the Prerequisite page, if a supported
version of IBM Rational License Key Administrator is not
installed, a warning message is displayed. A supported version of Rational License Key Administrator
comes with the product. To administer a license server, you must install
a supported version of Rational License
Key Administrator. If you use the launchpad program to install the
product, Rational License
Key Administrator is listed on the Install Packages page.
If you start Installation
Manager,
you must add the repository for Rational License
Key Administrator to install it at the same time as the product. Click Next to
continue.
On the Licenses page, read the license
agreement for the selected package. If you selected more than one
package to install, there might be a license agreement for each package.
On the left side of the License page, click each
package version to display its license agreement. The package versions
that you selected to install (for example, the base package and an
update) are listed under the package name.
If you agree to the terms of all of the license agreements,
click I accept the terms of the license agreements.
Click Next to continue.
On the Location page, type the path
for the shared resources directory in the Shared
Resources Directory field, or accept the default path.
The shared resources directory contains resources that can be shared
by one or more package groups. Click Next to
continue.
The default path to use follows:
C:\Program Files\IBM\IBMIMShared
/opt/IBM/IBMIMShared
Important:
You can specify the shared resources
directory only the first time that you install a package. Use your
largest disk for this to help ensure adequate space for the shared
resources of future packages. You cannot change the directory location
unless you uninstall all packages.
On the Location page, create a package
group to install the product package into or if this is an update,
use the existing package group. A package group represents a directory
in which packages share resources with other packages in the same
group. To create a package group:
Click Create a new package group.
Type the path for the installation directory for the
package group. The name for the package group is created
automatically.
The default path follows:
C:\Program Files\IBM\SDP
/opt/IBM/SDP
Click Next to continue.
Optional: On the next Location page,
you can choose to extend an existing Eclipse IDE that is installed
on your computer, which adds the functions in the packages that you
are installing. You must have Eclipse Version 3.6 with the latest
updates from eclipse.org to select this option. Click Next to
continue.
Note:
Rational Performance Tester does
not support extending an existing Eclipse IDE.
On the Features page under Translations,
select the languages for the package group. The corresponding translations
for the user interface and documentation for the product package will
be installed.
On the next Features page, select
the package features to install.
Optional: To see the dependency relationships
between features, select Show Dependencies.
Optional: Click a feature to view its brief
description under Details .
Select or clear features in the packages. Installation
Manager automatically
enforces any dependencies with other features and displays updated
download sizes and disk space requirements for the installation.
To use Processor Value Unit (PVU) licensing capability,
click IBM Rational Test Workbench Processor Value Unit
(PVU) support checkbox. Rational Performance Tester supports
the Processor Value Unit (PVU) licensing capability available with
the following newly introduced offerings:
All of these offerings include either Rational Performance Tester
or the Rational Performance Tester Agent. When you use any of these
new offerings, Rational Performance Tester utilizes PVU licensed agents
to generate virtual user load without the need for Virtual Tester
Pack licenses. This virtual user load is limited only by the capacity
of the PVU licensed agents.
When you are finished selecting features, click Next to
continue.
On the common licensing configuration page, type the TCP/IP
port number and host name of the license servers to use to configure
licensing on the workbench computer. Separate the port number and
host name with the at sign (@). Separate the port-host pairs with
semicolons (;). To use the default port, omit the port number. If
you do not know the port numbers and names of license servers to use,
you can configure the license servers after installation by using Rational License Key Administrator. For example, to configure three license servers that are
named license1, license2, and license3 to use port 27000, the default
port, and port 1765 respectively, enter this text: 27000@license1;@license2;1765@license3
On the help system configuration page, select one of these
options, and then click Next:
Access help from the Web
Download help and access content locally
Access help from a server on your intranet
On the Summary page, review your choices
before installing the product package. To change the choices that
you made on previous pages, click Back, and
make your changes. When you are satisfied with your installation choices,
click Install to install the package. A progress indicator shows the percentage of the installation
that is completed.
When the installation process is complete, a message confirms
the completion of the process.
Click View log file to open the
installation log file for the current session in a new window. You
must close the Installation Log window to continue.
In the Install Package wizard, select whether to start
the product when you exit.
Click Finish to start the selected
package. The Install Package wizard closes and you are returned to
the launchpad program.
License the product.
Installing Rational Performance Tester Agent
Use these instructions to install Rational Performance Tester Agent.
By starting the installation process from the launchpad program, IBM Installation Manager is
automatically installed if it is not already on your computer, and
it starts preconfigured with the location of the repository that contains
the product package. If you install and start IBM Installation Manager for
the Rational Software Delivery
Platform directly,
you must set repository preferences manually.
If you are installing from compressed files, such as
.zip or ISO files, extract the files into a common directory. Navigate
to Common_Directory/RPTAGENT_SETUP/disk1/Platform_Directory and
double-click install.exe.
If you are installing from a CD, insert the first product
CD into your CD drive. If autorun is enabled on your workstation,
the launchpad starts automatically. Otherwise, start the launchpad
program manually.
Run the launchpad.exe command,
which is located in the root directory of the Setup disk installation
image.
Run the launchpad.sh command,
which is located in the root directory of the Setup disk installation
image.
Optional: Select a language in which to run
the launchpad and IBM Installation Manager.
Click a product package to see its description in the Details pane
at the bottom of the screen.
To search for updates to the product packages, click Check
for Other Versions, Fixes, and Extensions. If updates
for a product package are found, they are displayed in the Installation
Packages list on the Install Packages page
below their corresponding product. Only recommended updates are displayed
by default.
To view all updates that are found for the available packages,
click Show all versions.
To display a package description under Details,
click the package name. If additional information about the package
is available, such as a readme file or release
notes, a More info link is included at the
end of the description text. Click the link to display the additional
information in a browser. To fully understand the package that you
are installing, review all the information.
Note:
For IBM Installation Manager to
search the predefined IBM update
repository locations for the installed packages, the Search
the linked repositories during installation and updates preference
on the Repositories preference page must be selected.
This preference is selected by default. Internet access is also required.
A progress indicator shows that the search is taking place. You can
install updates at the same time that you install the base product
package.
Select the product package and updates to the package to
install. Updates that have dependencies are automatically selected
and cleared together. Click Next to continue.
Note:
If you install multiple packages at the same time, all
the packages are installed into the same package group.
On the Licenses page, read the license
agreement for the selected package. If you selected more than one
package to install, there might be a license agreement for each package.
On the left side of the License page, click each
package version to display its license agreement. The package versions
that you selected to install (for example, the base package and an
update) are listed under the package name.
If you agree to the terms of all of the license agreements,
click I accept the terms of the license agreements.
Click Next to continue.
On the Location page, in the Shared
Resources Directory field, type the path for the shared
resources directory or accept the default path. The shared resources
directory contains resources that one or more package groups can share.
Click Next to continue.
These
default paths are provided:
C:\Program Files\IBM\IBMIMShared
/opt/IBM/IBMIMShared
Important:
You can specify the shared resources
directory only the first time that you install a package. Use your
largest disk for this directory to help ensure adequate space for
the shared resources of future packages. You cannot change the directory
location unless you uninstall all packages.
On the Location page, create a package
group to install the product package into or for an update, use
the existing package group. A package group represents a directory
in which packages share resources with other packages in the same
group. To create a package group, complete these steps:
Click Create a new package group.
Type the path for the installation directory for the
package group. The name for the package group is created
automatically.
These default paths are provided:
C:\Program Files\IBM\SDP
/opt/IBM/SDP
Click Next to continue.
If the Architecture Selection option
is available, you can select 32-bit or 64-bit.
Install the 64-bit version of the agent only if you plan to collect
data from 64-bit application servers when you use Rational Application Performance
Analyzer.
On the next Location page, you can
choose to extend an existing Eclipse IDE that is installed on your
computer, adding the functions in the packages that you are installing.
Click Next.
Note:
Rational Performance Tester Agent
does not support extending an existing Eclipse IDE, so you can ignore
this page.
On the Features page under Translations,
select the languages for the package group. The corresponding translations
for the user interface and documentation for the product package will
be installed.
On the next Features page, select
the package features to install.
By default, the Load Generation Agent check
box is selected. The Load Generation Agent is used to generate a load
on the system under test. The Rational Agent Controller gathers data
for the Response Time Breakdown feature and supports the startup and
control of web services stubs in the SOA protocol.
Note:
IBM Installation Manager automatically
enforces any dependencies with other features and displays updated
download sizes and disk space requirements for the installation.
Optional: To see the dependency relationships
between features, select Show Dependencies.
Optional: Click a feature to view its brief
description under Details.
After you are finished selecting features, click Next to
continue.
On the next Features page, configure
the agent:
For Load Generation Agent, type the workbench host name.
If you do not want to use 7080 as the port
number, change the port number. You can also change the port number
after you install Rational Performance Tester Agent.
For more information, see the Configuring ports for agents topic.
For Rational Agent Controller, select either a Typical
installation or a Custom installation. If you select Custom installation, you
can define an access list and enable security:
Access List: You
can limit access to the computer where the agent controller is installed
or to a list of specific computers.
Security: You can
enable encrypted communication and limit access to a specified set
of user IDs.
Click Next.
On the Summary page, review your choices
before installing the product package. To change the choices that
you made on previous pages, click Back, and
make your changes. When you are satisfied with your installation choices,
click Install to install the package. A progress indicator shows the percentage of the installation
that is complete.
When the installation process is complete, a message confirms
the completion of the process.
Click the View log file button
to open the installation log file for the current session in a new
window. You must close the Installation Log window
to continue.
Click Finish to start the selected
package. The Install Package wizard closes and you return to the launchpad
program.
To collect data on a system under test, you must complete
these steps to enable the test server for data collection:
To open the instrumentation application, click Start > IBM Data Collection Infrastructure > Application Server Instrumenter.
Click Instrument Local Server,
and select the type of application server that is running on the server.
Specify the server type fields, including the location
of the server if required, and click OK.
Stop and start the server for the instrumentation to
take effect.
Note:
All IBM Rational Performance Tester systems
that are involved with the data collection infrastructure must have
the data collection software running for the transaction breakdown
function to be available within the results of a Rational Performance Tester test
schedule.
Note:
The application server instrumenter or the instrumentServer.bat (or instrumentServer.sh)
batch file can fail with a generic error message (Error
during install/uninstall) when instrumenting or uninstrumenting
a server. If this error occurs, you can find more information to help
troubleshoot the error in the log files in the IBM Tivoli® common
directory. On Windows, the
default location of this directory is C:\Program Files\IBM\tivoli\common.
On Linux, the default location
of this directory is /var/ibm/tivoli/common.
If the IBM Tivoli common directory is not in the default
location, search for a path that contains tivoli/common,
or for any of these log files: trace-install.log, trace-ma.log,
or trace-tapmagent.log.
Note:
For IBM WebSphere Application Server 6.0
or later, if you create a new profile and then use the application
server instrumenter to instrument this profile without first starting WebSphere Application Server,
the application server instrumenter reports that the server is instrumented
and prompts you to restart the server manually. This message is incorrect;
the server is not actually instrumented. To work around this problem,
complete these steps:
Close and then restart the application server instrumenter.
Select the entry that you just added from the list of instrumented
servers, and click Remove.
Restart WebSphere Application Server.
Restart the application server instrumenter, and use it to instrument
the server.
To avoid this problem, after you create a new profile, start
the WebSphere Application Server profile
manually. Then, use the application server instrumenter to instrument
the server.
Installing Rational Performance Tester Agent
on AIX
See the IBM Technotes
for information on installing and uninstalling the Rational Performance Tester Agent
on AIX.
About this task
The IBM Technote
7036126 provides information about installing and uninstalling
the Rational Performance
Tester Agent 8.3 on AIX.
The IBM Technote
1415344 provides information about installing and uninstalling
the Rational Performance
Tester Agent on AIX.
Installing Rational Performance Tester Agent on z/OS (OS/390®)
You can install the Agent Controller for IBM Rational Performance Tester on the z/OS operating
system.
Uninstalling previous versions of Agent Controller
If you have a version of Agent Controller prior to 8.0, stop the
agent
and uninstall it before installing this version. You do not need to
remove Agent Controller Version 8.0 or later.
Configuring the operating system environment
Create the installation directory for Agent Controller. For example: mkdir /u/rpt/IBM/RAC.
Set ASSIZEMAX=2147483647. This might require support from the
system programmer.
Add the following export commands to the .profile of the user
ID that will be used to start Agent Controller:
export RASERVER_HOME={install location}
export LIBPATH=$LIBPATH:{install location}/lib:{path to java installation}/bin:
{path to java installation}/bin/classic
export PATH=$PATH:{install location}/bin:{path to java installation}/bin
export _BPX_SHAREAS="NO"
where install location is
the full path to location where Rational Performance Tester is installed.
Note:
After you set the environment variables, you can use the java -fullversion command to verify the Java version. Java version 1.6 or later is required.
Installing Agent Controller
The Rational Performance Tester agent includes Agent Controller and the data collection
infrastructure.
In a UNIX System Services
shell, go to the directory where you will install Agent Controller.
For best results, install Agent Controller in the /usr/lpp/ directory.
Transfer the installation images ibmrac.os390.pax and tptpdc.os390.pax to the installation
directory.
Issue this command to extract Agent Controller files:
pax -ppx -rvf ibmrac.os390.pax
Issue this command to extract the test and performance tools (TPTP)
Agent Controller files:
pax -ppx -rvf tptpdc.os390.pax
Make the Agent Controller shared object files program controlled
by issuing this command
in a UNIX System Services shell:
extattr +p /usr/lpp/IBM/AgentController/lib/*.so
Issue these commands to extract Agent Controller files:
After you have installed Agent Controller, change the directory
to the bin directory of the installation location, for example,/usr/lpp/IBM/AgentController/bin ; then run the setup
script by typing:
./SetConfig.sh
Follow the on-screen prompt to configure Agent Controller.
Starting and stopping Agent Controller on the z/OS (OS/390)
Start the server by logging in as root, opening the /usr/lpp/IBM/AgentController/bin directory, and issuing
the command:
./RAStart.sh
To stop the server, log in as root, open the /usr/lpp/IBM/AgentController/bin directory, and issue this command:
./RAStop.sh
Uninstalling the Agent Controller for Rational Performance Tester on the z/OS (OS/390)
If you ran the createLinks.sh command
when installing Agent Controller, then go to the /usr/lpp/IBM/AgentController/bin directory, and issue this command:
./removeLinks.sh
Remove the IBMRAC directory and all of its
subdirectories by issuing this command:
rm -rf /usr/lpp/IBM/AgentController
Managing licenses
Licensing for your installed IBM software and customized packages is administered through
the Manage Licenses wizard in the IBM Installation Manager. The Manage Licenses wizard displays
license information for each installed package.
Using the Manage Licenses wizard, you can apply a license to a
product or upgrade trial versions of an offering to a licensed version
by importing a product activation kit. You can also enable floating
license enforcement for offerings with trial or permanent licenses
to use floating license keys from a license server.
For more information about managing licenses for your Rational product, see these resources:
As a purchaser of an IBM Rational software product,
you can choose from three types of product licenses: an Authorized
User license, an Authorized User Fixed Term License (FTL), and a Floating
license. The best choice for your organization depends upon how many
people use the product, how often they require access, and how you
prefer to purchase software.
Authorized User license
An IBM Rational Authorized User license authorizes an individual to use a Rational software product.
Purchasers must obtain an Authorized User license for each individual
user who accesses the product in any manner. An Authorized User license
cannot be reassigned unless the purchaser replaces the original assignee
on a long-term or permanent basis.
For example, if you purchase
one Authorized User license, you can assign that license to one individual
who can use the Rational software product exclusively. The Authorized User license does not
authorize a second individual to use that product at any time, even
if the licensed individual is not using the product.
Authorized User Fixed Term License
An IBM Rational Authorized User Fixed Term License
(FTL) authorizes an individual to use a Rational software product for a specific
length of time (the term). Purchasers must obtain an Authorized User
FTL for each individual user who accesses the product in any manner.
An Authorized User FTL cannot be reassigned unless the purchaser replaces
the original assignee on a long-term or permanent basis.
Note:
When you purchase an Authorized User FTL under the IBM Passport Advantage Express® program, IBM automatically
extends the license term for an additional year at the prevailing
price unless you notify IBM before
the license expires that you do not want an extension. The subsequent
FTL term starts when the initial FTL term expires. The price for this
subsequent term is currently 80% of the initial FTL price, but is
subject to change.
If you notify IBM that you do not want to extend the license
term, then you must stop using the product when the license expires.
Floating license
An IBM Rational Floating license is a license for a single software product that
can be shared among multiple team members; however, the total number
of concurrent users cannot exceed the number of floating licenses
you purchase. For example, if you purchase one floating license for
a Rational software product,
then any user in your organization can use the product at any given
time. Another person who wants to access the product must wait until
the current user logs off.
To use floating licenses, you must
obtain floating license keys and install them on a Rational License Server. The server responds
to user requests for access to the license keys; the server grants
access to the number of concurrent users that equals the number of
licenses the organization purchased.
Enabling licenses
If you are installing the software for the first time or
want to extend a license to continue using the product, you have options
on how to enable licensing for your product.
Licenses for this product are enabled in two ways:
Importing a product activation kit
Enabling Rational Common
Licensing to obtain access to floating license keys
Activation kits
The Product Activation Kit
CD contains the permanent license key for you product. You use IBM Installation Manager to import
the activation kit to your product.
Floating license enforcement
Optionally,
you can obtain floating license keys, install IBM Rational License Server, and enable floating license enforcement for your
product. Floating license enforcement provides these benefits:
License compliance enforcement throughout the organization
Fewer license purchases
License keys served for IBM Rational Team Unifying
and Software Delivery Platform desktop products from the same license
server
Note:
Some 7.0 and later versions of Rational products require an upgraded version
of the Rational License
Server. See this support article for license upgrade information: http://www.ibm.com/support/docview.wss?uid=swg21250404
For more information about obtaining activation kits and
floating licenses, see Purchasing
licenses.
Enabling runtime licenses for testing
To run tests, you must have the correct license keys installed.
IBM Rational Performance Tester requires two types of licenses: product activation and
runtime licenses. Product activation licenses permit you to run the
product. Runtime licenses are unique to Rational Performance Tester. Runtime licenses consists of protocol keys and virtual
tester license key packs. Runtime licenses permit you to run performance
tests on specific protocols with multiple virtual users. You use different
tools to manage and configure product activation licenses and runtime
licenses. You manage product activation by using Installation Manager.
You manage runtime licenses by using IBM Rational License
Key Administrator.
With product activation licenses, you can start the product. There
are two forms of product activation licenses: a product activation
kit that is installed on the computer where the product is installed
or a floating product license that users check out from a Rational License Server. You
can download the product activation kit from IBM Passport Advantage for authorized user purchases. For floating
product licenses, your license server administrator must log in to
the Rational License Center
to download a floating license key and import it to your Rational License Server. Make sure to use
the version of Rational License Server that comes with the product. Earlier versions of Rational License Server might
not support all the required licensing functions. For more information
about the Rational License
Server, see Managing licenses with Rational Common Licensing.
The Rational License
Server supports floating license keys, so that administrators can
manage licensing throughout the enterprise. Administrators can install
the Rational License Server
from Passport Advantage or from the product media. To learn more about product activation,
including the Rational License
Server, see the product installation guide.
In addition to product activation, Rational Performance Tester also checks for runtime licensing when you run a performance
schedule. Runtime licensing consists of the correct protocol keys
and virtual tester license key packs. You must have a protocol key
to run performance tests with any protocol other than HTTP. You must
have a virtual tester license key pack to run tests with more than
five virtual users. You can check out these keys from the same Rational License Server that
you use for floating license product activation.
To check out protocol and virtual tester license keys in Windows, you must use the IBM Rational License Key Administrator program
to point to a Rational License
Server. Use the version of IBM Rational License Key
Administrator that was installed with Rational Performance Tester. Click Start > Programs > IBM Rational > License Key Administrator 8.2.1. Type the
name or IP address of your Rational License Server. Protocol and virtual tester license keys are available
from the Rational License
Key Center in the form of .upd files. If you
double-click a .upd file in Windows, the License Key Administrator program
starts automatically and imports the license keys. To learn more about IBM Rational License Key Administrator, click Help > Contents and Index.
There is no Linux version
of the IBM Rational License Key Administrator. To check
out protocol and virtual tester license keys in Linux, you must create and edit the .flexlmrc file. Create the file .flexlmrc in the home directory of every user who runs more than five virtual
testers, uses a protocol other than HTTP, or uses the floating license
product activation. Edit the .flexlmrc file,
adding a line with the computer name or the IP address of the Rational License Server. For
example, add the line RATIONAL_LICENSE_FILE=@license-server-name.com or RATIONAL_LICENSE_FILE=@license-server-ip-address.
Runtime license examples
To run tests, you must have the correct license keys installed.
The trial licensing key permits you to run Rational Performance Tester for 30 days from the initial installation. After 30 days
from the first time you install the product, the trial license expires.
The trial license permits you to run HTTP performance tests with up
to 5 virtual users. For other protocols except for SOA, the trial
license permits you to run tests with a single user. The trial license
for Rational Performance Tester does not permit you to run tests by using the SOA protocol.
The following table shows the number of virtual users you can use,
depending on the license keys that you have installed:
Protocol
Trial
Protocol key
500-user virtual tester key pack and protocol key
HTTP
5
n/a
505
Siebel
1
5
505
SAP
1
5
505
MySAP
1
5
505
Citrix
1
5
505
Socket
5
n/a
505
SOA
0
5
505
Purchasing licenses
You can purchase new licenses if your current product license
is about to expire or to acquire additional product licenses for team
members.
Procedure
Determine the type of license to purchase.
Go to ibm.com® or
contact your IBM sales representative
to purchase the product license. For details, visit the IBM web page on How
to buy software.
Depending on the type of license you purchase, use the
Proof of Entitlement that you receive and complete one of these steps
to enable your product:
If you purchase Authorized User licenses for your product,
go to Passport
Advantage, and follow the instructions there for downloading
your product activation kit. After you have downloaded the activation
kit, import the product activation .jar file
by using IBM Installation Manager.
Back
up the product activation .jar file. If you uninstall
the product and then install the product again, you might need to
use the product activation .jar file to license
the product again.
If you purchase floating licenses for your product, go to
the IBM Rational Licensing and Download
Center, and then click the link to connect to the IBM Rational License
Key Center. There you can use your Proof of Entitlement to obtain
floating license keys for your license server.
Optionally, you
can go to IBM Passport Advantage to download
the activation kit for your product. After importing the activation
kit, you can switch from a floating to a permanent license type if
you use your computer offline for long periods.
What to do next
To import the activation kit or enable floating license support
for your product, use the Manage Licenses wizard in IBM Installation Manager.
Viewing license information for installed packages
You can review license information for your installed packages,
including license types and expiration dates, from IBM Installation Manager.
Procedure
Start IBM Installation Manager.
On the main page, click Manage Licenses.
Results
The package vendor, current license types, and expiration
dates are displayed for each installed package.
Installing help content from an archive file
This topic explains how to install help content from the
archive file bundled with the product. Most help content is not installed
when you install your product. If you do not have an Internet connection,
to access help content locally you can install it from the bundled
archive file.
Before you begin
During installation, the help access option, Download
help and access the content locally, was selected. If
the help system window is open, close it before you start the following
procedure.
Extract the help archive file com.ibm.rpt.remote.help.updateSite.zip to
a temporary folder.
Note:
By default, on Windows, the help archive file is installed
in this directory: C:\Program Files\IBM\SDP\rpt\remotehelp\docs.
Start Rational Performance
Tester and select a workspace. A warning message
is displayed indicating that you need to install help content.
Click Launch Local Help Updater.
Alternately, from the main window of the product, click Help > Local Help Updater. The Local Help Updater is a browser application.
You might be prompted to adjust browser security settings to run the
Local Help Updater. The Updater site opens in a
separate browser window.
In the Available Content window, select
the Internal Sites filter.
Click the plus sign icon. The Add Internal Site window
opens.
Type any name in the Name field.
For example, type "Rational Performance
Tester Documentation."
Click Browse, then navigate to the
directory where you extracted RPT8.3_updateSite.zip.
Select the site.xml file, and then click OK. The name and location should now be displayed in the list
of internal sites.
Click the name of the internal site.
The Site List will be populated
with a list of the help that is available for download. Depending
on your network connection speed, this might take a few minutes. Select
the help content that you need.
Click Install. The
help content is downloaded and installed. A progress bar opens and
tracks the status of the download.
Click OK, and then close the browser
window.
Results
The help that you selected is installed on your system.
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 document
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 document. The furnishing of this document does not
grant 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:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 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 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 websites are provided
for convenience only and do not in any manner serve as an endorsement
of those websites. The materials at those websites are not part of
the materials for this IBM product
and use of those websites 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
5 Technology Park Drive
Westford, MA 01886
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 document 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.
If you are viewing this information softcopy, the photographs and
color illustrations may not appear.