Configuring and running the HCL OneTest UI adapter for Rational Quality Manager

Integration with IBM® Rational® Quality Manager is implemented through the use of an adapter. The adapter is installed by default when you install HCL OneTest™ UI and is configured on the computer where HCL OneTest UI is installed.

Before you begin

If you are a Rational Quality Manager user then ensure that you have appropriate permissions along with execute permissions to access the HCL OneTest UI adapter for Rational Quality Manager. If you do not have administrator rights then use the Connector Client Access license. This license can be obtained from the Rational Quality Manager administrator.

If the host name of the Rational Quality Manager server has not been registered with the DNS server, modify the hosts file and map the host name of the Rational Quality Manager server to its IP address.

Note: If the adapter connects to the Rational Quality Manager server through a proxy server, configure and start the adapter through the command-line interface. For instructions to do this, see Configuring and running the adapter through a proxy server.

Procedure

  1. Click Start > Program File > HCL OneTest > HCL OneTest UI > Adapter to Rational Quality Manager > Configure Adapter. The HCL OneTest UI Adapter dialog box opens.
    Note: You can also configure the adapter from the command-line interface. At the prompt, type cd <product installation directory>\FunctionalTester\RQMAdapter and run the configureadapter.bat command.
  2. Click Connection Information.
  3. In the Server URL field, type the Rational Quality Manager server URL to login to Rational Quality Manager. 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
  4. In Authentication Mode, specify the authentication mode to connect to Rational Quality Manager.
    • User name and Password - Specify the user ID and password of the Rational Quality Manager user account.
    • Kerberos - Select the kerberos .ini file. The file is automatically created when you set up Kerberos. Typically, on Windows, the file would be located at c:\windows\krb5.ini. The file name and the location would change for different operating systems.
    • SSL Cert - Specify the location of the SSL certificate and optionally, the password. The certificate should be a .p12 file.
    • Smart Card - (Windows-only). Select the smart card certificate alias. You must ensure that the workbench machine is connected to the smart card reader and that the smart card is inserted into the reader. The product reads the aliases from the smart card and prompts for the smart card PIN whenever the adapter connects to Rational Quality Manager.
    Note: While using IBM java to run the HCL OneTest UI-RQM adapter and keyword view, see the following technote and make changes to the java.security file in the IBM JRE at jdk\jre\lib\security\java.security: http://www.ibm.com/support/docview.wss?uid=swg21633703.
  5. In the Project Area list, select a project area you want. The server attempts to establish a connection with the project area.
    Note: To connect to a new project area, you must stop the adapter and start it again.
  6. Optional: You can change the adapter name in the Adapter Name field. Adapter Name is any name that you want to give your adapter to show up in the Quality Manager web UI to identify this instance of the adapter.
  7. Optional: Select Save password, to save the password in the connection file.
  8. Click Apply.
  9. To start the adapter, click Start Adapter. The HCL OneTest UI calls IBM Rational Quality Manager through the adapter. The Adapter Console window displays the status of the HCL OneTest UI integration with IBM Rational Quality Manager.
    Note:
    • To start the adapter in a Linux operating system, you must browse to <product installation directory>/Functional Tester/RQMAdapter/ and run ./configureadapter in the Linux terminal.
    • When the adapter is connected to the server and is running, if you want the process to continue running in the background, close the adapter window. The process runs in the background and the adapter icon is visible in the system task tray. To stop the adapter process, right-click the adapter icon in your system tray and click Stop Adapter.
    • 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.
Feedback