BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

Available Languages

Download Options

  • PDF     (293.3 KB)
    View with Adobe Reader on a variety of devices
Updated:January 6, 2001

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

Table Of Contents

BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

Contents

Prerequisites for BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

Restrictions for BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

Information About BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

Multipath Load Sharing Between eBGP and iBGP

eBGP and iBGP Multipath Load Sharing in a BGP MPLS Network

eBGP and iBGP Multipath Load Sharing With Route Reflectors

Benefits of Multipath Load Sharing for Both eBGP and iBGP

How to Configure BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

Configuring Multipath Load Sharing for Both eBGP an iBGP

Verifying Multipath Load Sharing for Both eBGP an iBGP

Configuration Examples for the BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN Feature

eBGP and iBGP Multipath Load Sharing Configuration Example

eBGP and iBGP Multipath Load Sharing Verification Examples

Where to Go Next

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Command Reference

maximum-paths eibgp


BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

Part Number OL-10923-01 (Rev A0), June 26, 2006

The BGP Multipath Load Sharing for eBGP and iBGP feature allows you to configure multipath load balancing with both external BGP (eBGP) and internal BGP (iBGP) paths in Border Gateway Protocol (BGP) networks that are configured to use Multiprotocol Label Switching (MPLS) Virtual Private Networks (VPNs). This feature provides improved load balancing deployment and service offering capabilities and is useful for multi-homed autonomous systems and Provider Edge (PE) routers that import both eBGP and iBGP paths from multihomed and stub networks.

Feature History for the BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN Feature

Release
Modification

12.2(4)T

This feature was introduced.

12.2(14)S

This feature was integrated into Cisco IOS Release 12.2(14)S.

12.0(24)S

This feature was integrated into Cisco IOS Release 12.0(24)S.

12.2(18)SXE

This feature was integrated into Cisco IOS Release 12.2(18)SXE.

12.0(31)S1

Support was added for IP Services Engine (ISE) line cards that are configured for the MPLS VPN over IP Tunnels feature on the Cisco 12000 series Internet router (see MPLS VPNs over IP Tunnels).

12.0(32)SY

Support was added for Engine 5 shared port adapters (SPAs) that are configured for the MPLS VPN over IP Tunnels feature in SPA Interface Processors (SIPs) on the Cisco 12000 series Internet router (see MPLS VPNs over IP Tunnels).


Finding Support Information for Platforms and Cisco IOS Software Images

Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.

Contents

•Prerequisites for BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

•Restrictions for BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

•Information About BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

•How to Configure BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

•Configuration Examples for the BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN Feature

•Additional References

•Command Reference

Prerequisites for BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

Load Balancing Requires CEF

Cisco Express Forwarding (CEF) or distributed CEF (dCEF) must be enabled on all participating routers.

Restrictions for BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

Address Family Support

This feature is configured on a per VPN routing and forwarding instance (VRF) basis. This feature can be configured under only the IPv4 VRF address family.

Memory Consumption Restriction

Each BGP multipath routing table entry will use additional memory. We recommend that you do not use this feature on a router with a low amount of available memory and especially if router is carries full Internet routing tables.

Route Reflector Limitation

When multiple iBGP paths installed in a routing table, a route reflector will advertise only one paths (next hop). If a router is behind a route reflector, all routers that are connected to multihomed sites will not be advertised unless a different route distinguisher is configured for each VRF.

Information About BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

To configure the BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN feature, you must understand the following concepts:

•Multipath Load Sharing Between eBGP and iBGP

•eBGP and iBGP Multipath Load Sharing in a BGP MPLS Network

•eBGP and iBGP Multipath Load Sharing With Route Reflectors

•Benefits of Multipath Load Sharing for Both eBGP and iBGP

Multipath Load Sharing Between eBGP and iBGP

A BGP routing process will install a single path as the best path in the routing information base (RIB) by default. The maximum-paths command allows you to configure BGP to install multiple paths in the RIB for multipath load sharing. BGP uses the best path algorithm to select a single multipath as the best path and advertise the best path to BGP peers.

Note The number of paths of multipaths that can be configured is documented on the maximum-paths command reference page.

Load balancing over the multipaths is performed by CEF. CEF load balancing is configured on a per-packet round robin or on a per session (source and destination pair) basis. For information about CEF, refer to Cisco IOS IP Switching Configuration Guide documentation:

