The adapter can be run in three modes:
Refer to the Rational Quality Manager information center for detailed information on using Rational Quality Manager.
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. See Customizing reports for more information. You can also view the full run results from within the test workbench by opening the test workbench in the workspace configured to be used by the adapter. Additionally, if you are running a Rational Performance Tester schedule with performance requirements, the Performance Requirements report for the last user stage of the schedule will be attached to the Rational Quality Manager results.
For Rational Service Tester for SOA Quality service tests and Rational Performance Tester performance tests, the result completion state reported to Rational Quality Manager reflects the overall verdict of the test log associated to the run. See Test log overview for more information. In many cases a test may contain a failed verification point, but still be considered as passed. You should view the attached report in the Rational Quality Manager execution result and set the execution results status accordingly.
For Rational Performance Tester schedules, the result completion state reported to Rational Quality Manager is based on the overall Performance Requirements status. Only performance requirements for the last user stage defined in the schedule are covered by the report. If no performance requirements are specified, the result completion state in Rational Quality Manager will be set to inconclusive. In this case, you should view the attached performance reports and manually set the completion state in Rational Quality Manager. See Defining performance requirements in schedules for more information.
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 initiated from Rational Quality Manager can be found under the Rational Quality Manager Results project.
All modes of the adapter use the Eclipse error log. You can view the log by opening the workbench and clicking
. By default, warning and error messages are logged. You can turn on more detailed logging for the adapter by clicking . The log component for the adapter is named com.ibm.rational.test.lt.rqm.adapter.If you are running the adapter as a Windows service or from the command-line, you can view the adapter.log file without opening the test workbench.
Problem | Solution or cause |
---|---|
Where do you look for errors or warnings? | In the workbench, click | .
You do not see the adapter available for selection. |
|
The adapter continuously fails to connect to Rational Quality Manager. | Make sure that the server is running. If necessary, restart the server or check network connectivity. |
The adapter shows up red in the selection dialog. |
|
You attempt to import a script from the adapter but no scripts are found. |
|
The adapter is running from the command line or as a service and tests continue to fail. | Run the adapter in GUI mode so that you can see what happens when the test workbench runs the test script. |
Adapter Windows services does not start. A error message states that the service failed to start in a timely fashion. | Ensure that the machine has .NET 2.0 or later. This platform can be installed from the Windows Update Site or manually. For more information on installing .NET, see http://support.microsoft.com/kb/923100. |
When testing shared assets, the execution fails with an IOException. | The most likely cause is that the Rational Quality Manager to
UNC shared location is not setup correctly.
|
When testing shared assets, the execution fails with a low level model error. | Ensure that the Rational Performance Tester adapter has the required protocol extensions installed. The test assets located on the shared location can only be run on an adapter workspace that supports those protocols. |
Service tests created in a previous version of Rational Performance Tester or Rational Service Tester for SOA Quality are unable to execute. | Upgrade every SOA asset to the latest version. |