CSS Command Reference (Software Version 5.00)
Owner and Content Configuration Mode Commands

Table Of Contents

Owner Configuration Mode Commands

(config-owner) address

(config-owner) billing-info

(config-owner) case

(config-owner) content

(config-owner) dns

(config-owner) dnsbalance

(config-owner) email-address

(config-owner) no

(config-owner) zero

Content Configuration Mode Commands

(config-owner-content) active

(config-owner-content) add

add dns

add service

(config-owner-content) advanced-balance

(config-owner-content) application

(config-owner-content) arrowpoint-cookie

arrowpoint-cookie browser-expire

arrowpoint-cookie expiration

arrowpoint-cookie expire-services

arrowpoint-cookie path

(config-owner-content) balance

(config-owner-content) dns-disable-local

(config-owner-content) dnsbalance

(config-owner-content) failover

(config-owner-content) header-field-rule

(config-owner-content) hotlist

hotlist

hotlist interval

hotlist size

hotlist threshold

hotlist type

(config-owner-content) load-threshold

(config-owner-content) no

(config-owner-content) param-bypass

(config-owner-content) persistent

(config-owner-content) port

(config-owner-content) primarySorryServer

(config-owner-content) protocol

(config-owner-content) redirect

(config-owner-content) redundancy-l4-stateless

(config-owner-content) remove

(config-owner-content) secondarySorryServer

(config-owner-content) show rule-header-field

(config-owner-content) sticky-inact-timeout

(config-owner-content) sticky-mask

(config-owner-content) sticky-no-cookie-found-action

(config-owner-content) sticky-serverdown-failover

(config-owner-content) string

string ascii-conversion

string eos-char

string operation

string prefix

string process-length

string range

string skip-length

(config-owner-content) suspend

(config-owner-content) url

(config-owner-content) vip address

(config-owner-content) zero


Owner Configuration Mode Commands

Owner configuration mode allows you to configure an owner. An owner is an entity that owns Web content and uses the CSS to manage access to that content through content rules. Up to 255 owners can use a single CSS and each owner has a configurable profile.

To access owner configuration mode, use the owner command from any mode except ACL, boot, group, and RMON alarm, event, and history configuration modes. The prompt changes to (config-owner [owner_name]). You can also use this command in owner mode to access another owner. For information about commands available in this mode, refer to the following commands.

Use the no form of this command to delete an existing owner.

owner owner_name
no owner existing_owner_name

Syntax Description

owner_name

The name of a new owner you want to create or the name of an existing owner. Enter an unquoted text string with no spaces and a maximum length of 31 characters. To see a list of existing owner names, enter:

owner ?

(config-owner) address

To enter the address for the owner of the Web hosting service, use the address command. Use the no form of this command to delete an address for the owner.

address "address"
no address

Syntax Description

address

The street address for the owner. Enter a quoted text string with a maximum length of 128 characters.


(config-owner) billing-info

To enter billing information about the owner providing the Web hosting service, use the billing-info command. Use the no form of this command to delete the billing information.

billing-info "information"
no billing-info

Syntax Description

information

The billing information about the owner. Enter a quoted text string with a maximum length of 128 characters.


(config-owner) case

To define whether the matching of content requests to the owner's rules is case-sensitive, use the case command.

case [insensitive|sensitive]

Syntax Description

insensitive

Matching of the owner's rules is not case-sensitive. Uppercase and lowercase characters in content requests are ignored.

sensitive

Matching of the owner's rules is case-sensitive. Uppercase and lowercase characters in content requests are used as part of the matching criteria.


(config-owner) content

To access content configuration mode and configure a content rule, use the content command. Use the no form of this command to an existing content rule.

content content_rule_name
no content content_rule_name

Syntax Description

content_rule_name

The name of a new content rule you want to create or an existing rule you want to modify. Enter an unquoted text string with no spaces and a maximum length of 31 characters. Enter an existing name exactly. To see a list of existing rules, enter:

content ? 

Usage Guidelines

When you use the content command to access this mode, the prompt changes to (config-owner-content [owner-rule]). For information about commands available in this mode, refer to the commands in "Content Configuration Mode Commands".

Related Commands

show rule
(config) service

(config-owner) dns

To set the peer DNS exchange policy for the owner, use the dns command. The default DNS exchange policy for the owner is none; the owner is hidden from the CSS peer. Use the no form of this command to reset the DNS exchange policy for the owner to its default setting of none.

dns [accept|push|both]
no dns

Syntax Description

accept

Accepts all content rules proposed by the CSS peer

push

Advertises the owner and push all content rules onto the CSS peer

both

Advertises the owner and push all content rules onto the CSS peer, and accept all content rules proposed by the CSS peer


Related Commands

(config) dns
(config) dns-server
(config-owner-content) add

(config-owner) dnsbalance

To determine where to resolve a request for a domain name into an IP address, use the dnsbalance command. Use the no form of this command to reset the DNS load balancing method to its default setting of roundrobin.

dnsbalance [leastloaded|preferlocal|roundrobin]
no dnsbalance

Syntax Description

leastloaded

Resolves the request to the least-loaded local or remote domain site. The CSS first compares load numbers. If the load number between domain sites is within 50, then the CSS compares their response times. The site with the faster response time is considered the least loaded site.

Note For the leastloaded option to work properly, all domain sites must be running a minimum of CSS software version 3.02.

preferlocal

Resolves the request to a local VIP address. If all local systems exceed their load threshold, the CSS chooses the least-loaded remote system VIP address as the resolved address for the domain name.

roundrobin

Resolves the request by evenly distributing the load to resolve domain names amongst content domain sites, local and remote. The CSS does not include sites that exceed their local load threshold.


Usage Guidelines

The DNS load balancing method configured for the owner applies to all of its content rules. To set a different method to a specific content rule, use the (config-owner-content) dnsbalance command.

Related Commands

(config-owner-content) dnsbalance

(config-owner) email-address

To enter an email address for the owner providing the Web hosting service, use the email-address command. Use the no form of this command to delete the email address for the owner.

email-address "information"
no email-address

Syntax Description

information

The email address for the owner. Enter a quoted text string with a maximum length of 64 characters.


(config-owner) no

To negate a command or set it to its default, use the no command. For information on general no commands you can use in this mode, refer to the general no command. The following options are available in owner mode:

Syntax Description

no acl index

Deletes an ACL

no address

Deletes the address for the owner

no billing-info

Deletes the billing information for the owner

no content content_rule_name

Deletes an existing content rule

no dns

Resets the DNS exchange policy for the owner to its default setting of none

no dnsbalance

Resets the DNS load balancing method for the owner to its default setting of roundrobin

no email-address

Deletes the email address for the owner

