| Apache Traffic Server |
| |
| Traffic Server is a high-performance building block for cloud services. |
| It's more than just a caching proxy server; it also has support for |
| plugins to build large scale web applications. |
| |
| 1. DIRECTORY STRUCTURE |
| |
| traffic/ ............... top src dir |
| |-- cop ................ traffic_cop application |
| |-- doc/ ............... generated documentation |
| |-- example/ ........... example plugins |
| |-- install/ ........... installation programs and scripts |
| |-- iocore/ ............ IO core |
| |-- lib/ ............... |
| |-- ts/ ............ Base / core library |
| |-- tsconfig/....... New config parser and library (experimental) |
| |-- records/ ....... library for config files |
| |-- m4/ ................ custom macros for configure.ac |
| |-- mgmt/ .............. Management server and tools (including traffic_manager) |
| |-- cli ............ Command line utilities and API |
| |-- proxy/ ............. HTTP proxy logic |
| |-- test/ .............. functional tests |
| |-- .indent.pro ........ indent profile for coding style |
| |-- emacs-style ........ emacs style definition |
| |-- README ............. intro, links, build info |
| |-- README-EC2 ......... info on EC2 support |
| |-- REVIEWERS .......... (incomplete) list of areas with committer interest |
| |-- LICENSE ............ full license text |
| |-- NOTICE ............. copyright notices |
| |-- configure.ac ....... autoconf configuration |
| `-- Makefile.am ........ top level automake configuration |
| |
| |
| 2. REQUIREMENTS |
| This section outlines different OS distributions |
| |
| Fedora 11,12, 13, 14, 15: |
| autoconf |
| automake |
| libtool |
| gcc-c++ |
| glibc-devel |
| openssl-devel |
| tcl-devel |
| expat-devel |
| pcre |
| libcap-devel |
| |
| Fedora 8 EC2 (Kernel: 2.6.21.7-2.ec2.v1.2.fc8xen): |
| FC8 on EC2 requires unique configure declarations, please see that section |
| below. |
| |
| NOTE: Alternately you may use the install scripts in 'contrib' which |
| automate this or use the pre-built public Fedora Core 8 EC2 AMI |
| with ATS installed. Both of which are HIGHLY RECOMMENDED. |
| See 'README-EC2' for further details. |
| |
| Install these packages: |
| autoconf |
| automake |
| libtool |
| gcc-c++ |
| glibc-devel |
| openssl-devel |
| tcl-devel |
| expat-devel |
| db4-devel |
| pcre |
| |
| Ubuntu 8.* ,9.*, 10.*, 11.*: |
| autoconf |
| automake |
| libtool |
| g++ |
| libssl-dev |
| tcl-dev |
| expat |
| libexpat-dev |
| libpcre3-dev |
| libcap-dev |
| |
| Ubuntu EC2 9.10: |
| NOTE: Alternately you may use the install scripts in 'contrib' which |
| automate this or use the pre-built public Ubuntu EC2 AMI with |
| ATS installed. Both of which are HIGHLY RECOMMENDED. |
| See 'README-EC2' for further details. |
| |
| Install these packages: |
| autoconf |
| automake |
| libtool |
| g++ |
| libssl-dev |
| tcl-dev |
| expat |
| libexpat-dev |
| libpcre3-dev |
| |
| FreeBSD 7.2,8.0,9.0,9.1 |
| GCC 4.2.1 compiler suite or clang |
| autoconf |
| automake |
| libtool |
| tcl |
| expat |
| openssl |
| pcre |
| bash |
| |
| OpenSolaris osol0906: |
| GCC 4.3.2 compiler suite (dev collection) |
| autoconf |
| automake |
| libtool |
| tcl |
| expat |
| openssl |
| pcre |
| |
| OSX 10.5: |
| GCC 4.2.4 compiler suite (ports collection) |
| autoconf |
| automake |
| libtool |
| tcl |
| expat |
| openssl |
| pcre |
| |
| |
| 3. Building from distribution |
| |
| You can download the latest source code from the official Apache Traffic |
| Server site: |
| |
| http://trafficserver.apache.org/downloads.html |
| |
| (or via the URL shortener: http://s.apache.org/uG). Once downloaded, |
| follow the instructions: |
| |
| tar xf trafficserver-2.1.8-unstable.tar.bz2 |
| cd trafficserver-2.1.8-unstable |
| ./configure # configure the build environment to create Makfiles |
| make # execute the compile |
| |
| This will build with a destination prefix of /usr/local. You can finish |
| the installation with |
| |
| sudo make install |
| |
| |
| 4. BUILDING FROM SVN REPO |
| |
| mkdir -p ~/dev # make yourself a development dir |
| cd ~/dev # enter your development dir |
| svn checkout ... # get the source code from ASF Subversion repo |
| cd traffic # enter the checkout dir |
| autoreconf -i # generate the configure script and Makefile.in files |
| ./configure # configure the build environment to create Makfiles |
| make # execute the compile |
| |
| 4b. Instructions for building on EC2 |
| NOTE: Alternately you may use the scripts under 'contrib' which will |
| automate the install for trafficserver under EC2 which is |
| HIGHLY RECOMMENDED. See 'README-EC2' for further details. |
| |
| # As root do the following when using Ubuntu |
| mkdir -p /mnt #EC2 Storage Mount, where storage is located |
| cd /mnt |
| svn checkout ... # get the source code from ASF Subversion repo |
| cd traffic # enter the checkout dir |
| autoreconf -i --force # generate the configure script and Makefile.in files |
| ./configure |
| make |
| |
| # As root do the following when using Fedora Core 8 kernel |
| mkdir -p /mnt #EC2 Storage Mount, where storage is located |
| cd /mnt |
| svn checkout ... # get the source code from ASF Subversion repo |
| cd traffic # enter the checkout dir |
| autoreconf -i --force # generate the configure script and Makefile.in files |
| ./configure --disable-eventfd |
| make |
| |
| |
| 5. INSTALLATION |
| |
| DEFAULT DIR CONTENTS |
| /usr/local/var/log/trafficserver log files created at runtime |
| /usr/local/var/trafficserver runtime files |
| /usr/local/etc/trafficserver configuration files |
| /usr/local/bin executable binaries |
| /usr/local/libexec/trafficserver plugins |
| |
| |
| 6. CRYPTO NOTICE |
| |
| This distribution includes cryptographic software. The country in |
| which you currently reside may have restrictions on the import, |
| possession, use, and/or re-export to another country, of |
| encryption software. BEFORE using any encryption software, please |
| check your country's laws, regulations and policies concerning the |
| import, possession, or use, and re-export of encryption software, to |
| see if this is permitted. See <http://www.wassenaar.org/> for more |
| information. |
| |
| The U.S. Government Department of Commerce, Bureau of Industry and |
| Security (BIS), has classified this software as Export Commodity |
| Control Number (ECCN) 5D002.C.1, which includes information security |
| software using or performing cryptographic functions with asymmetric |
| algorithms. The form and manner of this Apache Software Foundation |
| distribution makes it eligible for export under the License Exception |
| ENC Technology Software Unrestricted (TSU) exception (see the BIS |
| Export Administration Regulations, Section 740.13) for both object |
| code and source code. |
| |
| The following provides more details on the included cryptographic |
| software: |
| |
| The functionality of OpenSSL <http://www.openssl.org/> is |
| utilized in parts of the software. |
| |
| |
| 7. ADDITIONAL INFO |
| |
| Web page: http://trafficserver.apache.org/ |
| Wiki: http://cwiki.apache.org/confluence/display/TS/ |
| User mailing list: users@trafficserver.apache.org |