HP P4535A HP Cache Server Appliance Administrator Guide
HP P4535A - Web Cache Server Appliance Manual
 |
View all HP P4535A manuals
Add to My Manuals
Save this manual to your list of manuals |
HP P4535A manual content summary:
- HP P4535A | HP Cache Server Appliance Administrator Guide - Page 1
HP Cache Server Appliance Administrator Guide HP Part Number 5971-3045 Printed in June 2001 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 2
© Copyright 2001, Hewlett-Packard Company. Audience Assumptions This guide is for the person who installs, administers, and troubleshoots network infrastructure products. Hewlett-Packard Company assumes you are qualified in the servicing of computer equipment and trained in recognizing hazards in - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 3
Contents Preface xii Who should read this manual xii Conventions used in this manual xii 1 Overview 1 What is Traffic Server 1 Traffic Server deployment options 1 Traffic Server as a web server 17 Traffic Server as a caching proxy news server 17 Supporting several parent news servers 17 iii - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 4
Contents Blocking particular groups 18 Clustering 18 Transparency 19 Posting 19 Maintaining the cache: updates and feeds 19 Configuring access control 20 Using enhanced NNTP authentication 20 Obeying NNTP control messages 21 Client bandwidth throttling 21 4 Transparent Proxy Caching 22 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 5
Contents 7 Hierarchical Caching 51 Understanding cache hierarchies 51 HTTP cache hierarchies 51 Parent failover 52 Configuring Traffic Server to use an HTTP parent cache 52 ICP cache hierarchies 54 Configuring Traffic Server to use an ICP cache hierarchy 54 8 Configuring the cache 59 The - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 6
Contents Controlling access to Traffic Manager 83 Setting the administrator ID and password 83 Creating a list of administrator accounts 85 Controlling host access to Traffic Manager 86 Using SSL for secure administration 87 Configuring SOCKS firewall integration 89 Setting SOCKS configuration - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 7
Contents The Other page 126 The MRTG page 127 B Traffic Manager Configuration Options 128 The Server Basics page 128 The Protocols page 131 The Cache page 135 The Security page 137 The Routing page 138 The Host Database page 139 The Logging page 140 The Snapshots page 143 The Plugins page - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 8
215 socks.config 216 Format 216 Example 216 splitdns.config 217 Format 217 Example 217 storage.config 218 Format 218 Example 218 update.config 218 Supported tag/attribute pairs 219 viii - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 9
Contents Format 219 Example 220 Specifying URL Regular Expressions (url_regex 220 Example 221 E Event Logging Formats 222 HP custom logging fields 222 Logging format cross reference 224 Squid logging formats 224 Netscape Common logging formats 225 Netscape Extended logging formats 225 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 10
and static bypass rules: 32 To create a mapping rule from Traffic Manager: 36 To create a mapping rule manually: 37 To set reverse proxy options from Traffic Manager: 38 To set reverse proxy options manually: 38 To set FTP mapping rules: 40 To enable FTP reverse proxy: 40 To modify FTP options: 41 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 11
management options from Traffic Manager: 100 To set log management options manually: 100 To select a standard event log file format from Traffic a collation client from Traffic Manager: 116 To set log collation options manually: 117 To run a stand-alone collator: 118 To move information from the orphan - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 12
available in this manual, refer to the HP Web Cache Server Appliance (sa2100 or sa2200) Getting Started Guide. The manual discusses the following ports, and establishing DNS round robin services. Conventions used in this manual This manual uses the following typographic conventions. Convention - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 13
Traffic Server security options, on page 5 IMPORTANT The paths to files used in the manual are the following: For Command files: /home/TS4//bin For Configuration files: designed to improve content delivery for enterprises, Internet Service Providers (ISPs), backbone providers, and large - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 14
Traffic Server can act either as a parent or child cache, either to other Traffic Servers or to other caching products. Traffic Server supports the standard Internet Cache Protocol (ICP) to interoperate with existing ICP cache hierarchies. Hierarchical caching is described in more detail in Chapter - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 15
the protocol used. For example, for HTTP, the packet's destination port is changed to Traffic Server's HTTP port (usually 8080). The ARM supports automatic bypass of sites that do not function properly with proxy caches. Traffic Server can respond to client request overloads by forwarding requests - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 16
Chapter 1 Overview • Host reliability and availability information (to avoid making the user wait for non-functional servers) The DNS Resolver Traffic Server includes a fast, asynchronous DNS resolver to streamline conversion of host names to IP addresses. Traffic Server implements the DNS - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 17
interface. You can change configuration options by editing configuration files manually instead of using Traffic Manager or Traffic Line. (Any facilities. Traffic Server supports two management information bases (MIBs): MIB-2, a well known standard MIB, and the HP proprietary Traffic Server MIB - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 18
provide transparent access to external sites on the Internet. • Use LDAP-based proxy authentication that enables you to leverage existing directory services by supporting asynchronous match and bind requests to LDAP servers. This enables you to maintain policies that require users to log in and be - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 19
menu to complete these tasks. Instructions in this guide include Traffic Manager instructions as well as manual editing of configuration files through shell configuration utility. This is covered in the HP Web Cache Server Appliance Getting Started Guide. If you telnet into a previously unconfigured - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 20
is up and running When you completed the initial configuration of the cache appliance as described in the HP Web Cache Server Appliance sa2100/sa2200 Getting Started Guide, Traffic Server was automatically started. To verify that Traffic Server is up and running: 1. Access Traffic Manager (refer - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 21
Chapter 2 Getting Started Traffic Manager opens in your web browser and displays the Dashboard, shown in Figure 2-1. Click the Configure tab to display the Configure buttons and set configuration The Monitor tab contains seven buttons. Click a button to display a page of Click the Help button to - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 22
Configure tabs. To start a Traffic Line session: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access on page 76. Restarting Traffic Server Various procedures throughout this manual instruct you to restart Traffic Server. You can restart Traffic - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 23
them on to the origin server (the web server that contains the original copy of the requested information). The Traffic Server proxy supports both transparent proxy caching, where the user's client software (typically a browser) is unaware that it is communicating with a proxy, and explicit proxy - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 24
questions. Ensuring cached object freshness Traffic Server handles object freshness differently depending on protocol. HTTP FTP NNTP Web documents support optional author-specified expiration dates. Traffic Server adheres to these expiration dates; otherwise it picks an expiration date based - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 25
Chapter 3 Web Proxy Caching HTTP object freshness tests Here is how Traffic Server determines an HTTP document's freshness: Expires header test. Some documents come with Expires headers or max-age headers that explicitly define how long the document may be cached. A simple comparison of the - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 26
Chapter 3 Web Proxy Caching Traffic Server applies Cache-Control servability criteria after HTTP freshness criteria. For example, a document might be considered fresh, but if its age is greater than its max-age, it is not served. Configuring HTTP freshness options You can configure the following - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 27
Chapter 3 Web Proxy Caching Alternates are identified by header information. You can configure Traffic Server to cache all alternates according to a particular header. For example, if you tell Traffic Server to vary on the User-Agent header, Traffic Server caches all the different user-agent - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 28
updates to the local cache content. This enables you to instruct Traffic Server to explicitly load specific objects into cache. You articles posted to these groups are propagated around the world. Traffic Server supports NNTP as specified in RFC 977 and many common extensions and proposed extensions - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 29
traffic to parent news servers. If a particular overview or article is not in the cache, Traffic Server forwards requests to the parent server. Supporting several parent news servers Traffic Server can cache articles for several news servers. You specify all of the parent news servers for Traffic - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 30
advantage of the large number of concurrent connections Traffic Server supports. Traffic Server Parent Cache Bombay Parent NNTP Server Zurich overview lists, group lists, and LIST files are all maintained in HP's high performance object store. This information is updated at configurable intervals - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 31
increasing responsiveness and decreasing network utilization. Transparency mode is installed by default during Traffic Server installation. See the HP Web Cache Server Appliance Getting Started Guide for more information. Once installed, you will need to configure and enable it to be able to use - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 32
need to base your NNTP access control policies on factors such as time of day, system load, or other dynamic characteristics. Traffic Server supports enhanced NNTP authentication through the use of external programs, known as plugins, which interface directly with your directory or database. You can - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 33
cancel messages automatically in order to obey them. Client bandwidth throttling You can limit the amount of bandwidth allotted to clients for downloading articles. Clients that attempt to exceed the bandwidth limit will have each operation slowed in order to keep their bandwidth consumption to - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 34
strategies, on page 23 for details. 2. HP's Adaptive Redirection Module (ARM) redirects requests destined through proxies. Traffic Server identifies these problem clients and servers dynamically, and the ARM Additionally, clients and servers can be manually exempted from caching by configuring ARM. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 35
. Using a layer 4 switch with cache switching functionality to filter transparency requests • Layer 4 switches have the ability to rapidly redirect supported protocols to Traffic Server, while passing all other Internet traffic through directly to its destination. Figure 4-1. below illustrates this - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 36
the load. When the node returns to service, some switches automatically return the node to ; this feature is called cache affinity. HP recommends that you do not enable Traffic addition to port 80 (HTTP) traffic, WCCP 2.0 supports additional protocols including NNTP (port 119 traffic). internet - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 37
home page for a list of the platforms that support WCCP. - If you are using several Traffic Server that is sending traffic to Traffic Server. Instructions for enabling WCCP on Cisco routers is provided Traffic Server installation: 1. Telnet into the HP web cache appliance and select Shell Access as - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 38
Chapter 4 Transparent Proxy Caching To enable WCCP 2.0 after installation: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the records.config file located in the Traffic - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 39
in WCCP environments. If you are running clustered Traffic Servers, HP recommends that you do not enable virtual IP failover in WCCP policy-based routing has a performance impact on the router, and it does not support load balancing or heartbeat messaging. Use WCCP or an L4 switch instead of policy - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 40
not interoperate correctly with web proxies. Some of the causes of interoperability problems include: • Client software bugs (homegrown, non-commercial browsers) • Server below. • Static bypass rules must be manually configured in the bypass configuration file (bypass.config). See Static bypass rules, on - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 41
lists. Bypass rules are generated in response to interoperability problems. Client access control is simply restriction of the client in the records.config file. To set dynamic bypass rules: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 42
Chapter 4 Transparent Proxy Caching Variable proxy.config.arm.bypass_dynamic_enabled proxy.config.arm.bypass_use_and_rules_bad_client_request proxy.config.arm.bypass_use_and_rules_400 proxy.config.arm.bypass_use_and_rules_401 proxy.config.arm.bypass_use_and_rules_403 proxy.config.arm. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 43
in response to a 401 error. You can view the dynamic bypass statistics from Traffic Line. To view dynamic bypass statistics: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Enter the following command, and then press - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 44
you to manually configure bypass not pay for a caching service to be steered around the cache particular users that experience problems. To configure static rules The ARM has a supporting utility called print_bypass that allows you rules: 1. Telnet into the HP web cache appliance and select Shell - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 45
Off loading heavily used origin servers Traffic Server can absorb the main origin server request traffic to improve the speed and quality of service of web serving by reducing load and hot spots on backup origin servers. For example, a web hoster can maintain a scalable Traffic Server serving - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 46
Chapter 5 world wide web requests for www.janes_books.com and jazz.flute.org resolve to virtual IP of Traffic Server web Reverse Proxy and HTTP Redirects server real.janes_books.com web Traffic Server serves documents on behalf of real.janes_books.com and big.server.net Traffic Server server - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 47
in Using mapping rules, on page 36. Generally, you use reverse proxy mode to support more than one origin server. In this case, all of the advertised hostnames resolve to , or send the browser to a URL containing information about the problem. Refer to Setting HTTP reverse proxy options, on page 38. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 48
to the origin servers. Setting map and reverse-map rules You can set mapping rules by using Traffic Manager or by editing a configuration file manually. Both procedures are described below. To create a mapping rule from Traffic Manager: 1. Access Traffic Manager from your browser (refer to Accessing - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 49
URL for the rule. 8. Click the Add button to add the rule. 9. Click the Make These Changes button. To create a mapping rule manually: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the remap.config file located in - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 50
from older clients that do not provide a host header are directed. 8. Click the Make These Changes button. To set reverse proxy options manually: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the records.config file - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 51
Chapter 5 Reverse Proxy and HTTP Redirects 3. Edit the following variables: Variable proxy.config.reverse_proxy.enabled proxy.config.url_remap.pristine_host_hdr proxy.config.url_remap.remap_required proxy.config.header.parse.no_host_url_redirect Description Set this variable to 1 to enable HTTP - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 52
the ftp_remap.config file. To set FTP mapping rules: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access procedure below. To enable FTP reverse proxy: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 53
in the records.config file. You can modify the default FTP options to better suit your needs. To modify FTP options: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the records.config file located in Traffic - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 54
Chapter 5 Reverse Proxy and HTTP Redirects Variable proxy.config.ftp.proxy_server_port proxy.config.ftp.min_lisn_port proxy.config.ftp.max_lisn_port proxy.config.ftp.server_data_default_pasv proxy.config.ftp.try_pasv_times proxy.config.ftp.try_port_times proxy.config.ftp. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 55
servers. For example, if you redirect all requests for http://www.ultraseek.com to http://www.hp.com/ products/portal/search/, all HTTP requests for www.ultraseek.com go directly to www.hp.com/ products/portal/search. You can configure Traffic Server to perform permanent or temporary redirects - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 56
You can enter up to four components: scheme://host:port/path_prefix The following example permanently redirects all HTTP requests for www.hp to www.hp2.com. redirect http://www.hp.com http://www.hp2.com 4. Save and close the remap.config file. 5. Run the following command to apply the configuration - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 57
6 Traffic Server Clusters Traffic Server scales from a single node to multiple nodes that form a cluster, allowing you to improve system performance and reliability. This chapter discusses the following topics: • Understanding Traffic Server clusters, on page 45 • Changing clustering mode, on page - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 58
clustering mode To change clustering mode: 1. Telnet into the HP web cache appliance and select Shell Access as described in the cluster name is set the same as the node name. 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 59
the multicast address for cluster communications. All nodes in a cluster must use the same multicast address. Set this variable to specify the reliable service port. The reliable service port is used to send data between the nodes in the cluster. All nodes in a cluster must use the same reliable - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 60
the remaining operational nodes within approximately 30 seconds, so that service can continue without interruption. • The IP addresses are assigned or off by using Traffic Manager or by editing a configuration file manually. Both procedures are described below. To enable/disable virtual IP - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 61
the restart button to restart the traffic_manager process on all the nodes in the cluster. To enable/disable virtual IP addressing manually: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the records.config file - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 62
the restart button to restart the traffic_manager process on all the nodes in the cluster. To add or edit virtual IP addresses manually: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the vaddrs.config file located - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 63
of caches that communicate with each another. Traffic Server supports several types of cache hierarchies. All cache hierarchies recognize HTTP parent cache so that if one parent is unavailable, another parent can service requests. This is called parent failover and is described in Chapter , "Parent - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 64
failover Traffic Server supports the use of several parent caches so that if one parent cache is not available, another parent cache can service client requests. option by using Traffic Manager or by editing a configuration file manually. Both procedures are described below. To enable the HTTP parent - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 65
(shown below). Hierarchical Caching 4. Select Parent Caching: On. 5. Click the Make These Changes button. To enable HTTP parent caching manually: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the records.config - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 66
peers with which Traffic Server can communicate You can set ICP options and identify ICP peers by using Traffic Manager or by editing a configuration file manually. Both procedures are provided below. 54 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 67
field, enter the timeout for ICP queries. The default is 2 seconds. 8. Click the Make These Changes button. To set ICP options manually: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the records.config file located - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 68
must recognize its ICP peers (siblings and parents). You can identify ICP peers by using Traffic Manager or by editing a configuration file manually. To identify an ICP peer from Traffic Manager: 1. Access Traffic Manager from your browser (refer to Accessing Traffic Manager, on page 8). 2. On - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 69
attached to the first hop subnet). 13. Click the Add button. 14. Click the Make These Changes button. To identify an ICP peer manually: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the icp.config file located in - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 70
Chapter 7 Hierarchical Caching Field MC_IP MC_TTL Description Specifies the multicast IP address. Specifies one of the following options: 1 if you do not want IP multicast datagrams to be forwarded beyond a single subnetwork. 2 to allow delivery of IP multicast datagrams to more than one subnet ( - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 71
8 Configuring the cache The Traffic Server cache consists of a high speed object database called the object store that indexes objects according to URLs and associated headers. This chapter discusses the following topics: • The Traffic Server Cache, on page 59 • Clearing the cache, on page 62 • - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 72
that a certain amount of disk space is always available for a particular protocol. To partition the cache according to protocol: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Run the stop_traffic_server command. 3. Open - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 73
server, and a generic partition for all other origin servers not listed (the partitions do not have to be the same size). 2. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 3. Open the hosting.config file located in Traffic Server - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 74
.com is stored on partition 1 and 2, while content from www.yahoo.com is stored on partition 3. domain=hp.com partition=1,2 hostname=www.yahoo.com partition=3 NOTE If you want to allocate more than one partition to an origin server or domain, you must - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 75
that show Traffic Server performance and network traffic information. Refer to Using MRTG, on page 70. • SNMP (Simple Network Management Protocol) support lets you monitor and manage Traffic Server through SNMP network management facilities. Refer to Using SNMP, on page 71. Viewing statistics from - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 76
Chapter 9 Monitoring Traffic where nodename is the name of the web cache appliance and adminport is the number assigned to Traffic Manager port, port 8081 by default. NOTE Use the SSL https command to reach Traffic Manager only if you have restricted access to Traffic Manager via SSL connections - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 77
Chapter 9 Figure 9-1. shows the Dashboard. Click this link to see more information about the selected node Shows the number of objects served by the Traffic Server node Monitoring Traffic Shows the number of transactions processed per second by the Traffic Server node Lists the nodes in the - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 78
are the same graphs that display when you click a link for a statistic on the Node page). To display multiple statistics in one graph, click the box next to the name of each graph you want to display, then click the Graph Selected button. The Protocols button Click the Protocols button to - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 79
performance and network traffic. Refer to Using MRTG, on page 70. Working with Traffic Manager Alarms Traffic Server signals an alarm when it detects a problem (for example, if the traffic_server process shuts down, if the space allocated to event logs is full, or if Traffic Server cannot write to - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 80
write a script file that sends an E-mail to alert someone of the problem. Traffic Server provides a sample script file named example_alarm_bin.sh. You can Line Interactive session. To start Monitor mode: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 81
see only the information you want to obtain instead of seeing a group of related statistics. To retrieve a single statistic: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Execute the following command, then press Return - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 82
Chapter 9 Monitoring Traffic Using MRTG MRTG (Multi Router Traffic Grapher) is a graphing tool that enables you to monitor Traffic Server's performance and analyze network traffic. MRTG provides a variety of graphs that show information about virtual memory usage, client connections, document hit - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 83
of any problems. Traffic Server's SNMP agent supports access to two management information bases (MIBs): MIB-2 (a standard MIB) and the HP Traffic Server SNMP agent by using Traffic Manager or by editing a configuration file manually. Both procedures are provided below. To enable the SNMP agent from - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 84
Chapter 9 Monitoring Traffic 4. Save and close the records.config file. 5. Run the following command to apply the configuration changes. traffic_line -x Configuring SNMP trap destinations To configure SNMP trap destinations, edit the snmpd.cnf file located in Traffic Server's config directory. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 85
10 Configuring Traffic Server Traffic Server provides several options for configuring the system. This chapter discusses the following topics: • Configuring Traffic Server using Traffic Manager, on page 73 • Configuring Traffic Server using Traffic Line, on page 76 • Configuring Traffic Server - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 86
Chapter 10 Configuring Traffic Server Click here to display the Configure mode buttons Click a button to display a page listing configuration options you can modify Click this button to display a description of the configuration options on the current page Shows the current user logged on to - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 87
Chapter 10 Configuring Traffic Server • Configure customizable response pages for HTTP transactions The Protocols button Click the Protocols button to view or change Traffic Server's protocol configuration. You can: • Tune HTTP time-outs and remove HTTP headers to maintain the privacy of your site - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 88
scheduled to update automatically in the local cache. You can instruct Traffic Server to explicitly preload objects in to the cache, Traffic Line interactive session. To start Configure mode: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 89
Chapter 10 The Configure mode command list appears (shown below). Configuring Traffic Server If the command list does not display, enter ? at the prompt. Navigating Configure mode Configure mode in a Traffic Line interactive session consists of levels of commands. Each command has a number - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 90
mode. To set configuration options in batch mode: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Traffic Line, you can change Traffic Server configuration options by manually editing specific variables in the records.config file. The records - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 91
Chapter 10 The following is a sample portion of the records.config file. Configuring Traffic Server The variable name The variable type: an integer (INT), a string, or a floating point (FLOAT) The variable value that you can edit Figure 10-2. A sample records.config file In addition to the - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 92
11 Security Options Traffic Server provides a number of security features. This chapter discusses the following topics: • Controlling client access to the Traffic Server proxy cache, on page 81 • Controlling host access to the Traffic Server machine (ARM security), on page 81 • Controlling access to - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 93
to allow only certain clients to use the proxy cache. To specify the clients allowed to use Traffic Server as a proxy cache: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the ip_allow.config file located in Traffic - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 94
ssh access for yourself. • Enable the ARM security option To edit the arm_security.config file and enable the ARM security option: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the arm_security.config file located in - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 95
Chapter 11 Security Options 6. Open the records.config file located in Traffic Server's config directory with Vi. 7. Edit the following variable: Variable proxy.config.arm.security_enabled Description Set this variable to 1 to enable ARM security. NOTE To disable the ARM security option, set - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 96
Password link, and then enter the current and new password in the boxes provided. If you have forgotten the current administrator password, refer to ' To clear and re-enter the administrator password: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 97
of the page. 3. Click the Additional Users link to open the Additional Users page. 4. Click the Add Entry button to open the Add Entry dialog box (shown below). 85 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 98
ID and accounts, you can control which hosts have access to Traffic Manager. To control which hosts can access Traffic Manager: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the mgmt_allow.config file located in - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 99
changes. Using SSL for secure administration Traffic Server supports the Secure Sockets Layer protocol (SSL) to provide directory. 4. Click the Make These Changes button. To enable SSL manually: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 100
Chapter 11 Security Options Accessing Traffic Manager using SSL To access Traffic Manager from your browser using SSL, use the https command as shown below: https://nodename:adminport where nodename is the hostname of the Traffic Server node, and adminport is the port number assigned to Traffic - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 101
directly without going through the SOCKS server. You can set SOCKS configuration options by using Traffic Manager or by editing configuration files manually. Both procedures are provided below. To set SOCKS options from Traffic Manager: 1. Access Traffic Manager from your browser (refer to Accessing - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 102
the SOCKS server. 9. On the Socks List page, click the Add Entry button to open the Add Entry dialog box (shown below). Currently, the only selection in the Directive drop-down list box is no_socks. This specifies that Traffic Server will access the origin server or group of servers listed in the - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 103
11 Security Options To set SOCKS options manually: 1. Telnet into the HP web cache appliance and select Shell Access or a URL regular expression. To configure DNS server selection: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 104
leverage existing directory services by supporting asynchronous match and bind requests to LDAP servers, thereby supporting policies that clients to access specific sites without LDAP authentication: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 105
Chapter 11 Security Options 3. Edit the following variables: Variable proxy.config.ldap.auth.bypass.enabled proxy.config.ldap.auth.multiple.ldap_servers.enabled Description Set this variable to 1 to enable LDAP authentication bypass. Set this variable to 1 to allow the sites specified in the - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 106
Chapter 11 Security Options Client and Traffic Server connections Figure 11-2. illustrates communication between a client and Traffic Server, and between Traffic Server and an origin server when the SSL termination option is enabled and configured for client/Traffic Server connections only. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 107
Chapter 11 Security Options To set SSL termination configuration variables for client/Traffic Server connections: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the records.config file located in Traffic Server's - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 108
Chapter 11 Security Options 4. Save and close the records.config file. 5. Restart Traffic Server using the command start_traffic_server Traffic Server and origin server connections Figure 11-2. illustrates communication between Traffic Server and an origin server when the SSL termination option - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 109
Chapter 11 Security Options To set SSL termination configuration variables for Traffic Server/origin server connections: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the records.config file located in Traffic - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 110
12 Working with Log Files Traffic Server generates log files that contain information about every request it receives and every error it detects. This chapter discusses the following topics: • Understanding Traffic Server log files, on page 98 • Understanding event log files, on page 98 • Managing - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 111
Chapter 12 Working with Log Files Traffic Server supports several standard log file formats, such as Squid and Netscape, and user-defined custom formats. You can analyze the standard format log files with off- - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 112
space available in the logging directory is less than the headroom. 7. Click the Make These Changes button. To set log management options manually: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the records.config file - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 113
apply the configuration changes. Choosing event log file formats Traffic Server supports the following log file formats: • Standard formats, such as format options by using Traffic Manager or by editing a configuration file manually. Both procedures are provided below. To select a standard event - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 114
if you do not want to use a text header. 8. Click the Make These Changes button. To select a standard event log file format manually: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the records.config file located in - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 115
command traffic_line -x to apply the configuration changes. Using custom formats In addition to the standard log file formats, Traffic Server also supports two models for specifying custom log files: • Traditional (simple) • XML-based (highly configurable) Using the XML-based format, you can also - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 116
4. Select the Enabled: On button. 5. Select the Traditional button. 6. Click the Make These Changes button, then exit Traffic Manager. 7. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 8. Open the logs.config file with Vi. 9. To - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 117
logs.config file. 11. Run the command traffic_line -x to apply the configuration changes. Using XML-based custom formats Traffic Server supports a broad range of logging formats, including both standard and traditional custom formats. However, associating these formats to specific servers, collation - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 118
below). 4. Select the Enabled: On button. 5. Select the XML button. 6. Click the Make These Changes button, then exit Traffic Manager. 7. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 8. Open the records.config file located in - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 119
creating and enabling two custom log formats-one using aggregate operators and the other not. To create a summary log file: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the logs_xml.config file located in the - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 120
convert a binary log file to ASCII before you can analyze it using standard tools. To convert a binary log file to ASCII: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Change to the directory containing the binary log file - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 121
Chapter 12 Working with Log Files The following table describes the command-line options: Option -o output_file -a -S -C -E -2 Description Specifies where the command output is directed. Automatically generates the output file name based on the input file name. If the input is from stdin, this - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 122
15:00 each day. Setting log file rolling options You can set log file rolling options by using Traffic Manager or by editing a configuration file manually. Both procedures are provided below. To set log file rolling options from Traffic Manager: 1. Access Traffic Manager from your browser (refer to - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 123
specified in the Log Management section of the Logging page. 8. Click the Make These Changes button. To set log file rolling options manually: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the records.config file - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 124
Chapter 12 Working with Log Files Splitting event log files By default, Traffic Server uses standard log formats and generates separate log files for HTTP/FTP, NNTP, and ICP transactions. Under most circumstances, this default behavior offers the most flexibility for collecting and analyzing log - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 125
server listed in log_hosts.config file in the same log file. 7. Click the Make These Changes button. To set log splitting options manually: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the records.config file located - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 126
specify each origin server's hostname on a separate line in the file. NOTE If Traffic Server is clustered and if you enable log file collation, HP recommends that you use the same log_hosts.config file on every Traffic Server node in the cluster. To edit the log_hosts.config file: 1. Telnet into - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 127
log clients cannot contact their log collation server, they write their log buffers to their local disks, into orphan log files. Orphan log files require manual collation. See Figure 12-2. Node 1 Log Node 2 Orphan Log File Log Node 3 Node 4 Orphan Log File Log Orphan Log File Log Log Collation - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 128
doing analysis. Setting log collation options You can set log collation options by using Traffic Manager or by editing a configuration file manually. Both procedures are provided below. To configure a Traffic Server node to be a collation server from Traffic Manager: 1. Access Traffic Manager from - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 129
are created when the log collation server cannot be contacted). 10. Click the Make These Changes button. To set log collation options manually: 1. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 2. Open the records.config file - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 130
log collation clients. Refer to To configure a Traffic Server node to be a collation client from Traffic Manager:, on page 116. 2. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. 3. Copy the SAC binary from Traffic Server's /home - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 131
the Traffic Server logging system cannot write to your log collation server, it creates orphan log files on local disks, which you can collate manually into a large log file for the Traffic Server system. To move information from the orphan files into your central log files: 1. Copy the orphan - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 132
light Indicates that the traffic_server process is running (caching and proxying services are running). The green Off light indicates that the traffic_server The yellow light with exclamation point indicates that there is a cluster problem. The total number of objects served by the node. The number - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 133
Appendix A Traffic Manager Statistics Statistic/Field Node IP Address Virtual IP Address Mappings Description The IP address assigned to this node. If virtual IP addressing is enabled, several virtual IP addresses could be assigned to this node. If you have configured your Traffic Server system - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 134
Appendix A Traffic Manager Statistics The Protocols page The following table describes the statistics on the Protocols page. Statistic Description HTTP Transaction Frequency and Speeds Hits Fresh The percentage of hits that are fresh and their average transaction times. Stale Revalidated - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 135
Appendix A Traffic Manager Statistics Statistic PASV Connections Successes PASV Connections Failures PORT Connections Successes PORT Connections Failures Open Connections Bytes Read Bytes Written Open Connections Bytes Read Bytes Written Article Hits Article Misses Overview Hits Overview Refreshes - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 136
of active nodes Security Enabled Multicast Enabled Multicast Address Multicast TTL HTTP NNTP RTSP PNA My IP Number of buckets assigned to this node Service Id Leader's IP Description Queries Originating From ICP Peers The number of ICP query messages received from remote ICP peers (siblings and - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 137
Number of Routers Router[0] IP address Router[1] IP address Router[0] Received ID Router[1] Received ID My IP Number of buckets assigned to me Service Id Leader's IP Number of Caches Number of Routers Router[0] IP address Router[1] IP address Router[0] Received ID Router[1] Received ID Description - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 138
Appendix A Traffic Manager Statistics Statistic In Progress Hits Misses In Progress Successes Failures In Progress Successes Failures In Progress Successes Failures Description READS The number of cache reads in progress (NNTP, HTTP, and FTP). The number of cache reads completed since - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 139
Appendix A Traffic Manager Statistics Statistic Network Backups Clustering Nodes Unsuccessful Connections Successful Connections Connections in progress Currently Open Log Files Space Used For Log Files Number of Access Events Logged Number of Access Events Skipped Number of Error Events Logged - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 140
Server User ID Local Domain Expansion Description Traffic Server Turns the traffic_server process on or off, which shuts down all caching and proxying services on a node-by-node basis. You can turn the traffic_server process on or off only one node at a time. Normally, the traffic_server process - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 141
a client makes a request to hp, the Traffic Server redirects the request to www.hp.com. NOTE: If local domain about 15 seconds and caching and proxying services are disabled during this time. Specifies the needed. Specify the port to use for downloading the auto-configuration file. The port cannot - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 142
SNMP agent supports access to two management information bases (MIBs): MIB-2 (a standard MIB) and the HP Traffic Server : If Traffic Server detects an HTTP problem with a particular client transaction (such clients see Document contains no data dialog boxes on their screens, instead of Traffic - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 143
to origin servers open for a subsequent transfer of data after a transaction ends. Each time the Traffic Server opens a connection to download data from an origin server, it downloads the data, then keeps the connection alive for the timeout period you specify. If the Traffic Server does not need to - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 144
NNTP version 2 authentication. Use this option only if you are certain that all of your client authentication supports version 2. NNTP option: Run Local Authentication Server Runs an authentication program on this Traffic Server node. You can configure which clients must be authenticated in - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 145
Appendix B Traffic Manager Configuration Options Option Definition NNTP option: Clustering Allows cluster-wide NNTP caching. NNTP option: Allow Feeds Allows the Traffic Server to accept feeds of news articles from feed or push groups. CAUTION: If Traffic Server is clustered, configure your - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 146
are limited to downloading no more than this number of bytes per second. A throttle of 0 (zero) means that downloading is not limited server accepts it. This mode is firewall friendly, but some FTP servers do not support it. PORT only = The FTP server initiates the data connection and the Traffic - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 147
particular, some URLs can have large numbers of alternates due to cookies. If Traffic Server is set to vary on cookies, you might encounter this problem. Click this link to see a list of the files or hard disk partitions allotted to cache storage and their sizes. NOTE: Raw partitions may not - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 148
The default value is user-agent and cookie NOTE: Some documents can have thousands of alternate cookie versions. If you choose to vary on cookies, HP recommends that you limit the number of alternates cached. See Storage, on page 135. If the request is for images = Images are rarely personalized. If - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 149
Appendix B Traffic Manager Configuration Options The Security page The following table describes the configuration options on the Security page. Option Description Control Access to the Traffic Server Manager Authentication (basic) on/off Sets basic authentication on or off. When on, Traffic - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 150
Appendix B Traffic Manager Configuration Options Option SOCKS timeout (seconds) SOCKS List Description Specifies how long (in seconds) the Traffic Server must wait for the SOCKS server to respond. If the SOCKS server does not respond within the amount of time specified, the Traffic Server drops - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 151
Appendix B Traffic Manager Configuration Options Option Reverse Proxy Retain Client Host Header Serve Mapped Hosts Only Edit Mapping Rules Redirect requests without Host header to URL Description Reverse proxy Enables or disables HTTP reverse proxy caching mode. For FTP reverse caching mode, - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 152
's IP address in order to cache it. The next time a client makes the same request, the address will be in the cache. To provide DNS services, the Traffic Server uses a list of DNS servers that it obtains from the DNS table in your resolv.conf file. The Traffic Server always tries - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 153
Enables Traffic Server to be a log collation client. Selecting this option instructs Traffic Server to send the active standard formats, such as Squid, Netscape change the port number unless there is a conflict with another service already using the port. Specifies the password for the log collation - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 154
the logs.config file in the config directory for custom log formats. For more information, see Using custom formats, on page 103. Selecting XML instructs Traffic Server to look to the logs_xml.config file for highly configurable custom log formats. For more information, see Using custom formats, on - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 155
Appendix B Traffic Manager Configuration Options The Snapshots page The following table describes the configuration options on the Snapshots page. Option Name New Snapshot Take Snapshot Restore Snapshot Delete Snapshot Description Takes a snapshot and saves a copy of all Traffic Server - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 156
editor because the page takes care of automatically notifying Traffic Server when changes are made. If you do modify update.config directly, you must manually stop and restart the Traffic Server process. The Add Entry page contains the following options: URL - HTTP and FTP-based URLs. The system - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 157
Traffic Server commands. You can also script multiple batch mode commands in a shell. You execute batch mode commands by Telneting into the HP web cache appliance and selecting Shell Access as described in Overview of Access Methods, on page 7. The following table describes all the commands - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 158
Appendix C Traffic Line Commands Command traffic_line -B traffic_line -b traffic_line -T value Description Bounces the Traffic Server cluster wide. Bouncing the Traffic Server shuts down and immediately restarts Traffic Server node by node. Bounces the Traffic Server on the local node. Bouncing - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 159
Appendix C Traffic Line Commands Traffic Line variables You can view statistics and change configuration options in Traffic Line by using specific variables. The variables used for gathering statistics are described below. The variables used for viewing and changing configuration options are - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 160
Appendix C Traffic Line Commands Protocols HTTP (client) Total Document Bytes proxy.process.http.user_agent_response_document_total_ size Total Header Bytes proxy.process.http.user_agent_response_header_total_size Total Connections proxy.process.http.current_client_connections Transactions - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 161
Appendix C Traffic Line Commands NNTP (client) Open Connections Bytes Read Bytes Written NNTP (server) Open Connections Bytes Read Bytes Written NNTP (operations) Article Hits Article Misses Overview Hits Overview Refreshes Group Hits Group Refreshes Posts Post Bytes Pull Bytes Feed Bytes WCCP - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 162
Appendix C Traffic Line Commands Write Failures proxy.process.cache.write.cancel Updates in Progress proxy.process.cache.update.active Updates Completed proxy.process.cache.update.success Update Failures proxy.process.cache.update.failure Removes in Progress proxy.process.cache.remove. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 163
Appendix C Traffic Line Commands Configuration Options The following table lists the variables you can specify in Traffic Line interactive mode or batch mode to configure Traffic Server. For a description of the configuration options, refer to Appendix B, Traffic Manager Configuration Options. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 164
Appendix C Traffic Line Commands Configuration Option Variable Protocols HTTP Keep-Alive Timeout: Inbound (secs) proxy.config.http.keep_alive_no_activity_timeout_in Keep-Alive Timeout: Outbound proxy.config.http.keep_alive_no_activity_timeout_out (secs) Inactivity Timeout: Inbound (secs) - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 165
Appendix C Traffic Line Commands Configuration Option Variable Posting enabled proxy.config.nntp.posting_enabled 1 = Enable 0 = Disable Access Control enabled proxy.config.nntp.access_control_enabled 1 = Enable 0 = Disable NNTP V2 Authentication enabled proxy.config.nntp.v2_authentication - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 166
Appendix C Traffic Line Commands Configuration Option Variable Cache Activation Enable HTTP caching proxy.config.http.cache.http 1 = Enable 0 = Disable Enable FTP caching proxy.config.http.cache.ftp 1 = Enable 0 = Disable Enable NNTP caching proxy.config.nntp.cache.enabled 1 = Enable 0 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 167
Appendix C Traffic Line Commands Configuration Option Variable If alternates are enabled, then vary on these headers: If the request is for text proxy.config.http.cache.vary_default_text If the request is for images proxy.config.http.cache.vary_default_images If the request is for anything - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 168
Appendix C Traffic Line Commands Configuration Option Variable Log file header proxy.config.log2.squid_log_header Netscape Common Format Netscape Common Enabled proxy.config.log2.common_log_enabled 1 = Enable 0 = Disable Netscape Common Log file type proxy.config.log2.common_log_is_ascii - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 169
Appendix C Traffic Line Commands Configuration Option Auto-delete rolled log files when space is low Log Splitting NNTP Log Splitting Host Log Splitting Parent Proxy Parent Caching Parent Cache: ICP ICP mode: ICP Port ICP multicast enabled ICP Query Timeout Reverse Proxy Server Acceleration - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 170
Appendix C Configuration Option DNS Configuration Resolve attempt timeout(secs) Number of retries Variable proxy.config.dns.lookup_timeout proxy.config.dns.retries Traffic Line Commands 158 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 171
D Configuration Files This appendix describes the Traffic Server configuration files that you can edit. • arm_security.config, on page 160 • bypass.config, on page 161 • cache.config, on page 162 • filter.config, on page 164 • ftp_remap.config, on page 166 • hosting.config, on page 166 • icp.config, - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 172
Appendix D Configuration Files arm_security.config The arm_security.config file contains the ARM access control list. The file consists of a series of open, allow, and deny lines that specify the hosts that are allowed to communicate with the Traffic Server ARM using TCP and UDP through defined - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 173
destination. For example, you can route around specific client-server pairs that experience broken IP authentication or out-of-band HTTP traffic problems when cached. Source/destination bypass rules can be preferable to destination rules because they block a destination server only for users that - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 174
Appendix D Configuration Files Format The bypass rules have the following format: Rule Format source IP bypass bypass src IPaddress Where IPaddress can be: • a simple IP address, such as 1.1.1.1 • in CIDR (Classless Inter-Domain Routing) format, such as 1.1.1.0/24 • a range separated by a - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 175
Appendix D Configuration Files Format Each line in the cache.config file contains a caching rule. Traffic Server recognizes three space-delimited tags: primary destination=value secondary specifier=value action=value NOTE You can use more than one secondary specifier in a rule. However, you - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 176
gif and jpeg objects in the domain hp.com every 6 hours and all other objects in hp.com every hour. NOTE The rules are applied in the order listed. dest_domain=hp.com suffix=gif revalidate=6h dest_domain=hp.com suffix=jpeg revalidate=6h dest_domain=hp.com revalidate=6h filter.config The filter - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 177
is /viewpoint. url_regex=politics prefix=/viewpoint keep_hdr=client_ip The following rule configures Traffic Server to strip all cookies to the requested host www.hp.com. dest_host=www.hp.com strip_hdr=cookie The following rule configures Traffic Server not to allow puts to the requested host www - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 178
specific origin servers and/or domains so that you can manage your cache space more efficiently, and restrict disk usage. For step by step instructions on partitioning the cache according to origin servers and/or domains, refer to Partitioning the cache according to origin server or domain, on page - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 179
list_of_partition_numbers is a comma-separated list of generic partitions. Example In the following example, content from the domain hp.com is stored on partition 1 and content from www.hp.com is stored on partition 2. Content from all other origin servers is stored in partitions 3 and 4. domain - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 180
Appendix D Configuration Files Each field is described in the following table: Field Description host The hostname of the ICP peer. The name localhost is reserved for the Traffic Server. host _IP The IP address of the ICP peer. cache _type Use the following options: • 1 to indicate an ICP - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 181
Appendix D Configuration Files Example The following line in the ip_allow.config file allows all clients to access the Traffic Server proxy cache: src_ip=0.0.0.0-255.255.255.255 action=ip_allow The following line allows all clients on a specific subnet to access the Traffic Server proxy cache: - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 182
Appendix D Configuration Files Refer to records.config, on page 182 for information about setting records.config variables. If the proxy.config.log2.custom_logs_enabled variable is set to 0 (disabled), any custom log files set in the logs.config file are disabled. IMPORTANT After you modify the - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 183
Files WELF (WebTrends Enhanced Log Format) Traffic Server supports WELF, the WebTrends Enhanced Log format, so that you you must list each origin server's hostname in the log_hosts.config file. NOTE HP recommends that you use the same log_hosts.config file on every Traffic Server node - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 184
field>' as placeholders for valid HPhp field names. For more information, refer to HP custom logging fields, on page 222. The specified field can be of two types • A field within a container, such as an HTTP header or an HP stat. Fields of this type have the syntax: '%'. Use this - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 185
= "valid_filter_name"/> Allowed Inputs (Required) All filters must be uniquely named. (Required) ACCEPT or REJECT. This instructs Traffic Server to either accept or reject records satisfying the condition of the filter. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 186
Appendix D Field Configuration Files Allowed Inputs Valid logging modes include ASCII, binary, and - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 187
"/> WELF (WebTrends Enhanced Log Format) Traffic Server supports WELF, the WebTrends Enhanced Log format, so that you can analyze Traffic Server log files with WebTrends reporting tools. A predefined - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 188
. There are three ways of specifying groups of clients: by IP range, domain, or hostname. For example: ip=0.0.0.0-255.255.255.255 ip=127.0.0.1 domain=hp.com hostname=myhost.mydomain.com 176 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 189
Appendix D Configuration Files Following the client group is an access directive. The access directive is of the form access=value. The allowed access values are allow, deny, basic, generic, and custom. Depending on the access directive, you can further specify an authenticator program, users, and - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 190
Appendix D Tag group-wildmat priority Configuration Files Description Enter a comma-separated list of group names and list files in wildmat format (use * as a wildcard). The list files options are the following: subscriptions, distributions, and distrib.pats. Make sure there are no spaces in the - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 191
pullover group must be preceded by a cache on demand line as follows: comp.webhost.com alt.* comp.webhost.com alt.bicycles pull news.hp.com ink.* news.hp.com ink.* pullover parent.config The parent.config file identifies the HTTP parent proxies used in an HTTP cache hierarchy. This file allows you - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 192
Appendix D Configuration Files For the parent.config file to take effect, HTTP parent caching option must be enabled in Traffic Manager. Refer to Enabling the HTTP parent caching option, on page 52. IMPORTANT After you modify the parent.config file, Traffic Manager has to reread the - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 193
store data from certain origin servers and/or domains in the hosting.config file (refer to hosting.config, on page 166). For step by step instructions on partitioning the cache, refer to Partitioning the cache, on page 59. IMPORTANT The partition configuration must be the same on all nodes in - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 194
set automatically when you set configuration options in Traffic Manager or Traffic Line. Certain configuration options can be set only by editing variables manually in the records.config file. WARNING Do not change the records.config variables unless you are certain of the effect. Many variables - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 195
Appendix D Configuration Files Example In the following example, the variable proxy.config.proxy_name is of datatype string and its value is my_server. This means that the name of the Traffic Server proxy is my_server. CONFIG proxy.config.proxy_name STRING my_server In the following example, the - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 196
local manager. 3 8088 8089 1 Sets the clustering mode: 1 = full-clustering mode 2 = management-only mode 3 = no clustering Specifies the reliable service port. The reliable service port is used to send configuration information between the nodes in a cluster. All nodes in a cluster must use the - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 197
proxy.config.alarm. STRING example_ alarm_bin.sh Specifies the name of the script file that sends E-mail to alert someone of Traffic Server problems. The default file is a sample script. You must edit the script to suit your needs. Refer to Configuring Traffic Server to E-mail alarms - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 198
disables (0) the adaptive bypass option to bypass the proxy and go directly to the origin server when clients or servers cause problems. proxy.config.arm.bypass_use_and_rules 0 _bad_client_request INT Enables (1) or disables (0) dynamic source/ destination bypass in the event of non-HTTP traffic - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 199
Appendix D Configuration Files Configuration Variable Data Type proxy.config.arm.bypass_use_and_rules _405 INT proxy.config.arm.bypass_use_and_rules _406 INT proxy.config.arm.bypass_use_and_rules _408 INT proxy.config.arm.bypass_use_and_rules _500 INT proxy.config.arm.bypass_on_bad_client _request - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 200
Appendix D Configuration Files Configuration Variable Default Value Description Data Type proxy.config.header.parse.no_host_url_ NULL redirect Specifies the URL to which to redirect requests with no host headers (reverse proxy). STRING (ARM) Load Shedding Configuration proxy.config.arm. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 201
Appendix D Configuration Files Configuration Variable Data Type proxy.config.ldap.auth.multiple.ldap_ servers.enabled INT proxy.config.ldap.auth.bypass.enabled INT proxy.config.ldap.proc.ldap.server.name STRING proxy.config.ldap.proc.ldap.server.port INT proxy.config.ldap.proc.ldap.base.dn STRING - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 202
them to the expanded address, prepended with www. and appended with .com. For example, if a client makes a request to HP, Traffic Server redirects the request to www.hp.com. When enabled (1), and if HTTP parent caching is enabled, Traffic Server does no DNS lookups on request hostnames. Enables - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 203
Appendix D Configuration Files Configuration Variable Data Type proxy.config.http.origin_server_pipeline INT Default Value 1 proxy.config.http.user_agent_pipeline 4 INT proxy.config.http.share_server_sessions 1 INT proxy.config.http.ftp_enabled 1 INT proxy.config.http.record_heartbeat 0 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 204
Appendix D Configuration Files Configuration Variable Default Value Description Data Type proxy.config.http.parent_proxy.per_ 2 parent_connect_attempts INT Specifies the total number of connection attempts allowed per parent if multiple parents are used. proxy.config.http.parent_proxy. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 205
Appendix D Configuration Files Configuration Variable Default Value Description Data Type origin server connect attempts proxy.config.http.connect_attempts_ 6 max_retries INT Specifies the maximum number of connection retries Traffic Server can make when the origin server is not responding - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 206
Appendix D Configuration Files Configuration Variable Default Value Description Data Type proxy.config.http.anonymize_other_ header_list NULL Specifies the headers that Traffic Server will remove from outgoing requests. STRING proxy.config.http.snarf_username_from 0 _authorization INT When - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 207
Appendix D Configuration Files Configuration Variable Data Type proxy.config.http.cache.cache_urls_ that_look_dynamic INT proxy.config.http.cache.enable_default_ vary_headers INT proxy.config.http.cache.when_to_ revalidate INT proxy.config.http.cache.when_to_add_ no_cache_to_msie_requests INT - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 208
Appendix D Configuration Files Configuration Variable Default Value Description Data Type proxy.config.http.cache.fuzz.probability 0.005 FLOAT Specifies the probability that a refresh is made on a document during the specified fuzz time. dynamic content & content negotiation proxy.config. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 209
Default Value 1 1 0 0 1 1 1 0 1 HP NNTP server ready. posting ok HP NNTP server ready. no posting 119 NULL 0 Description Enables (1) Enable this option only if you are certain that all your client authentication supports NNTP version 2. Enables (1) or disables (0) cluster-wide NNTP caching. Enables - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 210
option. Enables (1) or disables (0) the obey rmgroups control messages option. Specifies the number of seconds that idle NNTP connections can remain open. HP recommends that you specify a value of at least 3 minutes. Specifies how often (in seconds) Traffic Server polls parent NNTP servers for new - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 211
retrying an origin server that was previously unavailable. Specifies the number of bytes per second that clients are allowed to download. A value of 0 means that downloading is not limited. Specifies the maximum number of articles allowed per group. Specifies how often Traffic Server checks to see - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 212
Appendix D Configuration Files Configuration Variable Data Type proxy.config.nntp.accept_local_ authentication_requests_only INT proxy.config.nntp.custom_ authentication_via_stdio INT proxy.config.nntp.first_authorization_ip STRING proxy.config.nntp.last_authorization_ip STRING proxy.config.ftp. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 213
Appendix D Configuration Files Configuration Variable Data Type proxy.config.ftp.server_data_default_ pasv INT Default Value 1 proxy.config.ftp.try_pasv_times INT 1024 proxy.config.ftp.try_port_times INT 1024 proxy.config.ftp.try_server_ctrl_connect 6 _times INT proxy.config.ftp. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 214
Appendix D Configuration Files Configuration Variable Default Value Description Data Type proxy.config.ftp.share_ftp_server_ctrl_ 1 enabled INT Enables (1) or disables (0) sharing the server control connections among multiple anonymous FTP clients. proxy.config.ftp.server_ctrl_keep_alive_ 90 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 215
Appendix D Configuration Files Configuration Variable Data Type proxy.config.net.connections_throttle INT proxy.config.cluster.cluster_port INT proxy.config.cluster.ethernet_interface STRING proxy.config.cache.permit.pinning INT proxy.config.cache.ram_cache.size INT proxy.config.cache.limits.http. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 216
Appendix D Configuration Files Configuration Variable Data Type proxy.config.dns.url_expansions STRING proxy.config.hostdb.size INT proxy.config.hostdb.ttl_mode INT proxy.config.hostdb.timeout INT proxy.config.hostdb.strict_round_robin INT proxy.config.log2.logging_enabled INT proxy.config.log2. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 217
changed. Enables (1) or disables (0) custom logging. Enables (1) or disables (0) extended custom logging using an XLM-based configuration file. A value of 0 instructs Traffic Server to use the traditional custom log formats. Enables (1) or disables (0) the squid log file format. Specifies the squid - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 218
Appendix D Configuration Files Configuration Variable Default Value Data Type proxy.config.log2.common_log_name common STRING proxy.config.log2.common_log_header NULL STRING proxy.config.log2.extended_log_enabled 0 INT proxy.confg.log2.extended_log_is_ascii 1 INT proxy.config.log2. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 219
Appendix D Configuration Files Configuration Variable Data Type proxy.local.log2.collation_mode INT Default Value 0 proxy.confg.log2.collation_host STRING proxy.config.log2.collation_port INT proxy.config.log2.collation_secret STRING NULL 8085 foobar proxy.config.log2.collation_host_tagged 0 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 220
Appendix D Configuration Files Configuration Variable Data Type proxy.config.reverse_proxy.enabled INT URL Remap Rules proxy.config.url_remap.default_to_ server_pac INT proxy.config.url_remap.default_to_ server_pac_port INT proxy.config.url_remap.remap_URL Remap Rules required INT proxy.config. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 221
Appendix D Configuration Files Configuration Variable Data Type proxy.config.ssl.server.cert.filename STRING proxy.config.ssl.server.cert.path STRING proxy.config.ssl.server.private_ key.filename STRING proxy.config.ssl.server.private_key.path STRING proxy.config.ssl.CA.cert.filename STRING proxy. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 222
Appendix D Configuration Files Configuration Variable Default Value Description Data Type ICP Configuration proxy.config.icp.enabled 0 Sets ICP mode for hierarchical caching: INT 0 = disables ICP. 1 = allows Traffic Server to receive ICP queries only. 2 = allows Traffic Server to send - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 223
, the routers on your network are not automatically discovered. You must specify the number of routers that direct traffic to Traffic Server. WCCP 2.0 supports a maximum of 32 routers. If multicast is not enabled, the routers on your network are not automatically discovered. You must specify the IP - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 224
Appendix D Configuration Files Configuration Variable Data Type proxy.config.arm.security_enabled INT Default Value Description ARM (Security Configuration) 0 Enables (1) or disables (0) ARM security. Refer to Controlling host access to the Traffic Server machine (ARM security), on page 81. - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 225
Appendix D Configuration Files Example The following section shows example mapping rules in the remap.config file. Reverse proxy mapping rules The following example shows a map rule that does not specify a path prefix in the target or replacement: map http://www.x.com/ http://server.hoster.com - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 226
redirects all HTTP requests for www.hp to www.hp3.com. redirect_temporary http://www.hp.com http://www.hp2.com snmpd.cnf The snmpd.cnf file contains parameters that control user access to MIB information and trap destinations. It is beyond the scope of this manual to describe all of the SNMP - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 227
Appendix D Configuration Files Configuring trap destinations You must modify the snmpd.cnf file to send traps to each of your monitoring stations. You must configure the snmpnotifyEntry and snmpTargetAddrEntry entries for trap destinations. snmpnotifyEntry sends traps to a particular host or group - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 228
Appendix D Configuration Files The snmpTargetAddrEntry line defines the host, host_a, which has the IP address A.B.C.D. The communityEntry line defines the community OneHost, which contains the host host_a. The vacmAccessEntry and vacmSecurityToGroupEntry lines allow access to the community - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 229
system determines the value from /etc/ resolv.conf. Example Consider the following DNS server selection specifications: dest_domain=internal.hp.com named="255.255.255.255:212 255.255.255.254" def_domain="hp.com" search_list="hp.com hp1.com" dest_domain=!internal.hp.com named="255.255.255.253" 217 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 230
hp1.com as the set of domains to search first. • http://www.microsoft.com This request will match the second line, namely not internal.hp.com. Therefore Traffic Server selects DNS server 255.255.255.253. Since, no def_domain or search_list was supplied, Traffic Server retrieves this information from - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 231
changes are made. If you do modify the update.config file directly, you must manually stop and restart the Traffic Server process. Supported tag/attribute pairs Scheduled update supports the following tag/attribute pairs when performing recursive URL updates: • • • - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 232
The following example illustrates an HTTP scheduled update: http://www.hp.com\User-Agent: noname user agent\13\3600\5\ This example = 86400. The following example illustrates an FTP scheduled update: ftp://[email protected]/pub/misc/test_file.cc\\18\120\0 This example specifies the FTP request, - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 233
s Either an r or an s Inserts an "end" node causing regular expression matching to stop when reached. The value n is returned. Example You can specify dest_domain=hp.com to match any host in hp.com. Likewise, you can specify dest_domain=. to match any request. 221 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 234
logging fields, and Netscape and Squid logging fields (including Netscape Extended and Extended-2 fields) HP custom logging fields The following table describes the HP custom logging fields. % {HTTP header field name}cqh {HTTP header field name}pqh {HTTP header field name}psh {HTTP - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 235
number. The client request URL path; specifies the argument portion of the URL (everything after the host). For example, if the URL is http:// www.hp.com/images/foo.gif, then this field displays /images/ foo.gif. The client request URL scheme (HTTP, FTP, etc.). The cache result code; specifies how - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 236
seconds; specifies the transfer time of the document in seconds. Logging format cross reference The following sections illustrate the correspondence between HP logging fields and standard logging fields for the Squid and Netscape formats. Squid logging formats The following table lists the Squid - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 237
field symbols. Netscape Extended host usr [time] "req" s1 c1 s2 c2 b1 b2 h1 h2 h3 h4 xt HP field symbols chi caun [cqtn] "cqtx" pssc pscl sssc sscl cqbl pqbl cqhl pshl pqhl sshl tts Netscape Extended-2 logging formats The following table lists - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 238
Appendix E Netscape Extended-2 s2 c2 b1 b2 h1 h2 h3 h4 xt route pfs ss crc HP field symbols sssc sscl cqbl pqbl cqhl pshl pqhl sshl tts phr cfsc pfsc crc Event Logging Formats 226 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 239
F Traffic Server Error Messages This appendix contains the following sections: • Traffic Server error messages, on page 227 describes the messages that Traffic Server software sends to the system log file (messages) • Traffic Server alarm messages, on page 229 describes the alarm messages that - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 240
range for node connect failed Incompatible software versions causing a problem. cache read error If this message appears by itself, it might indicate a cache read problem; call Technical Support. If it appears with other cache warnings such as unable to read cache - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 241
connections on port: Unable to open logfile , errno = unable to read cache segment Description Call technical support Cannot open the log file. The garbage collector is unable to read cache segments in the following cases: if the segment is corrupt - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 242
Check your custom log configuration file. There may be some syntax errors. See HP custom logging fields, on page 222 for correct custom log format fields. returns detailed error messages to browser clients when there are problems with the HTTP transactions requested by the browser. These Traffic - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 243
because your browser did not send an HTTP Host header. Manually configure your browser to use http:// proxy_name:proxy_port as an HTTP documentation for details. Alternatively, end users can upgrade to a browser that supports the HTTP Host header field. Host Header Required 400 Your browser did - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 244
Appendix F Traffic Server Error Messages Title HTTP Description code Customizable file name Temporarily Moved 302 The document you requested,URL, has redirect#moved_ moved to a new location. The new temporarily location is new_URL. Transcoding Not Available 406 Unable to provide the - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 245
origin servers to keep track of users. DNS. Domain Name Service. Traffic Server includes a fast, asynchronous DNS resolver to streamline conversion programming language specifically designed for writing programs that can be safely downloaded to your computer through the Internet. L4 switch. An - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 246
device (for example, a router). Traffic Server supports two MIBs: MIB2 (a wellknown standard MIB) and the HP proprietary Traffic Server MIB, which provides more of server content. Reverse proxy also offloads static content service from servers building dynamic content and provides a peak load - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 247
,"s. The proxy server may deny requests according to filter rules or security limitations. Web server. A computer that provides World Wide Web services on the Internet. See also Chapter , "Origin server,". WPAD. Web Proxy Auto-Discovery. A protocol that allows clients to automatically locate a web - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 248
Index A access methods overview, 7 accessing the Traffic Manager, 8 Adaptive Redirection Module. See ARM adding virtual IP addresses, 49 administration tools, 5 administrator accounts, 85 adminport, 7, 8 alarm messages, 229 alarms, 5, 67 email notification, 68 resolving, 67 alternates, 14 ARM about, - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 249
Index files arm_security.config, 82, 160 bypass.config, 161 cache.config, 162 filter.config, 164 ftp_remap.config, 40 hosting.config, 166 icp.config, 167 ip_allow.config, 81, 168 ldapsrvr.config, 169 log_hosts.config, 114, 171 logs.config, 169 logs_xml.config, 171 mgmt_allow.config, 86, 176 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 250
Index mgmt_allow.config file, 86, 176 MIBs, 71 Monitor dashboard, 9 Monitor mode Traffic Line, 68 Traffic Manager, 9, 63 monitoring tools, 63 monitoring traffic, 63 MRTG about, 5 accessing, 70 navigating, 70 using, 70 MRTG button (Traffic Manager Monitor), 67 N name format for rolled log files, 109 - HP P4535A | HP Cache Server Appliance Administrator Guide - Page 251
Index SQL-like aggregate logging operators, 106 Squid logging formats, 224 SSL certificate, 87 enabling (Traffic Manager), 87 using to access Traffic Manager, 88 SSL termination about, 93 configuring, 94, 96 enabling, 94, 96 SSL certificate, 94, 96 stand-alone collators, 118 starting Traffic Line,
-
1 -
2 -
3 -
4 -
5 -
6 -
7 -
8
-
9
-
10
-
11
-
12
-
13
-
14
-
15
-
16
-
17
-
18
-
19
-
20
-
21
-
22
-
23
-
24
-
25
-
26
-
27
-
28
-
29
-
30
-
31
-
32
-
33
-
34
-
35
-
36
-
37
-
38
-
39
-
40
-
41
-
42
-
43
-
44
-
45
-
46
-
47
-
48
-
49
-
50
-
51
-
52
-
53
-
54
-
55
-
56
-
57
-
58
-
59
-
60
-
61
-
62
-
63
-
64
-
65
-
66
-
67
-
68
-
69
-
70
-
71
-
72
-
73
-
74
-
75
-
76
-
77
-
78
-
79
-
80
-
81
-
82
-
83
-
84
-
85
-
86
-
87
-
88
-
89
-
90
-
91
-
92
-
93
-
94
-
95
-
96
-
97
-
98
-
99
-
100
-
101
-
102
-
103
-
104
-
105
-
106
-
107
-
108
-
109
-
110
-
111
-
112
-
113
-
114
-
115
-
116
-
117
-
118
-
119
-
120
-
121
-
122
-
123
-
124
-
125
-
126
-
127
-
128
-
129
-
130
-
131
-
132
-
133
-
134
-
135
-
136
-
137
-
138
-
139
-
140
-
141
-
142
-
143
-
144
-
145
-
146
-
147
-
148
-
149
-
150
-
151
-
152
-
153
-
154
-
155
-
156
-
157
-
158
-
159
-
160
-
161
-
162
-
163
-
164
-
165
-
166
-
167
-
168
-
169
-
170
-
171
-
172
-
173
-
174
-
175
-
176
-
177
-
178
-
179
-
180
-
181
-
182
-
183
-
184
-
185
-
186
-
187
-
188
-
189
-
190
-
191
-
192
-
193
-
194
-
195
-
196
-
197
-
198
-
199
-
200
-
201
-
202
-
203
-
204
-
205
-
206
-
207
-
208
-
209
-
210
-
211
-
212
-
213
-
214
-
215
-
216
-
217
-
218
-
219
-
220
-
221
-
222
-
223
-
224
-
225
-
226
-
227
-
228
-
229
-
230
-
231
-
232
-
233
-
234
-
235
-
236
-
237
-
238
-
239
-
240
-
241
-
242
-
243
-
244
-
245
-
246
-
247
-
248
-
249
-
250
-
251
 |
 |
HP Cache Server Appliance
Administrator Guide
HP Part Number 5971-3045
Printed in June 2001