Install and configure the plugin on your CI server

When setting up a non-Jenkins CI server for ValueEdge for the first time, install the Application Automation Tools plugin on your CI server and configure it to connect to ValueEdge. For Jenkins, see Jenkins integration.

In this topic:

Plugin overview

The CI plugin enables ValueEdge to integrate with a CI server.

For a list of available plugins and their locations, see CI and CD server integrations.

The CI plugins provide the following capabilities:

• Retrieve and display the build pipelines that run on the CI server

• Trigger pipeline runs on the CI server

• Retrieve build run results, test run results, and commit information from the CI server

• Retrieve code coverage reports from a Jenkins CI server

• Trigger UFT One test execution on a Jenkins CI server

Back to top

CI integration prerequisites

For a list of plugins that must be installed on the Jenkins server to enable ValueEdge integration, as well as plugins that are supported by the ValueEdge integration but not required, see the Application Automation Tools wiki page or Jenkins integration.

The following is required to set up an integration with a CI server:

• Proxy and connectivity. To enable the CI server to communicate with ValueEdge, make sure that the server can access the Internet. If your network requires a proxy to connect to the Internet, set up the required proxy configuration.

• Network. The CI integration uses HTTP long polling where the CI Plugin initiates an HTTP request to the server. For the integration to work, the CI server needs to be able to perform HTTPS calls on the ValueEdge server. However, there is no need for the ValueEdge server to be able to perform HTTPS calls on the CI server. ValueEdge does not require you to open an on-premises firewall for CI integration, since there is no direct communication back to the on-premises CI server.

• Decide which CI server user ValueEdge will use to access the CI server and execute jobs. For Azure DevOps Server (TFS) this is the Personal Access Token (PAT).

  The CI server user or PAT must have the following permissions:

  On Bamboo:	Build plan
  On Jenkins, for working with pipelines:	Job Build
  On Jenkins, for ValueEdge-UFT One integration without pipelines:	Job Create, Delete, and Read If your SCM repository requires credentials, Credentials create and update permissions are also required. This is so that ValueEdge can save the SCM access credentials you provide on the Jenkins server.
  On Azure DevOps Server (TFS):	Read permissions for: Build, Code, Project and team, Test management Execute permissions for Build
  On GoCD:	View permissions, and permissions to run a pipeline.
  On Azure:	Read and Execute permissions for Build

  Caution: We strongly recommend limiting this user’s permissions to the minimum required for this integration.

Back to top

Install the plugin

Download the relevant plugin from the Internet and install it on your CI server. Do one of the following:

Jenkins	In your Jenkins server's user interface, open the plugin management area and upload the plugin: Click Manage Jenkins (on the left). Click Manage Plugins, select the Advanced tab, and scroll down to Upload Plugin. Browse to the plugin file that you downloaded and click Upload. Select the option to restart Jenkins when installation is complete and no jobs are running. For further steps, see Jenkins integration.
TeamCity	In your TeamCity server's user interface, open the plugin management area and upload the plugin: Go to Administration > Plugins List and click Upload plugin zip. Browse to the plugin file that you downloaded and click Upload. Restart the TeamCity server.
Bamboo	In your Bamboo server's user interface, open the add on management area and upload the plugin: Click the Administration cogwheel button and select Add-ons from the menu. Click Pause server to pause the server while you install a new add on, to avoid adverse effects on currently running builds. Click Upload add-on, browse to the plugin file that you downloaded and click Upload. Click Resume server at the top of the page.
Azure DevOps Server (TFS)	Run the downloaded MSI on your Azure DevOps Server (TFS) machine to install the plugin.
GoCD	Download the plugin's .jar file and store it on your GoCD server in <GoCD server folder>/plugins/external/.
GitLab	Run the Java command line as described in ValueEdge GitLab CI service.
Azure DevOps Server (2019 and later) Azure DevOps Services	Within Azure: Install the ValueEdge Integration Extension. Enable the Pipeline Decorators preview feature. For details refer to the extension's readme file.
GitHub Actions	Configure the workflow as described in the integration's readme file.

Before configuring the plugin to access ValueEdge, the plugin installation must be complete. Wait for the CI server to restart (Jenkins or TeamCity), refresh the add-on management page (Bamboo), or restart the CI server (Azure DevOps Server/TFS, GoCD).

Back to top

Configure the plugin to access ValueEdge

After you install the Application Automation Tools plugin on your CI server, you must configure it to access ValueEdge and, if necessary, the CI server.

To configure a plugin:

1. Open the plugin's configuration area. Do one of the following:

   Jenkins	In your Jenkins server's user interface, locate the configuration area for the Application Automation Tools plugin: Click Manage Jenkins (on the left). Click Configure System. Scroll down to the configuration area for the ALM Octane CI. Follow the guidelines described in Jenkins integration.
   TeamCity	In your TeamCity server's user interface, locate the configuration area for the Application Automation Tools plugin: Go to Administration. Under Server Administration, click ALM Octane CI Plugin.
   Bamboo	In your Bamboo server's user interface, locate the configuration area for the Application Automation Tools plugin: Click the Administration cogwheel button and select Add-ons from the menu. In the left pane, click Application Automation Tools Plugin under COMMUNICATION.
   Azure DevOps Server (TFS)	On your Azure DevOps Server (TFS) machine, access the plugin's console: Go to http://localhost:4567. Click Configuration. For more details, see the plugin's readme.
   GoCD	In your GoCD server's user interface, open Admin > Plugins. Click the cogwheel displayed for the OctaneGoCDPlugin.
   Azure DevOps Server (2019 and later) Azure DevOps Services	In the target Azure DevOps project: Create a new ValueEdge Service Connection. Provide the properties of your ValueEdge workspace: Connection name, URL, instance ID, shared space ID, API client ID and secret. Add two jobs to your pipeline: AlmOctanePipelineStart which always runs at the pipeline beginning, and AlmOctanePipelineEnd which always waits until all other jobs finish. Note:   The steps that follow are not relevant for the Azure DevOps integration. See the plugin readme file for comprehensive information on how to configure this integration. For additional setup requirements within ValueEdge for this integration, see Admin setup for Azure DevOps pipelines.

