/
README-EC2
134 lines (109 loc) · 5.24 KB
/
README-EC2
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
Apache TrafficServer AMIs for EC2
Author: Jason Giedymin
--TOC--
1.0 Ubuntu Based Images
1.1 Ubuntu AMI Details
1.2 What is installed?
2.0 Fedora Based Images
2.1 Fedora AMI Details
2.2 What is installed?
3.0 The ATS Installation
3.1 Additional Update Functionality
3.2 User customized settings
3.3 Script Breakout
4.0 FAQ
4.1 I use EC2 and I'm still confused!?
4.2 What is EC2?
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?
4.4 How do I contact you for help?
4.5 Will these AMIs be updated in the future?
-------
1.0 Ubuntu Based Images
This is the prefered image as Ubuntu is kept up to date by Canonical.
1.1 Ubuntu AMI Details
Name: Amuxbit-Karmic-ApacheTrafficServer-AMI
x86_64 AMI: ami-ada24cc4, kernel: aki-fd15f694, Ramdisk: ari-7b739e12
i386 AMI: ami-5ba34d32, kernel: aki-5f15f636, Ramdisk: ari-d5709dbc
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)
2.0 Fedora Based Images
2.1 Fedora AMI Details
Name: Amuxbit-Fedora8-ApacheTrafficServer-AMI
x86_64 AMI: ami-c3a04eaa, kernel: aki-a3d737ca, Ramdisk: ari-7cb95a15
i386 AMI: ami-53a04e3a, kernel: aki-6eaa4907, Ramdisk: ari-42b95a2b
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)
3.0 The ATS Installation
Apache Traffic Server is installed in: '/ats'.
The installation script used to install ATS is contained within the contrib
directory, part of the ATS source distribution. The script is included
within the '/ats' folder for actual use.
3.1 Additional Update Functionality
The EC2 images provided contain additional scripts to maintain freshness
of the install scripts. At one time the scripts provided 'auto-heal'
functionality but that has beeen removed. Running /ats/install_update.sh
will keep the ATS installation up to date.
3.2 User customized settings
Any customized settings will be lost if the update/install scripts are run.
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 Script Breakout
ats
|-- contrib
| -- install_trafficserver.sh : installs ATS. Try not to run this directly.
| -- set_trafficserver.sh : sample config/testing/benchmark base script.
You may want to learn from/use this script.
` -- update_scripts.sh : used to update install_trafficserver.sh,
and set_trafficserver.sh from trunk.
|-- install_update.sh : the 'easy button' script to re-install ATS.
Executes update_scripts.sh, then install_trafficserver.sh.
This is what you want to run.
`-- readme : extra information.
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://cwiki.apache.org/confluence/display/TS/
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 on the ATS SVN/Git
repository under '/contrib'.
4.4 How do I contact you for help?
For mailing lists, and IRC information, visit our web page at
http://trafficserver.apache.org/
4.5 Will these AMIs be updated in the future?
Absolutely!