http://ciscosystems.com/en/US/docs/ios/ipswitch/configuration/guide/12_2sx/isw_12_2sx_book.html

The BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS VPN feature is enabled only under the IPv4 VRF address family configuration mode. When enabled, this feature can perform load balancing on eBGP and/or iBGP paths that are imported into the VRF. The number of multipaths is configured on a per VRF basis. Separate VRF multipath configurations are isolated by unique route distinguisher.

Note The BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS VPN feature operates within the parameters of configured outbound routing policy.

eBGP and iBGP Multipath Load Sharing in a BGP MPLS Network

Figure 1 shows a service provider BGP MPLS network that connects two remote networks to PE router 1 and PE router 2. PE router 1 and PE router 2 are both configured for VPNv4 unicast iBGP peering. Network 2 is a multihomed network that is connected to PE router 1 and PE router 2. Network 2 also has extranet VPN services configured with Network 1. Both Network 1 and Network 2 are configured for eBGP peering with the PE routers.

Figure 1 Service Provider BGP MPLS Network

PE router 1 can be configured with the BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS VPN feature so that both iBGP and eBGP paths can be selected as multipaths and imported into the VRF of Network 1. The multipaths will be used by CEF to perform load balancing. IP traffic that is sent from Network 2 to PE router 1 and PE router 2 will be sent across the eBGP paths as IP traffic. IP traffic that is sent across the iBGP path will be sent as MPLS traffic, and MPLS traffic that is sent across an eBGP path will be sent as IP traffic. Any prefix that is advertised from Network 2 will be received by PE router 1 through route distinguisher (RD) 21 and RD 22.The advertisement through RD 21 will be carried in IP packets, and the advertisement through RD 22 will be carried in MPLS packets. Both paths can be selected as multipaths for VRF1 and installed into the VRF1 RIB.

eBGP and iBGP Multipath Load Sharing With Route Reflectors

Figure 2 shows a topology that contains three PE routers and a route reflector, all configured for iBGP peering. PE router 2 and PE router 3 each advertise an equal preference eBGP path to PE router 1. By default, the route reflector will choose only one path and advertise PE router 1.

Figure 2 Topology With a Route Reflector

For all equal preference paths to PE router 1 to be advertised through the route reflector, you must configure each VRF with a different RD. The prefixes received by the route reflector will be recognized differently and advertised to PE router 1.

Benefits of Multipath Load Sharing for Both eBGP and iBGP

The BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS VPN feature allows multihomed autonomous systems and PE routers to be configured to distribute traffic across both eBGP and iBGP paths.

How to Configure BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN

This section contains the following procedures:

•Configuring Multipath Load Sharing for Both eBGP an iBGP

•Verifying Multipath Load Sharing for Both eBGP an iBGP

Note Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.

Configuring Multipath Load Sharing for Both eBGP an iBGP

To configure this feature, perform the steps in this section.

SUMMARY STEPS

1. enable

2. configure {terminal | memory | network}

3. router bgp as-number

4. address-family ipv4 [mdt | multicast | tunnel | unicast [vrf vrf-name] | vrf vrf-name] | ipv6 [multicast | unicast] | vpnv4 [unicast]

5. maximum-paths eibgp number [import number]

6. end

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables higher privilege levels, such as privileged EXEC mode.

•Enter your password if prompted.

Step 2 

configure {terminal | memory | network}

Example:

Router# configure terminal

Enters global configuration mode.

Step 3 

router bgp as-number

Example:

Router(config)# router bgp 40000

Enters router configuration mode to create or configure a BGP routing process.

Step 4 

address-family ipv4 vrf vrf-name

Example:

Router(config-router)# address-family ipv4 vrf RED

Places the router in address family configuration mode.

•Separate VRF multipath configurations are isolated by unique route distinguisher.

Step 5 

maximum-paths eibgp number [import number]

Example:

Router(config-router-af)# maximum-paths eibgp 6

Configures the number of parallel iBGP and eBGP routes that can be installed into a routing table.

Note The maximum-paths eibgp command can be configured only under the IPv4 VRF address family configuration mode and cannot be configured in any other address family configuration mode.

Step 6 

end

Example:

Router(config-router-af)# end

Exits address family configuration mode, and enters Privileged EXEC mode.

