Skip to main content
Jump to: navigation, search

G-Eclipse/AWS Cloud Getting Started

AMI Data

Here you find the meta data about the AMI Images in order to run the examples. These data are updated frequently by the g-Eclipse team.

Date 2009-10-11
AMI ID ami-ff46a796
Manifest 07qbcc8v0tc3nzpsa002.equinox/equinox-001.manifest.xml
Instance Type >= m1.small (32 bit)
Architecture x86
Visibility public


  1. If you are using Cloud Computing services provided by Amazon, you need to get an account there. The account itself is free of charge, but you have to pay with your credit card for the services that you are using. You can sign up for an account on this web portal:
  2. In order to use your account for a certain service (e.g. the storage service S3, or the computing service EC2) you have enable your account for each particular service and activate it in the portal above.
  3. For authentication and authorization against the AWS web services, g-Eclipse uses the Access Key ID and the Secret Access Key. Both can be obtained from the portal above in the Access Identifiers section.

And how do I start?


  1. Any Eclipse 3.4 will do as a starting point. If you want to start with the bare minimum, download an Eclipse Platform archive from
  2. Use p2 to install the g-Eclipse features by adding as repository URL
    1. g-Eclipse (Incubation) - this is the main feature and always required
    2. g-Eclipse Amazon Webservice Integration - this feature contains the connection layer that is required to access AWS plus some additional components
  3. Re-start Eclipse and switch to the g-Eclipse (User) perspective (important!)


Create a new Grid project

  1. Select New > Grid Project
  2. In the wizard, enter the name of the project, e.g. 'AWS Project'
  3. On the next wizard page you need to create a VO. The concept of a Virtual Organization (VO) is one of the central pieces in g-Eclipse. Creating a VO is pretty straightforward: Click on 'Edit VOs...', choose 'add', select 'AWS VO' (obviously this is the type of VO that we want to use), give it a name (e.g. ('My AWS VO') and enter your AWS Access ID (see Prerequisites above).
  4. Now you can press Finish and let the wizard create your Grid project.


After the initial setup and the Grid project creation you can start browsing your newly created project. In the Grid Projects View on the left you will find some directories that the wizard created for you, plus an additional virtual folder that represents your VO. Depending on your Grid middleware (in our case it is the AWS Cloud), you will find different nodes within this folder. In any case, you will find

  • Computing - that lists the currently running virtual computers, i.e. EC2 instances
  • Services - a list of additional services, such as Images that represent AMI's (comparable to a raw disk image with some meta data that can be instantiated), Elastic IPs, Keypairs that are used to access a newly started image by SSH, Security Groups that act as a simple firewall.
  • Storage - with a subfolder S3 that gives you access to the storage service and lets you mount and create S3 buckets

The first time that you are opening the subfolders in the VO-tree, you will be asked to authorize yourself and to create an authentication token. g-Eclipse automates this process and asks you for your Secret Access Key. in progress

Install and Run an OSGi Example

  • create keypair
  • create some additional security groups that allow connections to other ports than 22/SSH (required: 80 for the tomcat, and 8021 for telnetting to the OSGi console of the image below - possible security hole!)
  • start an image (AMI ID: ami-ff46a796 - 32bit Linux image, >= Small (m1.small) )
    • create launch configuration
    • use keypair
    • add security groups
  • add private key to SSH configuration!
  • use g-Eclipse SSH Terminal and login as root
  • the Tomcat
    • is listending on port 8180 but gets redirected to port 80 via iptables
    • /var/lib/tomcat5.5 is the directory to go
    • in /var/lib/tomcat5.5/webapps/ROOT/WEB-INF/... lives the Equinox Servlet Bridge
    • serves the p2 repository for the RAP demonstration application as well
  • the OSGi console
    • can be accessed with "telnet localhost 8021"
    • you can use the standard commands including p2 specific commands to hot-deploy new applications
      • provlr, provlar, provlp, provlg are quite handy

With these commands you can add the p2 repositories for the demo application

provaddrepo http://localhost/clouddemo
provaddartifactrepo http://localhost/clouddemo

What can be installed?

provlg http://localhost/clouddemo

Into which profile


Now: hot deploy something!

provinstall profile
start org.eclipse.rap.demo

...and disconnect


Unfortunately there is currently a problem with this demo application that requires a restart of the Tomcat before it can be accessed.

/etc/init.d/tomcat5.5 restart

Now you can access the new running Equinox application by using your webbrowser:

Back to the top