no owner owner_name

Deletes an existing owner

no rmon-event index

Deletes an RMON event

no rmon-history index

Deletes an RMON history


(config-owner) zero

To set the content rule counters to zero, use the zero command.

zero all

Related Commands

show rule

Content Configuration Mode Commands

Content configuration mode allows you to configure a content rule. In the CSS, content refers to Web content that exists as an object or set of objects. Content rules:

Describe the content available at services

Tell the CSS where the content physically resides, whether local or remote

Specify how to treat requests for the content

Content rules are hierarchical. If a request for content matches more than one rule, the characteristics of the most specific rule apply to the flow.

To access content mode, use the content command from owner mode. The prompt changes to (config-owner-content [owner-rule]). You can also use this command in content mode to access another content rule. For information about commands available in this mode, refer to the following commands.

Use the no form of this command to delete an existing content rule.

(config-owner) content name
no content content_rule_name

Syntax Description

name

The name of a new content rule you want to create or an existing rule you want to modify. Enter an unquoted text string with no spaces and a maximum length of 31 characters. Enter an existing name exactly. To see a list of existing rules, enter:

content ? 

(config-owner-content) active

To activate the content rule you are configuring, use the active command. Activating a content rule includes it in CSS content rule matching and load balancing decisions.

active

Related Commands

show rule
show running-config
(config-owner-content) suspend

(config-owner-content) add

To add an existing service to the content rule or to specify a DNS name that maps to the content rule, use the add command. The options for this command are:

add dns..., specifies a DNS name that maps to the content rule

add service..., adds an existing service to the content rule

For more information on these options, refer to the following commands.

add dns

To specify a DNS name that maps to the content rule, use the add dns command.

add dns dns_name {ttl_value}
remove dns dns_name

Syntax Description

dns_name

The DNS name mapped to the content rule. Enter the name as a case-sensitive unquoted text string with no spaces and a maximum length of 63 characters.

ttl_value

The optional Time to Live (TTL) value in seconds. This value sets how long the DNS client remembers the IP address response to the query. Enter a value of 0 to 255. The default is 0.


Command Modes

Owner-Content

Usage Guidelines

To add a TTL value to an existing DNS name, remove the name and then re-add it with the TTL value

Use the remove dns command to remove a DNS name mapped to the content rule.

Related Commands

show rule
(config) dns
(config) dns-server
(config-owner) dns
(config-owner-content) remove

add service

To add an existing service to the content rule, use the add service command. Adding a service includes it in the resource pool that the CSS uses for load balancing requests for the content governed by the rule.

add service service_name weight number
remove service service_name

Syntax Description

service_name

The name of the existing service. Enter the name as a case-sensitive unquoted text string with no spaces.

weight

This option allows you to assign a weight to the service used when you configure ACA and weighted roundrobin load balancing on the content rule. When you assign a higher weight, the CSS redirects more requests to the service. To configure load balancing, refer to the (config-owner-content) balance command.

number

The weight for the service. Enter a number from 1 to 10. The default is the weight configured for the service through the (config-service) weight command. By default, all services have a weight of 1.


Command Modes

Owner-Content

Usage Guidelines

Use the remove service command to remove a service.

Related Commands

show rule
(config) service
(config-owner-content) balance
(config-owner-content) remove
(config-service) weight

(config-owner-content) advanced-balance

To specify an advanced load balancing method for the content rule, including stickiness, use the advanced-balance command. A content rule is "sticky" when additional sessions from the same user or client are sent to the same service as the first connection, overriding normal load balancing. By default, the advanced balancing method is disabled. Use the no form of this command to disable the advanced balancing method.

advanced-balance [arrowpoint-cookie|cookies|cookieurl|none
|sticky-srcip|sticky-srcip-dstport|ssl|url|wap-msisdn]
no advanced-balance

Syntax Description

arrowpoint-cookie

Enables the content rule to stick the client to the server based on the unique service identifier information of the selected server in the ArrowPoint-generated cookie. Configure the service identifier by using the (config-service) string command. You do not need to configure string match criteria.

For information on configuring the ArrowPoint-generated cookie, refer to the (config-owner-content) arrowpoint-cookie command. You can use this option with any Layer 5 content rule.

cookies

Enables the content rule to stick the client to the server based on the configured string found in the HTTP cookie header. You must specify a port in the content rule to use this option. The CSS will then spoof the connection. A content rule with a sticky configuration set to advanced-balance cookies requires all clients to enable cookies on their browser.

When a client makes an initial request, they do not have a cookie. But once they go to a server that is capable of setting cookies, they receive the cookie from the server. Each subsequent request contains the cookie until the cookie expires. A string in a cookie can be used to stick a client to a server. The service mode string command enables you to specify where the CSS should locate the string within the cookie.

The CSS processes the cookie using:

An exact match that you set up when you configure the services

Data for a hash algorithm

cookieurl

Same as advanced-balance cookies, but if the CSS cannot find the cookie header in the HTTP packet, this type of failover looks up the URL extensions (that is, the portion after the "?" in the URL) based on the same string criteria. You can use this option with any Layer 5 HTTP content rule.

This option is useful if a Microsoft© IIS Web server is used with Cookie Munger, that dynamically places the session state information in the cookie header or URL extension depending on whether or not the client can accept cookies.

Some client applications do not accept cookies. When a site depends upon the information in the cookie, administrators sometimes modify the server application so that it appends the cookie data to the parameters section of the URL. The parameters typically follow a "?" at the end of the main data section of the URL.

Advanced-balanced cookieurl sticks a client to a server based on locating the configured string:

In the cookie, if a cookie exists

In the parameters section of the URL if no cookie exists

The string can either be an exact match or be hashed.

none

Disables the advanced-balancing method for the rule (default).

sticky-srcip

Enables the content rule to stick a client to a server based on the client IP address, also known as Layer 3 stickiness. You can use this option with Layer 3, 4, or 5 content rules.

sticky-srcip-dstport

Enables the content rule to stick a client to a server based on both the client IP address and the server destination port number, also known as Layer 4 stickiness. You can use this option with Layer 4 or 5 content rules.

ssl

Enables the content rule to stick the client to the server based on the Secure Socket Layer (SSL) version 3 session ID assigned by the server. The application type must be SSL for the content rule. You must specify a port in the content rule to use this option. The CSS will then spoof the connection.

Sites where encryption is required for security purposes often use SSL. SSL contains session IDs and the CSS has the ability to use these session IDs for sticking the client to a server. In order for the CSS to successfully provide SSL stickiness, the application must be using SSL version 3 session IDs. Sticky SSL uses the sticky table. If you are concerned about the number of concurrent sessions, and not concerned about security, you should consider using cookie, cookieurl, or url.

