Home
Rational® Performance Tester
Administrator Guide
This guide describes how to install Rational® Performance Tester. After you install the software, you can perform administration tasks such as license configuration and integration with other products. This guide is intended for administrators.
Configuration of the product
You must configure Rational® Performance Tester when you want to run SAP tests, collect response time breakdown data, or use the product in the Docker container.
Configuring the data collection infrastructure
If you want to collect response time breakdown data from remote computers used in distributed applications, you must install and configure the data collection infrastructure on the remote computers.
Removing instrumentation using the command prompt
Before you uninstall the data collection infrastructure, you must remove instrumentation from all application servers that were instrumented to work with the data collection infrastructure.

Rational® Performance Tester
- Release Notes
  This document contains information about what's new, installation instructions, known problems in IBM® Rational® Performance Tester and contact information of IBM Customer Support.
- System Requirements
  This document includes information about hardware and software requirements for IBM® Rational® Performance Tester.
- Getting Started
  This guide provides an overview and describes the task flows to get you started with Rational® Performance Tester. This guide is intended for new users.
- Tutorials
  This section contains the tutorials which explains the main features of Rational® Performance Tester.
- Samples
  This section describes about the sample project which can be used with Rational® Performance Tester to test the functionality of an application.
- Administrator Guide
  This guide describes how to install Rational® Performance Tester. After you install the software, you can perform administration tasks such as license configuration and integration with other products. This guide is intended for administrators.
  - Installation of Rational® Performance Tester
    Installing the product involves verifying requirements, planning, managing licenses, and configuring web-based help. This section lists all such topics.
  - License management
    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.
  - Product upgrade and migration
    You cannot upgrade to the latest version of the product. You must first uninstall the existing version of the product before you install the latest version of the product.
  - Configuration of the product
    You must configure Rational® Performance Tester when you want to run SAP tests, collect response time breakdown data, or use the product in the Docker container.
    - Configuring the environment for SAP tests
      Some of the capabilities of service tests require that you manually install additional libraries and files or that you configure some elements of the test environment.
    - Configuring the data collection infrastructure
      If you want to collect response time breakdown data from remote computers used in distributed applications, you must install and configure the data collection infrastructure on the remote computers.
      - Data collection infrastructure overview
        The data collection infrastructure collects performance profiling data for distributed applications and sends the data to the workbench computer, where you can view and analyze the collected data. The data collection infrastructure must be installed, configured, and running on all remote computers that will be used in your distributed application. The data collection infrastructure is installed when you install Rational® Performance Tester Agent.
      - Instrumenting local servers
        You must instrument application servers to collect response time breakdown data. You can use either a command-line or graphical user interface to instrument application servers to work with the data collection infrastructure.
      - Instrumenting servers by using the command prompt
        You must instrument application servers to collect response time breakdown data. You can use either a command prompt or graphical user interface to instrument application servers to work with the data collection infrastructure.
      - Removing instrumentation
        Before you uninstall the data collection infrastructure, you must remove instrumentation from all application servers that were instrumented to work with the data collection infrastructure.
      - Removing instrumentation using the command prompt
        Before you uninstall the data collection infrastructure, you must remove instrumentation from all application servers that were instrumented to work with the data collection infrastructure.
    - Configuring Docker containers
      Instead of reading through system requirements list and installing the products, you can now deploy the Docker containers on any computer and get started with testing. To automate playing back tests, you can push the product images to the Docker container.
    - Configuring IBM® Cloud Private
      To make use of automated workflows in IBM® Cloud Private, you can install it and push the Docker containers to it.
  - Integration with other products
    You can integrate Rational® Performance Tester with certain products to run tests, manage test assets, and create defects.
- Test Author Guide
  This guide describes how to create test scripts in Rational® Performance Tester and enhances tests by applying different test elements such as dataset, variables, and verification points. This guide is intended for testers.
- Test Execution Specialist Guide
  This guide describes tasks that you can perform on schedules, test execution with custom code, and Extending Rational® Performance Tester to support other protocols. This guide is intended for testers or test execution specialists.
- Test Manager Guide
  This guide describes how to keep track of the performance of the application by evaluating the test results. This guide is intended for test managers.
- Troubleshooting Guide
  This guide describes how to analyze and resolve some of the common problems that you might encounter while you work with Rational® Performance Tester.
- Reference Guide
  This guide describes, additional topics to gain more knowledge about Rational® Performance Tester.
- All Guides (PDFs)
  This page contains the release notes, system requirements, and persona guides for IBM® Rational® Performance Tester in PDF format.
- Security Considerations
  You can take certain actions to ensure that your installation is secure, customize your security settings, and set up user access controls.
- Notices
  This document provides information about copyright, trademarks, terms and conditions for the product documentation.

Removing instrumentation using the command prompt

Before you uninstall the data collection infrastructure, you must remove instrumentation from all application servers that were instrumented to work with the data collection infrastructure.

Before you begin

If you have uninstalled the application server or removed an instance of the application server, you cannot use the instrumentation utility to remove instrumentation from the server. This situation will block the data collection infrastructure uninstall process. Do not uninstall an application server before you have removed instrumentation from the application server.

Instrumented servers are listed in the file InstrumentationRegistry.xml. After you have removed instrumentation from a server, the InstrumentationRegistry.xml file will be empty of references to any application server. If you uninstall an application server before you have removed instrumentation, to uninstall the data collection infrastructure you must edit InstrumentationRegistry.xml to remove the applicationServer element for the application server that you uninstalled.

Procedure

To remove instrumentation from application servers:

Open a command prompt, and change directories to the instrument_comp folder in the data collection infrastructure installation directory. By default, on Microsoft™ Windows™ this directory is C:\Program Files\IBM\SDP\DCI\rapa_prod\instrument_comp. On Linux™ and IBM® AIX®, this directory is /opt/IBM/SDP/DCI/rapa_prod/instrument_comp.
Type the command name with the -uninstall argument and all of the other arguments that you used when instrumenting the server.
The instrumentation utility, which is also used to remove instrumentation from servers, is instrumentServer.sh on AIX® and Linux™ systems and instrumentServer.bat on Windows™ systems. Enter the command name with no arguments to see the syntax details for the command.
Restart the server if prompted to do so.

What to do next

You can uninstall the data collection infrastructure.