← Back to branch summary

~ps10gel/ubuntu/xenial/trafficserver/6.2.0

« back to all changes in this revision

Viewing changes to README-EC2

  • Committer: Bazaar Package Importer
  • Author(s): Arno Toell
  • Date: 2011-01-13 11:49:18 UTC
  • Revision ID: james.westby@ubuntu.com-20110113114918-vu422h8dknrgkj15
Tags: upstream-2.1.5-unstable
Import upstream version 2.1.5-unstable

Show diffs side-by-side

added added

removed removed

Lines of Context:
README-EC2
 
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 beeen 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!