Installing Headless Buckminster
< To: Buckminster Project
Buckminster is also packaged in a so called 'Headless' command line oriented version suitable for running on remote servers, be invoked from scripts etc. The Headless version is based on Eclipse but only includes what is needed to run as a command line tool. The footprint of the headless version is thus much smaller than for the complete Eclipse IDE.
The Headless version as it is delivered today requires configuration before use. The downloadable version only contains the Buckminster core - i.e. it does not contain any of the optional plugins. They are easy to add, but it requires some work on your part.
Prior to Eclipse 3.5, the headless buckminster uses Eclipse Update Manager to install the required features. Starting with 3.5, this is done with Eclipse p2. Note that it is possible to build for 3.4 using a 3.5 Buckminster.
Buckminster Packaged as an Eclipse Product
This format is for specialized situations; it is called the 'product' format as it is built using the Eclipse Product packaging paradigm. Beyond the fact that is intended as a standalone package, you can view it as a subset of the functionality gained through the update site. Specifically, it is intended to be used in Headless mode situations only (though given it's design it can serve as a foundation for achieveing a graphical startup as well). It only contains the bare essentials to begin with, so before it can be used for anything useful, it needs to be customized by you. The benefit is that you can be very selective on what it contains, and thus bring down the footprint. Actually, it is likely you may wish to use install further Buckminster features from the Buckminster update site.
Product builds are available as zip archives available on our download page.
Note that Buckminster has many possible extension points. This is also true for the Headless framework. In fact, it is entirely possible to use only this framework and produce your very own headless application which has nothing to do with what Buckminster otherwise can do. More on extending the Headless framework here.
Installing versions < Eclipse 3.5
Before 3.4, you will download a Buckminster product, and then configure it to include what you want.
- Goto the Buckminster Download Page
- Download the latest "buckminster.zip" for 3.4
- Unpack "buckminster.zip" to a location where you want it
- On Un*x, make the "buckminster script" executable. "cd buckminster", "chmod +x buckminster"
- Remember the "headless update site url" - http://download.eclipse.org/tools/buckminster/updates/headless-site.xml, as you need it when configuring your headless buckminster
- Configure your headless buckminster - it is empty when you get it, so you must do this. See this Sample headless configuration
Installing 3.5 version (and later)
In 3.5, headless buckminster is installed and updated using p2. Instead of downloading the buckminster product, you will start by downloading a headless p2 installer called "director".
- Goto the Buckminster Download Page
- Download the latest "director.zip"
The latest available version of the Buckminster Headless Product for Eclipse 3.5 milestones is only provided as an P2 Installable Unit (IU) from our headless repository.
The headless update site for Eclipse 3.5 milestones is http://download.eclipse.org/tools/buckminster/headless-3.5/
In order to install the headless buckminster, you must use the P2 director. A headless command line version of the director can be found here: director_1.0.0.r10030.zip. Buckminster headless can then be installed using the following command:
director -ar <url to headless repo> -mr <url to headless repo> -dest <buckminster install folder> -bundlepool <buckminster install folder> -profile Buckminster -installIU org.eclipse.buckminster.cmdline.product -vmargs -Declipse.p2.data.area= <buckminster install folder>/p2
If you wish you can to download the entire headless site here: org.eclipse.buckminster.site.eclipse.headless_1.1.0.r10035.zip.
This was announced here