CSS Content Load-Balancing Configuration Guide (Software Version 8.20)
Configuring Owners
Downloads: This chapterpdf (PDF - 230.0KB) The complete bookPDF (PDF - 3.86MB) | Feedback

Configuring Owners

Table Of Contents

Configuring Owners

Owner Configuration Quick Start

Creating an Owner

Configuring an Owner DNS Balance Type

Specifying Owner Address

Specifying Owner Billing Information

Specifying Case

Specifying Owner DNS Type

Specifying Owner E-Mail Address

Removing an Owner

Showing Owner Information

Showing Owner Summary

Where to Go Next


Configuring Owners


This chapter describes how to create and configure owners. Information in this chapter applies to all CSS models except where noted.

This chapter contains the following major sections:

Owner Configuration Quick Start

Creating an Owner

Configuring an Owner DNS Balance Type

Specifying Owner Address

Specifying Owner Billing Information

Specifying Case

Specifying Owner DNS Type

Specifying Owner E-Mail Address

Removing an Owner

Showing Owner Information

For information on how service, owners and content rules work together, see Chapter 1, Content Load-Balancing Overview.

Owner Configuration Quick Start

Table 9-1 provides a quick overview of the steps required to configure owners. Each step includes the CLI command required to complete the task. For a complete description of each feature and all the options associated with the CLI command, see the sections following Table 9-1.

Table 9-1 Owner Configuration Quick Start 

Task and Command Example

1. Enter config mode by typing config.

# config
(config)#

2. Create an owner.

(config)# owner arrowpoint
(config-owner[arrowpoint])#

3. Specify the owner e-mail address.

(config-owner[arrowpoint])# email-address bobo@arrowpoint.com

4. Specify the owner mailing address.

(config-owner[arrowpoint])# address "373 grand ave usa"

5. Specify the owner billing information.

(config-owner[arrowpoint])# billing-info "finance"

6. (Recommended) Display owner information to verify your owner configuration.

(config-owner[arrowpoint])# show owner

The following running-configuration example shows the results of entering the commands in Table 9-1.

!*************************** OWNER ***************************
owner arrowpoint 
  email-address bobo@arrowpoint.com 
  address "373 grand ave usa" 
  billing-info "finance" 

Creating an Owner

An owner is generally the person or company who contracts the web hosting service to host their web content and allocate bandwidth as required. Use the owner command to create an owner for a content rule. When you create an owner, you enable the CSS to identify the entity (for example, person, company name, or other meaningful title) that owns content rules. The CSS can contain many owners and maintain a configurable profile for each owner.

When creating an owner, you may want to use the owner's DNS (Domain Name Service) name. Enter the owner name as an unquoted text string from 1 to 31 characters in length. The following example creates the owner arrowpoint:

(config)# owner arrowpoint

Once you create an owner, the CLI enters owner mode.

(config-owner[arrowpoint])#

To remove an owner, use the no owner command. When you remove an owner, you also remove all content rules created for the owner. For example, enter:

(config-owner[arrowpoint])# no owner arrowpoint

Configuring an Owner DNS Balance Type

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

Use the dnsbalance command to determine where to resolve a request for a domain name to an IP address. The syntax and options for this owner mode command are:

dnsbalance leastloaded - Resolve the request to the least-loaded of all local or remote domain sites. 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.

dnsbalance preferlocal - Resolve the request to a local virtual IP (VIP) address. If all local systems exceed their load threshold, the CSS chooses the least-loaded remote CSS VIP address as the resolved address for the domain name.

dnsbalance roundrobin (default) - Resolve the request by evenly distributing the load to resolve domain names among content domain sites, local and remote. The CSS does not include sites that exceed their local load threshold.

For example, enter:

(config-owner[arrowpoint])# dnsbalance leastloaded

To reset the DNS load balancing method to its default setting of roundrobin, enter:

(config-owner[arrowpoint])# no dnsbalance

Specifying Owner Address

To enter an address for an owner, use the address command in owner mode. Enter a quoted text string with a maximum of 128 characters.

For example, enter:

(config-owner[arrowpoint])# address "373 granite ave usa"

To delete an owner address, enter:

(config-owner[arrowpoint])# no address

Specifying Owner Billing Information

To enter billing information for an owner, use the billing-info command in owner mode. Enter the billing information assigned to an owner as a quoted text string with a maximum length of 128 characters. For example, enter:

(config-owner[arrowpoint])# billing-info "finance"

To delete an owner billing address, enter:

(config-owner[arrowpoint])# no billing-info

Specifying Case

To define whether or not the CSS employs case-sensitivity when matching content requests to an owner's content rule, use the case command. The default is case insensitive.


Note You must reboot the CSS for the case command to take effect.


For example, a client requests content from arrowpoint/index.html. If owner arrowpoint is configured for:

case sensitive, the request must match content index.html exactly

case insensitive, the request can be any combination of uppercase and lowercase letters (for example, Index.html, INDEX.HTML)

To configure owner arrowpoint content rules to be case-sensitive, enter:

(config-owner[arrowpoint])# case sensitive

To return to the default, enter:

(config-owner[arrowpoint])# case insensitive

Specifying Owner DNS Type

To set the peer name exchange policy for a specific owner, use the dns command. The default is none, which does not set a peer name exchange policy. For information on configuring DNS, refer to the Cisco Content Services Switch Global Server Load-Balancing Configuration Guide.

The syntax and options for this owner mode command are:

dns accept - Accept all content rules proposed by the CSS peer

dns push - Push (send) all content rules onto the CSS peer

dns both - Accept all content rules proposed by the CSS peer and push all rules onto the CSS peer

