Install Rational Performance Tester Agent

Install Rational Performance Tester Agent

Overview

If you install using RPT_SETUP/launchpad.exe...

IBM Installation Manager and the License Key Administrator are automatically installed
IBM Installation Manager starts preconfigured with the location of the repository containing the RPT package.

On Windows 2088 64-bit I've encountered issues where launchpad.exe hangs when installing Rational Performance Tester workbench. In this case I've installed the workbench via method:

Install License Key Administrator (which installs the Installation Manager)...
RPT_SETUP/launchpad.exe

Install Rational Performance Tester workbench
RPT_SETUP/platform/install.exe

To install silently, see the IBM Installation Manager Information Center.

Install RPT Agent

Extract RPT install image files into a common directory.
For Windows 2008, before you extract the .zip files, do the following:

Right-click the .zip file and select Properties.
Click the General tab.
Click the Unblock button.
Repeat this process for each .zip file.

To install using launchpad, go to...
Common_Directory/RPT_8.3_Setup/RPT_SETUP

...and run...

launchpad.exe
launchpad.sh

If you are running 64-bit, execute launchpad64.exe.

Alternate method, go to...
Common_Directory/RPTAGENT_SETUP/disk1/Platform_Directory

...and run install.exe
Select a language
Click a product package to see its description
To search for updates to the product packages, click...

Check for Other Versions, Fixes, and Extensions

Package updates 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. To automatically search predefined IBM update repository locations, on the Repositories preference page select...
Search the linked repositories during installation and updates

This preference is selected by default. Internet access is 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.
If you install multiple packages at the same time, all the packages are installed into the same package group.
On the Licenses page click each package version to display its license agreement.
On the Location page, set the path for the shared resources directory in field...
Shared Resources Directory

Default paths...

C:\Program Files\IBM\IBMIMShared
/opt/IBM/IBMIMShared

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

...and then set 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

On the next Location page, you can choose to extend an existing Eclipse IDE. Click Next.
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 following check box is selected...

Load Generation Agent

The Load Generation Agent generates load. 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. IBM Installation Manager automatically enforces any dependencies with other features and displays updated download sizes and disk space requirements for the installation.
To see the dependency relationships between features, select...

Show Dependencies

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, set 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 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 Limit access to the computer where the agent controller is installed or to a list of specific computers.
Security Enable encrypted communication and limit access to a specified set of user IDs.

Click Next.

On the Summary page, review your choices

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.
Click Finish to start the selected package.

Enable the test server for data collection:

Run...

Start | IBM Data Collection Infrastructure | Application Server Instrumenter | 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.

Optional: Enable data collection infrastructure

The application server instrumenter, instrumentServer.sh, can fail with a generic error message...
Error during install/uninstall

...when instrumenting or uninstrumenting a server. If this error occurs, go to...

C:\Program Files\IBM\tivoli\common
/var/ibm/tivoli/common

...and review...

trace-install.log
trace-ma.log
trace-tapmagent.log

If you create a new profile, and then use the instrumenter to instrument this profile without first starting WAS, the 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...

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 creating a new profile

Start the WAS profile manually
Instrument the server

Error 404 - Not Found
Error 404 - Not Found
The document you are looking for may have been removed or re-named. Please contact the web site owner for further assistance.

Access List	Limit access to the computer where the agent controller is installed or to a list of specific computers.
Security	Enable encrypted communication and limit access to a specified set of user IDs.