README.md #1

P4 Plugin

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

Contents

Requirements

  • Jenkins 1.642.3 or greater.
  • Helix Versioning Engine 2016.1 or greater.
  • Minimum Perforce Protection of open for the Jenkins user.
  • Review Build feature requires Swarm 2016.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)
# P4 Plugin
Jenkins plugin for a Perforce Helix Versioning Engine (P4D).

## Contents

* [Release notes](https://github.com/jenkinsci/p4-plugin/blob/master/RELEASE.md)
* [FreeStyle setup guide](https://github.com/jenkinsci/p4-plugin/blob/master/SETUP.md)
* [Pipeline setup guide](https://github.com/jenkinsci/p4-plugin/blob/master/WORKFLOW.md)
* [Pipeline libraries](https://github.com/jenkinsci/p4-plugin/blob/master/LIBRARY.md)
* [MultiBranch guide](https://github.com/jenkinsci/p4-plugin/blob/master/MULTI.md)
* [Advanced scripting](https://github.com/jenkinsci/p4-plugin/blob/master/P4GROOVY.md)
* [Notes page](https://github.com/jenkinsci/p4-plugin/blob/master/NOTES.md)
* [Jenkins page](https://plugins.jenkins.io/p4)

## Requirements

* Jenkins 1.642.3 or greater.
* Helix Versioning Engine 2016.1 or greater.
* Minimum Perforce Protection of `open` for the Jenkins user.
* Review Build feature requires Swarm 2016.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](https://ci.jenkins.io/blue/organizations/jenkins/Plugins%2Fp4-plugin/branches).

## 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
#1 23650 abraka "Forking branch Main of p4-jenkins to mautokar-p4jenkins."
//guest/perforce_software/p4jenkins/main/README.md
#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