Configuring and running DevOps Test UI adapter for IBM® Engineering Test Management

You can integrate HCL DevOps Test UI (Test UI) with Engineering Test Management by using an adapter. The adapter is available in the Test UI installation directory. You can run the tests that you create by using Test UI in Engineering Test Management after you configure and start the adapter.

Before you begin

  • If you are a Engineering Test Management user, you must have appropriate permissions to use the Test UI adapter for Engineering Test Management.
  • You must have a Connector client access license or a license that supersedes the Connector client access license. For more information, refer to Client access license management in the Engineering Lifecycle Management Solution knowledge center.
  • You must have modified the hosts file and map the host name of the Engineering Test Management server to its IP address if the host name of your Engineering Test Management server is not registered with the DNS server.
    Important: You must configure and start the adapter through the command-line interface to connect the adapter to the Engineering Test Management server through a proxy server. For information, see Related Links.

Procedure

  1. Reconfigure the JRE path if you are using Kerberos for authentication:
    1. Modify the JRE path to use the Oracle Java path as follows in the eclipse.ini file in the C:\Program Files\HCL\DevOpsTest directory:

      Change -vm jdk/bin/j9vm/jvm.dll to

      -vm C:\Program Files\Java\jre1.8.0_331\bin\server\jvm.dll.

    2. Navigate to the FunctionalTester\RQMAdapter directory in the Test UI installation directory.
    3. Replace %RFT_ARG_JRE% with the Oracle Java path on your system in the following line of the configureadapter.bat file:

      start "" %RFT_ARG_JRE% -classpath %RFT_INSTALL_DIR%\hcl_ft.jar com.rational.test.ft.RQMAdapterConfigure %*.

      For example,

      start "" "C:\Program Files\Java\jre1.8.0_321\bin\javaw.exe" -classpath %RFT_INSTALL_DIR%\hcl_ft.jar com.rational.test.ft.RQMAdapterConfigure %*

  2. Configure the adapter to generate logs:
    1. Download the log4j2.xml file, and place the file in the DevOpsTest\FunctionalTester\RQMAdapter directory.
    2. Copy the following jar files from <Install_Directory>\HCLIMShared\plugins\com.ibm.rqm.integration.client_<version>\lib to the DevOpsTest\FunctionalTester\RQMAdapter directory:
      • commons-logging-1.2.jar
      • log4j-api-2.17.1.jar
      • log4j-core-2.17.1.jar
      • log4j-jcl-2.17.1.jar
    3. Replace start "" %RFT_ARG_JRE% -classpath %RFT_INSTALL_DIR%\hcl_ft.jar com.rational.test.ft.RQMAdapterConfigure %* in the configureadapter.bat file with the following command:

      start "" %RFT_ARG_JRE% -Dlog4j2.configurationFile=.\log4j2.xml -classpath .\log4j-api-2.17.1.jar;.\log4j-core-2.17.1.jar;.\log4j-jcl-2.17.1.jar;.\commons-logging-1.2.jar;%RFT_INSTALL_DIR%\hcl_ft.jar com.rational.test.ft.RQMAdapterConfigure %*

  3. Run configureadapter.bat in the Windows operating systems or configureadapter.sh in the Linux operating systems.

    The DevOps Test UI Adapter dialog is displayed.

  4. Complete the following steps from the Connection Information tab:
    1. Enter the server URL of Engineering Test Management in the Server URL field.
      Note: The URL that you enter in the Server URL field must match with the public URI of the Engineering Test Management server. You can view the public URI on the administrator page of the Engineering Test Management server.
    2. Select the mode that you want to use to authenticate the connection with the Engineering Test Management server from the Authentication Type drop-down list.
      You can select any of the options in the following table, and then complete the steps for that option:
      Option Description
      Username and Password

      You can establish the connection with the Engineering Test Management server by using the user ID and password.

      Complete the following actions:
      Field Action
      User ID Enter the user ID that you use to log in to Engineering Test Management
      Password Enter the password that you use to log in to Engineering Test Management.
      Project area
      Select the required project area in the Engineering Test Management server from the drop-down list.
      Note: This field is populated with the project names that are on the Engineering Test Management server and the project names are displayed after the connection is established.
      Important: You must select the project from the drop-down list and not type the project name.
      Save password Select this option to save your Engineering Test Management password.
      KERBEROS

      You can establish the connection with the Engineering Test Management server by using the Kerberos initialization file (krb5.ini).

      Complete the following actions:
      Field Action
      Configuration File Click Browse and select the krb5.ini file.
      Project area
      Select the required project area in the Engineering Test Management server from the drop-down list.
      Note: This field is populated with the project names that are on the Engineering Test Management server and the project names are displayed after the connection is established.
      Important: You must select the project from the drop-down list and not type the project name.
      Save password Select this option to save your Engineering Test Management password.
      SSLCERT

      You can establish the connection with the Engineering Test Management server by using an SSL certificate.

      Complete the following actions:
      Field Action
      Certificate Location Click Browse and select the SSL certificate.
      Note: The certificate must be a .p12 file.
      Password Enter the password that you use to log in to Engineering Test Management.
      Project area
      Select the required project area in the Engineering Test Management server from the drop-down list.
      Note: This field is populated with the project names that are on the Engineering Test Management server and the project names are displayed after the connection is established.
      Important: You must select the project from the drop-down list and not type the project name.
      SMARTCARD

      You can establish the connection with the Engineering Test Management server by using a smart card.

      Notes:
      • Smart card authentication is only available in Windows operating systems.
      • The computer must be connected to the smart card reader before you select this option. You must also insert the smart card into the smart card reader. Test UI reads the aliases from the smart card and prompts for the smart card PIN when the adapter connects to Engineering Test Management.
      Complete the following actions:
      Field Action
      Certificate Location Select the smart card certificate from the drop-down list.
      Project area
      Select the required project area in the Engineering Test Management server from the drop-down list.
      Note: This field is populated with the project names that are on the Engineering Test Management server and the project names are displayed after the connection is established.
      Important: You must select the project from the drop-down list and not type the project name.
    3. Enter the adapter name in the Adapter Name field.
    4. Click Apply.
  5. Click Start Adapter to start the connection between Test UI and Engineering Test Management.
    Note: You can view the status of the connection by clicking the Adapter Console tab. You can stop the connection by clicking Stop Adapter.