Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Equinox/p2/Installer

< Equinox‎ | p2
Revision as of 12:50, 6 March 2008 by John arthorne.ca.ibm.com (Talk | contribs) (How do I create my own installer?)

Equinox p2 now produces a small SWT-based installer that can be used to install the Eclipse SDK. This article gives details on how to use the installer.

Why should I use the installer?

Traditionally Eclipse software is obtained in the form of a zip or tar.gz file that is simply extracted onto disk and run. While this simplicity has its advantages, there are also some disadvantages for users:

  • Downloading a 100+ MB zip file over HTTP can be painful on a slow connection
  • If you already have some or all of the plug-ins on your local disk, you are downloading content unnecessarily
  • More advanced compression techniques can't be used, because there is no opportunity to add the uncompression code at the other end
  • You must pick a single mirror at the start, and can't switch mirrors in case of failure
  • There is no opportunity to check code certificates to ensure the software you are downloading was created by a trusted source

The installer leverages p2's inherent support for multi-threading, pack200 compression, dynamic mirror balancing, and certificate validation to address these problems.

How do I use the installer?

  • Get the installer for your platform from the equinox download page.
  • Unzip the installer anywhere on your local disk
  • Run the "p2installer" executable
  • In the install wizard, select where you want to install the software
  • When finished, you can delete the installer

How do I create my own installer?

While the installer by default will install the Eclipse SDK, the installer itself is entirely generic. The installer knows what to install by reading an install description specified in p2installer.ini:

 -vmargs -Dorg.eclipse.equinox.p2.installDescription=http://update.eclipse.org/eclipse/testUpdates/sdk-installer.properties

If you look at that file in a Web browser, you will see:

 eclipse.p2.rootId=sdk
 eclipse.p2.metadata=http://update.eclipse.org/testUpdates/
 eclipse.p2.artifacts=http://update.eclipse.org/testUpdates/
 ... and other properties ...

The 'rootId' attribute describes what to install, and the next two attributes describe where to get the metadata and artifacts to be installed. By changing those attributes, you can make the installer install a different piece of software, or install from a different repository.

Back to the top