Chapter 14: Running EnterMedia on Amazon EC2

From Amazon EC2's web site: "Amazon Elastic Compute Cloud (Amazon EC2) is a web service that provides resizable compute capacity in the cloud. It is designed to make web-scale computing easier for developers".

EnterMedia is EC2-ready, which means that you can have your own Amazon EC2 server running EnterMedia in no more than 10 minutes!

This document will guide you through the process of starting your EnterMedia-EC2 server. The steps and images in this guide were taken from a Linux PC running Gnome, although everything in here should work for any Mac and Linux Desktop. Do not hesitate to post your questions or problems into our Developer Community.

The only requisites for running this is guide is basic Linux (or Mac) and EC2 knowledge.

Launch an EnterMedia instance

We have prepared and shared an Ubuntu Linux Operating System Image (AMI) ready for running EnterMedia. It is basically an Ubuntu 9.04 Jaunty installation, part of the Alestic series, with all the software needed by EnterMedia:

• Java 6 (OpenJDK)
• Resin 3.1.9
• FFMpeg
• Lame
• ExifTool
• ImageMagick

To run an instance of this image:

1. Go to the Amazon Web Services web site: http://aws.amazon.com/
2. Go to the AWS Management Console.
3. Select "EC2" as the desired console.
4. Login with your Amazon user name and password.
5. Go to the "AMIs" section.
6. You will get to the AMIs screen.
7. In the "viewing" filters select "EBS Images" in the first dropdown and enter "entermedia" in the text box.
8. Right click the latest version of our AMI and select "Lauch instance".
9. Enter the number of instances (servers) you want to run and select an available key pair (Note: you will need the certificate file for this key pair to log into your server later.) Then select one or more security groups for this group (Note: you will need to allow traffic on port 80 to reach the web server.)
10. Click on "Close" and wait for the server to start.
11. You can check the server status in the "Instances" screen. After the server has started, it might take one more minute for the Resin web server to start.
12. From the "Instances" screen, copy the "Public DNS" field of your new instance and paste it into your browser's address bar. You should get a "Test Page" message.
13. Now open a terminal in your computer and access your new server through SSH. You can do that with "ssh -i <certificate_file> root@<public_dns>".
14. Once you're in, you can run "sh installEM.sh" to download and install the last version of EnterMedia into your server.
15. This script will download, uncompress, deploy EnterMedia and restart the web server. Once it's done wait one minute for the web server to start again.
16. Browse your web server again (using your public DNS name) and voila! EnterMedia is running and ready to be used. As usual, you can log in with the username of admin and password admin. We strongly recommend you to change this password as soon as possible.
17. For your site to work properly, you will need to set the siteRoot property. To do it, got to the file manager and select your root _site.xconf file.
18. Look for the siteRoot property and replace demo.entermediasoftware.com with your instance's public DNS name.