peer keep-all-routes (BGP-IPv4 multicast address family view)

Function

The peer keep-all-routes command configures an MBGP device to store all routing updates received from a specified peer after an MBGP connection is set up, even though those routing updates fail to match the configured import policy.

The undo peer keep-all-routes command cancels the configuration.

By default, an MBGP device stores only the routing updates that are received from a specified peer and match the configured import policy.

Format

peer peerIpv4Addr keep-all-routes

undo peer peerIpv4Addr keep-all-routes

Parameters

Parameter Description Value
peerIpv4Addr

Specifies the IP address of an MBGP peer.

The address is in dotted decimal notation.

Views

BGP-IPv4 multicast address family view

Default Level

2: Configuration level

Task Name and Operations

Task Name Operations
bgp write

Usage Guidelines

Usage Scenario

After changing a MBGP import policy, you can reset BGP connections for the new import policy to take effect immediately, interrupting these MBGP connections temporarily. If a device's peer does not support route-refresh, the peer keep-all-routes command can be used on the device to remain all routing updates received from the peer so that the device can refresh its routing table without closing the connection with the peer.

Implementation Procedure

If the peer keep-all-routes command is run but no peer exists, a message is displayed, indicating that the peer does not exist.

Precautions

If the route does not support the route-refresh capability, the peer keep-all-routes command needs to be run on the route and its peer. If the peer keep-all-routes command is run on a device for the first time, the sessions between the device and its peers will be re-established.

If the route supports the route-refresh capability, running this command does not result in re-establishment of the sessions between the route and its peers. After the refresh bgp command is run on the route, however, the route does not refresh its routing table.

After the keep-all-routes command is run, the undo peer keep-all-routes command becomes ineffective. To have the undo peer keep-all-routes command become effective, run the undo keep-all-routes command and then the peer keep-all-routes command.

Example

# Configure an MBGP device to store all routing updates received from its peer.
<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] peer 1.1.1.1 as-number 100
[*HUAWEI-bgp] IPv4-family multicast
[*HUAWEI-bgp-af-multicast] peer 1.1.1.1 enable
[*HUAWEI-bgp-af-multicast] peer 1.1.1.1 keep-all-routes
Copyright © Huawei Technologies Co., Ltd.
Copyright © Huawei Technologies Co., Ltd.
< Previous topic Next topic >