Install the Bamboo plugin

This topic describes how to install the Bamboo plugin on your Bamboo server machine.

Prerequisites

Before you start, verify that you have OpenText Functional Testing installed on the machine that hosts the Bamboo server.

Back to top

Upload the plugin

From the main Bamboo page (the Build Dashboard):

  1. In the upper right corner of the window, click the Administration button and select Add-ons or Manage apps. The add-ons or apps list is displayed in the Administration screen.

  2. In the Manage add-ons or Manage apps section of the Administration window, click Upload add-on or Upload app. A dialog opens enabling you to select the location of the .jar file for the plugin.

  3. In the Upload add-on or Upload app window, in the From my computer section, browse to or enter the URL of your .jar file.

    Note: This URL must be an absolute URL.

  4. Click Upload. Bamboo uploads and displays the installation progress in the Administration window.

    After the installation is finished, Bamboo displays a message describing the plugin.

    Note: When uploading Bamboo plugin 1.9 to Bamboo server or Data Center 8.2.x, you may encounter an error about the plugin not being compatible with your Bamboo server or Data Center.

    You can ignore this error. The plugin functionality is not affected.

    Close the installation window, and you are ready to set up build tasks to run OpenText Functional Testing tests.

After you successfully install the plugin, OpenText Functional Testing-related tasks are available in the Tests tab of the Tasks types window.

Back to top

Enable the agent

From the main Bamboo page (the Build Dashboard):

  1. In the upper right corner of the window, click the Administration button and select Agents.

  2. Locate and click the Server capabilities link.

  3. Click Detect server capabilities.

    The server pauses for a moment, and detects the ability to work with OpenText Functional Testing. When the detection is finished, OpenText Functional Testing is displayed in the list of executables.

    Note: OpenText Functional Testing is shown only if OpenText Functional Testing is installed on the server machine.

Running tests on remote hosts

If you plan on running a test on a remote host, you must first restart the Bamboo remote agent on the remote computer.

Do this after installing OpenText Functional Testing and detecting the new capabilities of the remote agent on the machine.

Back to top

Run tests from a Bamboo server installed on a different machine

This section describes how to run OpenText Functional Testing tests from a Bamboo server that is installed on a different machine than OpenText Functional Testing, such as a Linux-based machine.

Note: If you are using Bamboo version 7.0 or later, check whether the jna-x.x.x.jar and jna-platform-x.x.x.jar files are of the same version on the machine where your Bamboo server is installed. You can find the jar files in the <bamboo installation directory>/atlassian-bamboo/WEB-INF/lib directory.

To run tests from a Bamboo server installed on a different machine:

  1. Install the plugin on the Bamboo server and set up OpenText Functional Testing-related build tasks. For details, see Upload the plugin.

    Note: This feature is supported only for Bamboo plugin version 1.9 and later. You must install Bamboo plugin version 1.9 or later and then upload the plugin.

  2. On the Bamboo server, in the upper right corner of the window, click the Administration button . Then in the left pane, click Server capabilities.

  3. Scroll down to the Add capability section to add the OpenText UFT One capability.

    1. Select OpenText UFT One from the Capability type dropdown.

    2. Select Do you want to manually add the UFT path?.

    3. Copy the OpenText Functional Testing installation path to the Installation path input box.

      Specify the installation folder. For example, C:\Program Files (x86)\OpenText\UFT One. When OpenText Functional Testing is installed on the same machine as the server, the path is populated automatically and specifies the installation file. For example, C:\Program Files (x86)\OpenText\UFT One\bin\UFT.exe.

    4. Click Add.

  4. Install OpenText Functional Testing and the remote agent on a remote Windows machine. For how to install the remote agent, see Bamboo documentation.

  5. Connect the Bamboo server to the remote machine using the remote agent.

  6. Run OpenText Functional Testing tasks on the remote Windows machine from the Bamboo server using the remote agent.

Back to top

Security precaution

Although any sensitive information is encrypted and encoded, OpenText encourages you to routinely remove unnecessary configuration files generated by your Bamboo jobs, which are not removed by the OpenText Bamboo CI plugin.

These are the files located in the <Bamboo home directory>\xml-data\build-dir\<job name> folders.

By not implementing the file removal you may expose your system to increased security risks. You understand and agree to assume all associated risks and hold OpenText harmless for the same.

It remains at all times the Customer’s sole responsibility to assess its own regulatory and business requirements. OpenText does not represent or warrant that its products comply with any specific legal or regulatory standards applicable to Customer in conducting Customer's business.

Back to top

See also: