Install the P3 app from the Atlassian Marketplace into your Jira instance:
The app is composed of two Jira plugins: The P3 Installer is packed within the P3 Runtime. Both apps will automatically be installed on Jira:
Installing Equinox is required once only. |
Equinox is not installed (nor updated) on Jira automatically, it has to be done manually by a Jira administrator:
Go to:
Jira > Administration > Manage apps > P3 Plugin System > Manage
and click on the Install Equinox button: it will take a couple of minutes to download from the Internet all the required bundles to run Equinox right within Jira.
After the software has been installed. the page will change to something close to the picture below:
The installation process has been finished.
Equinox is lazily started up. It will remain inactive until some Jira user uses it, then Equinox will be initialized.
Once started up, Equinox will remain active until the P3 Runtime Jira app (with the app key = expert.marketplace.jira.eclipse.equinox4jira) is disabled.
P3 supports the Equinox P2 provisioning system and the Eclipse P2 UI, a friendly GUI to install and uninstall the software from the desktop (RCP) Eclipse tool. It has been ported to run on the browser by using Eclipse RAP, a technology that allows to port Eclipse RCP applications to the web with minimal changes.
Click on the Admin Workbench for Jira link:
There are two options in the Help menu:
Install New Software…: to install new software only
About: to explore the current configuration and uninstall software
You can install software from Eclipse Repositories (AKA Eclipse Update Sites)
Keep in mind that not all Eclipse-based Software can run on P3 without any change, it requires some grade of compatibility in many cases (read below).
Java 8 required and Java 11 recommended as the Eclipse project is adopting it as the default JVM version.
P3 is currently built on Eclipse RAP e3 3.14 (2020-09)
P3 Eclipse is installed at:
${SHARED_JIRA_HOME}/p3/eclipse
P3 Eclipse logs are:
${LOCAL_JIRA_HOME}/p3/eclipse/worksapce/.metadata/.logs
P3 Eclipse listens to (for custom Entry Points) the same HTTP port as Jira:
${JIRA_BASE_URL}/plugins/servlet/p3/<your_entry_point_here>