Plug-in Documentation

IBM Rational Performance Tester (RPT)

Overview

Overview
With the IBM Rational Test Workbench Performance Tester plugin for UrbanCode Deploy, you can automate the execution of tests, compound tests, and schedules. To initiate a service test run, you must install either the SOA extension as part of Rational Performance Tester or install Rational Service Tester for SOA Quality on the target computer.
For a performance test, install Rational Performance Tester on the target computer where the test will be run. When you run a schedule, ensure that the workbench is connected to the agent computers. If you run a schedule on the cloud, you must be aware of how much the run is going to cost you.

Compatibility
This plug-in requires version 6.1 of IBM UrbanCode Deploy.
This plug-in requires version 8.7 or later of Rational Performance Tester and Rational Performance Tester Agents.

Installation
No special steps are required for the installation of the plugin. See Installing plug-ins in UrbanCode Deploy documentation.

Steps

Process steps in the IBM Rational Test Workbench RPT plug-in

Run RPT Test

Execute Web UI Tests from IBM Rational Test Workbench

Input properties for the Run RPT Test step
Name Type Description Required
Config File String The complete path to a file that contains the parameters for a test or schedule run. No
Custom Report Format Files String A comma-separated list of absolute paths to custom report format files (.view files)
to use when exporting statistical report data with the-exportstatsoption.
No
Exported HTTP Test log File String The complete path to a file in which to store the exported HTTP test log. No
Exported Statistical Report Data File String The complete path to the directory in which to store exported statistical report data. No
Installation Manager Location String Complete path to Installation Manager. Yes
Number of Virtual Users String Overrides the default number of virtual users in the run. For a schedule, the default
is the number of users specified in the schedule editor. For a test, the default is
one user. This option creates a new copy of the schedule that contains the specified
number of users.
No
Overwrite Results file Boolean Determines whether a results file with the same name is overwritten. The default value,
true, means that the results file is overwritten.
No
Project String The path, including the file name,of the project relative to workspace. Yes
Quiet Boolean Turns off any message output from the launcher and returns to the command shell when
the run or the attempt is complete
No
Results File String The name of the results file. The default result file is the test or schedule name
with a time stamp appended.
No
Test Suite Name String The path, including the file name, of the test to run relative to the project Yes
User Comments String Add text within double quotation mark to display it in the User Comments row of the
report.
No
VM Args String Java virtual machine arguments to pass in. No
Var File String The complete path to the XML file that contains the variable name and value pairs No
Workspace String Complete path to Eclipse workspace. Yes

Usage

Use the Performance Tester plugin to continuously initiate the launch of tests, compound tests, and schedules from IBM UrbanCode Deploy.

Before you begin

  • Install IBM Rational Performance Tester version 8.7 or later and UrbanCode Deploy agent on computers where the tests will be run.
  • Install UrbanCode Deploy server and deploy the Performance Tester plugin in the server.
  • For information about installing UrbanCode Deploy, see its documentation.

  • To initiate a service test run, you must install either the SOA extension as part of Rational Performance Tester or install Rational Service Tester for SOA Quality on the target computer.

About the task
As a tester, you might have a large number of regression tests to run on the latest build of the product. Instead of manually running the tests on every new build, you can just install the latest build on the UrbanCode Deploy Agent computer and let UrbanCode Deploy launch the tests for you.

After deploying the Performance Tester plugin on the server, you must create the component and its processes, the applications and its processes, the environments, and the resources. For information about how to create these different pieces, see UrbanCode Deploy documentation.

After creating these pieces, you must create the testing workflow.

Procedure to create a workflow

  1. To create a workflow for the newly created component process, click the component process. The Tools view displays the available plugin steps.
  2. From Rational Test Workbench > Performance Tester, drag the Run RPT Test step to the design space.
  3. Specify the properties for the step. For information about the properties, see the Steps page.
  4. After you configure the step properties, save the step by clicking Save.

A typical process for the Performance Tester plugin will look like the following snapshot:

rpt-ucd

A process with multiple tests will look like the following snapshot:

rpt-multitest

If you have multiple products installed on one target machine, either in the same or different package groups, you can use a single process that includes steps from different products. The process will look like the following snapshot:

rpt-multiprodtest