Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 135 lines (109 sloc) 5.204 kB
0c8fba4 @zwoop Change these two bad boys from DOS line feeds to real one...
zwoop authored
1 Apache TrafficServer AMIs for EC2
2 Author: Jason Giedymin
3
4 --TOC--
5 1.0 Ubuntu Based Images
6 1.1 Ubuntu AMI Details
7 1.2 What is installed?
8
9 2.0 Fedora Based Images
10 2.1 Fedora AMI Details
11 2.2 What is installed?
12
13 3.0 The ATS Installation
14 3.1 Additional Update Functionality
15 3.2 User customized settings
16 3.3 Script Breakout
17
18 4.0 FAQ
19 4.1 I use EC2 and I'm still confused!?
20 4.2 What is EC2?
21 4.3 I don't use EC2 or have an AWS account, can I still use these scripts on
22 my Virtual Machine or dedicated Ubuntu/Fedora Linux Box?
23 4.4 How do I contact you for help?
24 4.5 Will these AMIs be updated in the future?
25
26 -------
27
28 1.0 Ubuntu Based Images
29 This is the prefered image as Ubuntu is kept up to date by Canonical.
30
31 1.1 Ubuntu AMI Details
32 Name: Amuxbit-Karmic-ApacheTrafficServer-AMI
33 x86_64 AMI: ami-ada24cc4, kernel: aki-fd15f694, Ramdisk: ari-7b739e12
34 i386 AMI: ami-5ba34d32, kernel: aki-5f15f636, Ramdisk: ari-d5709dbc
35
36 1.2 What is installed?
37 All packages other than Apache TrafficServer are from the ec2 ubuntu
38 package repositories. All software installed should be open source.
39 * Official Canonical Ubuntu Karmic 9.10 EC2 AMI
40 * Dist Upgraded as of 4/1/2010
41 * Apache TrafficServer - Trunk (can be updated at any time)
42 * openjdk-6-jre (for ec2 tools)
43 * ruby (for ec2 tools)
44 * libopenssl-ruby (for ec2 tools)
45 * Apache2 (httpd, used for testing)
46
47 2.0 Fedora Based Images
48
49 2.1 Fedora AMI Details
50 Name: Amuxbit-Fedora8-ApacheTrafficServer-AMI
51 x86_64 AMI: ami-c3a04eaa, kernel: aki-a3d737ca, Ramdisk: ari-7cb95a15
52 i386 AMI: ami-53a04e3a, kernel: aki-6eaa4907, Ramdisk: ari-42b95a2b
53
54 2.2 What is installed?
55 All packages other than Apache TrafficServer are from the ec2 fedora
56 package repositories. All software installed should be open source.
57 * Official Fedora Core 8 EC2 AMI
58 * Dist Upgraded as of 4/1/2010
59 * Apache TrafficServer - Trunk (can be updated at any time)
60 * java-1.7.0-icedtea (openjdk for ec2 tools)
61 * openssl-devel (for ec2 tools)
62 * ruby (for ec2 tools)
63 * httpd (Apache web server, used for testing)
64
65 3.0 The ATS Installation
66 Apache Traffic Server is installed in: '/ats'.
67 The installation script used to install ATS is contained within the contrib
68 directory, part of the ATS source distribution. The script is included
69 within the '/ats' folder for actual use.
70
71 3.1 Additional Update Functionality
72 The EC2 images provided contain additional scripts to maintain freshness
73 of the install scripts. At one time the scripts provided 'auto-heal'
74 functionality but that has been removed. Running /ats/install_update.sh
75 will keep the ATS installation up to date.
76
77 3.2 User customized settings
78 Any customized settings will be lost if the update/install scripts are run.
79 Upon executing the install/update scripts you may copy your files back into
80 the config directory. Users should periodically backup your config files,
81 and keep abrest of any config changes as new versions of ATS are released.
82 The latter reason being why I did not auto-copy configs. While I've tried
83 to lessen as much pain for any Sys Admins, ultimately you must take charge
84 of these critical settings as updates will and do happen frequently to the
85 ATS source.
86
87 An example script which alters settings can be found in
88 '/ats/contrib/set_trafficserver.sh'
89 This has been used on the AMIs already provided.
90
91 3.3 Script Breakout
92
93 ats
94 |-- contrib
95 | -- install_trafficserver.sh : installs ATS. Try not to run this directly.
96 | -- set_trafficserver.sh : sample config/testing/benchmark base script.
97 You may want to learn from/use this script.
98 ` -- update_scripts.sh : used to update install_trafficserver.sh,
99 and set_trafficserver.sh from trunk.
100 |-- install_update.sh : the 'easy button' script to re-install ATS.
101 Executes update_scripts.sh, then install_trafficserver.sh.
102 This is what you want to run.
103 `-- readme : extra information.
104
105 4.0 FAQ
106
107 4.1 I use EC2 and I'm still confused!?
108 With your EC2 account, refer to one of the AMIs listed in this doc
109 (Ubuntu/Fedora). Image architectures provided are i386, and x86_64.
110 64bit is offered for those who need to spin up a big high powered instances.
111 Once running (and it may take a while) you will find yourself with a Linux
112 distribution with Apache Traffic Server already installed. If you'd like
113 to re-install ATS against trunk, run '/ats/install_update.sh'. Note that
114 you will have to backup and/or optimize your configuration (see 3.2).
115 To further setup ATS see the TrafficServer wiki @
116
117 http://cwiki.apache.org/confluence/display/TS/
118
119 4.2 What is EC2?
120 See http://aws.amazon.com/
121
122 4.3 I don't use EC2 or have an AWS account, can I still use these scripts on
123 my Virtual Machine or dedicated Ubuntu/Fedora Linux Box?
124 Absolutely! The /contrib scripts are actually meant for Ubuntu/Linux
125 Installs first, EC2 second. You can find them on the ATS SVN/Git
126 repository under '/contrib'.
127
128 4.4 How do I contact you for help?
129 For mailing lists, and IRC information, visit our web page at
130
131 http://trafficserver.apache.org/
132
133 4.5 Will these AMIs be updated in the future?
134 Absolutely!
Something went wrong with that request. Please try again.