README

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:
    GCC 4.2.1 compiler suite
    autoconf 
    automake
    libtool
    tcl
    expat
    openssl
    pcre

  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