For example, enter:

(config-owner[arrowpoint])# dns push

To remove an owner's peer name exchange policy, enter:

(config-owner[arrowpoint])# no dns

Specifying Owner E-Mail Address

To enter an e-mail address for an owner, use the email-address command in owner mode. For example, enter:

(config-owner[arrowpoint])# email-address bobo@arrowpoint.com

To remove an owner e-mail address, enter:

(config-owner[arrowpoint])# no email-address

Removing an Owner


Caution Removing an owner also deletes the content rules associated with it.

To remove an owner, use the no owner command from config mode. To remove an owner, you must first exit from the owner mode. You cannot be in the owner mode that you wish to remove.

For example, to remove an owner, enter:

(config)# no owner arrowpoint

Showing Owner Information

The show owner command enables you to display owner information for an owner. An owner is an entity that owns Web content and is using the CSS to manage access to that content.

You can issue the following show owner commands from the specified command modes to display configuration information and statistics for an owner:

show owner {owner_name {statistics}} - Display configuration information and statistics for an owner.

This command is available in ACL, Circuit, Global, Group, Interface, Service, SuperUser, and User modes. The show owner command displays configuration information for all owners. The show owner owner_name command displays configuration information for a specified owner. The statistics option displays the statistics for the owner.

show owner {statistics} - Display configuration information and statistics for the current owner, or for the owner of the current content rule. This command is available in Owner and Content mode. The show owner command with no options displays configuration information only. The statistics option displays the statistics for the current owner.

For example, to display configuration information for a specific owner from the ACL, Circuit, Global, Group, Interface, Service, SuperUser, or User modes, enter:

# show owner test.com

To display configuration information for the owner in Owner mode, enter:

(config-owner[test.com])# show owner

Table 9-2 describes the fields in the show owner name command output.

Table 9-2 Field Descriptions for the show owner name Command
Output 

Field
Description

Name

The name of the owner.

Billing Info

The billing information about the owner.

Address

The postal address for the owner of the Web-hosting service.

Email Address

The e-mail address for the owner.

DNS Policy

The peer DNS exchange policy for the owner. The possible policies are:

accept - Accept all content rules proposed by the CSS peer.

push - Advertise the owner and push all content rules onto the CSS peer.

both - Advertise the owner and push all content rules onto the CSS peer, and accept all content rules proposed by the CSS peer.

none - The default DNS exchange policy for the owner. The owner is hidden from the CSS peer.

Case Matching

Indicates the matching of content requests to the owner's rules is case-sensitive or insensitive.


To display statistics for an owner from the ACL, Circuit, Global, Group, Interface, Service, SuperUser, or User modes, enter:

# show owner test.com statistics

To display statistics for the owner from either Owner or Content mode, enter:

(config-owner[test.com])# show owner statistics

Table 9-3 describes the fields in the show owner name statistics command output.

Table 9-3 Field Descriptions for the show owner name statistics
Command Output 

Field
Description

DNS Policy

The peer DNS exchange policy for the owner. The possible policies are:

accept - Accept all content rules proposed by the CSS peer.

push - Advertise the owner and push all content rules onto the CSS peer.

both - Advertise the owner and push all content rules onto the CSS peer, and accept all content rules proposed by the CSS peer.

none - The default DNS exchange policy for the owner. The owner is hidden from the CSS peer.

Hits

Number of connections processed under the rules of the owner.

Bytes

Total number of bytes transferred that matched the rules of the owner.

Frames

Total frames transferred that matched the rules of the owner.

Redirects

Total number of flows that have been redirected due to persistent connections or stickiness.

Spoofs

Number of times that client connections have been replied to by the CSS while the CSS simultaneously negotiates a connection with the back-end service.

Case Matching (Sensitivity)

Indicates whether the matching of content requests to the rules of the owner is case sensitive or case insensitive.

Reject Overload

Not used.

Reject No Services

Number of times that connections were rejected due to no available services.

Drops

Not used.

NAT Translations

Not used.


Showing Owner Summary

The show summary command enables you to display a summary of the following owner information for all owners or a specific owner:

Owners

Content rules

Services

Service hits

You can issue the following show summary commands from any mode:

show summary - Display a summary of all owner information

show summary owner_name - Display a summary of owner information for a specific owner

For example, enter:

(config)# show summary

Table 9-4 describes the fields in the show summary command output.

Table 9-4 Field Descriptions for the show summary Command Output 

Field
Description

Global Bypass Counters

No Rule Bypass Count

The number of times that a flow passes through even though it did not match one of the existing content rules.

ACL Bypass Count

The number of times that the ACL immediately sends traffic to its destination, bypassing the content rule.

URL Prams Bypass Count

The number of times that content requests match on content rules that have param-bypass set to enable. The CSS forwards the content requests to the origin server.

Cache Miss Bypass Count

The number of times that TCP connections from the cache servers bypassed content rules so the cache server could access the origin server for the requested content.

Garbage Bypass Count

The number of times that the CSS examined content requests and deemed them unrecognizable or corrupt. As a result, the CSS forwards the content request to the origin server rather than the cache server.

Owner

The owner name.

Content Rules

The rule associated with the owner.

State

The state of the rule (active or suspended).

Services

The services associated with the rule.

Service Hits

The number of hits on the service.


Where to Go Next

Once you create and configure an owner, see Chapter 10, Configuring Content Rules, for information on configuring content rules. Content rules instruct the CSS on how to handle requests for the owner's content. You create and configure a content rule within a specific owner mode. This method ensures that the configured content rule applies only to a specific owner.