Integrating

1. RPT integrations
1.1. Test with Rational Team Concert
1.1.1. Tracking defects with Rational Team Concert
1.2. Test with Rational Quality Manager
1.2.1. Rational Quality Manager integration overview
1.2.2. Configure the Rational Quality Manager adapter
1.2.3. Running the adapter in the workbench
1.2.4. Running the adapter from the command line
1.2.5. Running the adapter as a Windows service
1.2.6. Import test assets
1.2.7. Test shared assets

1.1. Performance and service testing with Rational Team Concert

IBM Rational Performance Tester can be integrated with IBM Rational Team Concert. You can manage performance and service test assets with Jazz. source control management. You must have a compatible version of Rational Team Concert server set up to use Jazz source control management. To use Rational Team Concert as the source control management tool for managing performance or service test assets, you must install Rational Team Concert version 2.0.0.2 iFix5 or later.

Introduction

You can use Rational Team Concert to connect to compatible Jazz servers, including Rational Team Concert servers and Rational Quality Manager servers.

Use this feature to do these tasks:

• Access Rational Team Concert and Rational Quality Manager work items.
• Manage performance test assets by using Jazz source control management.

If you have installed the Rational Team Concert client, see the Get Started section of the Rational Team Concert help to learn more about using Rational Team Concert.

The client version and server version of Rational Team Concert must match. See the Rational Team Concert information center to learn more about server and client version compatibility.

To access Jazz work items, use the Work Items view in the Work Items perspective. To switch to the Work Items perspective, click Window > Open Perspective > Work Items.

RPT version 8.2 does not include the Jazz Eclipse Client as an optional feature. The Jazz Eclipse Client was provided as an optional feature in earlier versions of RPT.

To install and manage RPT assets with Rational Team Concert, you must install RPT in the same package group as Rational Team Concert.

Install Rational Team Concert client version 2.0.0.2 iFix5 or later

Set up a compatible version of Rational Team Concert server.

You must have a Jazz.net account to download Rational Team Concert client. Register for a Jazz.net account at https://jazz.net/pub/user/register.jsp .

RPT version 8.2 is not compatible with releases of Rational Team Concert 2.0.0.2 prior to iFix5. Do not attempt to install Rational Team Concert version 2.0.0.2 iFix4 or earlier in the same package group as RPT version 8.2 or later.

1. Install RPT version 8.2.

   Note: If a previous version of Rational Team Concert client is installed on the same computer, you must install RPT in a different package group.

2. On the Installation Manager repository preferences page, add the Rational Team Concert client version 2.0.0.2 iFix5 (or later) repository to point to http://public.dhe.ibm.com/software/rationalsdp/rtc/v2/client_ext/updates/.
3. Install Rational Team Concert client version 2.0.0.2 iFix5 (or later) in the same package group as RPT version 8.2.
4. When the Password Required window for Jazz.net is displayed, type your Jazz.net user name and password.

1.1.1. Tracking defects with Rational Team Concert

You can submit defects to Rational Team Concert from the test log in RPT. By default, the test log editor uses Bugzilla as the defect tracking site. You must configure the product to use Rational Team Concert for defect tracking.

1. Click Window > Preferences > Test > Test Log Editor. The Test Log Editor preferences window opens.
2. In Submit URL, Search URL, and Open URL specify your Rational Team Concert server. Contact the administrator of the Rational Team Concert server for more information. Refer the following example URLs, where the name of the Rational Team Concert server is rtc.example.com and the name of the project is projectname:

   Submit URL: https://rtc.example.com:9443/jazz/web/projects/projectname#action=com.ibm.team.workitem.newWorkItem

   Search URL: https://rtc.example.com:9443/jazz/web/projects/projectname#action=jazz.viewPage&id=com.ibm.team.workitem

   Open URL: https://rtc.example.com:9443/jazz/web/projects/projectname#action=com.ibm.team.workitem.viewWorkItem&id=

   Note: If the Rational Team Concert server name changes, you must change the URLs accordingly.

