Skip to main content
Jump to: navigation, search

Eclipse Installer Marketplace

Revision as of 09:21, 2 July 2019 by (Talk | contribs) (Launch the Eclipse Installer)

Oomph Project Logo.png Powered by Oomph

This page provides step-by-step instructions for how to use the Eclipse Installer to install Marketplace listings.

If you encounter problems or have suggestions for improvements, please use Bug 548868 for that purpose.

Launch the Eclipse Installer

If you don't already have the Eclipse Installer on your system, download the installer that is appropriate for your operating system's architecture. For Windows, the installer is distributed as an executable. It will start without a JRE or JDK installed, but if you don't have at Java 8 installed, it will guide you to install that. For Mac and Linux, you must unpack the installer before you can run the application. In all cases, you must install a JRE or JDK (currently at least Java 8) before you can successfully use the installer, and of course the installation you will create needs it too. Please look at these instructions if you need further details. And note that on Mac you must install a JDK, not merely a JRE.

Now launch the installer application. Unless you just downloaded a new installer, the one you have probably needs to be updated; support for Marketplace is new to Oomph version 1.14. In simple mode, you'll see a "!" indicator on the menu button in the upper right corner; the menu will have an update item to start an update:

Oomph Installer Simple Update.png

In advanced mode, the right-most toolbar button at the bottom can be pressed to start an update.

Oomph Installer Advanced Update.png

Note that the installer will by default use a shared bundle pool for creating installations. This defaults to the .p2 folder in the home folder. If the file system for the home folder is relatively small, you can change the default location using the Bundle Pools menu option in simple mode, or the right-most toolbar button in the Bundle Pool section in advanced mode, as seen in each of the corresponding screen captures in the following section.

Note also that you can choose which Java VM is used by the installation you are about to create. The installer will generally detected the JREs and JDKs installed on your system, choosing an appropriate default, and remembering it for the next time you use the installer. But failing that, the installer will stay on the product page and you must use the tool button to locate a Java VM that is suitable for the installation being created.

Apply a Marketplace Listing

We will use a so-called Oomph configuration to automate the selection of the product and projects to provision. Drag and drop the Platform SDK Configuration link on the title area of the installer. If the installer is in simple mode, it will ask to Switch to Advanced Mode; confirm that prompt. When the configuration is successfully applied, the installer will be in advanced mode and will automatically turn to the Variables page. As an alternative to drag-and-drop, you can copy the Platform SDK Configuration link, and apply it to the installer. In advanced mode, this is done via the menu action; this action will appear in the menu only if the clipboard contains a valid configuration:

Oomph Installer Simple Apply Configuration.png

In simple mode, this is done via the left-most button in the toolbar; this button will appear in the toolbar only if the clipboard contains a valid configuration:

Oomph Installer Advanced Apply Configuration.png

Back to the top