- Install JIRA if you have not done so already
- Visit My Atlassian and login with the email address associated with your JIRA license. This is email account you gave when you signed up to download or purchase JIRA
- Download the JIRA Perforce plugin zip suitable for your version of JIRA.
- View your Perforce licenses. If you don't already have a key, you can either:
- Request a free 30 day trial key by clicking 'Generate evaluation license'
- Purchase a commerical key
- Follow the instructions on the Perforce license page on saving the Perforce plugin license file to JIRA
- To install the plugin:
- Stop JIRA
- Unzip the following jar files from the Perforce plugin zip into the JIRA directory <JIRA>/WEB-INF/lib:
- atlassian-jira-perforce-plugin-<version>.jar
- atlassian-p4package-<version>.jar
- Edit the perforce-jira-plugin.properties (from the Perforce Plugin zip) for your installation
- Copy perforce-jira-plugin.properties to the JIRA directory <JIRA>/WEB-INF/classes
- Copy the perforce license file into JIRA's WEB-INF/classes
- Edit JIRA's WEB-INF/classes/jira-application.properties, and set jira.option.ignore.url.with.key to false (see PERF-62)
- Start JIRA
- Configure permissions to allow groups and users to View Version Control information.
The JIRA Perforce plugin is initialised during JIRA start-up. The Perforce license is verified and the plugin connects to the Perforce server to query the commit changes. The change lists are indexed and stored in <JIRA_INDEX_DIR>/plugins/atlassian-perforce-changes
