|
This feature module describes the Dynamic Feedback Protocol (DFP) Support in DistributedDirector feature and includes the following sections:
DFP support enables DistributedDirector to make server and site selection on the basis of server load, in addition to other DistributedDirector metrics.
For more information on the Cisco DistributedDirector, see the following documents, which are located on Cisco Connection Online (CCO) at http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml:
Standards
None
MIBs
None
To obtain lists of supported MIBs by platform and Cisco IOS release, and to download MIB modules, go to the Cisco MIB web site on Cisco Connection Online (CCO) at http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml.
RFCs
None
See the following sections for the configuration tasks for this feature. This task is optional.
To configure DFP support in DistributedDirector, use the following command in global configuration mode:
Command | Purpose |
---|---|
Router(config)#ip director dfp ip-address [port]
[retry n] [attempts n] [timeout n]
| Configures the DistributedDirector DFP agent with which the DistributedDirector should communicate. |
To verify that the DistributedDirector is configured with DFP support for all specified IP addresses, use the show ip director dfp command. To verify that the DistributedDirector is configured with DFP support for a single IP address, use the show ip director dfp command.
This section provides the following configuration example DFP Support in DistributedDirector Example.
In the following example, the DistributedDirector is configured to communicate with a specified DFP agent:
ip director dfp 10.0.0.1 retry 3 attempts 60 timeout 6000
This section documents new and modified commands. All other commands used with the DistributedDirector are documented in the "Command Summary" and "Reference" sections of the Cisco DistributedDirector installation and configuration guides.
To configure default weight metrics for the DistributedDirector, use the ip director default-weights global configuration command. To restore the default, use the no form of this command.
ip director default-weights {[drp-int n] [drp-ext n] [drp-ser n] [drp-rtt n] [random n] [admin n] [portion n] [availability n] [route-map n]}
Syntax Description
drp-int n (Optional) Director Response Protocol (DRP) internal metric. The range is 1 to 100. This option sends a DRP request to all DRP server agents, asking them for the distance from themselves to the edge of their Border Gateway Protocol (BGP) autonomous system in the direction of the client originating the Domain Name System (DNS) query. This distance can be used along with the DRP external metric (drp-ext) to help determine the distance between the router and the client originating the DNS query. If the client and the DRP server agent are in the same autonomous system, this metric returns the Interior Gateway Protocol (IGP) cost metric between the client and the DRP server agent. drp-ext n (Optional) DRP external metric. The range is 1 to 100. This option sends a DRP request to all DRP server agents, asking them for the BGP distance between them and the client originating the DNS query. This distance represents the number of BGP hops between the autonomous system of the DRP server agent and the autonomous system of the client originating the DNS query. Because this is BGP information, the DRP server agents need to have access to full Internet BGP information in order for this metric to be useful. drp-ser n (Optional) DRP server metric. The range is 1 to 100. This option sends a DRP request to all DRP server agents, asking them for the IGP route metric between them and the distributed servers that they support. This distance can be used with the DRP internal metric (drp-int) to get a finer distance calculation between the distributed servers and the edge of the BGP autonomous system in the direction of the client originating the DistributedDirector query. If a true BGP border router is used as a DRP server agent, the DRP server metric will return the IGP route metric between the distributed server and the BGP border router (autonomous system edge). Because DRP server metrics should not change frequently, DistributedDirector issues DRP server queries (and caches the results) every 10 minutes. drp-rtt n (Optional) DRP round-trip time metric. The range is 1 to 100. This option sends a DRP request to all DRP server agents, asking them for the round-trip time between the DRP agent and the client originating the DNS query. random n (Optional) Random metric. The range is 1 to 100. This option selects a random number for each distributed server and defines the "best" server as the one with the smallest random number assignment. Using this metric alone results in random redirection of clients to the distributed servers. Because this metric requires no routing table information, it does not trigger DRP requests to the DRP server agents. admin n (Optional) Administrative metric. The range is 1 to 100. This option specifies a simple preference of one server over another. If the administrative metric has been explicitly set to zero, the Director will not consider the server, so the server is taken out of service. portion n (Optional) Portion metric. The range is 1 to 100. This option assigns a load "portion" to each server such that servers with a higher portion value will receive a larger percentage of connections at any one time. availability n (Optional) Availability metric. The range is 1 to 65,535. This option specifies the load information for the DistributedDirector. The default value is 65,535. route-map n (Optional) Route-map metric. The range is 1 to 100. This option specifies if a server should be offered to a client.
Defaults
The availability default value is 65,535.
Command Modes
Global configuration
Command History
11.1(18)IA This command was introduced. 12.1(5)T The availability and route-map metrics were added.
Release
Modification
Usage Guidelines
Not all of the metrics need to be configured; however, at least one metric must be configured when this command is used.
Default weights are used for all host names sorted by the DistributedDirector. To override default weights for a certain host, specify host-specific weights in the private DNS server configuration.
When the associated metric is referenced in the sorting decision, it will always be multiplied by the appropriate metric weight. In this way, you can specify that some metrics be weighted more than others. You may determine the weights that you want to use through experimentation. The weights given do not need to add up to 100.
The new availability metric allows the DistributedDirector to attempt to create a TCP connection to each distributed server on a configured port over a configurable time interval.
Examples
The following command configures default weights for the internal and external metrics:
ip director default-weights drp-int 10 drp-ext 90
Related Commands
debug ip director parse Shows debugging information for DistributedDirector parsing of TXT information. debug ip director sort Shows debugging information for DistributedDirector IP address sorting. ip director access-list Defines an access list for the DistributedDirector that specifies which subdomain names and host names should be sorted. ip director cache Enables the sorting cache on the DistributedDirector. ip director host priority Configures the order in which the DistributedDirector considers metrics when picking a server. ip director host weights Sets host-specific weights for the metrics that the DistributedDirector uses to determine the best server within a specific host name. ip director server admin-pref Configures a per-service administrative preference value. ip director server portion Sets the portion value for a specific server. ip director server preference Specifies DistributedDirector preference of one server over others or takes a server out of service. show ip director default-weights Shows the DistributedDirector default weights. show ip director servers Displays the DistributedDirector server preference information.
Command
Description
To configure the DistributedDirector Dynamic Feedback Protocol (DFP) agent with which the DistributedDirector should communicate, use the ip director dfp global configuration command. To turn off the DFP agent, use the no form of this command.
ip director dfp ip-address [port] [retry n] [attempts n] [timeout n]
Syntax Description
ip-address IP address. port (Optional) Port number to which the distributed servers are configured. The default value is 8080. retry n (Optional) Number of times a connection will be attempted. The default value is 5 attempts. attempts n (Optional) Delay, in seconds, between each attempt. The default value is 10,000 seconds. timeout n (Optional) Maximum amount of time, in seconds, for which DFP information is assumed valid. The default value is 10,000 seconds.
Syntax Description
The port default value is 8080.
The retry default value is 5 attempts.
The attempts default value is 10,000 seconds.
The timeout default value is 10,000 seconds.
Command Modes
Global configuration
Command History
12.1(5)T This command was introduced.
Release
Modification
Usage Guidelines
A connection is attempted a specified number of times with a delay of a specified number of seconds between each attempt. Once a connection is established, the DFP protocol will run. If a time interval update has not occurred for this DFP session, the connection breaks and is reestablished as described above.
Examples
The following example configures the DistributedDirector to communicate with a specified DFP agent:
ip director dfp 10.0.0.1 retry 3 attempts 60 timeout 6000
To configure a security key for use when connecting to the Dynamic Feedback Protocol (DFP) client named, use the ip director dfp security global configuration command. To turn off the security key, use the no form of this command.
ip director dfp security ip-address md5 string [timeout]
Syntax Description
ip-address IP address for the service. md5 Security data authentication. Message Digest 5. string Security key. timeout (Optional) Amount of time, in seconds, during which DistributedDirector will continue to accept a previously defined security key. The default value is 0 seconds.
Defaults
The timeout default value is 0 seconds.
Command Modes
Global configuration
Command History
12.1(5)T This command was introduced.
Release
Modification
Usage Guidelines
The ip director dfp security command should be entered before configuring the ip director dfp command, resulting in a connection being made, but it can be entered independently of making a connection.
DFP allows servers to take themselves Out-of-Service and place themselves back In-Service. This function could result in a security risk because a network that is hacked could be shut down even though all the servers are still performing. An optional security vector is included in DFP to allow each message to be verified. The security vector is used to describe the security algorithm being used and to provide the data for that algorithm. The security vector itself is also extensible in that it specifies which security algorithm is being used. This specification allows different levels of security from MD5 to Data Encryption Standard (DES) to be used without overhauling the protocol and disrupting any installed base of equipment. If a receiving unit is configured for the specified security type, all DFP packets must contain that security vector or they are ignored. If a receiving unit is not configured for any security type, the security vector does not have to be present, and if it is present, it is ignored while the rest of the message is processed normally.
Examples
The following example configures the security key hello:
ip director dfp security 10.0.0.1 md5 hello 60
Related Commands
ip director dfp Configures the DistributedDirector DFP agent with which the DistributedDirector should communicate.
Command
Purpose
To configure the order in which the DistributedDirector considers metrics when picking a server, use the ip director host priority global configuration command. To turn off metric priorities, use the no form of this command.
ip director host host-name priority {[drp-int n] [drp-ext n] [drp-ser n] [drp-rtt n] [random n] [admin n] [portion n] [availability n] [route-map n]}
Syntax Description
host-name Name of the host that maps to one or more IP addresses. Do not use an IP address. drp-int n (Optional) Director Response Protocol (DRP) internal metric. The range is 1 to 100. This option sends a DRP request to all DRP server agents, asking them for the distance from themselves to the edge of their Border Gateway Protocol (BGP) autonomous system in the direction of the client originating the Domain Name System (DNS) query. This distance can be used along with the DRP external metric (drp-ext) to help determine the distance between the router and the client originating the DNS query. If the client and the DRP server agent are in the same autonomous system, this metric returns the Interior Gateway Protocol (IGP) cost metric between the client and the DRP server agent. drp-ext n (Optional) DRP external metric. The range is 1 to 100. This option sends a DRP request to all DRP server agents, asking them for the BGP distance between them and the client originating the DNS query. This distance represents the number of BGP hops between the autonomous system of the DRP server agent and the autonomous system of the client originating the DNS query. Because this is BGP information, the DRP server agents need to have access to full Internet BGP information in order for this metric to be useful. drp-ser n (Optional) DRP server metric. The range is 1 to 100. This option sends a DRP request to all DRP server agents, asking them for the IGP route metric between them and the distributed servers that they support. This distance can be used with the DRP internal metric (drp-int) to get a finer distance calculation between the distributed servers and the edge of the BGP autonomous system in the direction of the client originating the DistributedDirector query. If a true BGP border router is used as a DRP server agent, the DRP server metric will return the IGP route metric between the distributed server and the BGP border router (autonomous system edge). Because DRP server metrics should not change frequently, DistributedDirector issues DRP server queries (and caches the results) every 10 minutes. drp-rtt n (Optional) DRP round-trip time metric. The range is 1 to 100. This option sends a DRP request to all DRP server agents, asking them for the round-trip time between the DRP agent and the client originating the DNS query. random n (Optional) Random metric. The range is 1 to 100. This option selects a random number for each distributed server and defines the "best" server as the one with the smallest random number assignment. Using this metric alone results in random redirection of clients to the distributed servers. Because this metric requires no routing table information, it does not trigger DRP requests to the DRP server agents. admin n (Optional) Administrative metric. The range is 1 to 100. This option specifies a simple preference of one server over another. If the administrative metric has been explicitly set to zero, the Director will not consider the server, so the server is taken out of service. portion n (Optional) Portion metric. The range is 1 to 100. This option assigns a load "portion" to each server such that servers with a higher portion value will receive a larger percentage of connections at any one time. availability n (Optional) Availability metric. The range is 1 to 65,535. This option specifies the load information for the DistributedDirector. The default value is 65,535. route-map n (Optional) Route-map metric. The range is 1 to 100. This option specifies if a server should be offered to a client.
Defaults
The availability default value is 65,535.
Command Modes
Global configuration
Command History
11.1(18)IA This command was introduced. 12.1(5)T The availability and route-map metrics were added.
Release
Modification
Usage Guidelines
Not all of the metrics need to be specified, but at least one must be specified.
The new availability metric allows the DistributedDirector to attempt to create a TCP connection to each distributed server on a configured port over a configurable time interval.
If multiple servers end up with the same metric value, the next metric is considered to determine the "best" server. If multiple metrics have the same priority value, the metrics are added to obtain a composite metric. For example, if two metrics have the same priority value, they are first multiplied by their weight values (if specified) and then added together to form the composite metric.
If you do not specify weights for a group of distributed servers, there are no default weights for the Director, and if you have specified priority values, the weight values are set to 1.
Any metrics that have a nonzero weight and that are assigned no priority value are set to a priority value of 101. They are considered after all other metrics that have priority values. As a result, if no priority values are specified for any metric, metrics are treated additively to form one composite metric.
If you do not use priority and multiple servers have the same metric value, the server whose last IP address was looked at will be returned as the "best" server. If you want to return a random IP address in the case of a tie, use metric priority with the random metric as the last criterion.
To turn off all priorities on all metrics associated with the defined host name, use the no ip director host priority command. You can turn off the priority for a specific metric or metrics using the no ip director host host-name priority [drp-int n] [drp-ext n] [drp-ser n] [drp-rtt n] [random n] [admin n] [portion n] [availability n] [route-map n] command.
Examples
The following example sets the external metric as the first priority and the administrative metric as the second priority:
ip director host www.xyz.com priority drp-ext 1 admin 2
Related Commands
ip director host connect Enables the DistributedDirector to verify that a server is available. show ip director hosts Displays the DistributedDirector host information.
Command
Description
To set host-specific weights for the metrics that the DistributedDirector uses to determine the best server within a specific host name, use the ip director host weights global configuration command. To turn off weights for a host, use the no form of this command.
ip director host host-name weights {[drp-int n] [drp-ext n] [drp-ser n] [drp-rtt n] [random n] [admin n] [portion n] [availability n] [route-map n]}
Syntax Description
host-name Name of the host that maps to one or more IP addresses. Do not use an IP address. drp-int n (Optional) Director Response Protocol (DRP) internal metric. The range is 1 to 100. This option sends a DRP request to all DRP server agents, asking them for the distance from themselves to the edge of their Border Gateway Protocol (BGP) autonomous system in the direction of the client originating the Domain Name System (DNS) query. This distance can be used along with the DRP external metric (drp-ext) to help determine the distance between the router and the client originating the DNS query. If the client and the DRP server agent are in the same autonomous system, this metric returns the Interior Gateway Protocol (IGP) cost metric between the client and the DRP server agent. drp-ext n (Optional) DRP external metric. The range is 1 to 100. This option sends a DRP request to all DRP server agents, asking them for the BGP distance between them and the client originating the DNS query. This distance represents the number of BGP hops between the autonomous system of the DRP server agent and the autonomous system of the client originating the DNS query. Because this is BGP information, the DRP server agents need to have access to full Internet BGP information in order for this metric to be useful. drp-ser n (Optional) DRP server metric. The range is 1 to 100. This option sends a DRP request to all DRP server agents, asking them for the IGP route metric between them and the distributed servers that they support. This distance can be used with the DRP internal metric (drp-int) to get a finer distance calculation between the distributed servers and the edge of the BGP autonomous system in the direction of the client originating the DistributedDirector query. If a true BGP border router is used as a DRP server agent, the DRP server metric will return the IGP route metric between the distributed server and the BGP border router (autonomous system edge). Because DRP server metrics should not change frequently, DistributedDirector issues DRP server queries (and caches the results) every 10 minutes. drp-rtt n (Optional) DRP round-trip time metric. The range is 1 to 100. This option sends a DRP request to all DRP server agents, asking them for the round-trip time between the DRP agent and the client originating the DNS query. random n (Optional) Random metric. The range is 1 to 100. This option selects a random number for each distributed server and defines the "best" server as the one with the smallest random number assignment. Using this metric alone results in random redirection of clients to the distributed servers. Because this metric requires no routing table information, it does not trigger DRP requests to the DRP server agents. admin n (Optional) Administrative metric. The range is 1 to 100. This option specifies a simple preference of one server over another. If the administrative metric has been explicitly set to zero, the Director will not consider the server, so the server is taken out of service. portion n (Optional) Portion metric. The range is 1 to 100. This option assigns a load "portion" to each server such that servers with a higher portion value will receive a larger percentage of connections at any one time. availability n (Optional) Availability metric. The range is 1 to 65,535. This option specifies the load information for the DistributedDirector. The default value is 65,535. route-map n (Optional) Route-map metric. The range is 1 to 100. This option specifies if a server should be offered to a client.
Note No host weights are set. If the ip director default-weights command is configured, the configured weights are the default. |
Defaults
The availability default value is 65,535.
Command Modes
Global configuration
Command History
11.1(25)IA This command was introduced. 12.0(3)T This command was integrated into the Cisco IOS Release 12.0(3)T. 12.1(5)T The availability and route-map metrics were added.
Release
Modification
Usage Guidelines
Use host-specific weights when you want to use different metric weights for different virtual host names (for example, www.xyz.com and ftp.xyz.com).
The new availability metric allows the DistributedDirector to attempt to create a TCP connection to each distributed server on a configured port over a configurable time interval.
If desired, host-specific weights can instead be configured on the DistributedDirector default DNS server.
For example, you could configure host-specific weights with the following DNS TXT record:
hostname in txt "ciscoDD: weights
{[drp-int
n]
[drp-ext
n]
[drp-ser
n]
[random
n]
[admin
n]}
"
To use the default weights for all metrics associated with this host name, use the no ip director host weights command. To use the default weights for a specific metric or metrics, use the no ip director host host-name weights [drp-int n] [drp-ext n] [drp-ser n] [drp-rtt n] [random n] [admin n] [portion n] [availability n] [route-map n] command.
Examples
The following example sets the DRP internal metric to 4:
ip director host www.xyz.com weights drp-int 4
Related Commands
ip director default-weights Configures default weight metrics for the DistributedDirector. show ip director hosts Displays the DistributedDirector host information.
Command
Description
To configure a default availability value for all ports on a server, use the ip director server availability global configuration command. To restore the default, use the no form of this command.
ip director server ip-address availability {availability-value | dfp [availability-value]}
Syntax Description
ip-address IP address. availability-value Availability value as it would be represented on the DistributedDirector system. The range is 0 to 65,535. dfp [availability-value] Availability value as it would be represented on the LocalDirector system. The range for value is 0 to 65,535.
Defaults
The availability default value is 65,535.
Command Modes
Global configuration
Command History
12.1(5)T This command was introduced.
Release
Modification
Usage Guidelines
There are two methods for specifying a default availability value. These two methods exist because the LocalDirector and the DistributedDirector deal with values in two different ways. All metrics for the DistributedDirector are arranged such that lower is better; however the LocalDirector load information is calculated such that higher is better. Thus, the DistributedDirector translates the metric value upon receipt from the LocalDirector by subtracting the availability from the maximum possible value of 65,535.
Examples
To configure a default availability to be used if there is no other valid availability information, the following configuration would suffice. The following example shows how to specify the LocalDirector load and DistributedDirector availability, respectively:
ip director server 10.0.0.1 availability dfp 1
ip director server 10.0.0.1 availability 65534
To make the availability clear and to allow for specifying numbers in both schemes easily, there are two methods of specifying availability information. If the servers are running multiple serves, it may be necessary to configure the default availability value on a per-port basis by using the ip director server port availability command.
ip director server 10.0.0.1 port availability dfp 65535
ip director server 10.0.0.20 port availability dfp 65535
Related Commands
ip director server port availability Configures a default availability value for a specific port on a server.
Command
Description
To configure a default availability value for a specific port on a server, use the ip director server port availability global configuration command. To restore the default, use the no form of this command.
ip director server ip-address port availability {availability-value | dfp [availability-value]}
Syntax Description
ip-address IP address. availability-value Availability value as it would be represented on the DistributedDirector system. The range is 0 to 65,535. dfp [availability-value] Availability value as it would be represented on the LocalDirector system. The range for value is 0 to 65,535.
Defaults
The availability default value is 65,535.
Command Modes
Global configuration
Command History
12.1(5)T This command was introduced.
Release
Modification
Usage Guidelines
There are two methods for specifying a default availability value. These two methods exist because the LocalDirector and the DistributedDirector deal with values in two different ways. All metrics for the DistributedDirector are arranged such that lower is better; however the LocalDirector load information is calculated such that higher is better. Thus, the DistributedDirector translates the metric value upon receipt from the LocalDirector by subtracting the availability from the maximum possible value of 65,535.
Examples
To make the availability clear and to allow for specifying numbers in both schemes easily, there are two methods of specifying availability information. If the servers are running multiple serves, it may be necessary to configure the default availability value on a per-port basis by using the ip director server port availability command.
ip director server 10.0.0.1 port availability dfp 65535
ip director server 10.0.0.20 port availability dfp 65535
To configure a default availability to be used if there is no other valid availability information, the following configuration would suffice. The following example shows how to specify the LocalDirector load and DistributedDirector availability, respectively:
ip director server 10.0.0.1 availability dfp 1
ip director server 10.0.0.1 availability 65534
Related Commands
ip director server availability Configures a default availability value for all ports on a server.
Command
Description
To display information about the current status of the DistributedDirector connections with a particular Dynamic Feedback Protocol (DFP) agent, use the show ip director dfp EXEC command.
show ip director dfp [host-name | ip-address]
Syntax Description
host-name (Optional) Host name. ip-address (Optional) IP address.
Command Modes
EXEC
Command History
12.1(5)T This command was introduced.
Release
Modification
Examples
The following is sample output from the show ip director dfp command:
Router# show ip director dfp
172.24.9.9:
Max retries: 5
Timeout between connect attempts: 60
Timeout between updates: 90
Last update received: 00:00:12 ago
Server Port BindID Address Mask
172.28.9.9 80 0 0.0.0.0 0.0.0.0
192.168.25.25
Max retries: 5
Timeout between connect attempts: 60
Timeout between updates: 90
Last update received: 00:00:44 ago
Server Port BindID Address Mask
192.168.30.30 80 0 0.0.0.0 0.0.0.0
Posted: Thu Jan 18 19:22:08 PST 2001
All contents are Copyright © 1992--2001 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.