Setting up the integration with Jenkins

You can run HCL OneTest™ API tests and view the results. You must set up the integration with Jenkins by deploying the Integration Tester plugins for Jenkins into the Jenkins environment.

Before you begin

  • HCL OneTest™ API or HCL OneTest™ API Agent must be installed on the same computer where Jenkins is installed.

  • If you are using Apache Ant to run your tests, you must have installed it on the same computer. It is not necessary to install HCL Quality Server on the same computer as the other software.

See also, Note.

The computer that is running the Jenkins service must have the HCL OneTest™ API license key available to Jenkins. The license key is found at the following location:
  • Windows: C:\Windows\System32\config\systemprofile\HCL\hclproducts\licensing.
  • Linux: /var/lib/jenkins/HCL/hclproducts/licensing.

About this task

You can deploy the Integration Tester plugins for Jenkins to run the tests and integrate viewing of test results from HCL OneTest™ API in the Jenkins Job view.
Note: The test results viewer plugin in the HPI file can get a different name depending on the version of HCL Quality Server that is in use:
  • In V9.1.1 or earlier: RITPluginForJenkins-1.4.hpi.
  • In V9.1.1: IntegrationTesterPluginForJenkins-1.4.hpi.
  • V9.1.1.1 or later: IntegrationTesterResultsPlugin-version.hpi, where version is the plugin version number. For example, 1.5.

The test execution plugin IntegrationTesterTestExecution-version.hpi is available in HCL Quality Server V9.1.1.1 or later only. It requires HCL OneTest™ API or HCL OneTest™ API Agent V9.1.1.1 or later.

Procedure

  1. Download and extract the Integration Tester plugins for Jenkins package (CIJenkins.zip) that is provided with HCL Quality Server. For more information on the tool package list, see HCL OneTest API tool packages.
  2. Copy the IntegrationTesterResultsPlugin-version.hpi file from the downloaded package to a temporary location on the computer where Jenkins is installed.

    For the exact file name, check Note.

  3. Open the Jenkins dashboard using a web browser and click Manage Jenkins.

    The Manage Jenkins page is displayed.

  4. Click Manage Plugins.
  5. Click the Advanced tab.
  6. Click the Choose File option under the Upload Plugin, navigate to the hpi file, and click Open.
  7. Click Upload.

    The plugin is installed.

  8. Select the Restart Jenkins when installation is complete and no jobs are running check box.

    Alternatively, restart Jenkins manually.

  9. Optional: After Jenkins restarts, verify that the plugin is installed by completing the following tasks:
    1. Click Manage Jenkins on the Jenkins dashboard.
    2. Click Manage Plugins on the Manage Jenkins page.
    3. Click the Installed tab.

      Under Name, an Integration Tester Results Plugin entry is displayed and under the Enabled option, a check box next to the name is selected.

  10. Repeat from Step 2 to Step 9 for the IntegrationTesterTestExecution-version.hpi file.
    Note: When you repeat Step 9, the name of the plugin to look for is Integration Tester Test Execution Plugin.

Results

You can use Jenkins to run HCL OneTest™ API tests and view the results.