README.md #22

P4 Plugin

Jenkins plugin for a Perforce Helix Versioning Engine (P4D).

Contents

Requirements

  • Jenkins 1.509 or greater.
  • Helix Versioning Engine 2012.1 or greater.
  • Minimum Perforce Protection of open for the Jenkins user.
  • Review Build feature requires Swarm 2014.2 or greater.

Install

  1. Open Jenkins in a browser; e.g. 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. Check the box and press the 'Install without restart' button

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. Press the 'Check now' button at the bottom of the page.
  3. When 'Done' go back to the update centre 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.

Lastest SNAPSHOT builds available here.

Manual install

  1. Open Jenkins in a browser; e.g. http://jenkins_host:8080
  2. Browse to 'Manage Jenkins' --> 'Manage Plugins’ and Select the 'Advanced' tab.
  3. Press the 'Choose File' button under the 'Upload Plugin' section
  4. Find the location of the 'p4.hpi' file and Select Upload
  5. Choose the 'Download now and install after restart' button (this might be different on the newer version)
# Change User Description Committed
#31 25082 paul_allen Added a shields for min version.
#30 24643 paul_allen Update Release notes for 1.9.0
#29 24489 paul_allen Updated min requirements.
#28 24174 paul_allen Deprecated Helix 'Build Farm' servers.
#27 24139 paul_allen Merge pull request #72 from p4kevin/master
Updates to Freestyle documentation.
#26 23013 paul_allen Add new pages for Pipeline.
#25 22823 paul_allen Update URLs in README.

Minor find bug fix.
#24 21856 paul_allen Update min Jenkins version
#23 17835 paul_allen Draft: documentation notes page.

Hints and Tips from Jenkins Users.
#22 17834 paul_allen Helix branding update.
#21 16541 paul_allen Document unshelve step and DSL
#20 16540 paul_allen Split up README to separate docs.
#19 16539 paul_allen Update release notes for 1.3.3
#18 16187 paul_allen Update release notes
#17 15858 paul_allen Docs: Workflow setup
#16 15696 paul_allen Update release notes
#15 15671 paul_allen Added Parallel & Custom Parallel builds to the README.
#14 15527 paul_allen Update release notes and docs.
#13 15493 paul_allen Update Swarm URLs in README
#12 15419 paul_allen Updates README with 'change' vs 'P4_CHANGELIST' issue
#11 15363 paul_allen Update POM and release notes for next release.
Latest: 1.2.7
#10 15329 paul_allen Update release notes.
#9 14915 paul_allen Update release notes.
#8 13956 paul_allen Update README

Update Troubleshooting section for Edge/Commit issue.
Added release notes for 1.2.4 and 1.2.3 releases.
#7 13619 paul_allen Document building at a change.

JENKINS-28301
#6 12468 karl_wirth Documenting solution for overcoming Java 128bit encryption restriction.

       Error seen:
Unable to connect: com.perforce.p4java.exception.ConnectionException: Error occurred during the SSL handshake: invalid SSL session

Due to current US export control restrictions for some countries, the standard JDK package only comes with 128 bit encryption level cyphers. In order to use P4Java to connect to an SSL-enabled Perforce server, those living in eligible countries may download the unlimited strength JCE (Java Cryptography Extension) package and replace the current default cryptography jar files with the unlimited strength files.
#5 11235 paul_allen MarkDown for Publish Asset.
#4 10014 paul_allen Added doc warning for reserved environment vars.
#3 9704 paul_allen Tidy up README and pushed out a new release 1.0.3 for null/empty params
#2 9696 paul_allen Updated install notes and removed old ref to p4-client
#1 9690 paul_allen [Branching using p4-jenkins]
Release 1.0.1
//guest/paul_allen/dev/p4-jenkins/p4-client/README.md
#1 9645 paul_allen Markdown file