Verifying Multipath Load Sharing for Both eBGP an iBGP

To verify this feature, perform the steps in this section

SUMMARY STEPS

1. enable

2. show ip bgp neighbors [neighbor-address [advertised-routes | dampened-routes | flap-statistics | paths [regexp] | received prefix-filter | received-routes | routes]]

3. show ip bgp vpnv4 {all | rd route-distinguisher | vrf vrf-name} ip-prefix/length [longer-prefixes] [output-modifiers] | network-address [mask] [longer-prefixes] [output-modifiers] [cidr-only] | [community [number | exact-match | local-as | no-advertise | no-export]] | [community-list name | number [exact-match]] | [dampening dampened-paths | flap-statistics | parameters] | [filter-list regexp-acl] | [inconsistent-as] | [injected-paths] | [labels] | [neighbors] | [paths [regexp]] | [peer-group [name [summary]]] | [quote-regexp [regexp]] | [regexp string] | [replication [update-group [ip-address]] | [ip-address]] | [rib-failure] | [route-map name] | [summary] | [templates peer-policy [name] | peer-session [name]] | update-group [update-group [ip-address]] | [ip-address]]

4. show ip route vrf vrf-name [connected] [protocol [process-number] [tag] [output-modifiers]] [ip-prefix] [list number [output-modifiers]] [profile] [static [output-modifiers]] [summary [output-modifiers]] [supernets-only [output-modifiers]] [traffic-engineering [output-modifiers]]

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables higher privilege levels, such as privileged EXEC mode.

•Enter your password if prompted.

Step 2 

show ip bgp neighbors [neighbor-address [advertised-routes | dampened-routes | flap-statistics | paths [regexp] | received prefix-filter | received-routes | routes]]

Example:

Router# show ip bgp neighbors

Displays information about the TCP and BGP connections to neighbors.

Step 3 

show ip bgp vpnv4 {all | rd route-distinguisher | vrf vrf-name} ip-prefix/length [longer-prefixes] [output-modifiers] | network-address [mask] [longer-prefixes] [output-modifiers] [cidr-only] | [community [number | exact-match | local-as | no-advertise | no-export]] | [community-list name | number [exact-match]] | [dampening dampened-paths | flap-statistics | parameters] | [filter-list regexp-acl] | [inconsistent-as] | [injected-paths] | [labels] | [neighbors] | [paths [regexp]] | [peer-group [name [summary]]] | [quote-regexp [regexp]] | [regexp string] | [replication [update-group [ip-address]] | [ip-address]] | [rib-failure] | [route-map name] | [summary] | [templates peer-policy [name] | peer-session[name]] | update-group [update-group [ip-address]] | [ip-address]]

Example:

Router# show ip bgp vpnv4 vrf RED

Displays VPN address information from the BGP table. This command is used to verify that the VRF has been received by BGP.

Step 4 

show ip route vrf vrf-name [connected] [protocol [process-number] [tag] [output-modifiers]] [ip-prefix] [list number [output-modifiers]] [profile] [static [output-modifiers]] [summary [output-modifiers]] [supernets-only [output-modifiers]] [traffic-engineering [output-modifiers]]

Example:

Router# show ip route vrf RED

Displays the IP routing table associated with a VRF instance. The show ip route vrf command is used to verify that the VRF is in the routing table.

Configuration Examples for the BGP Multipath Load Sharing for Both eBGP and iBGP in an MPLS-VPN Feature

The following examples show how to configure and verify this feature:

•eBGP and iBGP Multipath Load Sharing Configuration Example

•eBGP and iBGP Multipath Load Sharing Verification Examples

eBGP and iBGP Multipath Load Sharing Configuration Example

This following configuration example configures a router in address-family mode to select six BGP routes (eBGP or iBGP) as multipaths: 

Router(config)# router bgp 40000 

 Router(config-router)# address-family ipv4 vrf RED 

 Router(config-router-af)# maximum-paths eibgp 6 

 Router(config-router-af)# end

eBGP and iBGP Multipath Load Sharing Verification Examples

To verify that iBGP and eBGP routes have been configured for load sharing, use the show ip bgp vpnv4 EXEC command or the show ip route vrf EXEC command.

In the following example, the show ip bgp vpnv4 command is entered to display multipaths installed in the VPNv4 RIB: 

Router# show ip bgp vpnv4 all 10.22.22.0

