DLSw+ Enhanced Load Balancing Feature Summary In a network with multiple capable paths, the DLSw+ Enhanced Load Balancing feature improves traffic load balancing between peers by distributing new circuits based on existing loads and the desired ratio. Benefits For each capable peer (peers that have the lowest or equal cost specified), the DLSw+ Enhanced Load Balancing feature calculates the difference between the desired and the actual ratio of circuits being used on a peer. It detects the path that is underloaded in comparison to the other capable peers and will assign new circuits to that path until the desired ratio is achieved. When a DLSw+ router is deciding which path to use to start a new circuit, it checks to see what type of load balancing is configured. In Figure 1, assume Router B and Router C have 8 circuits each and then Router B fails. As a result, Router C now has 8 circuits and Router B has 0. When Router B recovers, the recovered 8 circuits will be distributed in the following manner, depending on the type of load balancing that is configured: Round-robin load balancing The DLSw+ router distributes the new circuits in a round-robin fashion, resulting in 4 circuits on Router B and 12 circuits on Router C. Enhanced load balancing If Router B and C have the same circuit weight value configured, the DLSw+ router distributes 8 circuits to Router B and 8 circuits on Router C. DLSw+ Enhanced Load Balancing 1
Platforms Figure 1 DLSw+ with Enhanced Load Balancing B FEP A C FEP If router B is a Cisco 7500 and router C is a Cisco 2500, the user can configure Router B with a circuit weight of 20 and Router C with a circuit weight of 10. In this case, router A knows that router B should be handling twice as many circuits as router C. Router A checks how many circuits it has with each peer and makes its decision based on a 2:1 ratio. The 8 new circuits are distributed to router B and when more circuits are created, all of the new circuits would come up through router B until there is a 2:1 ratio between router B and router C. If router B fails and then recovers, the first 16 circuits go to router B to achieve the 2:1 balance because router C already has 8 circuits. 18007 Restrictions Only TCP and DLSw+ Lite encapsulation work with the DLSw+ Enhanced Load Balancing feature. Platforms Prerequisites This feature is supported on the following platforms: Cisco 1600 series Cisco 1700 series Cisco 2500 series Cisco 2600 series Cisco 3600 series Cisco 3800 series Cisco 4000 series (Cisco 4000, 4000-M, 4500, 4500-M, 4700, 4700-M) Cisco 7200 series Cisco 7500 series Because a DLSw+ peer selects its new circuit paths from within its reachability cache, the user must configure the dlsw timer explorer-wait-time command with enough time to allow for all the explorer responses to be received. If the new DLSw+ Enhanced Load Balancing Feature is enabled, a message is displayed on the console to alert the user that the timer is not set. 2 Cisco IOS Release 12.0(3)T
Configure Enhanced Load Balancing For multiple peer connections, peer costs must be applied. The DLSw+ Enhanced Load Balancing feature works only with the lowest (or equal) cost peers. For example, if the user specifies dlswrtr1, dlswrtr2 and dlswrtr3 with costs of 4, 3, and 3 respectively, DLSw+ establishes new circuits with only dlswrtr 2 and dlswrtr3. Supported MIBs and RFCs No MIBs are supported by this feature. This feature supports the following RFCs: RFC 1795 RFC 2166 Configuration Tasks Configure Enhanced Load Balancing To enable the DLSw+ Enhanced Load Balancing feature on the local router, use the following command in global configuration mode: Command dlsw load-balance [round-robin circuit count circuit-weight] Purpose Configures the DLSw+ Enhanced Load Balancing feature on the local router. To adjust the circuit weight for a remote peer with TCP encapsulation, use the following command in global configuration mode: Command dlsw remote-peer tcp [circuit-weight value] Purpose Adjust the circuit weight on the remote peer. To adjust the circuit weight for a remote peer with DLSw+ Lite encapsulation, use the following command in global configuration mode: Command dlsw remote-peer frame-relay interface serial number dlci number [circuit-weight value] Purpose Adjust the circuit weight on the remote peer. The circuit-weight of a remote peer controls the number of circuits that peer can take. If multiple, equally low-cost peers can reach a remote source, the circuits to that remote source are distributed among the remote peers based on the ratio of their configured circuit-weights. The peer with the highest circuit-weight takes more circuits. DLSw+ Enhanced Load Balancing 3
Configuration Examples Configure the DLSw+ Explorer Wait Time To configure the amount of time needed for all the explorer responses to be received, use the following command in global configuration mode: Command dlsw timer {explorer-wait-time} Purpose Time to wait for all stations to respond to explorers. Configuration Examples Figure 2 shows DLSw+ configured with the DLSw+ Enhanced Load Balancing feature. Figure 2 DLSw+ with Enhanced Load Balancing RTR B RTR A RTR C RTR D 17277 Router A is configured for the DLSw+ Enhanced Load Balancing feature to load balance traffic among the DLSw+ remote peers B, C, and D. Router A dlsw local-peer 10.2.19.1 dlsw remote-peer 0 tcp 10.2 24.2 circuit weight 10 dlsw remote-peer 0 tcp 10.2.19.5 circuit weight 6 dlsw remote-peer 0 tcp 10.2.20.1 circuit weight 20 dlsw load-balance circuit-count dlsw timer explorer-wait-time 100 Router B dlsw local-peer 10.2.24.2 cost 1 promiscuous 4 Cisco IOS Release 12.0(3)T
Configure the DLSw+ Explorer Wait Time Router C dlsw local-peer 10.2.19.5 cost 1 promiscuous Router D dlsw local-peer 10.2.20.1 cost 1 promiscuous DLSw+ Enhanced Load Balancing 5
Command Reference Command Reference This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.0 command references. dlsw load-balance dlsw remote-peer frame-relay dlsw remote-peer tcp 6 Cisco IOS Release 12.0(3)T
dlsw load-balance dlsw load-balance Use the dlsw load-balance global configuration command to enable load balancing and to select either round robin or circuit-count based load balancing. dlsw load-balance [round-robin circuit-count circuit weight] no dlsw load-balance [round-robin circuit-count circuit weight] Syntax Description round-robin circuit-count circuit weight Enables round-robin type of load balancing. Enables the DLSw+ Enhanced Load Balancing feature. The value represents the default circuit-weight to be used for the peers that are not explicitly configured with a circuit-weight value in the dlsw remote-peer tcp command. The valid range is 1 to 100. Default Fault-tolerant mode is the default setting. The default value for the circuit weight is 10. Command Mode Global configuration Usage Guidelines This command first appeared in 12.0(3)T. A circuit is never be taken down and reestablished by the code in an attempt to rebalance the load. The DLSw+ Enhanced Load Balancing feature only changes the decision-making process at the time a new circuit is desired. The dlsw load-balance command replaces the dlsw duplicate-path-bias load balance command. The latter command continues to be accepted, however, it will be converted to the new command if the configuration is displayed or saved. Example The following example enables the DLSw+ Enhanced Load Balancing feature: dlsw load -balance circuit-count 10 DLSw+ Enhanced Load Balancing 7
Command Reference dlsw remote-peer frame-relay Use the dlsw remote-peer frame-relay global configuration command to specify the remote peer with which the router will connect. Use the no form of this command to disable the previous assignments. dlsw remote-peer list-number frame-relay interface serial number dlci-number [backup-peer [ip-address frame-relay interface serial number dlci-number interface name]] [bytes-netbios-out bytes-list-name] [circuit-weight weight] [cost cost] [dest-mac mac-address] [dmac-output-list access-list-number] [host-netbios-out host-list-name] [keepalive seconds] [lf size] [linger minutes] [lsap-output-list list] [passive] pass-thru no dlsw remote-peer list-number frame-relay interface serial number dlci-number [backup-peer [ip-address frame-relay interface serial number dlci-number interface name]] [bytes-netbios-out bytes-list-name] [circuit-weight weight] [cost cost] [dest-mac mac-address] [dmac-output-list access-list-number] [host-netbios-out host-list-name] [keepalive seconds] [lf size] [linger minutes] [lsap-output-list list] [passive] pass-thru Syntax Description list-number interface serial number dlci-number backup-peer ip-address backup-peer frame-relay interface serial number dlci-number backup-peer interface name bytes-netbios-out bytes-list-name circuit weight weight cost cost dest-mac mac-address Ring list number. The valid range is 1 to 255. The default is 0, which means DLSw+ forwards explorers over all ports or bridge groups on which DLSw+ is enabled. Serial interface number of the remote peer with which the router is to communicate. DLCI number of the remote peer. (Optional) IP address of the existing TCP/FST peer for which this peer is the backup peer. (Optional) Serial interface and DLCI number of the existing Direct/LLC2 Frame-Relay peer for which this peer is the backup peer. (Optional) Interface name of the existing direct peer for which this peer is the backup peer. (Optional) Configures NetBIOS bytes output filtering for this peer. The bytes-list-name argument is the name of the previously defined NetBIOS bytes access list filter. (Optional) Configures circuit-weight for this remote peer. (Optional) Cost to reach this remote peer. The valid range is 1 to 5. (Optional) Permits the connection to be established only when there is an explorer frame destined for the specified 48-bit MAC address written in dotted triplet form. 8 Cisco IOS Release 12.0(3)T
dlsw remote-peer frame-relay dmac-output-list access-list-number host-netbios-out host-list-name keepalive seconds lf size linger minutes lsap-output-list list passive pass-thru (Optional) Establishes the connection only when the explorer frame passes the specified access list. The access-list-number is the list number specified in the access-list command. (Optional) Configures NetBIOS host output filtering for this peer. The host-list-name is the name of the previously defined NetBIOS host access list filter. (Optional) Sets the keepalive interval for this remote peer. The range is 0 to 1200 seconds. (Optional) Largest frame size, in bytes, this local peer will use on a circuit to avoid segmented frames. Valid sizes are 516, 1470, 1500, 2052, 4472, 8144, 11407, 11454, and 17800 bytes. (Optional) Configures length of time the backup peer remains connected after the primary peer connection is reestablished. The valid range is 1 to 300 minutes. The default is 5 minutes. (Optional) Filters output IEEE 802.5 encapsulated packets. Valid access list numbers are in the range 200 to 299. (Optional) Designates this remote peer as passive. Selects passthru mode. The default is local acknowledgment mode. Default No remote peers are specified. Command Mode Global configuration Usage Guidelines This command first appeared in Cisco IOS Release 11.0. The following keywords and arguments first appeared in Cisco IOS Release 11.2: dest-mac mac-address, dmac-output-list access-list-number, and linger minutes. The cost keyword specified in a remote peer statement takes precedence over the cost learned as part of the capabilities exchange with the remote peer. The cost keyword is relevant only in fault tolerance mode. When you need to permit access to only a single MAC address, the dest-mac option is a simpler configuration than the dmac-output-list option. When pass-thru is not specified, traffic is locally acknowledged and reliably transported in LLC2 across the WAN. DLSw+ Enhanced Load Balancing 9
Command Reference Examples The following example specifies a DLSw+ Lite peer as a backup to a primary direct peer: dlsw remote-peer 0 frame-relay interface serial 1 40 pass-thru dlsw remote-peer 0 frame-relay interface serial 0 30 backup-peer frame-relay interface serial 1 40 The following example specifies Frame Relay encapsulation connection for remote peer transport: dlsw remote-peer 0 frame-relay interface 0 30 Related Commands show dlsw peers 10 Cisco IOS Release 12.0(3)T
dlsw remote-peer tcp dlsw remote-peer tcp Use the dlsw remote-peer tcp global configuration command to identify the IP address of a peer with which to exchange traffic using TCP. Use the no form of this command to remove a remote peer. dlsw remote-peer list-number tcp ip-address [backup-peer [ip-address frame-relay interface serial number dlci-number interface name]] [bytes-netbios-out bytes-list-name] [circuit-weight value] [cost cost] [dest-mac mac-address] [dmac-output-list access-list-number] [dynamic] [host-netbios-out host-list-name] [inactivity minutes] [dynamic] [keepalive seconds] [lf size] [linger minutes] [lsap-output-list list] [no-llc minutes] [passive] [priority] [rif-passthru virtual-ring-number] [tcp-queue-max size] [timeout seconds] no dlsw remote-peer list-number tcp ip-address [backup-peer [ip-address frame-relay interface serial number dlci-number interface name]] [bytes-netbios-out bytes-list-name] [circuit-weight value] [cost cost] [dest-mac mac-address] [dmac-output-list access-list-number] [dynamic] [host-netbios-out host-list-name] [inactivity minutes] [dynamic] [keepalive seconds] [lf size] [linger minutes] [lsap-output-list list] [no-llc minutes] [passive] [priority] [rif-passthru virtual-ring-number] [tcp-queue-max size] [timeout seconds] Syntax Description list-number tcp ip-address backup-peer ip-address backup-peer frame-relay interface serial number dlci-number backup-peer interface name bytes-netbios-out bytes-list-name circuit-weight value cost cost dest-mac mac-address Remote peer ring group list number. This ring group list number default is 0. Otherwise, this value must match the number you specify with the dlsw ring-list, dlsw port-list, or dlsw bgroup-list command. IP address of the remote peer with which the router is to communicate. (Optional) IP address of the existing TCP/FST peer for which this peer is the backup peer. (Optional) Serial interface and DLCI number of the existing Direct/LLC2 Frame Relay peer for which this peer is the backup peer. (Optional) Interface name of the existing direct peer for which this peer is the backup peer. (Optional) Configures NetBIOS bytes output filtering for this peer. The bytes-list-name argument is the name of the previously defined NetBIOS bytes access list filter. (Optional) Configures the target state that DLSw+ tries to maintain. The valid range is 1 to 100. (Optional) Cost to reach this remote peer. The valid range is 1 to 5. (Optional) Establishes the TCP connection only when there is an explorer frame destined for the specified 48-bit MAC address written in dotted triplet form. DLSw+ Enhanced Load Balancing 11
Command Reference dmac-output-list access-list-number dynamic host-netbios-out host-list-name inactivity minutes keepalive seconds lf size linger minutes lsap-output-list list no-llc minutes passive priority rif-passthru virtual-ring-number (Optional) Establishes the TCP connection only when the explorer frame passes the specified access list. The access-list-number is the list number specified in an access-list command. (Optional) Establishes the TCP connection only when there is DLSw+ data to send. (Optional) Configures NetBIOS host output filtering for this peer. The host-list-name is the name of the previously defined NetBIOS host access list filter. (Optional) Configures the length of time a connection is idle before closing the dynamic remote peer connection. The valid range is 1 to 300 minutes. The default is 5 minutes. Sets the keepalive interval for this remote peer. The range is 0 to 1200 seconds. (Optional) Largest frame size, in bytes, this local peer uses on a circuit to avoid segmented frames. Valid sizes are 516, 1470, 1500, 2052, 4472, 8144, 11407, 11454, and 17800 bytes. (Optional) Configures length of time the backup peer remains connected after the primary peer connection is reestablished. The valid range is 1 to 300 minutes. The default is 5 minutes. (Optional) Filters output IEEE 802.5 encapsulated packets. Valid access list numbers are in the range 200 to 299. (Optional) Configures the length of time a remote peer remains connected after all LLC2 connections are gone. The valid range is 1 to 300 minutes. The default is 5 minutes. (Optional) Designates this remote peer as passive. (Optional) Enables prioritization features for this remote peer. Valid TCP port numbers are the following: High: 2065 Medium: 1981 Normal: 1982 Low: 1983 (Optional) Configures the remote peer as RIF-Passthru. The virtual-ring-number value is the same number as the ring number value assigned in the source-bridge ring-group commands of the DLSw+ Passthru peers. 12 Cisco IOS Release 12.0(3)T
dlsw remote-peer tcp tcp-queue-max size timeout seconds (Optional) Maximum output TCP queue size for this remote peer. The valid maximum TCP queue size is a number in the range 10 to 2000. (Optional) Configures the retransmit time limit for TCP. The valid range is 5 to 1200 seconds. The default is 90 seconds. Defaults No peer IP address is identified. The linger option is inactive. If the linger option is added with no minutes specified, the default is 5 minutes. The dynamic option is not on by default. If the dynamic option is added without either the inactivity or no-llc argument specified, the default is to terminate the TCP connection to the remote peer after 5 minutes of no active LLC2 connection. Command Mode Global configuration Usage Guidelines This command first appeared in Cisco IOS Release 10.3. The following keywords and arguments first appeared in Cisco IOS Release 11.1: dynamic, inactivity minutes, linger minutes, no-llc minutes and timeout seconds. The following keywords and arguments first appeared in Cisco IOS Release 11.2: dest-mac mac-address, dmac-output-list access-list-number, linger minutes. SNA Dial-on-Demand Routing allows switched links to be closed during idle periods. To enable this feature, set the keepalive option to 0 and configure the timeout option. When the dynamic option is configured, the keepalive option is automatically set to 0. To enhance DDR cost-savings, you can configure the TCP connection to a remote peer to be dynamically established (that is, established only when there is DLSw data to send). You can further configure the TCP connection to terminate after a specified period of idle time on the peer or after a specified period of no active LLC sessions on the peer. You cannot use both no-llc and inactivity in a command specifying a dynamic peer. When you need to permit access to a single MAC address, the dest-mac option is a shortcut over the dmac-output-list option. Use the linger option to specify that a backup peer will remain connected for a specified period of time after the primary connection is gone. When the priority option on the dlsw remote-peer command is configured, DLSw+ automatically activates four TCP ports to that remote peer (ports 2065, 1981, 1982 and 1983) and assigns traffic to specific ports. Furthermore, if APPN is running with DLSw+ and you specify the priority option on the dlsw remote-peer command, then the SNA TOS maps APPN class COS to TCP TOS and preserves the APPN COS characteristics throughout the network. The rif passthru option works only on Token Ring LANs via SRB. Other LAN types, such as SDLC and QLLC, are not supported. The RIF Passthru feature is supported with TCP encapsulation and it disables local acknowledgment. DLSw+ Enhanced Load Balancing 13
Command Reference The following features are not supported with the DLSw+ RIF Passthru feature: Border peers Peer-on-demand peers Dynamic peers Backup peers Examples The following example specifies a TCP encapsulation connection for remote peer transport: dlsw remote-peer 0 tcp 10.2.17.8 The following example specifies a TCP peer as backup to a primary FST peer: dlsw remote-peer 0 fst 10.2.18.9 dlsw remote-peer 0 tcp 10.2.17.8 backup-peer 10.2.18.9 Related Commands show dlsw peers 14 Cisco IOS Release 12.0(3)T