peer next-hop-local (BGP-IPv4 unicast address family view) (IPv6)

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.

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 peerIpv6Addr next-hop-local

undo peer peerIpv6Addr next-hop-local

Parameters

Parameter	Description	Value
peerIpv6Addr	Specifies the IPv6 address of a BGP peer.	The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Parameter

Description

Value

peerIpv6Addr

Specifies the IPv6 address of a BGP peer.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-IPv4 unicast 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.

Precautions

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

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

Example

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

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[*HUAWEI-bgp] ipv4-family unicast
[*HUAWEI-bgp-af-ipv4] peer 2001:DB8:1::1 enable
[*HUAWEI-bgp-af-ipv4] peer 2001:DB8:1::1 next-hop-local