BGP routing table entry for 10:1:22.22.22.0/24, version 19

Paths:(5 available, best #5)

Multipath:eiBGP

  Advertised to non peer-group peers:

  10.0.0.2 10.0.0.3 10.0.0.4 10.0.0.5

  22

    10.0.0.2 (metric 20) from 10.0.0.4 (10.0.0.4)

      Origin IGP, metric 0, localpref 100, valid, internal, multipath

      Extended Community:0x0:0:0 RT:100:1 0x0:0:0

      Originator:10.0.0.2, Cluster list:10.0.0.4

  22

    10.0.0.2 (metric 20) from 10.0.0.5 (10.0.0.5)

      Origin IGP, metric 0, localpref 100, valid, internal, multipath

      Extended Community:0x0:0:0 RT:100:1 0x0:0:0

      Originator:10.0.0.2, Cluster list:10.0.0.5

  22

    10.0.0.2 (metric 20) from 10.0.0.2 (10.0.0.2)

      Origin IGP, metric 0, localpref 100, valid, internal, multipath

      Extended Community:RT:100:1 0x0:0:0

  22

    10.0.0.2 (metric 20) from 10.0.0.3 (10.0.0.3)

      Origin IGP, metric 0, localpref 100, valid, internal, multipath

      Extended Community:0x0:0:0 RT:100:1 0x0:0:0

      Originator:10.0.0.2, Cluster list:10.0.0.3

  22

    10.1.1.12 from 10.1.1.12 (10.22.22.12)

      Origin IGP, metric 0, localpref 100, valid, external, multipath, best

      Extended Community:RT:100:1

In the following example, the show ip route vrf command is entered to display multipath routes in the VRF table: 

Router# show ip route vrf PATH 10.22.22.0

Routing entry for 10.22.22.0/24

  Known via "bgp 1", distance 20, metric 0

  Tag 22, type external

  Last update from 10.1.1.12 01:59:31 ago

  Routing Descriptor Blocks:

  * 10.0.0.2 (Default-IP-Routing-Table), from 10.0.0.4, 01:59:31 ago

      Route metric is 0, traffic share count is 1

      AS Hops 1

    10.0.0.2 (Default-IP-Routing-Table), from 10.0.0.5, 01:59:31 ago

      Route metric is 0, traffic share count is 1

      AS Hops 1

    10.0.0.2 (Default-IP-Routing-Table), from 10.0.0.2, 01:59:31 ago

      Route metric is 0, traffic share count is 1

      AS Hops 1

    10.0.0.2 (Default-IP-Routing-Table), from 10.0.0.3, 01:59:31 ago

      Route metric is 0, traffic share count is 1

      AS Hops 1

    10.1.1.12, from 10.1.1.12, 01:59:31 ago

      Route metric is 0, traffic share count is 1

      AS Hops 1

Where to Go Next

For information about advertising the bandwidth of an autonomous system exit link as an extended community, refer to the BGP Link Bandwidth document:

http://www.cisco.com/en/US/docs/ios/iproute_bgp/configuration/guide/irg_link_band.html

Additional References

Related Documents

Related Topic
Document Title

BGP commands: complete command syntax, command mode, command history, defaults, usage guidelines, and examples

•Cisco IOS IP Command Reference, Volume 2 of 4: Routing Protocols, Release 12.3T

BGP configuration tasks

•Cisco IOS IP Configuration Guide, Release 12.3

Comprehensive BGP link bandwidth configuration examples and tasks

•BGP Link Bandwidth

CEF configuration tasks

•Cisco IOS Switching Services Configuration Guide


Standards

Standards
Title

No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.

—


MIBs

MIBs
MIBs Link

No new or modified MIBs are supported by this feature, and support for existing MIBs has not been modified by this feature.

To obtain lists of supported MIBs by platform and Cisco IOS release, and to download MIB modules, go to the Cisco MIB website on Cisco.com at the following URL:

http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml


RFCs


Technical Assistance

Description
Link

Technical Assistance Center (TAC) home page, containing 30,000 pages of searchable technical content, including links to products, technologies, solutions, technical tips, tools, and lots more. Registered Cisco.com users can log in from this page to access even more content.

http://www.cisco.com/public/support/tac/home.shtml


Command Reference

This section documents the maximum-paths eibgp command.

maximum-paths eibgp

To configure multipath load sharing for external BGP (eBGP) and internal (iBGP) routes, use the maximum-paths eibgp command in address family configuration mode. To disable multipath load sharing for eBGP and iBGP routes, use the no form of this command.

maximum-paths eibgp number [import number]

no maximum-paths eibgp number [import number]

Syntax Description

number

Specifies the number of routes to install to the routing table. See the usage guidelines for the number of paths that can be configured with this argument.

import number

(Optional) Specifies the number of redundant paths that can be configured as back up multipaths for a VRF. This keyword can only be configured under a VRF in address family configuration mode.

Note We recommend that this feature is enabled only where needed and that the number of import paths be kept to the minimum (Typically, not more than two paths). For more information, see the related note in the usage guidelines of this command reference page.


Defaults

Border Gateway Protocol (BGP) by default will install only one best path in the routing table.

Command Modes

IPv4 VRF Address family configuration

Command History

Release
Modification

12.2(4)T

This command was introduced.

12.0(24)S

This command was integrated into Cisco IOS Release 12.0(24)S.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.0(25)S

The import keyword was introduced.

12.2(13)T

The import keyword was integrated into Cisco IOS Release 12.2(13)T.

12.2(14)S

The import keyword was integrated into Cisco IOS Release 12.2(14)S.


Usage Guidelines

The maximum-paths eibgp command used to configure Border Gateway Protocol (BGP) multipath load sharing in an Multiprotocol Label Switching (MPLS) virtual private network (VPN) using eBGP and iBGP routes. This feature is configured under a VPN routing and forwarding instance (VRF) in address family configuration mode. The number of multipaths is configured separately for each VRF. The number of paths that can be configured is determined by the version of Cisco IOS software. The following list shows current limits:

•Cisco IOS Release 12.0S based software: 8 paths

•Cisco IOS Release 12.3T based software: 16 paths

•Cisco IOS Release 12.2S based software: 32 paths

The maximum-paths eibgp command cannot be configured with the maximum-paths or maximum-paths ibgp command because the maximum-paths eibgp command is a superset of these commands.

Note The configuration of this command does not override the existing outbound routing policy.

Configuring VRF Import Paths

A VRF will import only one path (best path) per prefix from the source VRF table, unless the prefix is exported with a different route-target. If the best path goes down, the destination will not be reachable until the next import event occurs, and then a new best path will be imported into the VRF table. The import event runs every 15 seconds by default.

The import keyword allows you to configure the VRF table to accept multiple redundant paths in addition to the best path. An import path is a redundant path, and it can have a next hop that matches an installed multipath.This feature should be used when there are multiple paths with identical next hops available to ensure optimal convergence times. A typical application of this feature is to configure redundant paths in a network that has multiple route reflectors for redundancy.

Note Configuring redundant paths with the import keyword can increase CPU and memory utilization significantly, especially in a network where there are many prefixes to learn and a large number of configured VRFs. It is recommended that this feature is only configured as necessary and that the minimum number of redundant paths are configured (Typically, not more than two).

Examples

In the following example, the router is configured to install 6 eBGP or iBGP routes into the VRF routing table: 

Router(config)# router bgp 40000 

Router(config-router)# address-family ipv4 vrf YELLOW 

Router(config-router-af)# maximum-paths eibgp 6

In the following example, the router is configured to install 4 equal-cost routes and 2 import routes (backup) in the VRF routing table: 

Router(config)# router bgp 45000 

Router(config-router)# address-family ipv4 vrf GREEN 

Router(config-router-af)# maximum-paths eibgp 4 import 2

In the following example, the router is configured to install 2 import routes in the VRF routing table: 

Router(config)# router bgp 50000

Router(config-router)# address-family ipv4 vrf ORANGE 

Router(config-router-af)# maximum-paths eibgp import 2

Note Separate VRFs must be configured with different route distinguisher to support separate multipath configurations.

Related Commands

Command
Description

maximum-paths

Configures the number of equal-cost routes that BGP will install in the routing table.

maximum-paths ibgp

Configures the number of equal-cost or unequal-cost routes that BGP will install in the routing table.

show ip bgp

Displays entries in the BGP routing table.


Copyright © 2006 Cisco Systems, Inc. All rights reserved

Was this Document Helpful?

FeedbackFeedback

Contact Cisco