IBM Rational Performance Tester, Version 8.0;
IBM Rational System Tester for SOA Quality, Version 8.0;
IBM Rational Agent Controller, Version 8.0
Installation Guide
First edition, October 2008
This edition applies to IBM Rational Performance Tester Version 8.0, IBM Rational System Tester for SOA Quality Version 8.0, and IBM Rational Agent Controller
Version 8.0 and to all subsequent releases and modifications until otherwise
indicated in new editions.
Copyright International Business Machines Corporation 2000, 2008. All rights reserved.
US Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Installing IBM Rational Performance Tester, IBM Rational Service Tester for SOA Quality,
and IBM Rational Performance Tester Agent
Controller
This installation guide provides instructions for installing, updating,
and uninstalling IBM(R) Rational(R) Performance Tester, IBM Rational Service Tester for SOA Quality,
and IBM Rational Performance Tester Agent
Controller.
Note:
This installation guide is limited in scope to standard installations
performed from the Launchpad and IBM Installation Manager.
For more detailed installation and configuration, please see the product Help.
Before
installing, you should consult the Release Notes for late-breaking installation issues.
Product Overview
Two independent products are covered by this installation guide: IBM Rational Performance Tester and
the IBM Rational Service Tester for SOA Quality.
The IBM Rational Performance Tester Agent
Controller is a tool for automating the load and scalability testing of server-based
software applications. You can use Rational Performance Tester to ensure
your software application will scale and perform to meet service-level agreements
and production-level loads. You can increase load generation capacity by installing
additional agents on remote computers. It is included as part of the IBM Rational Performance Tester product
kit.
- IBM Rational Performance Tester:
This product comes with 5 sets of disks.
- Quick Start Guide: This disk contains translated versions of the Quick
Start Guide.
- Rational Performance Tester:
These disks contain a complete set of installation software, including the
launchpad and IBM Installation Manager,
for installing the Rational Performance Tester and Rational Performance
Tester Agent as a product feature. When you start the launchpad, you have
the option to Install IBM Rational Performance Tester (Include Agent)I or Install IBM Rational Performance Tester Agent. "Include Agent" refers to the option to install
the Agent Controller as a feature on the workstation along with Rational Performance Tester. This feature is integrated with the product set on these disks.
The Install IBM Rational Performance Tester Agent opens a dialog box that directs the user to insert the Rational
Performance Tester Agent disks.
- Rational Performance Tester Agent:
These disks contain a complete set of installation software, including the
launchpad and IBM Installation Manager,
for installing the agent controller software.
- Rational Performance Tester Product
Activation Kit: This disk contains the product license for the Rational Performance Tester workstation.
- Rational Enterprise
Deployment CDs: These disks contain compressed copies of the IBM Installation Manager, the IBM Rational License Key Administrator, and the IBM Packaging
Utility.
- IBM Rational Service Tester for SOA Quality:
This product comes with 4 sets of disks.
- Quick Start Guide: This disk contains translated versions of the Quick
Start Guide.
- Rational Service Tester:
These disks contain a complete set of installation software, including the
launchpad and IBM Installation Manager,
for installing the Rational Service Tester.
- Rational Service Tester Product
Activation Kit: This disk contains the product license for the Rational Service Tester workstation.
- Rational Enterprise
Deployment CDs: These disks contain compressed copies of the IBM Installation Manager, the IBM Rational License Key Administrator, and the IBM Packaging
Utility.
Installation overview
Installation conventions and terminology
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. (Some packages cannot share a
package group, in which case the option to use an existing package group is
unavailable.)
- Repository
- A storage area where packages are available for download. 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 tools 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 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.
- 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.
For the most up-to-date, detailed system requirements, see http://www.ibm.com/software/awdtools/tester/performance/sysreq/index.html for Rational Performance Tester and Rational Performance Tester Agent
Controller, and http://www.ibm.com/software/awdtools/tester/service/sysreq/index.html for Rational Service Tester for SOA Quality.
Hardware requirements
Before you can install the product, verify that your system meets
the minimum hardware requirements.
Hardware |
Requirements |
Processor |
Minimum: 1.5 GHz Intel(R) Pentium(R) 4 (or higher for best results) |
Memory |
Minimum for Rational Performance Tester and Rational Service Tester for SOA Quality:
768 MB of RAM; minimum for just the Agent Controller: 500 MB of RAM |
Disk space |
Minimum: 1.5 GB of disk space for product package installation.
Additional disk space 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 environment variable TEMP.
-
An additional 500 MB of disk space is required in the /tmp directory. |
Display |
1024 x 768 resolution minimum using 256 Colors or higher for best
results
For just the Agent Controller: 800 x 600 display minimum using 256
Colors or higher for best results |
Other hardware |
Microsoft(R) mouse or compatible pointing device |
Software requirements
Before you can install the product, verify that your system meets
the software requirements.
Operating system
The following operating systems
are supported for this product. Some 64-bit versions of operating systems
are supported where noted. However, the Rational Performance Tester Agent Controller runs only in 32-bit mode on 64-bit operating systems.
Operating system |
Rational Performance Tester / Rational Service Tester Workbench |
Rational Performance Tester Agent
Controller |
AIX(R) 5.2 TL7 or later |
No |
Yes |
AIX 5.3 TL3 or later |
No |
Yes |
Red Hat Desktop 4 updates 1 through 7, includes 64-bit
version running in 32-bit mode |
Yes |
Yes |
Red Hat Enterprise Linux(R) 4 updates 1 through 7, includes
64-bit version running in 32-bit mode |
Yes |
Yes |
Red Hat Enterprise Linux 5 update 2, includes 64-bit version
running in 32-bit mode |
Yes |
Yes |
SuSE Linux Enterprise Server Version 9.0 SP1
to SP4 |
Yes |
Yes |
SuSE Linux Enterprise Desktop / Enterprise
Server Version 10.0 to SP2 |
Yes |
Yes |
Microsoft Windows(R) Server 2003 Enterprise/Standard
Edition with Service Pack 1, 2, or 3, includes 64-bit version running in 32-bit
mode |
Yes |
Yes |
Microsoft Windows Server 2008 |
Yes |
Yes (see note) |
Microsoft Windows XP with Service Pack 1, 2 or
3, includes 64-bit version running in 32-bit mode |
Yes |
Yes |
Microsoft Windows Vista SP1 |
Yes |
Yes |
z/OS(R) 1.4, 1.5, 1.6, 1.7, 1.8, 1.9 System Z |
No |
Yes (see note) |
Note:
- DCI functions are not supported by the Rational Performance Tester Agent Controller on Microsoft Windows Server 2008 or z/OS.
- The listed operating systems support all of the languages that are supported
by Rational Performance Tester.
- The SAP and Citrix extensions are supported only on Microsoft Windows operating
systems.
Java(TM) requirements for Rational Agent Controller on z/OS
z/OS Java 6
required for 8.0. See http://www-03.ibm.com/servers/eserver/zseries/software/java/products/j6pcont31.html#j6getting for
more information.
Software requirements for extending an installed Eclipse IDE
The
products in this version of the IBM Rational Software Delivery Platform were
developed for use with version 3.4, or later, of the Eclipse integrated development
environment (IDE). You can only extend
an existing Eclipse IDE of version 3.4 with latest updates from eclipse.org.
To
extend an installed Eclipse IDE, you also require a Java runtime
environment from one of these Java development kits:
-
IBM 32-bit
SDK for Windows, Java 2 Technology Edition, Version 6.0 service
release 2; Sun Java 2 Standard Edition 6.0 Update 2 for Microsoft Windows
-
IBM 32-bit
SDK for Linux on Intel architecture, Java 2
Technology Edition, Version 6.0 service release 7; Sun Java 2
Standard Edition 6.0 Update 7 for Linux x86 (not supported for SUSE Linux Enterprise
Server [SLES] Version 9)
Note:
You might need to update your Eclipse version in order to install
updates to Rational Performance
Tester. Refer to the release documentation of the update for information on
changes to the prerequisite Eclipse version.
Supported virtualization software
Rational Performance Tester supports Citrix Presentation Manager Version 4 or 4.5, running
on Windows Server
2003 Standard Edition or Windows Server 2003 Professional Edition.
Although the client for Citrix Presentation Server is available on Linux, Rational Performance Tester does
not support the Citrix extension on Linux.
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 view the readme files and the installation
guide and to support the Standard Widget Toolkit (SWT) browser widget:
- The Launchpad does not support Mozilla 1.6; if your browser is Mozilla,
you need version 1.7, or later, to run the launchpad.
- To view multimedia user assistance, such as tours, tutorials, and demonstration
viewlets, you must install Adobe(R) Flash Player.
-
Adobe Flash Player Version 6.0 release 65 or later
-
Adobe Flash Player Version 6.0 release 69 or later
- For information about supported database servers, Web application servers,
and other software products, see the online help.
User privileges requirements
You must have a user ID that meets the following requirements to
installRational Performance Tester, Rational Service Tester, Rational Performance Tester Agent
Controller.
- 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, 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 using the 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 shared by the products
installed into that package group.
- Product resources 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 will be 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 you want to
install the product package into an existing package group or whether you
want to create a new package group. IBM Installation Manager blocks products
that are not designed to share or do not meet version compatibility and other
requirements. If you want 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 of 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 of the products
in the package group will have the development, testing, and modeling functionality
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 necessary.
Important:
When installing products on the Windows Vista
operating system, do not install Eclipse in the Program Files directory (C:\Program
Files\). Otherwise, users without Administrator privileges will be unable
to use the product.
Extending an existing Eclipse IDE
When you install the your product package or packages, you can
choose to extend an Eclipse integrated development environment (IDE) already
installed on your computer by adding to the functions that your new product
or products contain.
Any product package that you install using IBM Installation Manager is bundled with a version of the Eclipse IDE or workbench; this bundled
workbench is the base platform for providing the functionality in the Installation Manager package.
However, if you have an existing Eclipse IDE on your workstation, then you
have the option to extend it, that is, add to the IDE the additional
functionality provided in the product package or packages.
To extend an existing Eclipse IDE: in the Location page of the Install
Packages wizard, select the Extend an existing Eclipse IDE option.
You might extend your existing Eclipse IDE, for example, because you want
to gain the functionality provided in a product package, but you also want
to have the preferences and settings in your current IDE when you work with
the functionality from the product package. You also might want to work with
plug-ins that you have installed that already extend the Eclipse IDE.
Your existing Eclipse IDE must be version 3.4 for the latest updates from
eclipse.org to be extended. Installation Manager checks that the Eclipse instance
you specify meets the requirements for the installation package.
Note:
You
might need to update your Eclipse version in order to install updates for
some products. Refer to the update release documentation for information on
changes to the prerequisite Eclipse version.
Increasing the number of file handles on Linux workstations
For best product performance, increase the number of file handles
above the default of 1024 handles.
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.
To increase your
file descriptors:
- Log in as root. If you do not have root access, you will need
to 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 4096. The point
is that 4096 is significantly larger than 1024, the default 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 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 number available to user1 is between the two. Make sure
that you read and understand the documentation contained in the limits.conf
file before making changes.
For more information on the ulimit command, see the man page for
ulimit.
Install the product software
These instructions can be used to install the Rational Performance Tester, the Rational Service Tester,
and the Rational Service Tester Agent
Controller.
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 directly,
then you must set repository preferences manually.
To install from the launchpad:
Important:
Installation notes for the Windows Vista operation system:
- You must run the launchpad programs as administrator. If the launchpad
program starts automatically (for example, if you are installing from a CD),
stop the launchpad program and restart it by using the Run as administrator command
(At the root level of the CD or disk image, right-click launchpad.exe and
click Run as Administrator.).
- Installing the products within the Program Files directory (C:\Program
Files) is not recommended. If you select either an Installation Location or
Shared Resources Directory within the Program Files directory, the packages
that you install must be run as administrator.
- Review the Installation considerations,
if you have not done so already.
- If you are installing from compressed files, such as ZIP or ISO
files, unpack the files into a common directory. For product installations
with multiple disks, the uncompressed directories must read /disk1,/disk2,
and so forth.
- 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
will start autostart. Otherwise, start the launchpad program manually.
-
Run launchpad.exe located in the root directory of the disk1 installation
image.
-
Run launchpad.sh located in the root directory of the disk1 installation
image.
- Select a language in which to run the launchpad and Installation
Manager. Click OK.
- Select the product to install from the launchpad menu. The Install
Packages window opens. If the IBM Installation Manager is not installed,
it will be listed as a package.
- Click on a product packages 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 and Extensions. If updates for a product package
are found, then they will be 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 found for the available packages, click Show
all versions.
- To display a package description under Details,
click on 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 you
are installing, review all information beforehand.
Note:
For IBM Installation Manager to search the predefined IBM update repository locations for the
installed packages, the preference Search the linked repositories
during installation and updates on the Repositories preference
page must be selected. This preference is selected by default. Internet access
is also required. A progress indicator shows 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 that
you want 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 will be 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, 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 is:
-
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 new 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 is:
-
C:\Program Files\IBM\SDP
-
/opt/IBM/SDP
- Click Next to continue.
- On the next Location page, you can choose to extend an existing
Eclipse IDE already installed on your system, adding the functionality in
the packages that you are installing. You must have Eclipse Version 3.4 with
the latest updates from eclipse.org to select this option.
- If you do not want to extend an existing Eclipse IDE, click Next to
continue.
- To extend an existing Eclipse IDE:
- Select Extend an existing Eclipse.
- In the Eclipse IDE field, type or navigate to the
location of the folder containing the eclipse executable file (eclipse.exe
or eclipse.bin). Installation Manager will
check if the Eclipse IDE version is valid for the package that you are installing.
The Eclipse IDE JVM field displays the Java Virtual
Machine (JVM) for the IDE that you specified.
- Click Next to continue.
- On the Features page under Languages, select
the languages for the package group. The corresponding national language translations
for the user interface and documentation for the product package will be installed.
- On the next Features page, select the package features that you
want 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 will automatically enforce any dependencies with other features
and display updated download size and disk space requirements for the installation.
- Optional: If you plan to collect response time breakdown
data, select the IBM Rational Performance Tester Agent check
box.
- When you are finished selecting features, click Next to
continue.
- On the Summary page, review your choices before installing the
product package. If you want 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 completed.
- When the installation process is complete, a message confirms the
success 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 you want the product
to start when you exit.
- Click Finish to launch the selected package.
The Install Package wizard closes and you are returned to the Start page of Installation Manager.
- If the Data Collection Infrastructure software is installed, follow
these steps to enable the test server for data collection:
- From the Start menu, select IBM Software Delivery Platform -> IBM Rational
Data Collection Infrastructure -> Application Server Instrumenter to open the instrumentation application.
- Click the Add Local button and select
the type of application server that you have running on the server.
- Fill in the server type specific fields including the location
of the server if required and click OK.
- Stop and start the server for the instrumentation to take effect.
- From the Start menu, select IBM Software Delivery Platform -> IBM Rational
Data Collection Infrastructure -> Start Data Collection.
Note:
All Rational Performance Tester systems
involved with the Data Collection Infrastructure must have the data collection
software running for the transaction breakdown functionality to be available
within the results of an 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 occurs, you can find more information to help troubleshoot
the error in the log files in the IBM Tivoli(R) 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 containing tivoli/common,
or for any of these log files: trace-install.log, trace-ma.log, or trace-tapmagent.log.
Note:
For
Websphere Application Server 6.x, if you create a new profile and then use
the Application Server Instrumenter to instrument this profile without first
starting WebSphere
(R) Application
Server, the Application Server Instrumenter will report that the server is
instrumented and will request that you re-start the server manually. This
message is incorrect; the server is not actually instrumented. To work around
this problem:
- Close and then re-start Application Server Instrumenter.
- Select the entry you just added from the list of instrumented servers
and click Remove.
- Re-start WebSphere Application
Server.
- Re-start Application Server Instrumenter and use it to instrument the
server.
To avoid this problem, after creating a new profile, start the WebSphere Application
Server profile manually. Then, use the Application Server Instrumenter to
instrument the server.
- License the product.
Manage licenses
Licensing for your installed IBM software and customized packages is
administered using the Manage Licenses wizard in the IBM Installation Manager. The Manage Licenses
wizard displays license information for each of your installed packages.
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 on managing licenses for your Rational product, see:
Licenses
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 your software.
Authorized User license
An IBM Rational Authorized User license authorizes
a single 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 a single 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 Passport Advantage(R) Express(TM) program, IBM will
automatically extend 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 may 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; it will grant access
to the number of concurrent users that equals the number of licenses the organization
purchased.
License enablement
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 contain
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 the following benefits:
- License compliance enforcement across the organization
- Fewer license purchases
- Serve license keys 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 support article
http://www.ibm.com/support/docview.wss?uid=swg21250404 for
license upgrade information.
For more information on obtaining activation
kits and Floating licenses, see Purchasing
licenses.
Purchasing licenses
You can purchase new licenses if your current product license is
about to expire or if you want to acquire additional product licenses for
team members.
To purchase licenses and use your product, complete the following
steps:
- Determine the type of license you want to purchase.
- Go to ibm.com(R) 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 do one of the following 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
using IBM Installation Manager.
- If you purchase Floating licenses for your product, click the link
to the IBM Rational Licensing and Download site, login
(IBM registration
is required), and then select 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 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.
When you want to import the activation kit or enable Floating License
support for your product, use the Manage Licenses wizard in IBM Installation
Manager.
You can review license information for your installed packages,
including license types and expiration dates, from IBM Installation Manager.
To view license information:
- Start IBM Installation Manager.
- On the main page, click Manage Licenses.
The package vendor, current license types, and expiration dates are
displayed for each installed package.
Notices
(C) Copyright IBM Corporation 2000, 2008. 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 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:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, 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 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, 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 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.
Trademarks and service marks
See www.ibm.com/legal/copytrade.shtml.