Configuring the Engineering Test Management adapter

You must configure the Engineering Test Management adapter to establish a successful connection between HCL DevOps Test UI (Test UI) and Engineering Test Management.

Before you begin

  • You must have the following information:

    • The URL of the Engineering Test Management server.

    • A user credential and valid license to access Engineering Test Management.

    • The user account must be added to the project area that is being accessed by the adapter with write permissions to the project.

  • You must have added -Dhptcostconfirm and -DCMDLINE_PORT=999 to the eclipse.ini file before you run a compound test or accelerated functional test that consume VU-Hours from Engineering Test Management.

    The eclipse.ini file must be available at the installation directory of Test UI.

For more information about Engineering Test Management, refer to the IBM Engineering Lifecycle Management documentation.

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/jre/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. Open Test UI.
  3. Click Window > Preferences > Quality Manager Adapter.
  4. Enter the following information of the Engineering Test Management:
    Fields Actions
    Server URL

    Enter the URL of Engineering Test Management.

    For example, https://<hostname>:<portnumber>/qm

    Note: If you rename the Engineering Test Management server, you must perform the following tasks:

    1. Update the Engineering Test Management server name in the hosts file with a new name.

    2. Update the Server URL field with the new name.

    3. Configure the adapter to point to the new URL.
    Adapter name

    Enter a unique name to identify the Engineering Test Management adapter. The Engineering Test Management adapter uses the name of the computer as the default name of the adapter.
    Project area

    Enter the name of the project area in Engineering Test Management.
  5. Select one of the following Authentication type from the drop-down list to connect to Engineering Test Management:
    Authentication type Actions
    Username and Password

    Perform the following steps:

    1. Enter the username associated with Engineering Test Management in the User ID field.

    2. Enter the password associated with the username of Engineering Test Management in the Password field.
    KERBEROS

    Click Browse to locate and select the kerberos.ini file in the Configuration File field.

    Note: The kerberos.ini file is automatically created when you set up Kerberos.

    For example, on Windows systems, you can locate the file in the c:\windows\krb5.ini. The file name and the location might change based on the operating systems.
    SSLCERT

    Perform the following steps:

    1. Enter the location of the SSL certificate keystore in the Certificate Location filed.

    2. Enter the keystore password in the Password field.

    Note: The expected format of the keystore is p12. The keystore must contain the client certificate that the adapter uses when you authenticate with Engineering Test Management.
    SMARTCARD Select a certificate from the drop-down list from the Certificate Selection field.
  6. Optional: Select the Enable Proxy checkbox to connect through a proxy computer and perform the following steps to enter the Proxy Details of the computer:
    1. Enter the hostname of the proxy computer in the Host field.
    2. Enter the port number of the proxy computer in the Port field.
    3. Enter the username and password of the proxy computer in the User and Password fields.
  7. Click Apply and Close to save and close the configuration.

Results

You have configured the details of Engineering Test Management on Test UI.

What to do next

You must start the adapter either from Test UI or command-line interface to run Web UI tests.