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

Compare with Current View Page History

« Previous Version 22 Next »

Overview

This document will help new developers setup their Eclipse development environment to get started working with Cyberintegrator and eAIRS.

Development Environment

The development environment will consist of Eclipse and some plug-ins we will need to add to the default installation (e.g. Maven for dependency management).

Software

In this section, we will outline

  1. Installing Eclipse
  2. Installing m2e - Maven Integration for Eclipse
  3. Installing Graphical Editing Framework / Zest Library
  4. Installing Commons Logging 1.1.1
  5. Installing EGit
  6. Adding Git repositories and Importing the projects from Git into a workspace
  7. Updating Plug-in Classpath
  8. Checking out and Building eairs-cfd-tools project

Installing Eclipse:

  1. First, download Eclipse Juno here. Download Eclipse IDE for Jave EE Developers.
  2. Unzip the Eclipse download somewhere on your development machine, (e.g. C:\Eclipse)
  3. Launch Eclipse. When Eclipse first launches, it will ask you to specify a workspace (e.g. C:\Users(user-name)\workspaces\kisti). After specifying a workspace, you can check the box "Use this as the default and do not ask again" box so that eclipse will not ask you to specify the workspace again.
  4. After Eclipse loads for the first time, you will need to select the Go to workbench button located on the right right of your screen. The icon looks like an arrow.

Installing m2e - Maven Integration for Eclipse

  1. The Eclipse Jave EE download does not contain Maven integration plugins that we require so we will need to install it from the Eclipse Update Site. While in Eclipse, go to Help-> Install New Software. From the Drop down menu next to "Work with:" select Juno - http://download.eclipse.org/releases/juno
  2. Expand "General Purpose Tools" and select "m2e - Maven Integration for Eclipse". Click Next. Click Next again. Accept the license agreement and click Finish. Once the installation finishes you will need to restart eclipse.
  3. After restarting Eclipse, you might need to push the Go to workbench button again to bring the workbench back up.

Installing Graphical Editing Framework / Zest Library

  1. Next we need to install the Zest library that we require so we will need to install it from the Eclipse Update Site. While in Eclipse, go to Help-> Install New Software. From the Drop down menu next to "Work with:" select Juno - http://download.eclipse.org/releases/juno
  2. Expand "Modeling" and select "Graphical Editing Framework Zest Visualization Toolkit SDK". Click Next. Click Next again. Accept the license agreement and click Finish. Once the installation finishes you will need to restart eclipse.
  3. After restarting Eclipse, you might need to push the Go to workbench button again to bring the workbench back up.

Installing Commons Logging 1.1.1

  1. Next we need to install the org.apache.commons.logging version 1.1.1 that we require so we will need to install it from the Eclipse Orbit Site. While in Eclipse, go to Help-> Install New Software. This time, we need to add a site so click the Add... button. For name, give it "Eclipse Orbit" and for location use "http://download.eclipse.org/tools/orbit/downloads/drops/R20120526062928/repository/" and click Ok. It should be added to the list of sites in the drop down next to "Work with: ", select it.
  2. Expand "All Orbit Bundles" and select "Apache Commons Logging Plug-in". Click Next and then click Finish. Once the installation finishes you will need to restart eclipse.
  3. After restarting Eclipse, you might need to push the Go to workbench button again to bring the workbench back up.

Installing EGit

  1. Next we need to install the EGit library that we provides Git support for Eclipse. To install it, go to Help-> Install New Software. From the Drop down menu next to "Work with:" select Juno - http://download.eclipse.org/releases/juno
  2. Expand "Collaboration" and select "Eclipse EGit". Click Next. Click Next again. Accept the license agreement and click Finish. Once the installation finishes you will need to restart eclipse.
  3. After restarting Eclipse, you might need to push the Go to workbench button again to bring the workbench back up.

Adding Git repositories and Importing the projects from Git into a workspace