What to do next

See Associate defects with a test log for details about working with defects in the test log.

1.2.1. Rational Quality Manager integration overview

To run tests from IBM Rational Quality Manager, you must configure the adapter that is installed by default when you install the product.

The adapter can be run in three modes:

• In GUI mode, from within the test workbench itself
• From the command line
• As a Windows service

Note: The term test workbench refers to either RPT, Rational Service Tester for SOA Quality, or Rational Test Workbench.

Use Rational Quality Manager

See the Rational Quality Manager Information Center for detailed information about using Rational Quality Manager.

View results

When you run a test script from Rational Quality Manager, the default report that is displayed during a test run is attached to the Rational Quality Manager results. This report can be customized.

If you use Rational Quality Manager version 4.0 or later, you can view and analyze the test reports in Rational Quality Manager. You can analyze the test reports while the test is in running state and after the run is completed. To view the test reports in Rational Quality Manager, in the Execution Results dialog box click Analyze Results Interactively using RPT .

Note: To access reports from outside workbench, you must enable the remote access from workbench.

The result completion state that is reported to Rational Quality Manager reflects the overall verdict of the test log that is associated with the run. In many cases a test might contain a failed verification point, but still be considered as passed. View the attached report in the Rational Quality Manager execution result and set the execution results status accordingly.

You can view the full run results from within the test workbench by opening the test workbench in the workspace that is configured to be used by the adapter.

If the adapter is running from the command line or as a Windows service, stop the adapter before opening the test workbench. When the workbench is opened, you can access the full test reporting and test log capabilities. Results for runs that are initiated from Rational Quality Manager are under the Rational Quality Manager Results project.

For RPT schedules, the result completion state that is reported to Rational Quality Manager is based on the overall Performance Requirements status. Only performance requirements for the last user stage that is defined in the schedule are covered by the report. If no performance requirements are specified, the result completion state in Rational Quality Manager is set to inconclusive. In this case, view the attached performance reports and manually set the completion state in Rational Quality Manager.

Known limitations

• Running tests from Rational Quality Manager with encrypted data pools is not supported. Password prompting when using such a datapool is not done in the adapter service or in the command-line mode. This is also discouraged in the GUI mode, because it requires user interaction with RPT for a run initiated from the Rational Quality Manager Web user interface.
• Start only one adapter per product installation on a given computer. Using multiple adapters on the same computer requires that you install each product as its own software package in its own directory. If you are running multiple adapters on the same computer, ensure that they are using different workspaces.

1.2.2. Configure the Rational Quality Manager adapter

Before running the tests from IBM Rational Quality Manager, you must configure the Rational Quality Manager adapter and establish a successful connection.

To configure the Rational Quality Manager adapter, you must have the following information:

• The URL of the Rational Quality Manager server.
• A login and password to access a user account in Rational Quality Manager. This user account must exist in Rational Quality Manager with a Connector Client Access License. The user account must also be added to the project area being accessed by the adapter, with a role granting write permissions to the project. The default Test Team Member role is recommended.

See the Rational Quality Manager Information Center for information about creating user accounts.

1. In the test workbench, click Window > Preferences > Quality Manager Adapter.
   1. In Server URL, type the Rational Quality Manager server URL. Type the URL in the format https://<server name>:<port number>/<context root> where <server name> is the Rational Quality Manager server host name that you specified in the hosts file. For example, type https://RQM01:9443/qm.

      Note: If the Rational Quality Manager server is renamed, complete these steps:

      1. If you have an entry for the Rational Quality Manager server in the hosts file, update it with the new server name.
      2. Update the Server URL field with the new server name.
      3. Configure the adapter again to point to the new URL.
   2. In Login and Password, type the ID and password of the Rational Quality Manager user account.
   3. In Adapter Name, type a unique name to identify the Rational Quality Manager adapter on this workstation. By default, the adapter uses the name of the computer.
   4. To connect the adapter to a project area other than the default Rational Quality Manager project, type the name of the project to connect to.
