The first step in getting your own Eclipse installation is to download Eclipse Juno Kepler 4.2.13 from the Eclipse download page. The download page offers several different variants of Eclipse; you want the Eclipse Modeling Tools, as they come with most many of the features required for KIELER development already installed. Once Eclipse is installed and started, there are two ways to install the remaining features: the (recommended) automatic way, and the manual way.

Automatically Installing the Remaining Features

The automatic installation basically uses a description of our reference Eclipse installation to bring your own installation to the same state. Follow these steps:

1. Download our reference installation file.
2. In Eclipse, choose Import... from the File menu. The import wizard should be displayed.
3. From the Install category, choose Install Software Items from File and click Next.
4. As the description file, select the one you've just downloaded.
5. The list should now display a bunch of features. Make sure they are all selected.

6. Click Next and wait for the wizard to collect all the installation details. This could take a while, so use the opportunity to visit your long-neglected relatives in New Zealand.

7. Once your relatives have finished telling you how tall you've grown since they've last seen you, the wizard will ask you to review the changes that it will apply to your installation. Confirm them by clicking Next, accept the license agreements and click Finish. This could again take a while, so go out and finally do that thing you've always wanted to do since you were a child.

8. Once you've finally done that thing and realized that it wasn't what you had expected, restart Eclipse and configure your installation according to our configuration guidelines.

If the installation fails because of some version problems, try to uncheck the option Install latest version of selected software in the Install Software Items from File wizard. Some of the plug-ins we're installing have been known to not play well with the latest versions of other plug-ins in the past.

Manually Installing the Remaining Features

If you have a problem with automatic installation procedures or the installation for some reason didn't work for you, install the required features manually. Warning: this is going to take quite a while. you need to install the remaining features. For each of these steps, fire up the software installation dialog by clicking Install New Software... from the Help menu.

1. From the Juno Kepler update site (should already be in the Work with list), choose the following components:
   
   1. Xpand SDK
   2. Xtext SDK
   3. Xtend SDK
   4. Graphical Editing Framework Zest Visualization Toolkit SDK
   5. JAX-WS Tools
   6. MWE 2 language SDK
   7. MWE 2 runtime SDK
   8. MWE SDK
   9. EMF Compare SDK
   10. Graphiti SDK Plus (Incubation)
   11. Graphical Modeling Framework (GMF) Notation SDK
   12. Graphical Modeling Framework (GMF) Tooling SDK
   13. Optional: Subversive SVN Team Provider (You will be prompted to install a Subversive Connector upon restarting Eclipse. SVN Kit 1.3.7 works fine.)
2. From the Itemis update site, install the following:
   
   1. Xtext Antlr SDK Feature
3. From the Checkstyle update site, install the following:
   
   1. Eclipse Checkstyle Plug-in
4. From the FindBugs update site, install the following:
   
   1. FindBugs Feature
5. From the Google Guava update site, install the following:
   
   1. Guava: Google Core Libraries for Java 1.5 - SDK (be sure to install version 10.0.1, since EMF Compare currently doesn't like newer versions; you will need to uncheck the Show only the latest version of available software checkbox to see older versions.)
6. SVG export functionality is based on the Batik Swing feature  from the Orbit update site. Make sure to install version 1.6 of the plug-in, not version 1.7.
7. If you want to work on KlighDning, from the Jetty update site, install the Jetty bundles (currently we are using version 8.x)
8. If you're interested in e4 application development, install the following from the e4 update site: (If you don't know what e4 application development is, odds are you won't need these.)
   1. Eclipse e4 Tools (Incubation)
   2. We originally also installed E4 CSS Spy (Incubation), but it installed keyboard shortcuts that somehow conflicted with Eclipse's built-in ones. This lead to common shortcuts such as Ctrl+Z and Ctrl+Space not working properly, which is why we don't install the CSS Spy for the time being.

After everything is installed, restart Eclipse and configure your installation according to our configuration guidelines.

Esoteric Dependencies

Some projects require a bunch of more esoteric dependencies. For each one of them, make sure you actually work with a given project and then install the required dependencies only if necessary. Note: This list has not yet been updated for Eclipse 4.2.1. If this doesn't work, find an adult!

1. Some plug-ins require Papyrus to be installed, which is available via the Indigo update siteyou should probably simply google for.