Format

Each line in the parent.config file must contain a parent caching rule. Content Gateway recognizes three space-delimited tags:

primary_destination=value secondary_specifier=value action=value

The following table lists the possible primary destinations and their allowed values.

Primary Destination Allowed Value
dest_domain A requested domain name
dest_host A requested hostname
dest_ip A requested IP address or range of IP addresses separated by a dash (-).
url_regex A regular expression to be found in a URL. See Specifying URL regular expressions (url_regex) for information about using regular expressions.

Secondary specifiers are optional in the parent.config file. The following table lists the possible secondary specifiers and their allowed values.

Secondary Specifier Allowed Value
time A time range, such as 08:00-14:00, during which the parent cache is used to serve requests
prefix A prefix in the path part of a URL
suffix A file suffix in the URL
src_ip A client IP address.
port A requested URL port
scheme

A request URL protocol; one of the following:

  • HTTP
  • FTP
method

A request URL method; one of the following:

  • get
  • post
  • put
  • trace
user_agent

A request header User-Agent value.

Takes a regular expression that is applied to the user-agent string. SeeSpecifying URL regular expressions (url_regex) for information about using regular expressions.

The following table lists the possible actions and their allowed values.

Action Allowed Value
parent An ordered list of parent servers. If the request cannot be handled by the last parent server in the list, it will be routed to the origin server. You can specify either a hostname or an IP address. You must specify the port number.
round_robin

One of the following values:

  • true - Content Gateway goes through the parent cache list in a round-robin based on client IP address.
  • strict - Content Gateway machines serve requests strictly in turn. For example, machine proxy1 serves the first request, proxy2 serves the second request, and so on.
  • false - round-robin selection does not occur.
go_direct

One of the following values:

  • true - requests bypass parent hierarchies and go directly to the origin server.
  • false - requests do not bypass parent hierarchies.