Installation

The Jira part

Install the P3 app from the Atlassian Marketplace into your Jira instance:

Open

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:

Open

The Equinox part

Equinox is not installed (nor updated) on Jira automatically, it has to be done manually by a Jira administrator:

Go to:

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.

Starting up & Shutting down Equinox

Startup

Equinox is lazily started up. It will remain inactive until some Jira user uses it, then Equinox will be initialized.

Shutdown

Once started up, Equinox will remain active until the P3 Runtime Jira app (with the app key = expert.marketplace.jira.eclipse.equinox4jira) is disabled.

Installing, Upgrading, and Uninstalling Software to/on/from Equinox

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).

Configuration main information

JVM version

Java 8 required and Java 11 recommended as the Eclipse project is adopting it as the default JVM version.

Eclipse version

P3 is currently built on Eclipse RAP e3 3.14 (2020-09)

Eclipse Install directory

P3 Eclipse is installed at:

Eclipse Logs

P3 Eclipse logs are:

Entry Points base URL

P3 Eclipse listens to (for custom Entry Points) the same HTTP port as Jira: