OpenGeo Suite Community Edition on Amazon Web Services

OpenGeo has released the OpenGeo Suite Community Edition 2.1.3 for Amazon EC2. Linux (Ubuntu 9.10) and Windows (Server 2003) versions are available as public AMIs (Amazon Machine Instance) ready for deployment on Amazon Web Services. The OpenGeo Suite AMIs simplify deploying web mapping applications by providing a complete environment. When an instance is launched the OpenGeo Suite is ready to serve maps and data on the web.

The Community Edition Suite AMIs are built on S3 boot images, which provide the lowest cost of operation. Note that AMIs based on S3 boot images will loose all data and changes you have made if the instance is terminated. To ensure that data and applications are saved you can add an Elastic Block Storage (EBS) Volume to store your data—this is not included with the OpenGeo Suite Community Edition AMIs.

The first part of this article describes how to obtain security credentials if you are new to Amazon Web Services. If you are already an AWS customer then log into the AWS console to launch the OpenGeo Suite AMIs as described further down.

First time Amazon Web Service EC2 Users

You will need an Amazon Web Services account. If you don’t have and account, the registration page will walk you through the process. If you already have an AWS account, you can skip this section and start at Launching the OpenGeo Suite instance using the AWS Management Console.

Once you have logged in, you will need to generate a set of security credentials to manage your account and your AMIs. You will need the following credentials:

  • Access Credentials: Your Private Keys, X.509 Certificates, and Key Pairs for managing your AMIs
  • Sign-In Credentials: Your E-mail Address, Password for managing your account
  • Account Identifiers: Your AWS Account ID

Creating a X.509 certificate and a Private Key

The X.509 Certificate and Private Key are used by the command line tools and SOAP. The X.509 certificate and Private Key are used when starting or stopping instances and when creating new AMIs. You can download the private key file once. If you lose it, you will need to create a new certificate. Up to two certificates can be active at any time.

  1. Log into the AWS Web Site.
  2. Click on Your Account and select Security Credentials
  3. Click the X.509 Certificates tabcreate-x509-cert
  4. Click Create a New Certificate and download the certificate and private key files.

x509-download

5. Create a .ec2 directory in your home directory, and save these files to it with the filenames offered by your browser.

Generate a Key Pair using the AWS Management Console

A key pair is used when logging into an Amazon EC2 instance.

  1. Log into the AWS Management Console and click on the Amazon EC2 tab
  2. Click on Key Pairs in the Navigation pane on the left.aws-console-keypair
  3. Click on Create Key Pair, enter a name, and click Createcreate-keypair
  4. The key pair will be downloaded automatically, keep the file in a safe place.download-keypair
  5. If you are using Linux, OS X, or any unix based OS, set the file permissions to be readable by you
$ chmod 600 my-keypair

Launching the OpenGeo Suite instance using the AWS Management Console

You can launch the OpenGeo Suite AMI using the Management Console using your security credentials.

  1. Log in the AWS Management Console and click the Amazon EC2 tab
  2. Click on AMIs in the Navigation side menu
  3. In the Amazon Machine Images pane, select Public Images and All Platforms in the drop down menus.
  4. Copy and paste the OpenGeo Suite image AMI ID into the text box and hit enter.Windows AMI: ami-ea1cf683
    Linux AMI: ami-041cf66d

    The selected instance is displayed below

    launching-ami

  5. To start or launch the instance, select the check box and click on the Launch button.
  • Enter 1 in the Number of Instances field.
  • Select the m1.small Instance Type option.
  • Select the Availability Zone, if desired.
  • Select the key pair that you created from the Key Pair Name list box.
  • Select default from the Security Groups list box.

The instance(s) begin launching.

pending-instance

Logging into the OpenGeo Suite Instance

This section describes how to log into the OpenGeo Suite instance from either the command line or through Windows RDP client. Before you can log into your instance you will need to find the Public DNS address for your instance. To find the Public DNS address in the AWS Console, click on Instances, select the check box for the instance, and copy the value for Public DNS in the panel below.

get-public-dns

Logging in from the command line for the OpenGeo Suite Linux instance

Using a ssh client on (such as OpenSSH, Xming, Putty) type:

$ ssh -Xi my-keypair ubuntu@ec2-174-129-184-64.compute-1.amazonaws.com
  • The -i option uses your key pair to authenticate (no passwords),
  • the -X option enables X11 forwarding which allows you to use the desktop tools of the OpenGeo Suite (if your ssh client supports trusted X11 forwarding, use the -Y option),
  • and the Linux version of the Suite on AWS is built on Ubuntu 9.10 which uses “ubuntu” as the default user.

Once your are logged into the Linux instance, you can launch the Dashboard to start the OpenGeo Suite by typing:

$ ./bin/opengeo-dashboard

Click on Getting Started in the Dashboard to begin serving maps and data on the web.

Logging into the OpenGeo Suite Windows instance through the Windows RDP Client

Getting the password for the Windows instance

