Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 17 Next »

You have two choices here: either work on our server, or install Eclipse on your own computer.

Working on Our Server

Using one of the SunRay  thin clients found all over the place, you can use the reference  installation of Eclipse on our server. Just log in and start Eclipse  using the following command line:

   /home/java/eclipse/eclipse

This  will always point to the current reference installation. Feel free to  setup a link on your desktop to avoid having to start the console every  time.

Installing Eclipse on Your Own Computer

If you want to install Eclipse on your own computer, just expand the installation guide below. Note that you need at least Java 1.5 to run and use Eclipse and KIELER. On Windows, double-click the eclipse.exe found in the installation directory. On Linux, execute the eclipse executable found in the installation directory.

The first step in getting your own Eclipse installation is to download Eclipse Juno 4.2.1 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 of the features required for KIELER development. 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. For each of these steps, fire up the software installation dialog by clicking Install New Software... from the Help menu.

  1. From the Juno 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. From the Jetty update site, install the Jetty bundles (currently we are using version 8.x)
  7. 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. Required for KEV: Install the missing Batik Swing plug-in from the Orbit update site. Make sure to install version 1.6 of the plug-in, not version 1.7.
  2. Some plug-ins require Papyrus to be installed, which is available via the Indigo update site.

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:

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

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

  • No labels