Integration with Rational® Service Tester for SOA Quality is implemented
through the use of an adapter. The adapter is installed by default when you
install either IBM® Rational Performance
Tester or Rational Service
Tester for SOA Quality Version 8.0 and is configured on the test machine.
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 Rational Performance Tester or Rational Service
Tester for SOA Quality Version 8.0.
Configuring the adapter to run in GUI mode
You configure
the adapter within the test workbench by selecting . Then you type the Rational Quality Manager server
URL, the Rational Quality Manager functional
connector ID and password, and a name to identify this adapter.
To configure
the tester adapter:
- On the test workbench, click .
- Type the Rational Quality Manager server
URL in the Server URL field.
- Type a Rational Quality Manager ID
in the Login field. This user account must exist in Rational Quality Manager with
a Connector Client Access License.
- Type the Rational Quality Manager functional
connector password in the Password field.
- (Optional) Type a unique name to identify the Rational Quality Manager adapter on this workstation in the Adapter Name field.
- Click OK to save the configuration.
Configuring the adapter to run in command-line mode or as
a Windows service
An
additional step is required to run the adapter in command line mode or as
a Windows service.
- Configure the adapter to run in GUI mode as previously described.
- Exit the test workbench.
- Locate the adapter.config file in the rst_install_dir \RPT-RST_RQMAdapter\config\
directory, where rst_install_dir is the directory where
the test workbench is installed, for example, C:\Program Files\IBM\SDP.
- 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.
Starting and stopping the adapter in command-line mode
You
can run the adapter in command line mode.
- Start a command prompt window.
- Switch to the rst_install_dir \RPT-RST_RQMAdapter\bin\
directory, where rst_install_dir is the directory where
the test workbench is installed, for example, C:\Program Files\IBM\SDP.
- In Windows, issue one of the following commands:
- To start the adapter, enter: RQMAdapter.bat START.
- To stop the adapter, enter: RQMAdapter.bat STOP.
- In Linux®,
issue one of the following commands:
- To start the adapter, enter: RQMAdapter.sh START.
- To stop the adapter, enter: RQMAdapter.sh STOP.
When running from the command line, adapter activities are printed
to rst_install_dir\RPT-RST_RQMAdapter\logs\adapter.log.
You can also print the current status of the adapter by entering this command: rst_install_dir\RPT-RST_RQMAdapter\bin\RQMAdapter.bat
STATUS.
Note: Do not open the test workbench in the same workspace while
the adapter is running from the command line. Doing so might interfere with
the ability of the adapter to run test scripts. Stop the adapter before opening
the workbench in the configured workspace.
Starting and stopping the adapter as a Windows service
When
you install the test workbench, you also install the adapter as a Windows service.
By default, the service is set to start manually.
Note: For IBM Rational Service
Tester for SOA Quality, the service is named IBM RST adapter for
RQM. If you are running Rational Service Tester, apply the
following actions to that service.
To start the service, open the Windows service
manager, right-click IBM RST adapter for RQM, and click Start.
To stop the service, right-click IBM RST adapter for RQM,
and click Stop.
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.
Note: The adapter
service for Windows requires the computer to have Microsoft® .NET
Framework 2.0 or later.
When running the adapter as a service, status
is printed to rst_install_dir\RPT-RST_RQMAdapter\logs\adapter.log.,
You can also print the status by entering this command:
rst_install_dir\RPT-RST_RQMAdapter\bin\RQMAdapter.bat
STATUS
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
opening the workbench in the configured workspace.
Starting and stopping the adapter in GUI mode
GUI
mode is when the adapter is running within the test workbench itself. 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.
Note: Do not use the test workbench while
a test is running in GUI mode. Doing so might interfere with the ability of
the adapter to run test scripts.
You interact with the adapter in
GUI mode by clicking .
Use this view to start, stop, and view adapter activities.
Buttons
to connect and disconnect to the Rational Quality Manager server
are located in the top 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. (See the troubleshooting section.)
Viewing 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. 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.
The result completion state reported to Rational Quality Manager is
based on the overall verdict of the runs associated test log. 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.
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.
Troubleshooting
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. |
- Verify that the Rational Quality Manager server
address provided to the adapter is correct. Provide the correct address.
- Check the login and password provided. Provide the correct password.
|
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. |
- The adapter is not communicating with the server.
- The adapter may already be in use.
|
You attempt to import a script from the adapter but
no scripts are found. |
- Make sure the project path entered in the Rational Quality Manager is a project under the workspace associated with the running adapter. You
need only to enter the project name. This is less error prone than typing
the complete project path, but either forms are acceptable.
- If running from the command-line or as a service, be certain the WORKSPACE_DIR
set in adapter.config is the same path as seen in the select workspace dialog
when running the test workbench. Be careful it’s not set to a project folder
under the workspace directory.
|
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/. |
Known limitations
- When shell sharing Rational Performance Tester and Rational Service
Tester, the adapter registers itself as a Rational Performance Tester adapter. To register as a Rational Service Tester adapter, Rational Service
Tester must be installed as it's own software package.
- 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 Rational Performance Tester for
a run initiated from the Rational Quality Manager Web
user interface.
- Only one adapter per product installation on a given computer should be
started. Using multiple adapters on the same computer requires that you install
each product as its own software package in it's own directory. If you are
running multiple adapters on the same computer, ensure that they are using
different workspaces.