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
- 'sudo make install' fails with '/usr/bin/install: invalid group nobody'
- How do I enable forward proxy mode?
- How do I access POST data in a Traffic Server plugin
- How do I enable DNS lookups?
- How do I enable SSL between Client/ATS/Origin end points?
- What happens if Traffic Server crashes?
- Do you have any sample configuration files?
- How do I profile Traffic Server's performance?
- How do get detailed logs for particular requests served by Traffic Server?
- How to enable cache inspector and others in http_ui?
- How do I setup a RAW disk cache?
- How do I know what debug tags are available?
- More questions?
What Platforms does Traffic Server support
- Linux is the primary platform supported.
- For other distributions such as FreeBSD, Mac OSX and OpenSolaris see 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:
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:
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:
How do I enable SSL between Client/ATS/Origin end points?
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 if you don't access from localhost, you may need to modify the default port 8080 if you have changed it
- enable http_ui from records.config, we use command line tool here：
- get traffic_server aware of the change:
- testing with nc:
How do I setup a RAW disk cache?
RAW disk cache is specified in storage.config using the physical /dev device with no additional parameters provided you run a recent kernel.
You must also ensure the trafficserver user owns the device and has block-level access. To do this we utilize udev rules. This must be a physical device and not an LVM mapping:
How do I know what debug tags are available?
When enabling debug logging, you specify tags to filter the debug output with the
proxy.config.diags.debug.tags option. The following command will show you all debug tags used in the trafficserver source code when outputting debug messages. Run it from inside the trafficserver source tree:
More Frequently Asked Questions?
- There are additional frequently asked questions available in the Traffic Server Administrator's Guide