The first step in getting your own Eclipse installation is to download Eclipse Indigo 3Luna 4.74.21 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 you need 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, except for the Eclipse Modeling Tools – your Eclipse download already had them.

6. Make sure to disable the check box Install latest version of selected software. This might seem silly, but some of the plug-ins you're about to install don't play well with the latest versions of other plug-ins you're about to install.

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

8. 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.

9. 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.

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:

. For each of these steps, fire up the software installation dialog by clicking Install New Software... from the Help menu.

1. From the Luna update site (should already be in the Work with list), choose the following components:
   1. Xtext Complete SDK
   2. MWE 2 language SDK
   3. MWE 2 runtime SDK
2. If you are going to be working in the Semantics project, you may also have to install the following from the Luna update site:
   
   1. Xpand SDK
      
   2. MWE SDK

Now open up the Eclipse Marketplace from the Help menu and install the following plug-ins:

1. Checkstyle Plug-in
2. FindBugs Eclipse Plugin

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

If you are in charge of creating a new reference target platform, make sure to consider the below.

Optional 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.

1. Some plug-ins use the Graphiti framework, which can be installed from this update site.
2. Required for KEV: Install the missing Batik Swing plug-in 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.The ...kiml.zest plug-in depends on the Zest Visualization Toolkit SDK, which can be found on the Indigo update site..
3. If you want to work on the Graphiti integration of KIELER Layout, install the Graphiti SDK Plus  from the Kepler update site.
4. If you want to work on KlighDning , install the Jetty bundles from the Jetty update site. Currently we are using version 8 (which should be included in the Luna Release).
5. If you want to work on KWebS , install the JAX-WS Tools from the Kepler update site.
6. 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.
7. If you use some code from Subversion repositories, install the Subversive SVN Team Provider from the Kepler update site. You will be prompted to install a Subversive Connector upon restarting Eclipse; select one that fits to your installed SVN version. KIELER does not use Subversion anymore.
8. Some plug-ins require Papyrus to be installed, which is available via the Indigo update site.you should probably simply google for.
9. Some deprecated dependencies (we don't work with these frameworks anymore):
   1. Graphical Editing Framework Zest Visualization Toolkit SDK
   2. Graphical Modeling Framework (GMF) Notation SDK
   3. Graphical Modeling Framework (GMF) Tooling SDK

Memory Problems

Regardless of the two methods you've decided on following, Eclipse may well run into problems due to lack of memory. If so, navigate to your installation directory, open eclipse.ini, and edit it to contain the following lines:

--launcher.XXMaxPermSize 256M
--launcher.XXPermSize 64M
-Xmn128m
-Xmx768m

For more information about what these settings to, see this page.