Skip to end of metadata
Go to start of metadata

Apache TrafficServer AMI for EC2

Provided for public consumption by Jason Giedymin.

Official ATS AMIs exist for Ubuntu 10.10, 10.04 LTS, 9.10 and Fedora Core 8.

AMI cliff notes:

Official EC2 AMIs

Icon

UPDATE! : As of 12/09/2010 the Images are temporarily Off-line and not accessible. Working on restoring them and easier alternatives to getting users up and running with ATS on EC2. Stay tuned.

AMIs last tested 11/09/2010.

For issues and concerns please see the ApacheTrafficServer mailing list.

Ubuntu 10.04 LTS Lucid AMIs

Icon

The LTS of Ubuntu is recommended for stability. As of this moment the latest recommended kernels are:

  • recommended 32bit AKI: aki-6603f70f
  • recommended 64bit AKI: aki-6a0cf803

It is not advisable to be running on anything older for security reasons. See the EC2/Amazon support forums for more information.

Quick Start

Icon
  • Spin up the desired AMI, which as of 11/09/2010 is running Apache TrafficServer TRUNK.
  • Apache TrafficServer should already be started. Refer to the necessary .config files for current settings.
  • Apache TrafficServer EC2 specific scripts are located at /ats/contrib (merging into trunk is underway)
  • On Ubuntu, start and stop ATS by typing "service trafficserver start" or "service trafficserver stop".
  • Run /ats/install_update.sh if you would like to re-install Apache TrafficServer to the latest trunk.
  • For EC2, the TrafficServer cache is set to /mnt/trafficserver_cache @ 100GB which is ephemeral.
  • See /ats/contrib/set_trafficserver.sh for tips on tuning Apache TrafficServer for EC2.

A breakout of the image details are below:

EC2 AMIs

Ubuntu 10.10 (i386)

Ubuntu 10.04 (i386)

Ubuntu 9.10 (i386)

Ubuntu 9.10 (x86_64)

AMI

ami-d0d92eb

ami-3ed92e57

ami-7f38d616

ami-7938d610

AKI

aki-407d9529

aki-6603f70f

aki-5f15f636

aki-fd15f694

ARI

N/A

N/A

ari-d5709dbc

ari-7b739e12

EC2 AMIs

Fedora 8 (i386)

Fedora 8 (x86_64)

AMI

ami-2138d648

ami-5338d63a

AKI

aki-6eaa4907

aki-a3d737ca

ARI

ari-42b95a2b

ari-7cb95a15


1.0 Ubuntu Based Images

This is the prefered image as Ubuntu is kept up to date by Canonical. LTS releases are highly recommended.

1.1 Ubuntu AMI Details

Name: Amuxbit-Lucid-ApacheTrafficServer-AMI
10.04 LTS Images provided for i386 and x86_64. See the cliff notes chart for details.

Name: Amuxbit-Maverick-ApacheTrafficServer-AMI
10.10 Images provided for i386 and x86_64. See the cliff notes chart for details.

1.2 What is installed?

All packages other than Apache TrafficServer are from the ec2 ubuntu package repositories. All software installed should be open source.

  • Official Canonical Ubuntu Karmic 9.10 EC2 AMI
  • Dist Upgraded as of 4/1/2010
  • Apache TrafficServer - Trunk (can be updated at any time)
  • openjdk-6-jre (for ec2 tools)
  • ruby (for ec2 tools)
  • libopenssl-ruby (for ec2 tools)
  • Apache2 (httpd, used for testing, you can uninstall it if you wish)

2.0 Fedora Based Images

Uses an older kernel but still compatible with ATS.

2.1 Fedora AMI Details

Name: Amuxbit-Fedora8-ApacheTrafficServer-AMI
Images provided for i386 and x86_64. See the cliff notes chart for details.

2.2 What is installed?

All packages other than Apache TrafficServer are from the ec2 fedora package repositories. All software installed should be open source.

  • Official Fedora Core 8 EC2 AMI
  • Dist Upgraded as of 4/1/2010
  • Apache TrafficServer - Trunk (can be updated at any time)
  • java-1.7.0-icedtea (openjdk for ec2 tools)
  • openssl-devel (for ec2 tools)
  • ruby (for ec2 tools)
  • httpd (Apache web server, used for testing, you can uninstall it if you wish)

3.0 The ATS Installation

Apache Traffic Server is installed in the directory: /ats
The installation script used to install ATS is contained within the contrib directory, part of the ATS source distribution. I've included this within the /ats directory.

3.1 Additional Update Functionality

The EC2 images provided contain additional scripts to maintain freshness of the install scripts. At one time I had them set to provide 'auto-heal' functionality but have since removed them. By running /ats/install_update.sh you can keep your ATS install up to date.

3.2 User customized settings

Any customized settings will be lost if you use the update/install scripts. Upon executing the install/update scripts you may copy your files back into the config directory. Users should periodically backup your config files, and keep abrest of any config changes as new versions of ATS are released. The latter reason being why I did not auto-copy configs. While I've tried to lessen as much pain for any Sys Admins, ultimately you must take charge of these critical settings as updates will and do happen frequently to the ATS source.

An example script which alters settings can be found in /ats/contrib/set_trafficserver.sh
This has been used on the AMIs already provided.

3.3 ATS Directory Breakout

4.0 FAQ

4.1 I use EC2 and I'm still confused!?

With your EC2 account, refer to one of the AMIs listed in this doc (Ubuntu/Fedora). Image architectures provided are i386, and x86_64. 64bit is offered for those who need to spin up a big high powered instances. Once running (and it may take a while) you will find yourself with a Linux distribution with Apache Traffic Server already installed. If you'd like to re-install ATS against trunk, run /ats/install_update.sh. Note that you will have to backup and/or optimize your configuration (see 3.2). To further setup ATS see the TrafficServer wiki @ http://incubator.apache.org/trafficserver/

4.2 What is EC2?

See http://aws.amazon.com/

4.3 I don't use EC2 or have an AWS account, can I still use these scripts on my Virtual Machine or dedicated Ubuntu/Fedora Linux Box?

Absolutely! The /contrib scripts are actually meant for Ubuntu/Linux Installs first, EC2 second. You can find them in the ATS SVN/Git repository under /contrib.

4.4 How do I contact you for help?

For mailing lists, and IRC see http://incubator.apache.org/trafficserver

4.5 Will these AMIs be updated in the future?

Absolutely! jasong is currently the owner of these images.

4.6 Will you provide EBS bootable root device images?

No EBS images are planned but that doesn't mean you cannot take the existing instance-store variant and use it to roll your own EBS backed AMI.

5.0 Other Guides, Blog Posts, Tweets, news about EC2+ATS

Thanks for reading!

  1. Anonymous

    These AMIs are very old, right? I can't find them on EC2.