peer load-balancing (BGP view) (group)

Function

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

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

By default, BGP load balancing is not enabled.

Format

peer group-name load-balancing [ as-path-ignore | as-path-relax ]

undo peer group-name load-balancing [ as-path-ignore | as-path-relax ]

Parameters

Parameter	Description	Value
group-name	Specifies the name of a peer group.	The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
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

group-name

Specifies the name of a peer group.

The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

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-IPv4 unicast address family view, BGP 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 group.
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

The maximum load-balancing command and the peer load-balancing command are mutually exclusive.

By default, BGP does not change the next hop addresses of routes to be advertised to IBGP peers to the local address. After peer-based load balancing is enabled, BGP does not change the next hop addresses of routes to be advertised, regardless of whether load balancing is implemented.

If load-balancing as-path-ignore or load-balancing as-path-relax is configured but as-path-ignore or as-path-relax is not configured in the peer load-balancing command, the configuration of load-balancing as-path-ignore or load-balancing as-path-relax takes effect. If as-path-ignore or as-path-relax is specified in the peer load-balancing command, the configuration specified in the peer load-balancing command takes effect.

Example

# Enable load balancing among routes learned from peer group.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] group test external
[*HUAWEI-bgp] peer test as-number 200
[*HUAWEI-bgp] peer test load-balancing as-path-relax