2. Click OK to save the configuration.
3. To run the Rational Quality Manager adapter from the command line or as a Windows service, complete these additional steps:
   1. Locate the adapter.config file in the rpt_install_dir \RPT-RST_RQMAdapter\config\ directory, where rpt_install_dir is the directory where the test workbench is installed, for example, C:\\IBM\SDP.
   2. Edit the WORKSPACE_DIR variable in the adapter.config file to point to the same test workspace that you want the adapter to use, for example: WORKSPACE_DIR= C:\Documents and Settings\username\IBM\rationalsdp\my_adapter_workspace

1.2.3. Start and stop the Rational Quality Manager adapter in the workbench

You can use the Quality Manager Adapter view to connect, disconnect, and view adapter activities from the test workbench.

Note: The term test workbench refers to either Rational Performance Tester, Rational Service Tester for SOA Quality, or Rational Test Workbench. Before running the Rational Quality Manager adapter, you must configure the test workbench and the adapter.

In GUI mode you can use the Quality Manager Adapter view to start, stop, and view adapter activities. In GUI mode, when a script is run from Rational Quality Manager, you see the test running inside the test workbench as though the test were run manually in a test workbench.

Push buttons to connect and disconnect to the Rational Quality Manager server are located in the upper-right corner of this view. This view also has a local preferences menu that you can use to control some behavior of the GUI mode adapter. If you see errors or warnings, use the Error Log view for further investigation.

Note: Do not use the workbench while the adapter is running. Doing so might interfere with the ability of the adapter to run test scripts. Stop the adapter before opening the workbench.

1. On the test workbench, click Window > Show View > Quality Manager Adapter to open the Quality Manager Adapter view.
2. To start the adapter, click Connect to RQM.
3. To stop the adapter, click Disconnect from RQM.

1.2.4. Start and stop the Rational Quality Manager adapter from the command line

You can use the command line interface to connect, disconnect, and view adapter activities from the test workbench.

Before running the Rational Quality Manager adapter, you must configure the test workbench and the adapter.

When running from the command line, adapter activities are printed to the rpt_install_dir\RPT-RST_RQMAdapter\logs\adapter.log file. To print the current status of the adapter, navigate to the rpt_install_dir\RPT-RST_RQMAdapter\bin\ directory, where rpt_install_dir is the workbench installation directory, and enter this command: RQMAdapter.bat STATUS.

Note: Do not use the workbench while the adapter is running. Doing so might interfere with the ability of the adapter to run test scripts. Stop the adapter before you open the workbench.

1. Open a command-line window, and navigate to the rpt_install_dir\RPT-RST_RQMAdapter\bin\directory , where rpt_install_dir is the directory where the test workbench is installed, for example: C:\Program Files\IBM\SDP.
2. To start the adapter from the command line, run the adapter command:
   • In Windows, type: RQMAdapter.bat START
   • In Linux, type: RQMAdapter.sh START
3. To stop the adapter from the command line, run one of these adapter commands:
   • In Windows, type: RQMAdapter.bat STOP
   • In Linux, type: RQMAdapter.sh STOP

1.2.5. Start and stop the Rational Quality Manager adapter as a Windows service

You can use the Windows service to connect, disconnect, and view adaptor activities from the test workbench.

Before running the Rational Quality Manager adapter, you must have configured the test workbench and the adapter.

When you install the test workbench, you also install the adapter as a Windows service. By default, the service is set to start manually.

The adapter service for Windows requires the computer to have Microsoft .NET Framework 2.0 or later.

Note: Do not open the test workbench in the same workspace while the adapter is running as a Windows service. Doing so might interfere with the ability of the adapter to run test scripts. Stop the adapter before you open the workbench in the configured workspace.