2. Enter information for the plugins:

   1. Set the Location. Enter the URL of the ValueEdge server, using its fully qualified domain name (FQDN), where the port number is optional. You can copy the URL from the address bar of the browser in which you opened ValueEdge. For example, for a space ID 1002: http://myServer.myCompany.com:8081/ui/?p=100 use the following format: http://<ValueEdge hostname / IP address> {:<port number>}/ui/?p=<space ID>

      Note: When configuring an integration between an on-premises and a CI server via the plugin, we strongly recommend using HTTPS to ensure that the credentials are sent securely.

   2. Set the Client ID. Enter the API access Client ID that the plugin should use to connect to ValueEdge. For details, see CI integration prerequisites.
   3. Enter the Client secret. Specify the Client secret that the plugin should use to connect to ValueEdge. For details, see CI integration prerequisites.

   4. For Jenkins, Bamboo, or TeamCity: Select the CI server user account. This is the user account that will run jobs at ValueEdge's request.

      Follow these guidelines:

      • Make sure the user exists in the CI server
      • In Bamboo, you must specify a user—you cannot leave it blank.
      • In Jenkins and TeamCity, if you do not specify a user ValueEdge uses Anonymous, and is limited to Anonymous permissions.
   5. For Azure DevOps: Set the HTTP address and Personal Access Token for the plugin to use to access Azure DevOps Server (TFS). The permissions required for this PAT are described above.
   6. For the GoCD API: Enter the username and password required for accessing GoCD.

3. Click Test Connection to validate the configuration, and then save your changes.

Back to top

Move an existing CI server to a new address

If your Bamboo or TeamCity CI server moves to a new location and you reinstall the plugin, you must re-create the CI server and its pipelines in ValueEdge.

If your GitLab server moves to another location, get the CI server instance ID using the following steps. Then, use the ciserver.identity property as described in ValueEdge GitLab CI service.

In Jenkins or Azure DevOps Server (TFS), if you move your server and reinstall the plugin, use the following steps to adjust the plugin's configuration and continue working with your existing pipelines.

Configure the Jenkins or Azure DevOps Server (TFS) plugin to work with existing ValueEdge pipelines

1. Get the plugin instance ID originally used to set up the CI server on ValueEdge:

   1. In ValueEdge, in Settings > Spaces, select a workspace.

   2. Click the DevOps tab. On the left side of the pane, and select CI servers.

   3. In the grid, locate the Instance ID column and copy your CI server's Instance ID.

2. In Azure DevOps Server (TFS) or Jenkins, update the new plugin to use the original instance ID.

   Jenkins	In your Jenkins server's user interface:  Click Manage Plugins in the left pane. Click Configure System. Scroll down to the ALM Octane CI configuration area. Click Show plugin instance ID. In the Instance ID box, enter the Instance ID you copied from ValueEdge earlier.
   Azure DevOps Server (TFS)	On the Azure DevOps Server (TFS) server, go to http://localhost:4567 to access the plugin's console. Click Configuration. In the Instance ID box, enter the Instance ID you copied from ValueEdge earlier. For more details, see the plugin's readme.

Back to top

Admin setup for Azure DevOps pipelines

This section describes the steps that admins need to do for integrating Azure DevOps with ValueEdge. The setup includes the Azure DevOps token and a DevOps CI server entry.

To set up the Azure DevOps integration:

1. In Azure project settings > Pipeline settings, set the following to OFF: Limit variables that can be set at queue time.

2. By default, you cannot set the following required variables as parameters or variables in yaml: executionId, suiteId, octaneTestRunnerFramework, octaneSpaceId, octaneEnvironment, suiteRunId, octaneWorkspaceId, octaneRunByUsername.

   Set these as editor’s variables by editing the pipeline in Azure Devops. Select Settable at queue time on the pipeline editor's Variables tab.

3. Make sure you have the latest Azure DevOps ValueEdge extension installed. If your version is outdated, when a user tries to run the pipeline, ValueEdge will issue a message indicating the required version. For details, see Configure the plugin to access ValueEdge.

4. Test suite and tests should be created first in ValueEdge (these can be created with pipeline injection).

5. Add credentials:

   1. Create a token in Azure DevOps.
   2. In Settings , select Spaces in the Administration section.
   3. Go to the Credentials tab and click + to add a new credential.
   4. Enter arbitrary text in the Name and User Name fields.
   5. For the password, enter the Azure token. For details, see Credentials.
   6. Click Add.

6. Add the CI server:

   1. In Settings , select Spaces in the Administration section.
   2. Go to the Devops tab and click + to add a new CI server.
   3. Add the server information for Azure DevOps and select the credential that you created above. This requires the following:

      1. In Administration > Spaces > DEVOPS, use the column selector and add the Credential column.

      2. Under your connection, check the Credential column checkbox and save.

   4. Click Add. Users can now run Azure DevOps pipelines. For details, see Run Azure DevOps pipelines.

Back to top

Next steps:

• Add CI/CD servers on ValueEdge
• Jenkins integration
• Create and configure pipelines or Set up UFT One integration