peer next-hop-local (BGP-VPNv4 address family view) (group)

Function

The peer next-hop-local command configures a BGP device to set its IP address as the next hop of routes when the BGP device advertises routes to an IBGP peer group.

The undo peer next-hop-local command restores the default setting.

By default:

A BGP router sets IP address of the local interface connected to the peer as the next-hop address of routes when advertising these routes to an EBGP peer.
A BGP router does not change the next-hop address of non-labeled routes if the routes are from an EBGP peer and are to be sent to an IBGP peer. The router sets IP address of the local interface connected to the peer as the next-hop address of labeled routes if the routes are from an EBGP peer and are to be sent to an IBGP peer.
A BGP router does not change the next-hop address of routes if the routes are from an IBGP peer and are to be sent to an IBGP peer.
A BGP router sets the IP address of the local interface connected to the peer as the next-hop address of the locally originated routes to be advertised to an IBGP peer.

Format

peer group-name next-hop-local

undo peer group-name next-hop-local

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.

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.

Views

BGP-VPNv4 address family view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
bgp	write

Usage Guidelines

Usage Scenario

The peer next-hop-local command is usually run on an ASBR. By default, when an ASBR forwards a route learned from an EBGP peer to its IBGP peers, the ASBR does not change the Next_Hop of the route. Therefore, the Next_Hop address of the route remains the EBGP peer IP address. After being forwarded to the IBGP peers, the route cannot become active because of the unreachable Next_Hop. The peer next-hop-local command needs to be run to configure the ASBR to modify the Next_Hop of the route to the local IP address before advertising the route to IBGP peers. After being forwarded to the IBGP peers, the route can be active because the Next_Hop is reachable (an IGP is configured in the AS).

Configuration Impact

If the peer next-hop-local command is run more than once, the latest configuration overrides the previous one.

After the peer next-hop-local command is configured on a device, the device sets its IP address as the next hop of routes when the BGP device advertises the routes to its IBGP peer group.

Precautions

The peer next-hop-local command is applicable to IBGP peers.

When the BGP device advertises routes to an IBGP peer group, the peer next-hop-local command and the peer next-hop-invariable command are mutually exclusive.

If the peer next-hop-local command is run on a route reflector, the command takes effect for BGP labeled routes, VPNv4 routes, and VPNv6 routes.

If the peer next-hop-local command is run on a route reflector or a peer in a BGP confederation, the command takes effect only for BGP labeled routes, VPNv4 routes, and VPNv6 routes over the public network and does not take effect for the other types of routes.

Example

# Configure a BGP device to set its IP address as the next hop of routes when advertising the routes to peer group.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[~HUAWEI-bgp] group a internal
[~HUAWEI-bgp] ipv4-family vpnv4
[~HUAWEI-bgp-af-vpnv4] peer a enable
[~HUAWEI-bgp-af-vpnv4] peer a next-hop-local