There are 3 Git repositories where the Cyberintegrator source is maintained. This section will describe how to check out each repository to your workspace.

  1. First, we will import ncsa-common.git. To do this, go to File > Import > Git > Projects from Git. Click Next.
  2. Select URI and click Next. See image below:
  3. Copy and Paste https://opensource.ncsa.illinois.edu/fisheye/git/ncsa-common.git into the URI field and it will auto-complete the rest. Click Next. See image below:
  4. Make sure master is checked and click Next. See image below:
  5. It is suggested that you change the destination of the checked out project to be inside the workspace so in the future you could work with multiple versions in different workspaces. It keeps checked out projects more organized so you know the workspace that the project belongs to. If you created your workspace in the previous steps at C:\Users(user-name)\workspaces\kisti then we suggest you make the destination: C:\Users(user-name)\workspaces\kisti\git\ncsa-common. See the image below for my settings. Everything else can be left as the default. Click Next.
  6. You can leave the defaults. Yours should look similar to the image below. Click Next.
  7. Make sure all projects are selected (similar to the image below) and click Finish.

After you checkout the first repository, your project may take some time to checkout Maven dependencies and attempt to build the workspace. Once this is finishes, you can proceed with the next repository. The only differences will be in step 3 (the repository URI) and in step 5 (where you put the repository projects).

  1. The next repository to checkout is cyberintegrator.git. To check it out, go back to File > Import > Git > Projects from Git. Click Next.
  2. Select URI and click Next.
  3. Copy and Paste https://opensource.ncsa.illinois.edu/fisheye/git/cyberintegrator.git into the URI field and it will auto-complete the rest. Click Next.
  4. Make sure master is checked and click Next.
  5. As with the previous project, we want to change the destination of the project to be inside the workspace. Make the destination for this repository as: C:\Users(user-name)\workspaces\kisti\git\cyberintegrator. All other settings are the same as the previous step 5 image. Click Next.
  6. You can leave the defaults as they are. Click Next.
  7. Make sure all projects are selected except for dataset-rcp and click Finish.

As with the previous, this will take some time to checkout and build since it will begin downloading maven dependencies. Let this process finish and then move on to the final repository.

  1. The last repository to checkout is paw.git. To check it out, go back to File > Import > Git > Projects from Git. Click Next.
  2. Select URI and click Next.
  3. Copy and Paste https://opensource.ncsa.illinois.edu/fisheye/git/paw.git into the URI field and it will auto-complete the rest. Click Next.
  4. Make sure master is checked and click Next.
  5. As with the previous project, we want to change the destination of the project to be inside the workspace. Make the destination for this repository as: C:\Users(user-name)\workspaces\kisti\git\paw. All other settings are the same as the previous step 5 image. Click Next.
  6. You can leave the defaults as they are. Click Next.
  7. Make sure all projects are selected and click Finish.

As with the previous two repositories, let the the workspace download it's maven dependencies and finish building before moving on to the next section, Runing Cyberintegrator.

Updating Plug-in Classpath

If you see an error in cyberintegrator-rcp ImportDatasetWizard.java saying that it cannot find the Logger class, you will need to fix the .classpath of the spring-libraries project. It is a known issue when combining Eclipse and Maven where both try to manage the classpath. To fix the issue, do the following:

  1. Right click on spring-libraries and select Plug-in Tools > Update Classpath...

If you ever have to perform a Maven > Update Project or Run as > Maven Install on spring-libraries, then you will need to fix the classpath by performing the action Plug-in Tools > Update Classpath.

Checking out and Building eairs-cfd-tools project

This section hasn't been updated yet.

Running Cyberintegrator

In this section, we will outline:

  1. Launching Cyberintegrator
  2. Importing eAIRS Java tools into Cyberintegrator
  3. Importing eAIRS HPC Tool into Cyberintegrator

Launching Cyberintegrator

To launch Cyberintegrator, do the following:

  1. Expand the project cyberintegrator-rcp
  2. Double click on Cyberintegrator.product to open the Product view
  3. Under the Testing section, click the link Launch an Eclipse Application

When Cyberintegrator finishes launching, you should see an image similar to the one below:

Importing eAIRS Java tools into Cyberintegrator

Importing eAIRS HPC Tool into Cyberintegrator

  • No labels