Installation and configuration

Instructions to integrate TeamForge 17.1 with TestLink 1.9.15.

Installation requirements for TeamForge-TestLink integration.
Attention: TeamForge 17.1 supports integration with TestLink 1.9.15. If you are on earlier versions of TestLink, upgrade to TestLink 1.9.15 and integrate it with TeamForge.

Do this on the TeamForge Application Server

  1. Log on to the TeamForge Application Server.
  2. A new version of TestLink integration jar (collabnet-testlink-1.0.1.jar) is available with TeamForge 16.10. If you have integrated TestLink with TeamForge using the collabnet-testlink-1.0.jar file in the past:
    1. Go to My Workspace > Admin
    2. Select Projects > System Tools > Customizations.
    3. Select collabnet-testlink-1.0.jar.
    4. Click Delete.

      A confirmation message is displayed. Click OK.

  3. Download the collabnet-testlink-1.0.1.jar file.
  4. Go to My Workspace > Admin
  5. Select Projects > System Tools > Customizations and click Create.
  6. Click Choose File and select the collabnet-testlink-1.0.1.jar file.
  7. Click Add.

Do this on the TestLink Server

  1. Log on to the TestLink Server, download and install TestLink.
    Important: Make sure that you have the following RPMs available during TestLink installation:
    • php-xml
    • php-mcrypt
  2. Download the teamforge-testlink-plugin-1.0.tar file to the /tmp directory and untar the file to <testlink-installation-directory>/plugins/ directory.
    • cd <testlink-installation-directory>/plugins/
    • tar -xvf /tmp/teamforge-testlink-plugin-1.0.tar
  3. Log on to TestLink.
  4. Click the Plugins Management icon from the toolbar.
  5. Identify the TeamForge-TestLink integration plugin from the list of Availabe Plugins and click Install. The TeamForge-TestLink integration plugin is installed and shows up in the Installed Plugins section.
  6. Click the Home icon from the toolbar.
  7. Create a TestLink project.
    1. Click Test Project Management and click Create.
    2. Define project attributes such as the name, description, project prefix and so on. Click Save.
  8. Go to TestLink Home and click the TeamForge Setup link.
  9. Type the TeamForge Project Home URL, Username, Password, Defect Tracker ID and Requirements Tracker ID and click Save.
    Important: It is assumed that you have a TeamForge project, requirements tracker and defect tracker created already. If not, create them first and then perform this step of setting up TeamForge in TestLink. Have the requirements and defect tracker ID handy while setting up TeamForge in TestLink.
    Fore more information on creating a TeamForge project and seting up trackers, see: Once you set up the TeamForge project mapping in TestLink, a new TestLink tool is created in TeamForge (Project Home > Project Admin > Tools).

Do this on the TeamForge Application Server

  1. Go to Project Home > Project Admin > Tools and select the TestLink tool.

    The Edit Tool page appears.

    1. Type a Source Name.
    2. Select Custom Activity Source from the Source Type drop-down list.
    3. If required, select an Associated Source from the drop-down list. For example, select Build.
    4. Change the icon, background color and add tags, if you want to.
    5. Click Show Configuration to view the configuration data.
      Important: Copy and keep the custom source information such as the Source Association Key, Queue Server, Queue Username and Queue Password handy to be used for Test Suite configuration later in the process.
    6. Click Update.