Use these instructions to install Rational® Performance Tester Agent.
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 directly,
you must set repository preferences manually.
To learn how to install
the product from a command prompt in silent mode, see the Installing
Silently section of the IBM Installation Manager Information
Center.
Procedure
- Complete one of the following steps:
- 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.
- 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 .
- 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.