Install a Jenkins adapter

A new CollabNet Plugin for Jenkins (v2.0) is now available that functionally subsumes both CollabNet Plugin v1.2.0 and EventQ Jenkins Adapter v2.0. Install this plugin using the web interface. Existing TeamForge-Jenkins integrations that use either CollabNet Plugin v1.2.0 (or earlier), or EventQ Jenkins Adapter v2.0 (or earlier), or both, must be migrated (using migrate_jenkins_plugin.sh script) after installing CollabNet Plugin.

Features of CollabNet Plugin v2.0 include:

Notify TeamForge EventQ when builds complete. The CollabNet Plugin must be installed once on each Jenkins server you wish to connect to TeamForge EventQ.
Authenticate users from TeamForge. If setup as the "Build & Test" application, it can even use Single Sign-On.
Authorization from TeamForge, including the ability to set permissions in Jenkins based on roles in your TeamForge project.
Upload the build log or workspace artifacts to the TeamForge Documents.
Upload workspace artifacts to the TeamForge File Release System, as a post-build publishing task or as a build promotion task.
Open/update/close TeamForge Tracker artifacts based on the Jenkins build status.
Upload workspace artifacts to the Lab Management Project Build Library. (Requires CollabNet Lab Management).

Click here to know more about the requirements for installing CollabNet Plugin.

If you are integrating TeamForge and Jenkins for the first time:
1. Log on to the Jenkins Server as a privileged Jenkins user, navigate to Manage Jenkins > Manage Plugins > Available.
2. Select the CollabNet Plugin v2.0 and install the plugin.
3. Restart your Jenkins server.
Existing TeamForge-Jenkins integrations that use CollabNet Plugin v1.2.0 (or earlier):
1. Log on to the Jenkins Server as a privileged Jenkins user, navigate to Manage Jenkins > Manage Plugins > Updates.
2. Select the latest CollabNet Plugin and install the plugin.
3. Download the migrate_jenkins_plugin.sh script and save it to <JENKINS_HOME_DIRECTORY>/jobs/.
  Tip: Jenkins default home directory is /var/lib/jenkins/.
4. Change ownership of the migrate_jenkins_plugin.sh file.
  - chmod 755 migrate_jenkins_plugin.sh
5. Run the migrate_jenkins_plugin.sh script.
  - ./migrate_jenkins_plugin.sh
Existing TeamForge-Jenkins integrations that use either EventQ Jenkins Adapter v2.0 (or earlier) or both CollabNet Plugin v1.2.0 (or earlier) and EventQ Jenkins Adapter v2.0 plugins:
1. Log on to the Jenkins Server as a privileged Jenkins user, navigate to Manage Jenkins > Manage Plugins > Installed.
2. Select the EventQ Jenkins Adapter v2.0 and click Uninstall.
3. If you have Collabnet Plugin v1.2.0 (or earlier) installed already, select the Updates tab. Select the Available tab otherwise.
4. Select the CollabNet Plugin v2.0 and install the plugin.
5. Download the migrate_jenkins_plugin.sh script and save it to <JENKINS_HOME_DIRECTORY>/jobs/.
  Tip: Jenkins default home directory is /var/lib/jenkins/.
6. Change ownership of the migrate_jenkins_plugin.sh file.
  - chmod 755 migrate_jenkins_plugin.sh
7. Run the migrate_jenkins_plugin.sh script.
  - ./migrate_jenkins_plugin.sh