The Windows instance of the OpenGeo Suite does not user key pairs. A new administrator password is generated each time a Windows instance is launched. You can retrieve the password using the AWS Console.

  1. Log in the AWS Management Console and click the Amazon EC2 tab
  2. Click on Instances in the Navigation side menu
  3. Click on the checkbox for the Windows instance
  4. Click on Instance Actions drop down and select Get Windows Admin Password get-windows-password
  5. A window will appear prompting you to paste the contents of your Private Key into a text box, paste your private keycopy-key-pair
    private-key
  6. The AWS Console returns a window with the Decrypted Password, copy the password and save it to a text file or write it down.windows-password

Logging into the OpenGeo Suite Windows instance

You can log into the Windows instance using an RDP Client (CoRD for OS X, rdesktop for linux, Remote Desktop Connection for Windows). This example users Remote Desktop Connection to connect to your OpenGeo Suite Windows EC2 instance:

  1. On the taskbar, click Start, point to Programs, point to Accessories, point to Communications, and click Remote Desktop Connection.
  2. The Remote Desktop Connection dialog box appears.
  3. Enter the Public DNS address in the Computer field.
  4. Enter ‘administrator’ in the User name field.rdc-login
  5. Enter the password in the Password field.rdc-password

After logging in, you can launch the Dashboard and start the OpenGeo Suite. Click on Getting Started in the Dashboard to begin serving maps and data on the web.

ogs-in-wndows

*Note: The OpenGeo Suite Community edition currently does not have an option to run as service in Windows. Logging off the instance will shutdown the Suite. To keep the Suite running, disconnect by clicking on the Close button at the top of the screen.

EmailTwitterFacebookGoogle+tumblrLinkedIn

14 thoughts on “OpenGeo Suite Community Edition on Amazon Web Services

  1. Is OpenGeo AMI generally tuned and optimized for performance, or you still need to configure yourself?

  2. The Community Edition AMI is the same build as the download. As with the download Community Edition, each user will have to optimize it for their application.

  3. I had to add RDP to the Security Group before I could remote desktop to my Windows instance.

  4. Is this web ready, in that it comes packaged with tomcat, i cannot restart my tomcat server, or do i need to install tomcat on amazonws? Anything else i am to install?

  5. Jude,

    This is web ready and uses jetty as the app server. Ubuntu desktop is installed on the linux AMI, so you if your ssh client supports X windows, just ssh -X -i your-keypair ubuntu@the.instance.public.address and the Dashboard, PGAdminIII and the shp2pgsl loader will be available to you. Of course, all these are available if you use the Windows AMI and access it through an RCP client. Everything is pre-installed and ready to use.

  6. Tried this today, and my first experience of the OpenGeo Suite. Really impressed, you’ve done a great job on bringing the OS stack together, and I think this is right up there with any Server based commercial offering…speaking of which, how much does this AMI cost to run? Is it just the standard AWS rates for OS and data transfer? What can I do with this AMI, is it just try before you buy? Just curious, excellent product.

    Rob

  7. Rob,

    We’ve released this as a public AMI that anyone can use and the cost is just the AWS rated for the OS and data transfer. You can also download the Community Edition to run on your own hardware/ISP. You can compare the difference between the Community and Enterprise Editions here: http://opengeo.org/products/suite/compare/ . In the future we will be releasing an Enterprise versions on Amazon. Currently, our partner Skygone offers the Enterprise version of the OpenGeo Suite on their cloud infrastructure.

  8. Hi,

    Thank you for the information. I tried using the windows AMI and was successful for the most part. I was not able to access the default public address through the internet with my defined security group for SSH(port 22), HTTP(port 80) and RDP(with port).

    Is there something I am missing here?

    I logged into the server and after starting the dashboard, I was able to access geoserver etc..( I had to change internet settings a bit before making it work) But then again, I am having the same question, why am I not able to access geoserver through the internet with my public name?

    Do I have to open any port to make it work?

    Thanks,
    Ravi.

  9. The ami you reference above (id=ami-041cf66d) does not appear to exist anymore in AWS. There are others listed with “opengeo” in their name (e.g id=ami-5005fd39). Are these “free” except for regular AWS instance charges?

    Thanks,

    Tim

  10. Hi,
    Is this AMI still existing? I have tried in vain to locate one that is windows based.

  11. For windows edition, this took me a little while to figure out. If you search just windows and the search is geo. I found three AMI with opengeo using EBS. So try searching for ami-27d77f4e

    The root device is EBS and according to the free tier, EBS at 30 Gib is free, so hopefully since the AMI is only 30 Gib, it doesn’t start to charge me.

    Free Tier
    30 GB of Amazon Elastic Block Storage, plus 2 million I/Os and 1 GB of snapshot storage*
    * These free tiers are only available to new AWS customers, and are available for 12 months following your AWS sign-up date. When your free usage expires or if your application use exceeds the free usage tiers, you simply pay standard, pay-as-you-go service rates (see each service page for full pricing details). Restrictions apply; seeoffer terms for more details.

  12. Can’t find ami-27d77f4e today. Plus a search of public AMIs, all platforms with keyword “geo” does not find OpenGeo. Is OpenGeo still available as a public AMI?

  13. Regarding my last post, just found the ami in the us-east region (we are in the us-west region).

Comments are closed.