Installation

This chapter covers the installation of the Helix Plugin for Jenkins.

Requirements

  • Jenkins 2.387.3 or greater.
  • Helix Core Server 2020.1 or greater.
  • Minimum Perforce Protection of open for the Jenkins user.
  • Review Build feature requires Helix Swarm 2022.1 or greater.

Known Limitations

  • One Jenkins job per Helix Swarm branch.
  • Helix 'Build Farm' servers are not supported, they were superseded by Helix Commit-Edge servers in 2013.2
  • The change summary for a concurrent build may report additional changes if that build is already in progress, JENKINS-57901.

Installation

  1. Open Jenkins in a browser; for example http://jenkins_host:8080
  2. Browse to Manage Jenkins, Manage Plugins, and select the Available tab.
  3. Find the P4 plugin or use the Filter if needed
  4. Select the check box and click the Install without restart button
Tip

If you are unable to find the plugin, you may need to refresh the update site.

  1. Select the Advanced tab (under Manage Plugins)
  2. Click the Check now button at the bottom of the page.
  3. When Done go back to the update center and try again.

Building

To build the plugin and run the tests use the following:

mvn package

Note

For the tests to run you must have p4d in your PATH, to skip tests use the -DskipTests flag.

The latest SNAPSHOT builds are available here.

Manual installation

  1. Open Jenkins in a browser; for example http://jenkins_host:8080
  2. Browse to Manage Jenkins, Manage Plugins, and select the Advanced tab.
  3. Click the Browse button in the Upload Plugin section.
  4. Find the location of the p4.hpi file and click the Open button.
  5. Click the Download now and install after restart button (this might be different on a newer version).

Useful links