View Source

Frequently Asked Questions

Welcome to the Apache Traffic Server FAQ.
Below is a list of frequently asked questions pertaining to Apache Traffic Server.

What Platforms does Traffic Server support

Linux is the primary platform supported.
For other distributions such as FreeBSD, Mac OSX and OpenSolaris see http://svn.apache.org/repos/asf/trafficserver/traffic/trunk/README

'sudo make install' fails with '/usr/bin/install: invalid group nobody'

The default installed user is 'nobody' and the default group is 'nobody'.
You can specify the installed group via:

# It is very important to do a clean uninstall and distclean before
# re-configuring, re-building, and re-installing after the failed
# first install.
sudo make uninstall
sudo make distclean
configure i.e './configure --with-group=nogroup'

How do I enable forward proxy mode?

Forward proxy mode is not enabled out of the box for security reasons. When enabling any proxy on the internet, you want to make sure you observe pertinent security restrictions. Having an open proxy available to internet users is a bad thing. If you understand this and are sure you know what you are doing, go ahead and enable:

    # Set this variable to 1 if you want Traffic Server to serve 
    # requests only from origin servers listed in the mapping rules
    # of the remap.config file. If a request does not match, then 
    # the browser will receive an error.
    CONFIG proxy.config.reverse_proxy.enabled INT 0
    CONFIG proxy.config.url_remap.remap_required INT 0

How do I access POST data in a Traffic Server plugin

You use a transformation plugin. Details are available by visiting the Traffic Server SDK guide

How do I enable DNS lookups?

Edit records.config and enable round_robin along with specifying your nameservers. For example:

    # Enables (1) or disables (0) DNS server round-robin.
    CONFIG proxy.config.dns.round_robin_nameservers INT 1

    #The DNS servers.
    CONFIG proxy.config.dns.nameservers STRING 10.0.0.1 192.172.0.4

How do I enable SSL between Client/ATS/Origin end points?

TODO

What happens if Traffic Server crashes?

it is automatically restarted by the Traffic Manager
if you turn off cores (limit coredumpsize 0) you can prevent disk full errors on crash loops

Do you have any sample configuration files?

Yes we do, see the sample configuration page.

How do i profile Traffic Server's performance

Visit the Profiling page for more information.

How do get detailed logs for particular requests served by Traffic Server?

You can set
CONFIG proxy.config.http.slow.log.threshold INT
in records.config to see various time milestones for HTTP requests in the error log. The value is in milliseconds, requests that take longer than that value will generate a slow log entry.

How to enable cache inspector and others in http_ui?

http_ui is a cache inspector for TS internal system, a Swiss knife tool for TS, you can setup http_ui by:

add these remap rules to remap.config, you may need to replace localhost to your own hostname

    map http://localhost/cache-internal/ http://{cache-internal}
    map http://localhost/cache/ http://{cache}
    map http://localhost/stat/ http://{stat}
    map http://localhost/test/ http://{test}
    map http://localhost/hostdb/ http://{hostdb}
    map http://localhost/net/ http://{net}
    map http://localhost/http/ http://{http}

enable http_ui from records.config, we use command line tool here：

    traffic_line -s proxy.config.http_ui_enabled -v 3
    traffic_line -s proxy.config.http.enable_http_info -v 1

get traffic_server aware of the change:
traffic_line -x

testing with nc:

    echo -e "GET http://localhost/stat/ HTTP/1.0\r\n\r\n" | nc -i 1 localhost 8080