# Unzip the director where you want it, although we only use it for installing buckminster, this is a generic headless p2 installer so may want to use it as an alternative to running the "director.app" embedded in the Eclipse IDE).

# Unzip the director where you want it, although we only use it for installing buckminster, this is a generic headless p2 installer so may want to use it as an alternative to running the "director.app" embedded in the Eclipse IDE).

# If you are on UN*X, you need to chmod the director script. "cd director", "chmod +x director"

# If you are on UN*X, you need to chmod the director script. "cd director", "chmod +x director"

−

# Run the director to install Headless Buckminster

+

# Run the director to install Headless Buckminster:

+

<pre>

<pre>

director

director

Line 44:

Line 45:

-vmargs -Declipse.p2.data.area= <buckminster install folder>/p2

-vmargs -Declipse.p2.data.area= <buckminster install folder>/p2

</pre>

</pre>

−

#7 Configure your headless buckminster - it is empty when you get it, so you must do this. See this [[Sample headless configuration (Buckminster)|Sample headless configuration]], but note that you should use http://download.eclipse.org/tools/buckminster/headless-3.5/ as the repository URL in the install commands. (See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=269736 bug 269736] for a proposal to be able to skip the repo URL when installing from the repository the product was installed from).

+

<ol>

−

+

<li value=7> Configure your headless buckminster - it is empty when you get it, so you must do this. See this [[Sample headless configuration (Buckminster)|Sample headless configuration]], but note that you should use http://download.eclipse.org/tools/buckminster/headless-3.5/ as the repository URL in the install commands. (See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=269736 bug 269736] for a proposal to be able to skip the repo URL when installing from the repository the product was installed from).

+

</li>

+

</ol>

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 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:

−

<pre>

−

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

−

</pre>

−

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 [http://www.eclipse.org/newsportal/article.php?id=867&group=eclipse.tools.buckminster#867 here]

This was announced [http://www.eclipse.org/newsportal/article.php?id=867&group=eclipse.tools.buckminster#867 here]

Revision as of 19:18, 23 March 2009

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.

Unzip the director where you want it, although we only use it for installing buckminster, this is a generic headless p2 installer so may want to use it as an alternative to running the "director.app" embedded in the Eclipse IDE).

If you are on UN*X, you need to chmod the director script. "cd director", "chmod +x director"