Installation and configuration

Instructions to integrate TeamForge 17.4 with TestLink 1.9.15 and 1.9.16.

Installation requirements for TeamForge-TestLink integration.
Attention:
  • CollabNet supports only the integration between TestLink and TeamForge. For TestLink support, contact TestLink directly. Click here for more information.
  • TeamForge 16.7 and later releases support integration only with TestLink 1.9.15 and 1.9.16. TestLink 1.9.17 and later versions are not supported. If you are on earlier versions of TestLink, upgrade to one of the supported TestLink versions and integrate it with TeamForge. This integration does not provide backward compatibility (Data reliability and Migration) to older TeamForge-TestLink 1.9.11 integration that is based on TeamForge's Integrated Application Framework (IAF).
Important: By default, only TeamForge users with "Site Administrator" privileges can create test suites. If you want other users to create test suites, you must create a site-wide role in TeamForge, grant "CREATE/VIEW" access to "All Projects" for the role and assign this role to users.

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.2.jar) is available . 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.2.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.2.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
    • php-mbstring
    • php-bcmath
  2. Download the collabnet-testlink-1.0.1.tar file to the /tmp directory and untar the file to <testlink-installation-directory>/plugins/ directory.
    • cd <testlink-installation-directory>/plugins/
    • tar -xvf /tmp/collabnet-testlink-1.0.1.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.