url

Enables the content rule to stick a client to a server based on a configured string found in the URL of the HTTP request. You must specify a port in the content rule to use this option. The CSS will then spoof the connection. Similar to advanced-balanced cookie, advanced-balanced url may use either an exact match method or a hash algorithm. The string can exist anywhere in the URL.

To use stickiness based on SSL version 3 session ID, configure an SSL Layer 5 rule for the service:

Set the port to 443 with the (config-owner-content) port command.

Set the URL to /* with the (config-owner-content) url command.

Enable the content rule to be sticky based on SSL with the (config-owner-content) advanced-balance ssl command.

Specify the SSL application type with the (config-owner-content) application command.

Note You cannot configure the application ssl and url urql commands on the same content rule.

wap-msisdn

Enables a Layer 5 content rule to stick a client to a server based on the MSISDN header of the HTTP request. MSISDN is the header field for wireless clients using the Wireless Application Protocol (WAP).

If the CSS finds the MSISDN header in an HTTP request, the CSS generates a key based on the value in the header field. The CSS uses the key to look up an entry in the sticky table. If the entry exists, the CSS sends the client to the sticky server indicated by the table entry. If the entry does not exist, the CSS creates a new sticky entry, hashes the MSISDN value into a key, and saves the key in the entry.

If the CSS does not find the MSISDN header, the CSS load balances the client request based on the balance method configured through the (config-owner-content) balance command.

You can use the advanced-balance wap-msisdn command alone or with the MSISDN header field type. Refer to the (config-header-field-group) header-field command.


Command Modes

Owner-Content

Related Commands

show rule
(config-owner-content) sticky-mask
(config-owner-content)
string range

(config-owner-content) application

To specify the application type associated with the content rule, use the application command. The application type enables the CSS to correctly interpret the data stream matching the content rule and parse them. Otherwise, the data stream packets are rejected. Use the no form of this command to reset the application type to its default setting of HTTP.

application type
no application

Syntax Description

type

The application type. Enter one of the following:

bypass, to bypass the matching of the content rule and send the request directly to the origin server.

http (default), to process HTTP data streams.

ftp-control, to process FTP data streams.

realaudio-control, to process RealAudio Control data streams.

ssl, to process Secure Socket Layer (SSL) protocol data streams.


Usage Guidelines

You cannot configure the application ssl and url urql commands on the same content rule.

Define an application type for non-standard ports.

(config-owner-content) arrowpoint-cookie

To configure the ArrowPoint cookie path and expiration, use the arrowpoint-cookie command.

arrowpoint-cookie browser-expire..., allows the browser to expire the cookie

arrowpoint-cookie expiration..., sets an expiration time which the CSS compares with the time associated with the cookie

arrowpoint-cookie expire-services..., expires the service information when the cookie expires

arrowpoint-cookie path..., sets the cookie path to a configured path

For more information about these options, refer to the following commands.

Usage Guidelines

The CSS transparently generates the ArrowPoint cookie for the client, the client stores it and returns it in subsequent requests, and the CSS later uses it to maintain the client-server stickiness. The cookie contains the sticky information itself and does not refer to a sticky table.

If you configure the arrowpoint-cookie method in the content rule, the CSS always check for the existence of the ArrowPoint cookie when it receives a client request. If this cookie does not exist, the CSS performs a server load balance and generates an ArrowPoint cookie. When the CSS finds the cookie in the client request, it unscrambles the cookie data and then validates it. Then, the CSS checks the cookie expiration time. If the cookie has expired, the CSS sends a new cookie the information about the server where the client was stuck. This will allow for the appearance of an uninterrupted connection.

If the cookie format is valid, the CSS ensures the consistency between the cookie and the CSS configuration. When all the validations are passed, the CSS forwards the client request to the server indicated by the server identifier. Otherwise, the CSS treats the request as an initial request.

If the cookie is valid but the sticky server is not available, the CSS uses the sticky-serverdown-failover configuration to handle the request. If the configured sticky-serverdown-failover type is balance, then the CSS treats the client request as an initial client request without the ArrowPoint cookie, runs through the load balance algorithm to choose a server, and then redirects with a generated ArrowPoint cookie. If the sticky-serverdown-failover type is redirect, the CSS redirects the request to the specified URL.

Related Commands

show rule
(config-owner-content) advanced-balance

arrowpoint-cookie browser-expire

To allow the browser to expire the ArrowPoint cookie based on the expiration time, use the arrowpoint-cookie browser-expire command. To configure the expiration time, refer to the arrowpoint-cookie expiration command. Use the no form of this command to allow the CSS to expire the cookie.

arrowpoint-cookie browser-expire
no arrowpoint-cookie browser-expire

Command Modes

Owner-Content

Usage Guidelines

When the cookie expires, all sticky information is lost.

Related Commands

arrowpoint-cookie expiration

arrowpoint-cookie expiration

To set the cookie duration time which the CSS compares with the time associated with the ArrowPoint cookie, use the arrowpoint-cookie expiration command. When the cookie time exceeds the duration time, the CSS expires the cookie. To allow the browser to expire the cookie, use the arrowpoint-cookie browser-expire command. Use the no form of this command to expire the cookie when you close the browser.

arrowpoint-cookie expiration dd:hh:mm:ss
no arrowpoint-cookie expiration

Syntax Description

dd

The number of days. Valid numbers are from 00 to 99.

hh

The number of hours. Valid numbers are from 00 to 99.

mm

The number of minutes. Valid numbers are from 00 to 99.

ss

The number of seconds. Valid numbers are from 00 to 99.


Command Modes

Owner-Content

Usage Guidelines

If the cookie has expired, the CSS sends a new cookie that includes the server where the client was stuck. This will allow for the appearance of an uninterrupted connection.

Examples

For example, to set an expiration time of 2 days, 3 hours, 21 minutes and 0 seconds, enter:

arrowpoint-cookie expiration 02:03:21:00

Related Commands

arrowpoint-cookie browser-expire

arrowpoint-cookie expire-services

To expire service information when the cookie expires before sending a new cookie, use the arrowpoint-cookie expire-services command. By default, when the cookie expires, the CSS sends a new cookie with the server information from the expired cookie. Use the no form of this command to reset the default behavior.

arrowpoint-cookie expire-services
no arrowpoint-cookie expire-services

Command Modes

Owner-Content

arrowpoint-cookie path

To set the ArrowPoint cookie path to a configured path, use the arrowpoint-cookie path command. Otherwise, the CSS sets the default path attribute of the cookie to "/". Use the no form of this command to reset the cookie path to its default of "/".

arrowpoint-cookie path "path_name"
no arrowpoint-cookie path

Syntax Description

path_name

The pathname where you want to send the cookie. Enter a quoted text string with a maximum of 99 characters. The default path of the cookie is "/".


Command Modes

Owner-Content

Related Commands

(config-owner-content) advanced-balance arrowpoint-cookie

(config-owner-content) balance

To specify the load-balancing algorithm for the content rule, use the balance command. Use the no form of this command to reset the load balancing algorithm to its default setting of roundrobin.

balance [aca|destip|domain|domainhash|leastconn|roundrobin|srcip|url
|urlhash|weightedrr]
no balance

Syntax Description

aca

ArrowPoint Content Awareness algorithm. The CSS correlates content request frequency with the server's cache sizes to improve cache hit rates for that server.

destip

Destination IP address division. The CSS directs all client requests with the same destination IP address to the same service.

domain

Domain name division. The CSS uses the domain name in the request URI to direct the client request to the appropriate service.

domainhash

Internal CSS hash algorithm based on the domain string. The CSS uses the algorithm to hash the entire domain string. Then, the CSS uses the hash result to choose the server.

leastconn

Least connections. The CSS chooses a running service that has the least number of connections.

We do not recommend that you use UDP content rules with the leastconn load-balancing algorithm. The service connection counters do not increment and remain at 0 because UDP is a connectionless protocol. Because the counters remain at 0, the CSS will give inconsistent results.

roundrobin

Roundrobin algorithm (default).

srcip

Source IP address division. The CSS directs all client requests with the same source IP address to the same service.

url

URL division. The CSS uses the URL (omitting the leading slash) in the redirect URL to direct the client requests to the appropriate service.

urlhash

Internal CSS hash algorithm based on the URL string. The CSS uses the algorithm to hash the entire URL string. Then, the CSS uses the hash result to choose the server.

weightedrr

Weighted roundrobin algorithm. The CSS uses the roundrobin algorithm but weighs some services more heavily than others. You can configure the weight of a service when you add it to the rule.


Usage Guidelines

Before you can change the balance method, you must suspend the rule.

Related Commands

show rule
(config-owner-content)
add service
(config-owner-content) advanced-balance
(config-owner-content)
string operation

(config-owner-content) dns-disable-local

To disable DNS on the content rule, use the dns-disable-local command. The CSS informs other CSSs through APP that the services related to the content rule are not available for DNS activities. However, the services remain active for other activities.

Use the no form of this command to enable DNS on the content rule.

dns-disable-local
no dns-disable-local

(config-owner-content) dnsbalance

To determine where to resolve a request for a domain name into an IP address, use the dnsbalance command. By default, the content rule will use the DNS load balancing method assigned to the owner.

Use the no form of this command to reset the DNS load balancing method to its default setting of using the method assigned to the owner.

dnsbalance [leastloaded|preferlocal|roundrobin|useownerdnsbalance]
no dnsbalance

Syntax Description

leastloaded

Resolves the request to the least-loaded local or remote domain site. The CSS first compares load numbers. If the load number between domain sites is within 50, then the CSS compares their response times. The site with the faster response time is considered the least loaded site.

Note For the leastloaded option to work properly, all domain sites must be running a minimum of CSS software version 3.02.

preferlocal

Resolves the request to a local VIP address. If all local systems exceed their load threshold, the CSS chooses the least-loaded remote system VIP address as the resolved address for the domain name.

roundrobin

Resolves the request by evenly distributing the load to resolve domain names amongst content domain sites, local and remote. The CSS does not include sites that exceed their local load threshold.

useownerdnsbalance

Resolves the request by using the DNS load balancing method assigned to the owner. This is the default method for the content rule. If you do not implicitly set an owner method, the CSS uses the default owner DNS load balancing method of roundrobin.


Usage Guidelines

Before you can change the DNS balance method, you must suspend the rule.

Related Commands

(config-owner) dnsbalance

(config-owner-content) failover

To define what will happen to content requests when a service fails or is suspended, use the failover command. For the CSS to use this setting, you must configure keepalive for each service. Use the no form of this command to reset the failover for the content rule to its default setting of linear. The linear failover method distributes the content requests to the failed service evenly between the remaining services.

failover [bypass|next]
no failover

Syntax Description

bypass

Bypasses all services and send the content request directly to the origin service.

next

Sends the content requests to the service next to the failed service. The CSS selects which service is next to the failed one by referring to the order in which the services were configured.


Usage Guidelines

If you remove a service, the CSS rebalances the remaining services. The CSS does not use the failover command setting.

Before you can change the failover method, you must suspend the rule.

Related Commands

(config-owner-content) balance
(config-service) keepalive

(config-owner-content) header-field-rule

To associate a header-field group to a content rule, and optionally assign a weight value to the header-field group, use the header-field-rule command. Use the no form of this command to remove the header-field group from the rule.

header-field-rule name {weight number}
no header-field-rule

Syntax Description

name

The name of the header-field group used with the content rule. To see a list of groups, enter:

header-field-rule ?

number

The weight you want to assign to the header-field group. Enter a number from 0 to 1024. The default weight is 0.


Usage Guidelines

Use weights to allow the CSS to prefer one content rule over a similar content rule. For example, you want to load balance French clients to a specific server, and you also want to differentiate French Internet Explorer clients from French Netscape clients. If it is more important to direct the French clients to a specific server than to direct them to a server based on whether they are using Internet Explorer or Netscape, then you need to weight the "french" content rule higher than the "Internet Explorer/Netscape" content rule.

Before you can change the header-field group, you must suspend the rule.

Related Commands

show rule
(config) header-field-group

(config-owner-content) hotlist

To enable the hotlist for the content rule and configure hotlist parameters, use the hotlist command. A hotlist lists the most requested content during a user-defined period of time. The options for this content mode command are:

hotlist, enables the hotlist for the content rule

hotlist interval..., sets the hotlist refresh interval

hotlist size..., sets the size of the hotlist

hotlist threshold..., sets the hotlist threshold

hotlist type..., sets the hotlist type to hit count

For more information on these options, refer to the following commands.

hotlist

To enable the hotlist for the content rule, use the hotlist command. Use the no form of this command to disable the hotlist for the content rule.

hotlist
no hotlist

Command Modes

Owner-Content

hotlist interval

To set the hotlist refresh interval, use the hotlist interval command. Use the no form of this command to reset the hotlist interval for the content rule to its default setting of 1 minute.

hotlist interval time
no hotlist interval

Syntax Description

time

The interval, in minutes, for refreshing the hotlist. Enter an integer from 1 to 60. The default is 1.


Command Modes

Owner-Content

hotlist size

To set the size of the hotlist, use the hotlist size command. Use the no form of this command to reset the hotlist size for the content rule to its default setting of 10 entries.

hotlist size entries
no hotlist size

Syntax Description

entries

The total number of hotlist entries that is maintained for the rule. Enter an integer from 1 to 100. The default is 10.


Command Modes

Owner-Content

hotlist threshold

To set the hotlist threshold, use the hotlist threshold command. Use the no form of this command to reset the hotlist threshold for the content rule to its default setting of 0.

hotlist threshold threshold
no hotlist threshold

Syntax Description

threshold

The threshold below which an item is not considered hot. Enter an integer from 0 to 65535. The default is 0.


Command Modes

Owner-Content

hotlist type

To set the hotlist type, use the hotlist type command. Currently, the CSS supports only the hit count hotlist type, which is the default setting. Hit count is the number of times that the content is accessed. Use the no form of this command to reset the hotlist type for the content rule to its default setting of hitCount.

hotlist type hitCount
no hotlist type

Command Modes

Owner-Content

(config-owner-content) load-threshold

To set the normalized load threshold for the availability of each local service on the content rule, use the load-threshold command. When the service load metric exceeds this threshold, the local service becomes unavailable and is redirected to the remote services.

Use the no form of this command to reset the load threshold for the content rule to its default setting of 254.

load-threshold threshold
no load-threshold

Syntax Description

threshold

The maximum load. Enter an integer from 2 through 254. The default is 254, which is the maximum load. To view the load on services, enter:

show service

(config-owner-content) no

To negate a command or set it to its default for the content rule, use the no command. For information on general no commands you can use in this mode, refer to the general no command. The following options are available in content mode.

Syntax Description

no acl index

Deletes an ACL

no advanced-balance

Disables the advanced balancing method for the content rule

no application

Resets the application type to its default setting of HTTP

no arrowpoint-cookie browser-expire

Resets the cookie expiration method to the time configured through the arrowpoint-cookie expiration command

no arrowpoint-cookie expiration

Resets the expiration time to one year after the timestamp on the cookie

no arrowpoint-cookie expire-services

Resets the default behavior of sending a new ArrowPoint cookie with the server information from the expired cookie

no arrowpoint-cookie path

Resets the ArrowPoint cookie path to its default of "/"

no balance

Resets the load balancing algorithm to its default setting of roundrobin

no dns-disable-local

Enables DNS on the content rule

no dnsbalance

Resets the DNS load balancing method to its default setting of using the method assigned to the owner

no failover

Resets the failover to its default setting of linear

no header-field-rule

Removes the header-field group from the content rule

no hotlist

Disables the hotlist for the content rule

no hotlist interval

Resets the hotlist interval to its default setting of 1minute

no hotlist size

Resets the hotlist size to its default setting of 10 entries

no hotlist threshold

Resets the hotlist threshold to its default setting of 0 entries

no hotlist type

Resets the hotlist type to its default setting of hit count

no load-threshold

Resets the load threshold to its default setting of 254

no owner existing_owner_name

Deletes an existing owner

no persistent

Disables persistence

no port

Resets the port number to its default value of 0

no primarySorryServer

Removes the primary sorry service from the rule

no protocol

Resets the protocol for the content rule to its default of any

no redirect

Deletes the redirect URL

no redundancy-l4-stateless

Disables stateless redundancy failover

no rmon-event index

Deletes an RMON event

no rmon-history index

Deletes an RMON history

no secondarySorryServer

Removes the secondary sorry service from the rule

no sticky-inact-timeout

Disables the sticky connection inactivity timeout feature

no sticky-mask

Resets the sticky mask to 255.255.255.255

no sticky-no-cookie-found-action

Resets sticky-no-cookie-found-action to the default of loadbalance

no sticky-serverdown-
failover

Sets the sticky server failover method to its default setting of using the configured load balancing method

no string ascii-conversion

Enables the ASCII conversion of escaped special characters within the specified sticky range before applying any processing to the string

no string eos-char

Clears the end of string characters as the delimiters for the sticky string

no string operation

Resets the string operation to choose a server by matching a service cookie in the sticky string

no string prefix

Clears the string prefix

no string process-length

Resets the number of bytes that the string operation will use to its default of 0

no string range

Resets the string range within a cookie, URL, or URL extension from a client to its default setting of 1 to 100

no string skip-length

Resets the number of bytes to skip after the end of a prefix to find the string result to its default of 0

no url

Removes the URL for the content rule

no vip address

Clears the VIP address for the content rule


(config-owner-content) param-bypass

To enable content requests to bypass transparent caches when the CSS detects special terminators in the requests, use the param-bypass command. These terminators include "#" and "?" which indicate that the content is dependent on the arguments that follow the terminators. Because the content returned by the server is dependent on the content request itself, the returned content is not cacheable.

param-bypass [disable|enable]

Syntax Description

disable

Content requests with special terminators do not bypass transparent caches. This is the default setting.

enable

Content requests with special terminators bypass transparent caches and are forwarded to the origin server.


Related Commands

show rule

(config-owner-content) persistent

To maintain a persistent connection with a server, use the persistent command. By default, persistence is enabled. Use the no form of this command to disable persistence.

persistent
no persistent

Usage Guidelines

In content rule persistence, the CSS keeps the client on the same service connection specified by the content rule for an entire flow session as long as a new content request:

Matches on the same content rule that specified the current service

Matches on a new content rule that contains the current service, even if a different best service is specified by the content rule

Does not match on a content rule, but a previous content rule match connected the client to the current service

If you are using transparent caches (which prefetch content) or mirrored-content servers, this scheme works well because the same content is available on each service.


Note If a request for content on a persistent connection matches on a new content rule that does not contain the current service, or persistence is disabled and there is a better service configured in the content rule, the CSS redirects or remaps the current connection to a new best service based on the setting of the (config) persistence reset command, if configured. If you do not configure persistence reset, the CSS performs an HTTP redirect by default.


Disabling persistence allows the CSS to move a connection to a better service on the same rule or to utilize cache bypass functionality (EQLs or failover bypass). Disable persistence on a content rule with:

A balance method of domain or domain hash when using proxy caches

A balance method of url or urlhash when using transparent caches

A failover method of bypass when using transparent caches

An EQL bypass with a transparent cache

Adding a sorry server to a content rule

Related Commands

(config) bypass persistence
(config) persistence reset

(config-owner-content) port

To specify the content rule's TCP/UDP port number, use the port command. The port number for a content rule is the port number used by incoming requests for the content governed by the rule. Use the no form of this command to reset the port number to its default value of 0.

port number
no port

Syntax Description

number

The TCP or UDP incoming port number associated with the content rule. Enter an integer from 0 to 65535. The default value is 0.

To use stickiness based on the Secure Socket Layer (SSL) session ID, set the port to 443. Then, set the URL to /* with the (config-owner-content) url command, and enable stickiness with the (config-owner-content) advanced-balance ssl command. Then specify an SSL application type.


Usage Guidelines

Before you can change the port number, you must suspend the rule.

Related Commands

show rule
(config-owner-content) protocol

(config-owner-content) primarySorryServer

To configure the primary sorry service for the content rule, use the primarySorryServer command. A sorry service is a server that is used for content requests when all other services are unavailable. You can configure the service to contain content, or to provide a drop or redirect message. The service is not used in load balancing. Use the no form of this command to remove a primary sorry service.

primarySorryServer service_name
no primarySorryServer

Syntax Description

service_name

The name of the existing service. Enter the name as a case-sensitive unquoted text string with no spaces.


Usage Guidelines

Do not configure a sorry server on a content rule used for matching non-cacheable content.

Related Commands

show rule
(config) service
(config-owner-content) secondarySorryServer

(config-owner-content) protocol

To specify the content rule's IP protocol, use the protocol command. The protocol for a content rule is the protocol used by incoming requests for the content governed by the rule. Use the no form of this command to reset the protocol to its default value of any.

protocol [any|tcp|upd]
no protocol

Syntax Description

any

The content rule uses any protocol. This is the default protocol.

tcp

The content rule uses the TCP protocol suite.

udp

The content rule uses the UDP protocol suite.


Usage Guidelines

Before you can change the protocol, you must suspend the rule.

Related Commands

show rule
(config-owner-content) port

(config-owner-content) redirect

To set HTTP status code 302 for the content rule, use the redirect command. Use the no form of this command to delete the redirect URL.

redirect "url"
no redirect

Syntax Description

url

The URL to send with HTTP status code 302. Enter a quoted text string and a maximum length of 64 characters.


Usage Guidelines

The redirect command makes the content at its current address unavailable to subsequent requests, and provides a message to send with the status code back to the requestor. Specify a message that returns the alternate location of the content governed by the rule.

Related Commands

show rule

(config-owner-content) redundancy-l4-stateless

To enable the Stateless Redundancy Failover feature for a content rule on a redundant CSS, use the redundancy-l4-stateless command. The CSS can set up a connection for a mid-stream TCP flow, allowing TCP traffic to continue when a failure occurs at the load-balancing CSS. By default, the CSS rejects TCP sessions that do not begin with a TCP/SYN frame. Use the no form of this command to reset the default behavior of the CSS.

redundancy-l4-stateless
no redundancy-l4-stateless

Command Modes

Owner-content configuration mode

Usage Guidelines

The Stateless Redundancy Failover feature has specific environment and configuration requirements. The environment requirements are as follows:

Layer 3 and Layer 4 content rules with a VIP address. This feature is not supported in Layer 5 configurations.

Source IP address load balance method only.

CSS-to-CSS identical server and content rule configuration including:

Content VIP address.

Content balance method.

Failover method.

Service IP address, number, and order. The CSS orders services alphabetically. Apply identical service names on the master and backup CSSs.

Visibility of identical servers to keepalive traffic from CSS to CSS. This ensures that the redistribution of the balance method does not occur in a failover event.

Redundant routes in a high availability topology surrounding the CSS are supported. However, the topology must not balance packets in a TCP/IP socket connection across more than one Ethernet port on the CSS.

IP and VIP redundant configurations are supported. The configuration requirement for each server farm is synchronization across all CSSs of:

Membership and IP addresses of the server farms.

Content rule VIP address. Each CSS must share the content VIP address that is used as a balance point for the server farm.

Source group VIP address. Define each CSS with a source group VIP address as the content VIP address to NAT source addresses for packets returning from the server. In case of a failover, the source group handles connection setups for TCP/IP retransmissions that arrive at the CSS from a server. All servers on the farm must be a member of the source group.

Do not configure source groups for outbound traffic from the servers because the backup CSS does not know which ports were mapped by the source group on the master CSS.

For more detailed information on Stateless Redundancy Failover, refer to the Content Services Switch Advanced Configuration Guide.

Related Commands

show redundancy
(config) ip redundancy
(config) group
(config) interface
(config) service
(config-group) redundancy-l4-stateless
(config-owner) content

(config-owner-content) remove

To remove either a DNS name or an existing service from the content rule, use the remove command.

remove [dns dns_name|service service_name]

Syntax Description

dns

Removes the DNS name from the content rule.

dns_name

The DNS name. Enter the name as a case-sensitive unquoted text string with no spaces and a maximum length of 32 characters. To see a list of DNS names, enter:

remove dns ?

service

Removes an existing service from the content rule. Removing a service removes it from the resource pool that the CSS uses for balancing the load of requests for the content governed by the rule. The CSS rebalances the remaining services. It does not use the failover command setting.

service_name

The name of the existing service. Enter the name as a case-sensitive unquoted text string with no spaces and a maximum length of 32 characters. To see a list of service names, enter:

remove service ?

Related Commands

show rule
(config-owner-content) add

(config-owner-content) secondarySorryServer

To configure the secondary sorry service for the content rule, use the secondarySorryServer command. Use the no form of this command to remove a secondary sorry service.

secondarySorryServer service_name
no secondarySorryServer

Syntax Description

service_name

The name of the existing service. Enter the name as a case-sensitive unquoted text string with no spaces.


Usage Guidelines

A secondary sorry service is a backup service that is used when the primary sorry service is unavailable. You can configure the service to contain content, or to provide a drop or redirect message. The service is not used in load balancing.

Do not configure a sorry server on a content rule used for matching non-cacheable content.

Related Commands

show rule
(config) service
(config-owner-content) primarySorryServer

(config-owner-content) show rule-header-field

To display information about the header-field rule and group associated with a content rule, use the show rule-header-field command.

show rule-header-field

Examples

To display information about the header-field rule and group associated with a content rule, enter:

(config-owner-content[test-rule1])# show rule-header-field
header-field-rule: palmpilot.
 lookup pass: 0, lookup fail: 0.

header field group : palmpilot              Description: Palm Pilot 
users
  header-field 1 user-agent contain "PalmPilot"

Related Commands

(config-owner-content) header-field-rule

(config-owner-content) sticky-inact-timeout

To specify the inactivity timeout period on a sticky connection for a content rule before the CSS removes the sticky entry from the sticky table, use the sticky-inact-timeout command. Use the no form of this command to disable the sticky connection inactivity timeout feature.

sticky-inact-timeout minutes
no sticky-inact-timeout

Syntax Description

minutes

The number of minutes of inactivity. Enter a number from 0 to 65535. The default value is 0, which means this feature is disabled. When disabled, the CSS does not remove the entry from the table until the sticky table is full. When table is full, the CSS recycles the least used sticky entry first.


Usage Guidelines

When you configure the inactivity timeout period, the CSS keeps the sticky entry in the sticky table for the specified amount of time. The CSS does not reuse the entry until the time expires. If the sticky table is full and none of the entries has expired, the CSS rejects the new sticky request. When the sticky connection expires, the CSS uses the configured load balance method to choose an available server for the request.

When this feature is disabled, the new sticky connection uses the oldest used sticky entry. A sticky association could exist for a time depending on the sticky traffic load on the CSS.

Related Commands

show rule

(config-owner-content) sticky-mask

To mask a group of client IP addresses in order to preserve the client connection state when the client's source IP address changes, use the sticky-mask command. Use the no form of this command to reset the default sticky mask of 255.255.255.255.

sticky-mask subnet_mask
no sticky-mask

Syntax Description

subnet_mask

The subnet mask used for stickiness. Enter the IP mask in dotted-decimal format (for example, 255.255.255.0). The default is 255.255.255.255.


Usage Guidelines

The client's source IP address change occurs when a client-server connection is lost and the client sends a different IP address. The CSS needs to reconnect the client to the same server that is preserving the client information.

Related Commands

show rule
(config-owner-content) advanced-balance
(config-owner-content)
string range

(config-owner-content) sticky-no-cookie-found-action

To specify the action the CSS should take for a sticky cookie content rule when it cannot locate the cookie header or the specified cookie string in the client request, use the sticky-no-cookie-found-action command. Use the no form of this command to reset sticky-no-cookie-found-action to the default of loadbalance.

sticky-no-cookie-found-action [loadbalance|redirect "URL"|reject|service name]
no sticky-no-cookie-found-action

Syntax Description

loadbalance

The CSS uses the configured balanced method when no cookie is found in the client request. This option is the default setting.

redirect "URL"

The CSS redirect the client request to a specified URL string when no cookie found in the client request. When using this option, you must also specify a redirect URL. Enter the redirect URL as a quoted text string from 0 to 64 characters.

reject

The CSS rejects the client request when no cookie is found in the request.

service name

The CSS sends the no cookie client request to the specified service when no cookie is found in the request.


(config-owner-content) sticky-serverdown-failover

To define what will happen when a sticky string is found but the associated service has failed or is suspended, use the sticky-serverdown-failover command. Use the no form of this command to set the sticky failover method to its default setting of using the configured load balancing method.

sticky-serverdown-failover [balance|redirect|reject|sticky-srcip|sticky-srcip-dstport]
no sticky-serverdown-failover

Syntax Description

balance

Sets the failover method to use a service based on the configured load balancing method.

redirect

Sets the failover method to use a service based on the currently configured redirect string. If a redirect string is not configured, the load balancing method is used.

reject

Rejects the content request.

sticky-srcip

Sets the failover method to use a service based on the client IP address. This is dependent on the sticky configuration.

sticky-srcip-dstport

Sets the failover method to use a service based on the client IP address and the server destination port. This is dependent on the sticky configuration.


Related Commands

(config-owner-content) balance
(config-owner-content) redirect

(config-owner-content) string

To set string criteria to derive string results and the method to choose a destination server for the result, use the string command and its options. The string result is a sticky string in the cookie header, URL, or URL extension based on a sticky type being configured.

The options for this content mode command are:

string ascii-conversion...., enables or disables the ASCII conversion of escaped special characters within the specified sticky range before applying any processing to the string

string eos-char..., specifies the delimiters for the sticky string

string operation..., specifies the method to choose a destination server for a string result

string prefix..., specifies the string prefix located in the sticky range

string process-length..., specifies how many bytes, after the end of the prefix designated by the string prefix command and skipping the bytes designated by the string skip-length command, that the string operation will use

string range..., specifies the starting and ending byte positions within a cookie, URL, or URL extension from a client

string skip-length..., specifies how many bytes to skip after the end of prefix to find the string result

For more information on these options, refer to the following commands.

string ascii-conversion

To enable or disable the ASCII conversion of escaped special characters within the specified sticky range before applying any processing to the string, use the string ascii-conversion command. By default, ACSII conversion is enabled. Use the no form of this command to re-enable the ASCII conversion of special escaped characters.

string ascii-conversion [enable|disable]
no string ascii-conversion

Command Modes

Owner-Content

Related Commands

(config-owner-content) string range

string eos-char

To specify up to three ASCII characters as the delimiters for the sticky string, use the string eos-char command. For example, in a cookie header, a ";" character is usually used as a delimiter; in a URL extension, a "&" character is often used as a delimiter. Use the no form of this command to clear the end of string characters.

string eos-char "characters"
no string eos-char

Syntax Description

character

The end of string characters. Enter a quoted text string with a maximum of three characters.


Command Modes

Owner-Content

Usage Guidelines

The CSS uses this command if the string process-length command is not configured; the string process-length command has higher precedence. If neither commands are configured, the CSS uses the maximum 64 bytes for the final string operation.

Related Commands

(config-owner-content) string process-length

string operation

To determine the method to choose a destination server for a string result, derived from the settings of the string criteria commands, use the string operation command. You can choose a server by using the configured balance method or by using the hash key generated by specified sticky hash type.

Use the no form of this command to reset the string operation to its default setting, choosing a server by matching a service cookie in the sticky string.

string operation [match-service-cookie|hash-a|hash-crc32|hash-xor]
no string operation

Syntax Description

match-service-cookie

Choose a server by matching a service cookie in the sticky string. This is the default setting. When a match is not found, the server is chosen by using the configured balance method (for example, roundrobin).

hash-a

Choose a server by applying a basic hash algorithm on the hash string to generate the hash key.

If the selected server is out of service, the CSS performs a rehash to choose another server.

hash-crc32

Choose a server by applying the CRC32 algorithm on the hash string to generate a hash key.

If the selected server is out of service, the CSS performs a rehash to choose another server.

hash-xor

Choose a server by performing an Exclusive OR (XOR) each byte of the hash string to derive the final hash key.

If the selected server is out of service, the CSS performs a rehash to choose another server.


Command Modes

Owner-Content

Related Commands

(config-owner-content) string ascii-conversion
(config-owner-content)
string eos-char
(config-owner-content)
string prefix
(config-owner-content)
string process-length
(config-owner-content)
string skip-length

string prefix

To specify the string prefix located in the sticky range, use the string prefix command. Use the no form of this command to clear the string prefix.

string prefix "text"
no string prefix

Syntax Description

text

The string prefix. Enter a quoted text string with a maximum of 30 characters. The default has no prefix ("").

If you do not configure the string prefix, the string functions start from the beginning of the cookie, URL, or URL extension, depending on the sticky type. If the string prefix is configured but is not found in the specified sticky range, load balancing defaults to the roundrobin method.


Command Modes

Owner-Content

Related Commands

(config-owner-content) advanced-balance
(config-owner-content)
string range

string process-length

To specify how many bytes, after the end of the prefix designated by the string prefix command and skipping the bytes designated by the string skip-length command, that the string operation will use, use the string process-length command. Use the no form of this command to set the number of bytes to its default setting of 0.

string process-length bytes
no string process-length

Syntax Description

bytes

The number of bytes. Enter a number from 0 to 64. The default is 0.


Command Modes

Owner-Content

Usage Guidelines

The string process-length command has higher precedence than the string eos-char command. If neither commands are configured, the CSS uses the maximum 64 bytes for the final string operation.

Related Commands

(config-owner-content) string eos-char
(config-owner-content)
string operation
(config-owner-content)
string prefix
(config-owner-content)
string skip-length

string range

To specify the starting and ending byte positions within a cookie, URL, or URL extension from a client, use the string range command. Use the no form of this command to reset the range to its default setting of 1 to 100.

string range start_byte to end_byte
no string range

Syntax Description

start_byte

The starting byte position of the cookie, URL, or URL extension after the header. Enter an integer from 1 to 1999. The default is 1. Make sure that the starting byte position is less than the end byte.

end_byte

The ending byte position of the cookie, URL, or URL extension. Enter an integer from 2 to 2000. The default is 100. Make sure that the ending byte position is more than the start byte.


Command Modes

Owner-Content

Usage Guidelines

By specifying the range of bytes, the CSS processes the information located only within the range. This limits the amount of information that the CSS has to process when examining each cookie, URL, or URL extension, enhancing its performance.


Note If the starting position is beyond the cookie, URL or URL extension, the CSS does not perform the string function. When the ending position is beyond the cookie, URL or URL extension, the string processing stops at the end of the corresponding header.


Related Commands

(config-owner-content) advanced-balance
(config-owner-content) sticky-mask

string skip-length

To specify how many bytes to skip after the end of the prefix to find the string result, use the string skip-length command. Use the no form of this command to set the number of bytes to its default setting of 0.

string skip-length bytes
no string skip-length

Syntax Description

bytes

The number of bytes. Enter a number from 0 to 64. The default is 0.


Command Modes

Owner-Content

Related Commands

(config-owner-content) string prefix

(config-owner-content) suspend

To deactivate the content rule, denying access to the content governed by the rule, use the suspend command. Suspending a content rule does not affect existing flows to the content; it only applies to future requests for the content.

suspend

Related Commands

show rule
(config-owner-content) active

(config-owner-content) url

To specify the Uniform Resource Locator (URL) for the content, use the url command. Use the no form of this command to remove the URL or the URQL from the content rule.

url ["/url_name"|"{/url_path}/*" [eql eql_name|dql dql_name {eql_name}]|urql urql_name]
no url {urql}

Syntax Description

url_name

The URL for the content. Enter a quoted text string with a maximum length of 252 characters. You must place a slash character (/) at the beginning of the URL, for example, "/files/test.gif".

Note Do not include the ? or # parameter character in the URL string. The CSS terminates the URL at these parameter characters.

To specify a domain name, place two slashes at the beginning of the URL. For example, "//www.access.com/*" allows the rule to match on the HTTP traffic that contains the www.access.com domain name in the HTTP host tag.

To specify certain wildcard operations for wildcard matching, use a "*" character to specify a wildcard match. Examples of supported wildcards are:

/*.html which matches all requests with the .html extension

/newfiles/*.jpg which matches all requests for files beginning with /newfiles and have the .jpg extension.

/newfiles/* which matches all requests for files beginning with /newfiles.

/newfiles/1.jpg which matches requests for the /newfile/1.jpg file only.

To use stickiness based on Secure Socket Layer (SSL) session ID, set the URL to /*. Also, set the port to 443 with the (config-owner-content) port command and enable stickiness with the (config-owner-content) advanced-balance ssl command. Then specify an SSL application type.

url_path

An optional path to any content file that has its file extension defined in the EQL. Enter a quoted text string. You must place:

A slash character (/) at the beginning of the path

/* characters at the end of the path

An example is "/announcements/new/*".

To specify a domain name, place two slashes at the beginning of the URL.

eql

Specifies the URL for any content file that has its file extension defined in an EQL or that has its domain defined in a DQL.

eql_name

The name of the EQL. To see a list of EQLs, enter:

eql ?

dql

Specifies the URL for any content file that has its file extension defined in an EQL or that has its domain defined in a DQL.

dql_name

The name of the DQL. To see a list of DQLs, enter:

dql ?

urql

Specifies a URQL consisting of a group of URLs to the content rule.

urql_name

The name of the URQL. You can only assign one URQL per rule. To see a list of URQLs, enter:

urql ?

Usage Guidelines

Before you can change the URL for the content rule, you must suspend the rule and you must remove the current URL.

When you configure content replication and staging, you must configure an URL or URQL in a content rule to define which files you want replicated:

Use an URL to specify files.

Use an URQL to define a static list of files.

Then add the subscriber services to the content rule.

If you want all files in all directories replicated, you do not need to create a content rule. Create a content rule to specify only those files you want replicated.

You cannot configure the application ssl and url urql commands on the same content rule.


Note For caching environments, you can configure a domain content rule by placing two slash characters (//) at the front of the url_name or url_path. The rule matches HTTP traffic that contains the domain name in the HTTP host tag.


Related Commands

show content
show rule
(config) eql
(config) urql

(config-owner-content) vip address

To specify the content rule virtual IP (VIP) address or a range of addresses, use the vip address command. The VIP address for a content rule is the IP address used by incoming requests for the content governed by the rule. Use the no form of this command to clear the VIP address.

vip address ip_or_host {range number}
no vip address

Syntax Description

ip_or_host

The IP address or name for the content rule. Enter the address in either dotted-decimal IP notation (for example, 192.168.11.1) or mnemonic host-name format (for example, myhost.mydomain.com).

range number

The range option allows you to specify a range of IP addresses starting with the VIP address (ip_or_host). Enter a number from 1 to 65535. The default range is 1.

For example, if you enter an IP address of 203.1.1.1 with a range of 10, the VIP addresses range from 203.1.1.1 through 203.1.1.10.


Related Commands

show rule

(config-owner-content) zero

To set the counters for the current content rule or all content rules to zero, use the zero command.

zero {all}

Syntax Description

all

Zeros the counters for all content rules


Related Commands

show rule