1. Open the Windows service manager.
2. To start the service, right-click IBM RTW-RPT-RST adapter for RQM and click Start. The adaptor is same for IBM Rational Test Workbench, IBM RPT and IBM Rational Service Tester for SOA Quality
3. To stop the service, right-click IBM RTW-RPT-RST adapter for RQM and click Stop.

What to do next

Optionally, you can configure the service to start automatically by right-clicking the adapter listing, selecting Properties, and selecting Automatic as the startup type. With this setting, the adapter can start automatically when the computer restarts, without requiring a user to log in.

When running the adapter as a service, status is printed to the install_dir\RPT-RST_RQMAdapter\logs\adapter.log file. You can also print the status by navigating to the install_dir\RPT-RST_RQMAdapter\bin\ directory, and entering this command: RQMAdapter.bat STATUS.

1.2.6. Import test assets into Rational Quality Manager

With the adapter, you can import the performance, service, and functional tests into Rational Quality Manager.

Before importing test assets into Rational Quality Manager, the adapter must be running on a computer where the test assets are located.

1. Log in to Rational Quality Manager, and click Construction > Import Test Scripts.
2. In Script Type, select one of the following test scripts:
   1. Select Performance Test to import a performance test or schedule from RPT.
   2. Select Service Test to import a service test from Rational Service Tester for SOA Quality
   3. Select RTW Test to import a test from Rational Test Workbench.
3. Select Use test resources that are local to a test machine, and click Select Adapter.
4. Select the computer on which the adapter is running, and click Next.
5. In Project Path, type the name of the project, and click Go. You must specify only the project name and not the entire path to the project.
6. Select the test assets that to import, and click Finish.

What to do next

See the Rational Quality Manager Information Center for more information about importing test scripts.

1.2.7. Test shared assets with Rational Quality Manager

You can make test projects and assets shareable in Rational Quality Manager. By sharing assets, any computer with your product, that is connected to Rational Quality Manager can execute a test or schedule.

When you are working with tests or schedules from a remote shared location, RPT, Rational Test Workbench, or Rational Service Tester for SOA Quality uses a local workspace for the Rational Quality Manager adapter. This adapter workspace is different from normal workspaces because the test assets are stored remotely. This means that every asset that is related to the test or schedule is downloaded from the shared location into the local workspace before execution. The following limitations apply:

• Assets in the adapter workspace might be deleted or overwritten with newer versions when updates are made to the shared location.
• If you change the shared location in the adapter workspace, the entire project is removed from the adapter workspace.
• Test results are stored in a different project, called RQM_Results, and are never deleted. The Rational Quality Manager test result page links to the correct location.

Note: Do not edit test assets in the adapter workspace because you might lose your work. Use these assets only for running tests and schedules.

If you are using source control and want to include only the minimum required assets, then include the following files:

• All *.testsuite tests and schedule files
• The /src directory if you use custom code
• All *.dp datapool files
• All *.location location files
• All digital certificates
• All WSDL and SOA security files.

All other assets, such as test results, are not required.

Custom code Java. classes in the shared assets cannot use libraries that are outside the workspace. If your custom code must use such a library, then copy the library into the project, and update the classpath to use the local copy.

To share tests and schedules in Rational Quality Manager:

1. Create a shared directory on the computer that hosts the UNC file system containing the test projects to share. For example, create this directory: C:\MyRemoteWorkspace.
2. Copy the test projects to share into the shared directory. If a project is stored in source control software, then copy it from there.
3. Check that the Rational Quality Manager server can access the shared directory by using UNC paths. For example, the \\MyServer\RPTRemoteAssets\ path must be mapped to the C:\MyRemoteWorkspace directory.
4. In Rational Quality Manager, specify the directory containing the actual test projects that are located in the shared directory.
5. Verify that you have correctly specified the UNC shared directory by browsing for the shared resource. Ensure that the first dialog box contains the projects at the first level. You must not have intermediate directories between the UNC shared directory and the project directory.

What to do next

See the Rational Quality Manager Information Center for more information about setting up shared resource locations and importing shared scripts.