peer load-balancing (BGP-Labeled address family view)

Function

The peer load-balancing command enables BGP peer-based load balancing.

The undo peer load-balancing command restores the default configuration.

By default, BGP load balancing is not enabled.

Format

peer ipv4-address load-balancing [ as-path-ignore | as-path-relax ]

undo peer ipv4-address load-balancing [ as-path-ignore | as-path-relax ]

Parameters

Parameter	Description	Value
ipv4-address	Specifies the IPv4 address of a peer.	The value is in dotted decimal notation.
as-path-ignore	Prevents the router from comparing AS_Path attributes when selecting routes for load balancing.	-
as-path-relax	Configures the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.	-

Parameter

Description

Value

ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

as-path-ignore

Prevents the router from comparing AS_Path attributes when selecting routes for load balancing.

as-path-relax

Configures the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.

Views

BGP-Labeled address family view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
bgp	write

Usage Guidelines

Usage Scenario

On large networks, there may be multiple valid routes to the same destination. BGP, however, advertises only the optimal route to its peers. This may result in unbalanced traffic on different routes. To prevent this problem, configure load balancing.

After the peer load-balancing command is run, BGP peer-based load balancing is implemented only when the following conditions are met:

The routes are received from the specified peer.
The optimal route and optimal equal-cost routes exist.
The AS_Path attribute is the same as that of the optimal route, or as-path-ignore or as-path-relax is specified in the peer load-balancing command.
a.If as-path-ignore is specified, the device ignores comparing AS_Path attributes when selecting routes for load balancing. In this case, routes can participate in load balancing even if their AS_Path attributes are different.
b.If as-path-relax is specified, the device ignores comparing the AS_Path attributes of the same length when selecting routes for load balancing. In this case, routes cannot participate in load balancing if their AS_Path attributes are of different lengths. For example, the AS_Path attribute of route A is 10, and the AS_Path attribute of route B is 10, 20. Because the two AS_Path attributes are of different lengths, the two routes cannot participate in load balancing.

Precautions

By default, BGP does not change the next-hop IP addresses of the routes to be advertised to IBGP peers to the local IP address. However, if BGP peer or peer group-based load balancing is enabled, BGP changes the next-hop IP addresses of the routes to be advertised to the peer or peer group to the local IP address.

If the peer load-balancing command without as-path-ignore or as-path-relax specified and the load-balancing as-path-ignore or load-balancing as-path-relax command are run, the load-balancing as-path-ignore or load-balancing as-path-relax command takes effect. If the peer load-balancing command with as-path-ignore or as-path-relax specified and the load-balancing as-path-ignore or load-balancing as-path-relax command are run, the peer load-balancing command takes effect.

Example

# Enable load balancing among routes learned from peer and among routes learned from peer 2::2 and configure the device to ignore comparing the AS_Path attributes of the same length when selecting routes for load balancing.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] peer 1.1.1.1 as-number 100
[*HUAWEI-bgp] ipv4-family labeled-unicast
[*HUAWEI-bgp-af-ipv4-labeled] peer 1.1.1.1 enable
[*HUAWEI-bgp-af-ipv4-labeled] peer 1.1.1.1 load-balancing as-path-relax