05-Layer 3-IP Routing Command Reference

HomeSupportResource CenterH3C S5560S-EI&S5560S-SI&S5500V3-SI Switch Series Command References-R612x-6W10205-Layer 3-IP Routing Command Reference
06-BGP commands
Title Size Download
06-BGP commands 664.40 KB

Contents

BGP commands· 1

additional-paths select-best 1

address-family ipv4· 1

address-family ipv6· 2

address-family link-state· 3

advertise-rib-active· 4

aggregate· 5

balance· 7

balance as-path-neglect 9

balance as-path-relax· 9

bestroute as-path-neglect 10

bestroute compare-med· 11

bestroute igp-metric-ignore· 11

bestroute med-confederation· 12

bgp· 13

bgp apply-policy on-startup duration· 13

bgp policy on-startup med· 14

bgp update-delay on-startup· 15

bgp update-delay on-startup prefix-list 16

bmp server 16

compare-different-as-med· 17

confederation id· 17

confederation nonstandard· 18

confederation peer-as· 19

dampening· 20

default local-preference· 21

default med· 22

default-route imported· 23

default-route update-first 24

display bgp bmp server 24

display bgp dampening parameter 26

display bgp group· 27

display bgp instance-info· 30

display bgp link-state· 30

display bgp network· 34

display bgp non-stop-routing status· 36

display bgp paths· 37

display bgp peer 38

display bgp peer received prefix-list 50

display bgp routing-table dampened· 51

display bgp routing-table flap-info· 53

display bgp routing-table ipv4 multicast 55

display bgp routing-table ipv4 unicast 62

display bgp routing-table ipv6 multicast 69

display bgp routing-table ipv6 unicast 76

domain-distinguisher 83

ebgp-interface-sensitive· 84

fast-reroute route-policy· 84

filter-policy export 85

filter-policy import 87

flush suboptimal-route· 88

graceful-restart 89

graceful-restart timer purge-time· 90

graceful-restart timer restart 91

graceful-restart timer wait-for-rib· 92

group· 93

ignore all-peers· 94

ignore-first-as· 95

import-route· 95

ip vpn-instance (BGP instance view) 97

log-peer-change· 98

log-route-flap· 99

network· 100

network short-cut 101

non-stop-routing· 102

peer additional-paths· 103

peer advertise additional-paths best 104

peer advertise-community· 105

peer advertise-ext-community· 107

peer allow-as-loop· 108

peer as-number (for a BGP peer group) 110

peer as-number (for a BGP peer) 111

peer as-path-acl 112

peer bfd· 113

peer bmp server 115

peer capability-advertise conventional 116

peer capability-advertise orf non-standard· 117

peer capability-advertise orf prefix-list 118

peer capability-advertise route-refresh· 119

peer capability-advertise suppress-4-byte-as· 120

peer connect-interface· 121

peer default-route-advertise· 123

peer description· 125

peer dscp· 125

peer ebgp-max-hop· 126

peer enable· 127

peer fake-as· 129

peer filter-policy· 130

peer group· 132

peer ignore· 134

peer ignore-originatorid· 135

peer ipsec-profile· 136

peer keep-all-routes· 138

peer log-change· 139

peer low-memory-exempt 140

peer next-hop-local 141

peer nexthop-recursive-policy disable· 142

peer password· 143

peer preferred-value· 144

peer prefix-list 146

peer public-as-only· 147

peer reflect-client 149

peer route-limit 150

peer route-policy· 152

peer route-update-interval 154

peer soo· 155

peer source-address· 156

peer substitute-as· 158

peer timer 159

peer timer connect-retry· 160

peer ttl-security· 161

pic· 162

preference· 163

primary-path-detect bfd· 164

reflect between-clients· 165

reflector cluster-id· 165

refresh bgp· 166

reset bgp· 168

reset bgp all 169

reset bgp bmp server statistics· 170

reset bgp dampening· 170

reset bgp flap-info· 172

router id· 173

router-id (BGP instance view) 174

router-id (BGP-VPN instance view) 175

route-rate-limit 176

server 176

snmp context-name· 177

snmp-agent trap enable bgp· 178

statistics-interval 179

summary automatic· 180

timer 180

timer connect-retry· 181

 


BGP commands

additional-paths select-best

Use additional-paths select-best to set the maximum total number of Add-Path optimal routes that can be advertised to all peers.

Use undo additional-paths select-best to restore the default.

Syntax

additional-paths select-best best-number

undo additional-paths select-best

Default

A maximum of one Add-Path optimal route can be advertised to all peers.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

Predefined user roles

network-admin

Parameters

best-number: Specifies the maximum total number of Add-Path optimal routes that can be advertised to all peers, in the range of 2 to 32.

Usage guidelines

The number of optimal routes cannot exceed the maximum total number of Add-Path optimal routes that can be advertised to all peers.

Examples

# In BGP IPv4 unicast address family view, set the maximum total number to 3 for Add-Path optimal routes that can be advertised to all peers.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] additional-paths select-best 3

Related commands

peer additional-paths

peer advertise additional-paths best

address-family ipv4

Use address-family ipv4 to create the BGP IPv4 unicast address family, BGP-VPN IPv4 unicast address family, or BGP IPv4 multicast address family, and enter its view, or enter the view of the existing address family.

Use undo address-family ipv4 to remove the BGP IPv4 unicast address family, BGP-VPN IPv4 unicast address family, or BGP IPv4 multicast address family, and all its configurations.

Syntax

In BGP instance view:

address-family ipv4 [ multicast | unicast ]

undo address-family ipv4 [ multicast | unicast ]

In BGP-VPN instance view:

address-family ipv4 [ unicast ]

undo address-family ipv4 [ unicast ]

Default

No BGP IPv4 unicast address family, BGP-VPN IPv4 unicast address family, or BGP IPv4 multicast address family exists.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Parameters

multicast: Specifies the IPv4 multicast address family.

unicast: Specifies the IPv4 unicast address family. If this command is executed with the unicast keyword in BGP instance view, it places you into BGP IPv4 unicast address family view. If this command is executed with the unicast keyword in BGP-VPN instance view, it places you into BGP-VPN IPv4 unicast address family view.

Usage guidelines

Configurations made in BGP IPv4 unicast address family view apply only to the BGP IPv4 unicast routes and peers of the public network.

Configurations made in BGP-VPN IPv4 unicast address family view apply only to the BGP IPv4 unicast routes and peers of the specified VPN instance.

Configurations made in BGP IPv4 multicast address family view apply only to the BGP IPv4 multicast routes and peers.

By default, the unicast keyword is used if you do not specify the multicast or unicast keyword.

Examples

# In BGP instance view, create the BGP IPv4 unicast address family and enter its view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4]

address-family ipv6

Use address-family ipv6 to create the BGP IPv6 unicast address family, BGP-VPN IPv6 unicast address family, or BGP IPv6 multicast address family, and enter its view, or enter the view of the existing address family.

Use undo address-family ipv6 to remove the BGP IPv6 unicast address family, BGP-VPN IPv6 unicast address family, or BGP IPv6 multicast address family, and all its configurations.

Syntax

In BGP instance view:

address-family ipv6 [ multicast | unicast ]

undo address-family ipv6 [ multicast | unicast ]

In BGP-VPN instance view:

address-family ipv6 [ unicast ]

undo address-family ipv6 [ unicast ]

Default

No BGP IPv6 unicast address family, BGP-VPN IPv6 unicast address family, or BGP IPv6 multicast address family exists.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Parameters

unicast: Specifies the IPv6 unicast address family. If this command is executed with the unicast keyword in BGP instance view, it places you into BGP IPv6 unicast address family view. If this command is executed with the unicast keyword in BGP-VPN instance view, it places you into BGP-VPN IPv6 unicast address family view.

multicast: Specifies the IPv6 multicast address family.

Usage guidelines

Configurations made in BGP IPv6 unicast address family view apply only to the BGP IPv6 unicast routes and peers of the public network.

Configurations made in BGP-VPN IPv6 unicast address family view apply only to the BGP IPv6 unicast routes and peers of the specified VPN instance.

Configurations made in BGP IPv6 multicast address family view apply only to the BGP IPv6 multicast routes and peers.

By default, the unicast keyword is used if neither the multicast keyword nor the unicast keyword is specified.

Examples

# In BGP instance view, create the BGP IPv6 unicast address family and enter its view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv6 unicast

[Sysname-bgp-default-ipv6]

address-family link-state

Use address-family link-state to create the BGP LS address family and enter its view, or enter the view of the existing address family.

Use undo address-family link-state to remove the BGP LS address family and all its configurations.

Syntax

address-family link-state

undo address-family link-state

Default

No BGP LS address family exists.

Views

BGP instance view

Predefined user roles

network-admin

Usage guidelines

Configurations made in BGP LS address family view apply only to the BGP LS routes and peers of the public network.

Examples

# In BGP instance view, create the BGP LS address family and enter its view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family link-state

[Sysname-bgp-default-ls]

advertise-rib-active

Use advertise-rib-active to enable BGP to advertise only the optimal BGP routes in the IP routing table.

Use undo advertise-rib-active to restore the default.

Syntax

advertise-rib-active

undo advertise-rib-active

Default

In BGP instance view, BGP advertises optimal routes in the BGP routing table, regardless of whether they are optimal in the IP routing table. In other views, the setting is the same as that in BGP instance view.

Views

BGP instance view

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

Predefined user roles

network-admin

Usage guidelines

The advertise-rib-active command does not apply to the following routes:

·          Routes redistributed by the import-route command.

·          Routes advertised by the network command.

·          Default routes redistributed by the default-route imported command.

·          IPv4 multicast routes.

·          IPv6 multicast routes.

This command takes effect only on the routes generated after you execute this command. To apply this command to existing routes, use the reset bgp command to reset BGP sessions.

The setting in BGP unicast address family view applies when it is different from that in BGP instance view.

Examples

# In BGP instance view, enable BGP to advertise optimal routes in the IP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] advertise-rib-active

aggregate

Use aggregate to create a summary route in the BGP routing table.

Use undo aggregate to remove a summary route.

Syntax

In BGP IPv4 unicast address family view/BGP-VPN IPv4 unicast address family view/BGP IPv4 multicast address family view:

aggregate ipv4-address { mask-length | mask } [ as-set | attribute-policy route-policy-name | detail-suppressed | origin-policy route-policy-name | suppress-policy route-policy-name ] *

undo aggregate ipv4-address { mask-length | mask }

In BGP IPv6 unicast address family view/BGP-VPN IPv6 unicast address family view/BGP IPv6 multicast address family view:

aggregate ipv6-address prefix-length [ as-set | attribute-policy route-policy-name | detail-suppressed | origin-policy route-policy-name | suppress-policy route-policy-name ] *

undo aggregate ipv6-address prefix-length

Default

No summary routes are configured.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

ipv4-address: Specifies an IPv4 summary address.

mask-length: Specifies a mask length for the IPv4 summary address, in the range of 0 to 32.

mask: Specifies a mask for the IPv4 summary address, in dotted decimal notation.

ipv6-address: Specifies an IPv6 summary address.

prefix-length: Specifies a prefix length for the IPv6 summary address, in the range of 0 to 128.

as-set: Enables the AS_PATH attribute of the summary route to contain the AS path information for all summarized routes. The AS_PATH attribute is of the AS_SET type that requires no sequence when arranging AS numbers. If you do not specify this keyword, the AS_PATH attribute of the summary route contains only the AS number of the local router.

attribute-policy route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters, to set attributes for the summary route.

detail-suppressed: Advertises only the summary route. If you do not specify this keyword, BGP advertises both the summary route and the more specific routes.

origin-policy route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters, to select routes to be summarized.

suppress-policy route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters, to filter more specific routes to be advertised. Routes permitted by the specified routing policy are not advertised. Routes denied by the specified routing policy are advertised.

Usage guidelines

This command creates a summary route. If the BGP routing table has routes whose destination addresses fall within the specified network, the summary route is added to the BGP routing table. For example, if two routes 10.1.1.0/24 and 10.1.2.0/24 exist in the BGP routing table, configuring the aggregate 10.1.0.0 16 command creates a summary route 10.1.0.0/16.

If the summarized routes have different ORIGIN attributes, the summary route selects the ORIGIN attribute in the sequence of INCOMPLETE, EGP, and IGP. For example, if the ORIGIN attributes of the summarized routes include INCOMPLETE and IGP, the ORIGIN attribute of the summary route is INCOMPLETE.

The COMMUNITY attribute of the summary route includes all the COMMUNITY (or extended community) attribute values if the routes have the following details:

·          Summarized routes have different COMMUNITY (or extended community) attribute values.

·          The summary route does not have the ATOMIC_AGGREGATE attribute.

Table 1 Functions of the keywords

Keywords

Function

as-set

Enables the summary route to carry the AS path information for all summarized routes. This feature can help avoid routing loops. However, if many routes are summarized and are changed frequently, do not specify this keyword. This configuration causes the summary route to flap with the more specific routes.

attribute-policy

Sets attributes for the summary route. The peer route-policy command can achieve the same purpose.

You cannot use this keyword to modify the AS_PATH attribute of the summary route.

detail-suppressed

Disables advertisement of all more specific routes. To disable advertisement of some more specific routes, use the suppress-policy keyword or the peer filter-policy command.

origin-policy

Summarizes only routes matching a routing policy.

If the destination address of a route falls within the summary network but does not match the routing policy, the route is not summarized. It is not controlled by the detail-suppressed and suppress-policy keywords.

There is no need to configure apply clauses for the routing policy applied by the origin-policy keyword because they do not take effect.

suppress-policy

Disables advertisement of some more specific routes filtered by a routing policy. The routing policy uses if-match clauses to filter routes.

There is no need to configure apply clauses for the routing policy applied by the suppress-policy keyword because they do not take effect.

Examples

# In BGP IPv4 unicast address family view, create summary route 1.1.0.0/16 in the BGP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] aggregate 1.1.0.0 255.255.0.0

Related commands

display bgp routing-table ipv4 multicast

display bgp routing-table ipv4 unicast

display bgp routing-table ipv6 multicast

display bgp routing-table ipv6 unicast

summary automatic

balance

Use balance to enable load balancing and set the maximum number of BGP ECMP routes for load balancing.

Use undo balance to disable load balancing.

Syntax

balance [ ebgp | eibgp | ibgp ] number

undo balance [ ebgp | eibgp | ibgp ]

Default

Load balancing is disabled.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

ebgp: Enables load balancing over EBGP routes.

eibgp: Enables load balancing between EBGP and IBGP routes.

ibgp: Enables load balancing over IBGP routes.

number: Specifies the maximum number of BGP ECMP routes for load balancing. When it is set to 1, load balancing is disabled.

Usage guidelines

Unlike IGP, BGP has no explicit metric for making load balancing decision. Instead, it implements load balancing by modifying route selection rules.

BGP uses the following load balancing criteria to determine load balanced routes:

·          The routes have the same ORIGIN, LOCAL_PREF, and MED attributes.

·          The routes meet the following requirements on the AS_PATH attribute:

¡  If both the balance as-path-neglect and balance as-path-relax commands are configured or only the balance as-path-neglect command is configured, the routes can have different AS_PATH attributes.

¡  If only the balance as-path-relax command is configured, the routes can have different AS_PATH attributes, but the length of the AS_PATH attributes must be the same.

¡  If neither the balance as-path-neglect nor the balance as-path-relax command is configured, the routes must have the same AS_PATH attribute.

The value range for the number argument depends on the max-ecmp-num command. If you set the maximum number of ECMP routes to m by using the max-ecmp-num command and reboot the device, the number argument in the balance command is in the range of 1 to m.

If you do not specify the ibgp, eibgp, or ebgp keyword, this command enables load balancing over EBGP routes and IBGP routes, but not between EBGP and IBGP routes.

After you execute the balance eibgp number command, the balance [ ebgp | ibgp ] number and undo balance [ ebgp | ibgp ] commands cannot be executed; and vice versa.

Examples

# In BGP IPv4 unicast address family view, enable load balancing and set the maximum number of BGP ECMP routes used for load balancing to 2.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] balance 2

Related commands

balance as-path-neglect

max-ecmp-num

balance as-path-neglect

Use balance as-path-neglect to enable BGP to ignore the AS_PATH attribute when it implements load balancing.

Use undo balance as-path-neglect to restore the default.

Syntax

balance as-path-neglect

undo balance as-path-neglect

Default

BGP does not ignore the AS_PATH attribute when it implements load balancing.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Usage guidelines

For BGP to implement load balancing over routes with different AS_PATH attributes, you must use this command together with the balance command.

After this command is executed, BGP ignores the AS_PATH attributes in the routes for load balancing and changes the attributes of the advertised routes to those of the optimal route. The operations might cause routing loops. Therefore, use this command with caution.

Examples

# In BGP IPv4 unicast address family view, enable BGP to ignore the AS_PATH attribute when it implements load balancing.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] balance as-path-neglect

Related commands

balance

balance as-path-relax

Use balance as-path-relax to enable load balancing for routes that have different AS_PATH attributes of the same length.

Use undo balance as-path-relax to restore the default.

Syntax

balance as-path-relax

undo balance as-path-relax

Default

BGP cannot perform load balancing for routes that have different AS_PATH attributes of the same length.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Usage guidelines

For BGP to perform load balancing for routes with different AS_PATH attributes of the same length, you must use this command together with the balance command.

If you configure both the balance as-path-relax and balance as-path-neglect commands, the balance as-path-neglect command takes effect.

After this command is executed, BGP ignores the AS_PATH attributes in the routes for load balancing and changes the attributes of the advertised routes to those of the optimal route. This might cause routing loops. Therefore, use this command with caution.

Examples

# In BGP IPv4 unicast address family view, enable load balancing for routes that have different AS_PATH attributes of the same length.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] balance as-path-relax

bestroute as-path-neglect

Use bestroute as-path-neglect to configure BGP to ignore the AS_PATH attribute during optimal route selection.

Use undo bestroute as-path-neglect to restore the default.

Syntax

bestroute as-path-neglect

undo bestroute as-path-neglect

Default

BGP considers the AS_PATH attribute during optimal route selection.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Examples

# In BGP instance view, ignore AS_PATH during optimal route selection.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bestroute as-path-neglect

bestroute compare-med

Use bestroute compare-med to enable MED comparison for routes on a per-AS basis.

Use undo bestroute compare-med to restore the default.

Syntax

bestroute compare-med

undo bestroute compare-med

Default

MED comparison for routes on a per-AS basis is disabled.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Usage guidelines

By default, BGP does not compare MEDs for routes from the same AS. When a router learns a new route, it compares the route with the optimal route in its BGP routing table. If the new route is more optimal, it becomes the optimal route in the BGP routing table. In this way, route learning sequence might affect optimal route selection.

To solve the selection problem, the router puts routes received from the same AS into a group when the bestroute compare-med command is configured. The router then selects the route with the lowest MED from the same group, and compares routes from different groups.

Examples

# In BGP instance view, enable MED comparison for routes on a per-AS basis.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bestroute compare-med

bestroute igp-metric-ignore

Use bestroute igp-metric-ignore to configure BGP to ignore IGP metrics during optimal route selection.

Use undo bestroute igp-metric-ignore to restore the default.

Syntax

bestroute igp-metric-ignore

undo bestroute igp-metric-ignore

Default

BGP considers IGP metrics during optimal route selection, and selects the route with the smallest IGP metric as the optimal route.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Examples

# In BGP instance view, ignore IGP metrics during optimal route selection.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bestroute igp-metric-ignore

bestroute med-confederation

Use bestroute med-confederation to enable MED comparison for routes received from confederation peers.

Use undo bestroute med-confederation to restore the default.

Syntax

bestroute med-confederation

undo bestroute med-confederation

Default

MED comparison is disabled for routes received from confederation peers.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Usage guidelines

This command enables BGP to compare the MEDs of routes received from confederation peers. However, if a route from a confederation peer has an AS number that does not belong to the confederation, BGP does not compare the route with other routes. For example, a confederation has three AS numbers 65006, 65007, and 65009. BGP receives three routes from different confederation peers. The AS_PATH attributes of these routes are 65006 65009, 65007 65009, and 65008 65009, and the MED values of them are 2, 3, and 1. Because the third route's AS_PATH attribute contains AS number 65008, which does not belong to the confederation, BGP does not compare it with other routes. As a result, the first route becomes the optimal route.

Examples

# In BGP instance view, enable MED comparison for routes received from confederation peers.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bestroute med-confederation

bgp

Use bgp to enable a BGP instance and enter its view.

Use undo bgp to disable a BGP instance.

Syntax

bgp as-number [ instance instance-name ]

undo bgp [ as-number [ instance instance-name ] ]

Default

BGP is disabled and no BGP instances exist.

Views

System view

Predefined user roles

network-admin

Parameters

as-number: Specifies a local AS by its number in the range of 1 to 4294967295.

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command enables the BGP instance default.

Usage guidelines

A router supports 4-byte AS number.

A BGP router can run multiple BGP processes. Each BGP process corresponds to a BGP instance. BGP maintains an independent routing table for each BGP instance.

You can create multiple public address families for a BGP instance. However, each public address family (except for public IPv4/IPv6 unicast address family) can belong to only one BGP instance.

You can create multiple VPN instances for a BGP instance, and each VPN instance can have multiple address families. A VPN instance can belong to only one BGP instance.

You cannot specify the same peer for the same address family of different BGP instances.

The IPv4 and IPv6 multicast address families must belong to the same BGP instance.

Different BGP instances can have the same AS number but cannot have the same name.

Examples

# Enable BGP instance default, set the local AS number to 100, and enter BGP instance view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default]

bgp apply-policy on-startup duration

Use bgp apply-policy on-startup duration to specify the period after reboot within which the startup policy is effective.

Use undo bgp apply-policy on-startup duration to restore the default.

Syntax

bgp apply-policy on-startup duration seconds

undo bgp apply-policy on-startup duration

Default

The startup policy does not take effect.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

seconds: Specifies the period after reboot within which the startup policy is effective, in the range of 0 to 3600 seconds. The number of 0 indicates that the startup policy is effective permanently.

Usage guidelines

This command allows BGP to send route updates with the attribute values specified in the startup policy within the specified period after reboot. Then, BGP can forward traffic through other devices to avoid traffic loss caused by reboot.

Examples

# In BGP instance view, set the period after reboot to 100 seconds within which the startup policy is effective.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bgp apply-policy on-startup duration 100

Related commands

bgp policy on-startup med

bgp policy on-startup med

Use bgp policy on-startup med to set the MED attribute value in the startup policy.

Use undo bgp policy on-startup med to restore the default.

Syntax

bgp policy on-startup med med-value

undo bgp policy on-startup med

Default

The MED attribute value in the startup policy is 4294967295.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

med-value: Specifies the MED attribute value in the startup policy, in the range of 0 to 4294967295.

Usage guidelines

After you configure this command, BGP uses the specified MED attribute value to send route updates within the specified period after reboot.

Examples

# In BGP instance view, set the MED attribute value in the startup policy to 100.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bgp policy on-startup med 100

Related commands

bgp apply-policy on-startup

bgp update-delay on-startup

Use bgp update-delay on-startup to configure BGP to delay sending route updates on reboot.

Use undo bgp update-delay on-startup to restore the default.

Syntax

bgp update-delay on-startup seconds

undo bgp update-delay on-startup

Default

BGP sends route updates immediately on reboot.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

seconds: Specifies the delay time in the range of 0 to 3600 seconds. The value of 0 indicates that BGP does not send route updates after the device reboots.

Usage guidelines

After you execute this command, BGP redistributes all routes from other neighbors on reboot, selects the optimal route, and then advertises it. Using this command can reduce traffic loss caused by reboot.

Examples

# In BGP instance view, configure BGP to delay sending route updates on reboot and set the delay time to 100 seconds.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] bgp update-delay on-startup 100

Related commands

bgp update-delay on-startup prefix-list

bgp update-delay on-startup prefix-list

Use bgp update-delay on-startup prefix-list to configure BGP to immediately send route updates for routes that match a prefix list.

Use undo bgp update-delay on-startup prefix-list to restore the default.

Syntax

bgp update-delay on-startup prefix-list prefix-list-name

undo bgp update-delay on-startup prefix-list

Default

No prefix list is specified to filter routes.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

prefix-list-name: Specifies an IPv4 prefix list by its name, a case-sensitive string of 1 to 63 characters.

Usage guidelines

After the bgp update-delay on-startup command is configured, BGP delays sending updates for all routes on reboot. For BGP to immediately send updates for the specified routes, execute the bgp update-delay on-startup prefix-list command.

This command is available only to IPv4 prefix lists.

Examples

# In BGP instance view, configure BGP to send updates 100 seconds after reboot and immediately send updates for routes that match prefix list aaa.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-100] bgp update-delay on-startup 100

[Sysname-bgp-100] bgp update-delay on-startup prefix-list aaa

Related commands

bgp update-delay on-startup

bmp server

Use bmp server to create a BGP monitoring protocol (BMP) server and enter BMP server view.

Use undo bmp server to remove a BMP server and all its configurations.

Syntax

bmp server server-number

undo bmp server server-number

Default

No BMP servers exist.

Views

System view

Predefined user roles

network-admin

Parameters

server-number: Specifies a BMP server by its number in the range of 1 to 8.

Examples

# Create BMP server 5 and enter its view.

<Sysname> system-view

[Sysname] bmp server 5

[Sysname-bmpserver-5]

compare-different-as-med

Use compare-different-as-med to enable MED comparison for routes from peers in different ASs.

Use undo compare-different-as-med to restore the default.

Syntax

compare-different-as-med

undo compare-different-as-med

Default

MED comparison is disabled for routes from peers in different ASs.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Usage guidelines

If multiple routes to a destination exist, the route with the smallest MED is selected.

Do not use this command unless relevant ASs adopt the same IGP protocol and routing selection method.

Examples

# In BGP instance view, enable MED comparison for routes from peers in different ASs.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] compare-different-as-med

confederation id

Use confederation id to configure a confederation ID.

Use undo confederation id to restore the default.

Syntax

confederation id as-number

undo confederation id

Default

No confederation ID is configured.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

as-number: Specifies an AS number that identifies the confederation, in the range of 1 to 4294967295.

Usage guidelines

You can split an AS into several sub-ASs, and each sub-AS remains fully meshed. These sub-ASs form a confederation. Key path attributes of a route, such as the Next_HOP, MED, and LOCAL_PREF, are not discarded when crossing each sub-AS. The sub-ASs still look like one AS from the perspective of other ASs. The AS number is the confederation ID.

Confederation can ensure the integrity of the former AS, and solve the problem of too many IBGP connections in the AS.

Configure the same confederation ID for all routers in one confederation.

For a non-confederation BGP router that establishes a BGP connection to a router in a confederation, the confederation ID is the AS number of the router.

Examples

# Confederation 9 consists of four sub-ASs numbered 38, 39, 40 and 41. Peer 10.1.1.1 is a member of sub-AS 38. Peer 200.1.1.1 is a member outside of confederation 9, which belongs to AS 98. Confederation 9 looks like one AS (with AS number 9) from the perspective of peer 200.1.1.1. This example uses a router in sub-AS 41.

<Sysname> system-view

[Sysname] bgp 41

[Sysname-bgp-default] confederation id 9

[Sysname-bgp-default] confederation peer-as 38 39 40

[Sysname-bgp-default] group Confed38 external

[Sysname-bgp-default] peer Confed38 as-number 38

[Sysname-bgp-default] peer 10.1.1.1 group Confed38

[Sysname-bgp-default] group Remote98 external

[Sysname-bgp-default] peer Remote98 as-number 98

[Sysname-bgp-default] peer 200.1.1.1 group Remote98

Related commands

confederation nonstandard

confederation peer-as

confederation nonstandard

Use confederation nonstandard to enable compatibility with routers not compliant with RFC 3065 in the confederation.

Use undo confederation nonstandard to restore the default.

Syntax

confederation nonstandard

undo confederation nonstandard

Default

The device is compatible with only routers compliant with RFC 3065 in the confederation.

Views

BGP instance view

Predefined user roles

network-admin

Usage guidelines

Configure this command on all routers compliant with RFC 3065 to interact with those routers not compliant with RFC 3065 in the confederation.

Examples

# Confederation 100 consists of two sub-ASs, 64000 and 65000, and contains routers not compliant with RFC 3065. Enable compatibility with routers not compliant with RFC 3065 in the confederation.

<Sysname> system-view

[Sysname] bgp 64000

[Sysname-bgp-default] confederation id 100

[Sysname-bgp-default] confederation peer-as 65000

[Sysname-bgp-default] confederation nonstandard

Related commands

confederation id

confederation peer-as

confederation peer-as

Use confederation peer-as to specify confederation peer sub-ASs.

Use undo confederation peer-as to remove the specified confederation peer sub-ASs.

Syntax

confederation peer-as as-number-list

undo confederation peer-as [ as-number-list ]

Default

No confederation peer sub-ASs are specified.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

as-number-list: Specifies a sub-AS number list. A maximum of 32 sub-ASs can be configured in one command line. The expression is as-number-list = as-number &<1-32>. The as-number argument specifies a sub-AS number in the range of 1 to 4294967295, and &<1-32> indicates that a maximum of 32 numbers can be specified.

Usage guidelines

Before this configuration, use the confederation id command to specify the confederation ID for the sub-ASs.

If the undo confederation peer-as command is executed without the as-number-list argument, all confederation peer sub-ASs are removed.

Examples

# In BGP instance view, specify confederation peer sub-ASs 2000 and 2001.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] confederation id 10

[Sysname-bgp-default] confederation peer-as 2000 2001

Related commands

confederation id

confederation nonstandard

dampening

Use dampening to enable BGP route dampening.

Use undo dampening to restore the default.

Syntax

dampening [ half-life-reachable half-life-unreachable reuse suppress ceiling | route-policy route-policy-name ] *

undo dampening

Default

Route dampening is disabled.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

half-life-reachable: Specifies a half-life for active routes, in the range of 1 to 45 minutes. By default, the value is 15 minutes.

half-life-unreachable: Specifies a half-life for suppressed routes, in the range of 1 to 45 minutes. By default, the value is 15 minutes.

reuse: Specifies a reuse threshold value for suppressed routes, in the range of 1 to 20000. A suppressed route whose penalty value decreases under the value is reused. By default, the reuse value is 750. The reuse threshold must be less than the suppression threshold.

suppress: Specifies a suppression threshold in the range of 1 to 20000. The route with a penalty value greater than the threshold is suppressed. The default value is 2000.

ceiling: Specifies a ceiling penalty value in the range of 1001 to 20000. The value must be greater than the suppress value. By default, the value is 16000.

route-policy route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters.

Usage guidelines

This command dampens only EBGP routes.

If an EBGP peer goes down after you configure this command, routes coming from the peer are dampened but not deleted.

Examples

# In BGP IPv4 unicast address family view, configure BGP route dampening. Set the half-life for both active and suppressed routes to 10 minutes, the reuse threshold to 1000, the suppression threshold to 2000, and the ceiling penalty to 10000.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] dampening 10 10 1000 2000 10000

Related commands

display bgp dampening parameter

default local-preference

Use default local-preference to configure a default local preference.

Use undo default local-preference to restore the default.

Syntax

default local-preference value

undo default local-preference

Default

The default local preference is 100.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

value: Specifies a default local preference in the range of 0 to 4294967295. A larger value represents a higher preference.

Usage guidelines

You can also use the apply local-preference command in a routing policy to configure the local preference for BGP routes. If no routing policy is configured, all BGP routes use the local preference set by the default local-preference command. If a routing policy is configured, BGP routes matching the routing policy use the local preference set by the apply local-preference command. Other BGP routes use the local preference set by the default local-preference command.

Examples

# In BGP IPv4 unicast address family view, set the default local preference to 180.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] default local-preference 180

Related commands

apply local-preference

route-policy

default med

Use default med to specify a default MED value.

Use undo default med to restore the default.

Syntax

default med med-value

undo default med

Default

The default MED value is 0.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

med-value: Specifies the default MED value in the range of 0 to 4294967295.

Usage guidelines

BGP selects a MED value in the following order:

1.        MED set by the apply cost command.

2.        MED set by the med keyword in the import-route command.

3.        MED set by the default med command.

4.        Original MED of a BGP route, or MED changed from the metric of a redistributed IGP route.

Examples

# In BGP IPv4 unicast address family view, set the default MED to 25.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] default med 25

Related commands

apply cost

import-route

route-policy

default-route imported

Use default-route imported to enable default route redistribution into the BGP routing table.

Use undo default-route imported to restore the default.

Syntax

default-route imported

undo default-route imported

Default

Default route redistribution into the BGP routing table is disabled.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Usage guidelines

By default, BGP does not redistribute default IGP routes. To redistribute default IGP routes into the BGP routing table, you must use the default-route imported command together with the import-route command.

Examples

# In BGP IPv4 unicast address family view, enable default route redistribution from OSPF process 1 into the BGP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] default-route imported

[Sysname-bgp-default-ipv4] import-route ospf 1

Related commands

import-route

default-route update-first

Use default-route update-first to enable prioritized advertisement of default-route updates.

Use undo default-route update-first to restore the default.

Syntax

default-route update-first

undo default-route update-first

Default

BGP does not send updates of the default route prior to other routes.

Views

BGP instance view

Predefined user roles

network-admin

Usage guidelines

Typically a BGP router does not send update messages of the default route prior to other routes to its peers. If the peer relationship is down, the default route cannot be withdrawn first. Traffic interruption might occur. After you execute this command, BGP sends withdrawal message of the default route prior to other routes when the peer relationship is down. Traffic can be immediately switched to a valid path to reduce the traffic interruption time.

Examples

# In BGP instance view, enable prioritized advertisement of default-route updates.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] default-route update-first

display bgp bmp server

Use display bgp bmp server to display BMP server information.

Syntax

display bgp [ instance instance-name ] bmp server server-number

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BMP server information for the default BGP instance.

server-number: Specifies a BMP server by its number in the range of 1 to 8.

Examples

# Display information about BMP server 1.

<Sysname> display bgp bmp server 1

BMP server number: 1

Server address: 100.1.1.1  Server port: 6895

Client address: 100.1.1.2  Client port: 21452

BMP server state: Connected  Up for 00h41m53s

 

Message statistics:

Total messages sent: 15

         INITIATION: 1

        TERMINATION: 0

       STATS-REPORT: 0

            PEER-UP: 4

          PEER-DOWN: 3

          ROUTE-MON: 7

 

BMP monitor BGP peers:

  10.1.1.1

Table 2 Command output

Field

Description

Server address

IP address of the BMP server used by the TCP connection to the BMP client.

Server port

Port number of the BMP server used by the TCP connection to the BMP client.

Client address

IP address of the BMP client used by the TCP connection to the BMP server.

Client port

Port number of the BMP client used by the TCP connection to the BMP server.

BMP server current state

TCP connection status:

·         Connected.

·         Not connected.

Up for

Duration of the TCP connection.

Total messages sent

Number of messages that BGP sends to the BMP server.

INITIATION

Number of initiation messages that BGP sends to the BMP server.

TERMINATION

Number of termination messages that BGP sends to the BMP server.

STATS-REPORT

Number of statistics messages that BGP sends to the BMP server.

PEER-UP

Number of peer-up messages that BGP sends to the BMP server.

PEER-DOWN

Number of peer-down messages that BGP sends to the BMP server.

ROUTE-MON

Number of route monitoring messages that BGP sends to the BMP server.

BMP monitor BGP peers

Peers that are monitored by the BMP server.

Related commands

reset bgp bmp server statistics

display bgp dampening parameter

Use display bgp dampening parameter to display BGP route dampening parameters.

Syntax

display bgp [ instance instance-name ] dampening parameter { ipv4 | ipv6 } [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP route dampening parameters for the default BGP instance.

ipv4: Displays BGP IPv4 route dampening parameters.

ipv6: Displays BGP IPv6 route dampening parameters.

multicast: Displays BGP multicast route dampening parameters.

unicast: Displays BGP unicast route dampening parameters.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays BGP route dampening parameters for the public network.

Usage guidelines

By default, the unicast keyword is used if neither the multicast keyword nor the unicast keyword is specified.

Examples

# Display BGP IPv4 unicast route dampening parameters.

<Sysname> display bgp dampening parameter ipv4

Maximum suppression time (in seconds)              : 3973

Ceiling value                                      : 16000

Reuse value                                        : 750

Half-life time for reachable routes (in seconds)   : 900

Half-life time for unreachable routes (in seconds) : 900

Suppression threshold                              : 2000

Table 3 Command output

Field

Description

Maximum suppression time

Maximum time (in seconds) for the penalty value to decrease from the ceiling value to the reuse value.

Ceiling value

Penalty ceiling value.

Reuse value

Reuse threshold.

Related commands

dampening

display bgp group

Use display bgp group to display BGP peer group information.

Syntax

display bgp [ instance instance-name ] group ipv4 [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ] [ group-name group-name ]

display bgp [ instance instance-name ] group ipv6 [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ] [ group-name group-name ]

display bgp [ instance instance-name ] group link-state [ group-name group-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP peer group information for the default BGP instance.

ipv4: Displays IPv4 BGP peer group information.

ipv6: Displays IPv6 BGP peer group information.

link-state: Displays BGP LS peer group information.

multicast: Displays BGP multicast peer group information.

unicast: Displays BGP unicast peer group information.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays BGP peer group information for the public network.

group-name group-name: Specifies a BGP peer group by its name, a case-sensitive string of 1 to 47 characters. If you do not specify a group, this command displays brief information about all BGP peer groups for the specified address family.

Usage guidelines

By default, the unicast keyword is used if the unicast and multicast keywords are not specified.

Examples

# Display brief information about all BGP IPv4 unicast peer groups.

 BGP peer group: group1

 Remote AS: 600

 Type: external

 Members:

  1.1.1.10

 

 BGP peer group: group2

 Remote AS number: not specified

 Type: external

 Members:

  2.2.2.2

# Display detailed information about BGP IPv4 unicast peer group group1.

<Sysname> display bgp group ipv4 group-name group1

 BGP peer group: group1

 Remote AS: 600

 Type: external

 Maximum number of prefixes allowed: 4294967295

 Threshold: 75%

 Configured hold time: 180 seconds

 Keepalive time: 60 seconds

 Minimum time between advertisements: 30 seconds

 Peer preferred value: 0

 Site-of-Origin: Not specified

 

 Routing policy configured:

 No routing policy is configured

 

 Members:

* - Dynamically created peer

  Peer                    AS  MsgRcvd  MsgSent OutQ PrefRcv Up/Down  State

 

  1.1.1.10               600        0        0    0       0 00:00:55 Established

# Display detailed information about BGP IPv6 unicast peer group group2.

<Sysname> display bgp group ipv6 group-name group2

 BGP peer group: group2

 Remote AS: 600

 Type: external

 Maximum number of prefixes allowed: 4294967295

 Threshold: 75%

 Configured hold time: 180 seconds

 Keepalive time: 60 seconds

 Minimum time between advertisements: 30 seconds

 Peer preferred value: 0

 IPsec profile name: profile001

 Site-of-Origin: Not specified

 

 Routing policy configured:

 No routing policy is configured

 

 Members:

* - Dynamically created peer

  Peer                    AS  MsgRcvd  MsgSent OutQ PrefRcv Up/Down  State

 

  2::2                   600        0        0    0       0 00:00:45 Established

  3::3                   600        0        0    0       0 00:00:40 Established

Table 4 Command output

Field

Description

BGP peer group

Name of the BGP peer group.

Remote AS

AS number of the peer group.

Type

Type of the peer groups:

·         external—EBGP peer group.

·         internal—IBGP peer group.

Maximum number of prefixes allowed

Maximum number of routes allowed to learn from the peer.

Threshold

Percentage of received routes from the peer to maximum routes allowed to learn from the peer. If the percentage is reached, the system generates a log message.

Configured hold time

Configured hold interval in seconds.

Keepalive time

Keepalive interval in seconds.

Minimum time between advertisements

Minimum route advertisement interval in seconds.

Peer preferred value

Preferred value specified for routes from the peer.

Site-of-Origin

SoO for the peer group.

Routing policy configured

Routing policy configured for the peer group.

If you do not specify a routing policy, this field displays No routing policy is configured.

Members

Information about peers included in the peer group.

* - Dynamically created peer

An asterisk (*) before a peer address indicates that the peer is a dynamic peer.

Peer

IPv4 or IPv6 address of the peer.

AS

AS number of the peer.

MsgRcvd

Number of messages received.

MsgSent

Number of messages sent.

OutQ

Number of messages to be sent.

PrefRcv

For the IPv4 and IPv6 address families, this field displays the number of prefixes received from the peer.

Up/Down

Lasting time of the current BGP session state.

State

Current state of the BGP session between the local router and the peer.

IPsec profile name

IPsec profile applied to the IPv6 BGP peer group.

display bgp instance-info

Use display bgp instance-info to display information about all BGP instances.

Syntax

display bgp instance-info

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display information about all BGP instances.

<Sysname> display bgp instance-info

Total BGP instances: 3

  BGP instance name               AS

  BGP1                            100

  BGP2                            200

  BGP3                            300

Table 5 Command output

Field

Description

Total BGP instances

Number of BGP instances.

BGP instance name

BGP instance name.

AS

AS number of the BGP instance.

display bgp link-state

Use display bgp link-state to display BGP LS information.

Syntax

display bgp [ instance instance-name ] link-state [ ls-prefix | peer { ipv4-address | ipv6-address } { advertised | received } [ statistics ] | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP LS information for the default BGP instance.

ls-prefix: Specifies an LS prefix. If you do not specify this argument, the command displays all BGP LS information.

ipv4-address: Specifies a peer by its IPv4 address.

ipv6-address: Specifies a peer by its IPv6 address.

advertised: Displays advertised LS information.

received: Displays received LS information.

statistics: Displays statistics about LS messages.

Usage guidelines

If you do not specify any parameters, this command displays brief BGP LS information.

Examples

# Display brief BGP LS information for the public network.

<Sysname> display bgp link-state

 

 Total number of routes: 2

 

 BGP local router ID is 1.1.2.1

 Status codes: * - valid, > - best, d – dampened, h – history,

               s – suppressed, S – stale, i - internal, e - external

               a - additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 Prefix codes: E link, V node, T IP reachable route, u/U unknown,

               I Identifier, N local node, R remote node, L link, P prefix,

               L1/L2 ISIS level-1/level-2, O OSPF, D direct, S static,

               a area-ID, , l link-ID, t topology-ID, s ISO-ID,

               c confed-ID/ASN, b bgp-identifier, r router-ID,

               i if-address, n peer-address, o OSPF Route-type, p IP-prefix

               d designated router address

* >e Network : [V][O][I0x0][N[c20][b1.1.1.2][a0.0.0.0][r1.1.1.2]]/376

     NextHop : 1.1.1.2                                  LocPrf    :

     PrefVal : 0                                        OutLabel  : NULL

     MED     :

     Path/Ogn: 20i

 

* >e Network : [T][O][I0x0][N[c20][b1.1.1.2][a0.0.0.0][r1.1.1.2]][P[o0x1][p1.1.1.0/24]]/480

     NextHop : 1.1.1.2                                  LocPrf    :

     PrefVal : 0                                        OutLabel  : NULL

     MED     :

     Path/Ogn: 20i

Table 6 Command output

Field

Description

Status codes

Status codes:

·         * – valid—Valid route.

·         > – best—Optimal route.

·         d - dampened—Dampened route.

·         h – history—History route.

·         s – suppressed—Suppressed route.

·         S – stale—Stale route.

·         i – internal—Internal route.

·         e – external—External route.

·         a - additional-path—Add-Path optimal route.

Prefix codes

Route status codes:

·         E – link.

·         V – node.

·         T – IP reachable route.

·         u/U – unknown.

·         I – Identifier.

·         N – local node.

·         R – remote node.

·         L  – link.

·         P – prefix.

·         L1/L2 – ISIS level-1/level-2.

·         O – OSPF.

·         D – direct.

·         S – static.

·         a – area-ID.

·         l – link-ID.

·         ‌t – topology-ID.  

·         s – ISO-ID.

·         c – confed-ID/ASN.

·         b – bgp-identifier.

·         r – router-ID.

·         i – if-address.

·         n – peer-address.

·         o – OSPF Route-type.

·         p – IP-prefix.

·         d – designated router address.

·         a - additional-path.

Origin

Origin of the route:

·         i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP.

·         e – EGP—Learned through EGP.

·         ? – incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.

Network

NLRI for the LS.

NextHop

Next hop IP address.

LocPrf

Local preference.

OutLabel

This field is not supported in the current software version.

Outgoing label of the route.

MED

MED attribute.

Path/Ogn

AS_PATH and ORIGIN attributes of the route:

·         AS_PATH—Records the ASs the route has passed, which avoids routing loops.

·         ORIGIN—Identifies the origin of the route.

# Display detailed BGP LS information with the specified LS prefix.

<Sysname> display bgp link-state [V][O][I0x0][N[c20][b1.1.1.2][a0.0.0.0][r1.1.1.2]]/376

 

 BGP local router ID: 1.1.1.2

 Local AS number: 20

 

 Paths:   1 available, 1 best

 

 BGP LS information of [V][O][I0x0][N[c20][b1.1.1.2][a0.0.0.0][r1.1.1.2]]/376:

 Imported route.

 Original nexthop: 0.0.0.0

 OutLabel        : NULL

 RxPathID        : 0x0

 TxPathID        : 0xffffffff

 LS              : Node flag bits: 30[EA]

 AS-path         : (null)

 Origin          : igp

 Attribute value : pref-val 32768

 State           : valid, local, best

 IP precedence   : N/A

 QoS local ID    : N/A

 Traffic index   : N/A

Table 7 Command output

Field

Description

Paths

Number of routes:

·         available—Number of valid routes.

·         best—Number of optimal routes.

BGP LS information of

NLRI prefix.

Original nexthop

Original next hop of the route. If the route was obtained from a BGP update message, the original next hop is the next hop IP address in the message.

LS

LS attribute:

·         Node flag bits—Node attribute in hexadecimal format:

¡  10[A]—OSPF ABR bit.

¡  30[E]—OSPF External bit.

·         Metric—Link or prefix cost.

RxPathID

Add-path ID of received routes.

TxPathID

Add-path ID of advertised routes.

AS-path

AS_PATH attribute of the route, which records the ASs the route has passed and avoids routing loops.

Attribute value

BGP path attributes:

·         MED—MED value.

·         localpref—Local preference value.

·         pref-val—Preferred value.

·         pre—Route preference.

State

Current state of the route:

·         valid.

·         internal.

·         external.

·         local.

·         synchronize.

·         best.

IP precedence

IP precedence in the range of 0 to 7. N/A indicates that the route does not support this field.

QoS local ID

QoS local ID in the range of 1 to 4095. N/A indicates that the route does not support this field.

Traffic index

Traffic index in the range of 1 to 64. N/A indicates that the route does not support this field.

display bgp network

Use display bgp network to display information about routes advertised by the network command and shortcut routes configured by the network short-cut command.

Syntax

display bgp [ instance instance-name ] network { ipv4 | ipv6 } [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays information for the default BGP instance.

ipv4: Displays IPv4 address family information.

ipv6: Displays IPv6 address family information.

multicast: Displays BGP multicast address family information.

unicast: Displays BGP unicast address family information.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays routing information for the public network.

Usage guidelines

By default, the unicast keyword is used if neither the multicast keyword nor the unicast keyword is specified.

Examples

# Display information about routes advertised by the network command and shortcut routes configured by the network short-cut command in the IPv4 unicast address family.

<Sysname> display bgp network ipv4

 

  BGP local router ID: 192.168.1.135

  Local AS number: 100

 

  Network           Mask            Route-policy        Short-cut

  20.1.1.0          255.255.255.0                       No

  40.1.1.0          255.255.255.0   abc                 No

  30.1.1.0          255.255.255.0                       Yes

# Display information about routes advertised by the network command and shortcut routes configured by the network short-cut command in the IPv6 unicast address family.

<Sysname> display bgp network ipv6

 

  BGP local router ID: 192.168.1.135

  Local AS number: 100

 

  Network           PrefixLen       Route-policy        Short-cut

  1::               24                                  No

  2::               24                                  No

  3::               64              policy1             No

  2::               24                                  Yes

Table 8 Command output

Field

Description

Network

Destination network address of the routes advertised by the network command and the shortcut routes.

Mask

Mask of the destination network address.

PrefixLen

Prefix length of the destination network address.

Route-policy

Routing policy that is applied to the route.

Short-cut

Whether the route is a shortcut route:

·         Yes.

·         No.

display bgp non-stop-routing status

Use display bgp non-stop-routing status to display BGP NSR status information.

Syntax

display bgp [ instance instance-name ] non-stop-routing status

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP NSR status information for the default BGP instance.

Examples

# Display BGP NSR status information.

<Sysname> display bgp non-stop-routing status

 

BGP NSR status: Not ready

 Location of preferred standby process: -

 TCP NSR status: Not ready

Table 9 Command output

Field

Description

BGP NSR status

BGP NSR status:

·         Ready—BGP NSR has backed up BGP neighbor and routing information from the active process to the standby process. In this state, BGP NSR can ensure continuous routing when an active/standby process switchover occurs.

·         Not ready—BGP NSR is backing up BGP neighbor and routing information from the active process to the standby process. If an active/standby process switchover occurs in this state, traffic is interrupted and the BGP session will be re-established.

·         Not configured—BGP NSR is disabled.

Location of preferred standby process

ID of the IRF member device where the preferred standby process resides.

This field displays - if no standby processes exist.

TCP NSR status

TCP NSR status:

·         Ready—TCP NSR has backed up TCP connection information from the active process to the standby process.

·         Not ready—TCP NSR is backing up TCP connection information from the active process to the standby process.

display bgp paths

Use display bgp paths to display BGP path attribute information.

Syntax

display bgp [ instance instance-name ] paths [ as-regular-expression ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP path attribute information for the default BGP instance.

as-regular-expression: Displays information about BGP path attributes whose AS_PATH attribute matches the specified regular expression. The as-regular-expression argument is a string of 1 to 256 characters. If you do not specify this argument, the command displays information about all BGP path attributes.

Examples

# Display information about all BGP path attributes.

<Sysname> display bgp paths

 

  RefCount    MED         Path/Origin

  3           0           ?

  2           0           100i

  3           0           100i

  1           0           ?

  1           0           ?

  1           0           ?

Table 10 Command output

Field

Description

RefCount

Number of BGP routes with these path attributes.

MED

MULTI_EXIT_DISC attribute.

Path/Origin

AS_PATH and ORIGIN attributes of the route:

·         AS_PATH attribute—Records the ASs the route has passed, which avoids routing loops.

·         ORIGIN attribute—Identifies the origin of the route:

¡  i—Originated in the AS. The origin of routes advertised with the network command is IGP.

¡  e—Learned through EGP.

¡  ?—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.

display bgp peer

Use display bgp peer to display BGP peer or peer group information.

Syntax

display bgp [ instance instance-name ] peer ipv4 [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ] [ ipv4-address mask-length | { ipv4-address | group-name group-name } log-info | [ ipv4-address ] verbose ]

display bgp [ instance instance-name ] peer ipv6 [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ] [ ipv6-address prefix-length | { ipv6-address | group-name group-name } log-info | [ ipv6-address ] verbose ]

display bgp [ instance instance-name ] peer { ipv4 | ipv6 } [ unicast ] vpn-instance-all [ verbose ]

display bgp [ instance instance-name ] peer link-state [ ipv4-address mask-length | ipv6-address prefix-length | { ipv4-address | ipv6-address | group-name group-name } log-info | [ ipv4-address | ipv6-address ] verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP peer or peer group information for the default BGP instance.

ipv4: Displays IPv4 BGP peer or peer group information.

ipv6: Displays IPv6 BGP peer or peer group information.

link-state: Displays BGP LS peer or peer group information.

multicast: Displays BGP multicast peer or peer group information.

unicast: Displays BGP unicast peer or peer group information.

vpn-instance-all: Displays BGP peer or peer group information for all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays BGP peer or peer group information for the public network.

ipv4-address mask-length: Specifies a subnet. The value range for the mask length is 0 to 32. If you specify a subnet, this command displays information about all dynamic peers in the subnet.

ipv4-address: Specifies a peer by its IPv4 address.

ipv6-address prefix-length: Specifies a subnet. The value range for the prefix length is 0 to 128. If you specify a subnet, this command displays information about all dynamic peers in the subnet.

ipv6-address: Specifies a peer by its IPv6 address.

group-name group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters.

log-info: Displays log information.

verbose: Displays detailed information. If you do not specify this keyword, the command displays brief BGP peer or peer group information.

Usage guidelines

If you do not specify any parameters, this command displays brief information about all BGP peers for the specified address family.

By default, the unicast keyword is used if the unicast and multicast keywords are not specified.

Examples

# Display brief information about all BGP IPv4 unicast peers.

<Sysname> display bgp peer ipv4

 

 BGP local router ID: 192.168.100.1

 Local AS number: 100

 Total number of peers: 1                  Peers in established state: 1

 

  * - Dynamically created peer

  Peer                    AS  MsgRcvd  MsgSent OutQ PrefRcv Up/Down  State

 

  10.2.1.2               200       13       16    0       0 00:10:34 Established

# Display brief BGP IPv4 unicast peer information for all VPN instances.

<Sysname> display bgp peer ipv4 vpn-instance-all

 

Local AS number: 100                                                          

  * - Dynamically created peer

                                                 

 VPN instance: 1                                                                

 BGP local router ID: 111.1.1.1                                                 

 Total number of peers: 2                 Peers in established state: 0         

                                                                               

  Peer                    AS  MsgRcvd  MsgSent OutQ PrefRcv Up/Down  State     

                                                                               

  111.1.1.1              100        0        0    0       0 00:00:34 Connect   

  111.1.1.2              100        0        0    0       0 00:00:34 Connect   

                                                                               

 VPN instance: 2                                                                

 BGP local router ID: 112.1.1.1                                                 

 Total number of peers: 2                 Peers in established state: 0         

                                                                               

  Peer                    AS  MsgRcvd  MsgSent OutQ PrefRcv Up/Down  State     

                                                                               

  112.1.1.1              100        0        0    0       0 00:00:06 Idle      

  112.1.1.2              100        0        0    0       0 00:00:06 Idle       

Table 11 Command output

Field

Description

* - Dynamically created peer

An asterisk (*) before a peer address indicates that the peer is a dynamic peer.

VPN instance

Name of the VPN instance to which the peer belongs.

Peer

IPv4 or IPv6 address of the peer.

AS

AS number of the peer.

MsgRcvd

Number of messages received.

MsgSent

Number of messages sent.

OutQ

Number of messages to be sent.

PrefRcv

For the IPv4 and IPv6 address families, this field displays the number of prefixes that have been received from the peer and added into the local BGP routing table.

Up/Down

Lasting time of the current BGP session state.

State

Current state of the BGP session between the local router and the peer.

# Display brief information about all dynamic peers in network 1.1.1.0/24.

<Sysname> display bgp peer ipv4 1.1.1.0 24

 

 Type: EBGP link

 Dynamic address range: 1.1.1.0 24

 Configured: Active Hold Time: 3 sec     Keepalive Time: 1 sec

 Address family IPv4 Unicast: Configured

 

 Maximum allowed prefix number: 100

 Threshold: 75%

 Minimum time between advertisements is 100 seconds

 Optional capabilities:

  Multi-protocol extended capability has been enabled

  Route refresh capability has been enabled

 Nexthop self has been configured

 Keep-all-routes has been configured

 Send community has been configured

 Send extend community has been configured

 Default route originating has been configured

 Multi-hop ebgp has been enabled

 Peer preferred value: 100

 BFD: Enabled

 Site-of-Origin: 1:1

 Routing policy configured:

 No import as-path-acl list

 Export as-path-acl list is: 22

 No import prefix list

 Export prefix list is: p1

 No import route policy

 Export route policy is: p1

 No import filter-policy

 No export filter-policy

 

 Dynamic peers:

  1.1.1.3

# Display brief information about all dynamic peers in network 1::/64.

<Sysname> display bgp peer ipv6 1:: 64

 

 Type: IBGP link

 Dynamic address range: 1:: 64

 Configured: Active Hold Time: 180 sec   Keepalive Time: 60 sec

 Address family IPv6 Unicast: Configured

 

 Maximum allowed prefix number: 4294967295

 Threshold: 75%

 Minimum time between advertisements is 15 seconds

 Optional capabilities:

  Multi-protocol extended capability has been enabled

  Route refresh capability has been enabled

 Send community has been configured

 Peer preferred value: 0

 Site-of-Origin: Not specified

 Routing policy configured:

 No routing policy is configured

 

 Dynamic peers:

  1::1

Table 12 Command output

Field

Description

Type

BGP connection type between the local router and the dynamic peer:

·         IBGP link—IBGP connection.

·         EBGP link—EBGP connection.

Configured

Timers configured on the local router in seconds, including the hold time (Active Hold Time) and keepalive interval (Keepalive Time).

Address family IPv4 Unicast

IPv4 unicast address family capability.

Address family link-state

LS address family capability.

Address family IPv6 Unicast

IPv6 unicast address family capability.

Address family IPv4 Multicast

IPv4 multicast address family capability.

Address family IPv6 Multicast

IPv6 multicast address family capability.

Maximum allowed prefix number

Maximum number of routes allowed to learn from the peer.

Threshold

Percentage of received routes from the peer to maximum routes allowed to learn from the peer. If the percentage is reached, the system generates alarm messages.

Minimum time between advertisements

Minimum route advertisement interval in seconds.

Optional capabilities

Optional capabilities supported by the local end.

Peer Preferred Value

Preferred value specified for the routes from the peer.

BFD

Whether BFD is enabled to detect the link to the BGP peers.

IPsec profile name

IPsec profile applied to the IPv6 BGP peer.

This field is available only for the IPv6 unicast and IPv6 multicast address families.

Routing policy configured

Routing policy configured for the peer.

If you do not specify a routing policy, this field displays No routing policy is configured.

Dynamic peers

IP addresses of dynamic peers.

# Display detailed information about BGP IPv4 unicast peer 10.2.1.2.

<Sysname> display bgp peer ipv4 10.2.1.2 verbose

 

         Peer: 10.2.1.2          Local: 192.168.100.1

         Type: EBGP link

         BGP version 4, remote router ID 192.168.100.2

         BGP current state: Established, Up for 00h11m10s

         BGP current event: RecvKeepalive

         BGP last state: OpenConfirm

         Port:  Local - 179      Remote - 60672

         Configured: Active Hold Time: 180 sec   Keepalive Time: 60 sec

         Received  : Active Hold Time: 180 sec

         Negotiated: Active Hold Time: 180 sec   Keepalive Time: 60 sec

         Peer optional capabilities:

         Peer support BGP multi-protocol extended

         Peer support BGP route refresh capability

         Peer support BGP route AS4 capability

         Address family IPv4 Unicast: advertised and received

 

InQ updates: 0, OutQ updates: 0

 NLRI statistics:

         Rcvd:   UnReach NLRI          0,      Reach NLRI          0

         Sent:   UnReach NLRI          0,      Reach NLRI          0

 

 Message statistics:

 Msg type     Last rcvd time/      Current rcvd count/      History rcvd count/

              Last sent time       Current sent count       History sent count

 Open         10:38:50-2013.7.23   1                        1

              10:38:50-2013.7.23   1                        1

 Update       10:38:51-2013.7.23   1                        1

              10:38:51-2013.7.23   1                        1

 Notification -                    0                        0

              -                    0                        0

 Keepalive    10:38:50-2013.7.23   1                        1

              10:38:50-2013.7.23   1                        1

 RouteRefresh -                    0                        0

              -                    0                        0

 Total        -                    3                        3

              -                    3                        3  

 

 Maximum allowed prefix number: 4294967295

 Threshold: 75%

 Minimum time between advertisements is 30 seconds

 Optional capabilities:

  Multi-protocol extended capability has been enabled

  Route refresh capability has been enabled

 Peer Preferred Value: 0

 GTSM has been enabled, and the maximum number of hops is 10

 BFD: Enabled

 Site-of-Origin: Not specified

 

 Routing policy configured:

 No routing policy is configured

# Display detailed information about BGP IPv6 unicast peer 1::2.

<Sysname> display bgp peer ipv6 1::2 verbose

 

         Peer: 1::2      Local: 192.168.1.136

         Type: EBGP link

         BGP version 4, remote router ID 192.168.1.135

         BGP current state: Established, Up for 00h05m48s

         BGP current event: RecvKeepalive

         BGP last state: OpenConfirm

         Port:  Local - 13184    Remote - 179

         Configured: Active Hold Time: 180 sec   Keepalive Time: 60 sec

         Received  : Active Hold Time: 180 sec

         Negotiated: Active Hold Time: 180 sec   Keepalive Time: 60 sec

         Peer optional capabilities:

         Peer support BGP multi-protocol extended

         Peer support BGP route refresh capability

         Peer support BGP route AS4 capability

         Address family IPv6 Unicast: advertised and received

 

 InQ updates: 0, OutQ updates: 0

 NLRI statistics:

         Rcvd:   UnReach NLRI          0,       Reach NLRI          0

         Sent:   UnReach NLRI          0,       Reach NLRI          3

 

 Message statistics:

 Msg type     Last rcvd time/      Current rcvd count/      History rcvd count/

              Last sent time       Current sent count       History sent count

 Open         18:59:15-2013.4.24   1                        1

              18:59:15-2013.4.24   1                        2

 Update       -                    0                        0

              18:59:16-2013.4.24   1                        1

 Notification -                    0                        0

              18:59:15-2013.4.24   0                        1

 Keepalive    18:59:15-2013.4.24   1                        1

              18:59:15-2013.4.24   1                        1

 RouteRefresh -                    0                        0

              -                    0                        0

 Total        -                    2                        2

              -                    3                        5

 

 Maximum allowed prefix number: 4294967295

 Threshold: 75%

 Minimum time between advertisements is 30 seconds

 Optional capabilities:

  Multi-protocol extended capability has been enabled

  Route refresh capability has been enabled

 Peer preferred value: 0

 GTSM has been enabled, and the maximum number of hops is 10

 BFD: Enabled

 IPsec profile name: profile001

 Site-of-Origin: Not specified

 

 Routing policy configured:

 No routing policy is configured

# Display detailed BGP IPv4 unicast peer information for all VPN instances.

<Sysname> display bgp peer ipv4 vpn-instance-all verbose

 

         Peer: 111.1.1.1 Local: 111.1.1.1                                      

         VPN instance: 1                                                        

         Type: IBGP link                                                       

         BGP version 4, remote router ID 0.0.0.0                               

         BGP current state: Connect                                             

         BGP current event: CRTimerExpired                                     

         BGP last state: Connect                                               

                                                                                

 InQ updates: 0, OutQ updates: 0                                               

 NLRI statistics:                                                              

         Rcvd:   UnReach NLRI          0,      Reach NLRI          0           

         Sent:   UnReach NLRI          0,      Reach NLRI          0           

                                                                               

 Message statistics:                                                           

 Msg type     Last rcvd time/      Current rcvd count/      History rcvd count/

              Last sent time       Current sent count       History sent count 

 Open         -                    0                        0                  

              -                    0                        0                  

 Update       -                    0                        0                  

              -                    0                        0                  

 Notification -                    0                        0                  

              -                    0                        0                  

 Keepalive    -                    0                        0                  

              -                    0                        0                  

 RouteRefresh -                    0                        0                  

              -                    0                        0                  

 Total        -                    0                        0                  

              -                    0                        0                  

                                                                               

 Maximum allowed prefix number: 4294967295                                      

 Threshold: 75%                                                                

 Minimum time between advertisements is 15 seconds                             

 Optional capabilities:                                                         

  Multi-protocol extended capability has been enabled                          

  Route refresh capability has been enabled                                    

 Peer preferred value: 0                                                        

 Site-of-Origin: Not specified                                                 

 Routing policy configured:                                                    

 No routing policy is configured                                               

                                                                                

         Peer: 111.1.1.2 Local: 111.1.1.1                                      

         VPN instance: 1                                                       

         Type: IBGP link                                                       

         BGP version 4, remote router ID 0.0.0.0                               

         BGP current state: Connect                                            

         BGP current event: CRTimerExpired                                     

         BGP last state: Connect                                               

                                                                               

 InQ updates: 0, OutQ updates: 0                                               

 NLRI statistics:                                                              

         Rcvd:   UnReach NLRI          0,      Reach NLRI          0           

         Sent:   UnReach NLRI          0,      Reach NLRI          0           

                                                                               

 Message statistics:                                                           

 Msg type     Last rcvd time/      Current rcvd count/      History rcvd count/

              Last sent time       Current sent count       History sent count 

 Open         -                    0                        0                  

              -                    0                        0                  

 Update       -                    0                        0                  

              -                    0                        0                  

 Notification -                    0                        0                   

              -                    0                        0                  

 Keepalive    -                    0                        0                  

              -                    0                        0                   

 RouteRefresh -                    0                        0                  

              -                    0                        0                  

 Total        -                    0                        0                  

              -                    0                        0                  

                                                                               

 Maximum allowed prefix number: 4294967295                                     

 Threshold: 75%                                                                 

 Minimum time between advertisements is 15 seconds                             

 Optional capabilities:                                                        

  Multi-protocol extended capability has been enabled                          

  Route refresh capability has been enabled                                    

 Peer preferred value: 0                                                       

 Site-of-Origin: Not specified                                                 

 Routing policy configured:                                                    

 No routing policy is configured                                               

                                                                                

         Peer: 112.1.1.1 Local: 112.1.1.1                                      

         VPN instance: 2                                                       

         Type: IBGP link                                                        

         BGP version 4, remote router ID 0.0.0.0                               

         BGP current state: Connect                                            

         BGP current event: CRTimerExpired                                      

         BGP last state: Connect                                               

                                                                               

 InQ updates: 0, OutQ updates: 0                                                

 NLRI statistics:                                                              

         Rcvd:   UnReach NLRI          0,      Reach NLRI          0           

         Sent:   UnReach NLRI          0,      Reach NLRI          0            

                                                                               

 Message statistics:                                                           

 Msg type     Last rcvd time/      Current rcvd count/      History rcvd count/

              Last sent time       Current sent count       History sent count 

 Open         -                    0                        0                  

              -                    0                        0                  

 Update       -                    0                        0                  

              -                    0                        0                  

 Notification -                    0                        0                  

              -                    0                        0                  

 Keepalive    -                    0                        0                  

              -                    0                        0                  

 RouteRefresh -                    0                        0                  

              -                    0                        0                  

 Total        -                    0                        0                  

              -                    0                        0                  

                                                                               

 Maximum allowed prefix number: 4294967295                                     

 Threshold: 75%                                                                 

 Minimum time between advertisements is 15 seconds                             

 Optional capabilities:                                                        

  Multi-protocol extended capability has been enabled                          

  Route refresh capability has been enabled                                    

 Peer preferred value: 0                                                       

 Site-of-Origin: Not specified                                                  

 Routing policy configured:                                                    

 No routing policy is configured                                               

                                                                                

         Peer: 112.1.1.2 Local: 112.1.1.1                                      

         VPN instance: 2                                                       

         Type: IBGP link                                                        

         BGP version 4, remote router ID 0.0.0.0                               

         BGP current state: Connect                                            

         BGP current event: CRTimerExpired                                     

         BGP last state: Connect                                               

                                                                               

 InQ updates: 0, OutQ updates: 0                                               

 NLRI statistics:                                                               

         Rcvd:   UnReach NLRI          0,      Reach NLRI          0           

         Sent:   UnReach NLRI          0,      Reach NLRI          0           

                                                                               

 Message statistics:                                                           

 Msg type     Last rcvd time/      Current rcvd count/      History rcvd count/

              Last sent time       Current sent count       History sent count 

 Open         -                    0                        0                  

              -                    0                        0                  

 Update       -                    0                        0                  

              -                    0                        0                  

 Notification -                    0                        0                  

              -                    0                        0                  

 Keepalive    -                    0                        0                  

              -                    0                        0                  

 RouteRefresh -                    0                        0                  

              -                    0                        0                  

 Total        -                    0                        0                  

              -                    0                        0                   

                                                                               

 Maximum allowed prefix number: 4294967295                                     

 Threshold: 75%                                                                 

 Minimum time between advertisements is 15 seconds                             

 Optional capabilities:                                                        

  Multi-protocol extended capability has been enabled                          

  Route refresh capability has been enabled                                    

 Peer preferred value: 0                                                       

 Site-of-Origin: Not specified                                                 

 Routing policy configured:                                                    

 No routing policy is configured                                                

Table 13 Command output

Field

Description

Peer

IPv4 or IPv6 address of the peer.

Local

Local router ID.

VPN instance

Name of the VPN instance to which the peer belongs.

Type

BGP connection type between the local router and the peer:

·         IBGP link—IBGP connection.

·         EBGP link—EBGP connection.

remote router ID

Router ID of the peer.

BGP current state

Current state of the BGP session between the local router and the peer.

Up for

Lasting time of the BGP session.

BGP current event

Current event of the BGP session between the local router and the peer.

BGP last state

Previous state of the BGP session.

Port

TCP port numbers of the local router and its peer.

Configured

Timers configured on the local router in seconds, including the hold time (Active Hold Time) and keepalive interval (Keepalive Time).

Received

Received timer (configured on the peer) in seconds, including the hold time (Active Hold Time).

Negotiated

Negotiated timers in seconds, including the hold time (Active Hold Time) and keepalive interval (Keepalive Time).

Peer optional capabilities

Optional capabilities supported by the peer.

Peer support BGP route AS4 capability

The peer supports 4-byte AS number.

Address family IPv4 Unicast

IPv4 unicast address family capability: routes of the address family can be advertised and received.

Address family LS

LS address family capability: routes of the address family can be advertised and received.

Address family IPv6 Unicast

IPv6 unicast address family capability: routes of the address family can be advertised and received.

Address family IPv4 Multicast

IPv4 multicast address family capability: routes of the address family can be advertised and received.

Address family IPv6 Multicast

IPv6 multicast address family capability: routes of the address family can be advertised and received.

InQ updates

Number of received updates to be processed.

OutQ updates

Number of updates to be sent to the peer.

NLRI statistics

Number of the reachable and unreachable routes received from and sent to the peer after the BGP session is established.

Message statistics

BGP message statistics.

Msg type

BGP message type.

Last rcvd time/Last sent time

Time when the most recent BGP message was received from or sent to the peer.

Current rcvd count/Current sent count

Number of BGP messages received from or sent to the peer on the current BGP session.

History rcvd count/History sent count

Number of BGP messages received from or sent to the peer since the BGP peer relationship was established.

Total

Total number of received and sent messages.

Maximum allowed prefix number

Maximum number of routes allowed to learn from the peer.

Threshold

Percentage of received routes from the peer to maximum routes allowed to learn from the peer. If the percentage is reached, the system generates alarm messages.

Minimum time between advertisements

Minimum route advertisement interval in seconds.

Optional capabilities

Optional capabilities supported by the local end.

Peer Preferred Value

Preferred value specified for the routes from the peer.

GTSM has been enabled

GTSM is supported.

the maximum number of hops

Maximum number of hops to the specified peer.

BFD

Whether BFD is enabled to detect the link to the BGP peer.

IPsec profile name

IPsec profile applied to the IPv6 BGP peer.

This field is available only for the IPv6 unicast and IPv6 multicast address families.

Routing policy configured

Routing policy configured for the peer.

If you do not specify a routing policy, this field displays No routing policy is configured.

# Display log information for BGP IPv4 unicast peer 1.1.1.1.

<Sysname> display bgp peer ipv4 1.1.1.1 log-info

 

 Peer : 1.1.1.1

 

     Date      Time    State Notification

                             Error/SubError

 

  06-Feb-2013 22:54:42 Down  Send notification with error 6/4

                             Cease/Administrative Reset

                             <administrative reset>

Table 14 Command output

Field

Description

Peer

IPv4 or IPv6 address of the peer.

Date

Date on which the Notification was sent or received.

Time

Time at which the Notification was sent or received.

State

BGP session state:

·         Up—The BGP session is in Established state.

·         Down—The BGP session is down.

Notification Error/SubError

Error code of the Notification, indicating the cause of why the BGP session was down.

·         Error—Refers to the error code, which identifies the type of the Notification.

·         SubError—Refers to the error subcode of the Notification, which identifies the specific information about the reported error.

display bgp peer received prefix-list

Use display bgp peer received prefix-list to display the ORF prefix information received by a peer.

Syntax

display bgp [ instance instance-name ] peer ipv4 [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ] ipv4-address received prefix-list

display bgp [ instance instance-name ] peer ipv6 [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ] ipv6-address received prefix-list

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays ORF prefix information for the default BGP instance.

ipv4: Displays BGP IPv4 peer information.

ipv6: Displays BGP IPv6 peer information.

multicast: Displays BGP multicast peer information.

unicast: Displays BGP unicast peer information.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify an instance, this command displays information for the public network.

ipv4-address: Specifies a peer by its IPv4 address.

ipv6-address: Specifies a peer by its IPv6 address.

Examples

# Display the ORF prefix information received by peer 10.110.25.20.

<Sysname> display bgp peer ipv4 10.110.25.20 received prefix-list

 

ORF prefix list entries: 2

    index: 10               prefix  1.1.1.0/24              ge  26  le  32

    index: 20               prefix  2.1.1.0/24              ge  26  le  32

Table 15 Command output

Field

Description

ORF prefix list entries

Number of ORF prefixes.

index

Prefix index.

prefix

Prefix information.

ge

Greater than or equal to.

le

Less than or equal to.

display bgp routing-table dampened

Use display bgp routing-table dampened to display dampened BGP routes.

Syntax

display bgp [ instance instance-name ] routing-table dampened { ipv4 | ipv6 } [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays dampened BGP routes for the default BGP instance.

ipv4: Displays dampened BGP IPv4 routes.

ipv6: Displays dampened BGP IPv6 routes.

multicast: Displays dampened BGP multicast routes.

unicast: Displays dampened BGP unicast routes.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays dampened BGP routes for the public network.

Usage guidelines

By default, the unicast keyword is used if neither the multicast keyword nor the unicast keyword is specified.

Examples

# Display dampened BGP IPv4 unicast routes.

<Sysname> display bgp routing-table dampened ipv4

 

 Total number of routes: 1

 

 BGP local router ID is 192.168.1.135

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

     Network            From            Reuse                         Path/Ogn

 

  de 20.1.1.0/24        10.1.1.2        00:56:27                      100i

# Display dampened BGP IPv6 unicast routes.

<Sysname> display bgp routing-table dampened ipv6

 

 Total number of routes: 2

 

 BGP local router ID is 192.168.1.135

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

  de Network : 2::                                      PrefixLen : 64

     From    : 10.1.1.1                                 Reuse     : 00:39:49

     Path/Ogn: 100i

 

  de Network : 2::                                      PrefixLen : 64

     From    : 1::1                                     Reuse     : 00:39:49

     Path/Ogn: 100i

Table 16 Command output

Field

Description

Status codes

Status codes:

·         * – valid—Valid route.

·         > – best—Optimal route.

·         d – dampened—Dampened route.

·         h – history—History route.

·         s – suppressed—Suppressed route.

·         S – stale—Stale route.

·         i – internal—Internal route.

·         e – external—External route.

·         a – additional-path—Add-Path optimal route.

Origin

Origin of the route:

·         i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP.

·         e – EGP—Learned through EGP.

·         ?– incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.

Network

Destination network address.

From

IP address from which the route was received.

Reuse

Reuse time of the route.

Path/Ogn

AS_PATH and ORIGIN attributes of the route:

·         AS_PATH attribute—Records the ASs the route has passed, which avoids routing loops.

·         ORIGIN attribute—Identifies the origin of the route.

Related commands

dampening

reset bgp dampening

display bgp routing-table flap-info

Use display bgp routing-table flap-info to display BGP route flap statistics.

Syntax

display bgp [ instance instance-name ] routing-table flap-info ipv4 [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ] [ ipv4-address [ { mask-length | mask } [ longest-match ] ] | as-path-acl as-path-acl-number ]

display bgp [ instance instance-name ] routing-table flap-info ipv6 [ multicast | [ unicast ] [ vpn-instance vpn-instance-name ] ] [ ipv6-address prefix-length | as-path-acl as-path-acl-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP route flap statistics for the default BGP instance.

ipv4: Displays BGP IPv4 route flap statistics.

ipv6: Displays BGP IPv6 route flap statistics.

multicast: Displays BGP multicast route flap statistics.

unicast: Displays BGP unicast route flap statistics.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays BGP route flap statistics for the public network.

ipv4-address: Specifies a destination network address.

mask-length: Specifies a mask length in the range of 0 to 32.

mask: Specifies a network mask in dotted decimal notation.

longest-match: Specifies longest match mode, which selects the longest matching route through the following steps:

1.        ANDs the specified network address with the mask of each route.

2.        Matches a route if the AND result is the same as the network address of the route and the mask of the route is shorter than or equal to the specified mask.

3.        Selects the route with the longest mask among the matching routes.

ipv6-address prefix-length: Displays route flap statistics for BGP IPv6 routes that match the specified network address, and match the prefix length in the range of 0 to 128.

as-path-acl as-path-acl-number: Displays route flap statistics for BGP routes that match the AS path list specified by its number in the range of 1 to 256.

Usage guidelines

If you specify only the ipv4-address argument, the system ANDs the network address with the mask of a route. If the result matches the network address of the route, the command displays flap statistics of the route.

If you specify the ipv4-address mask or ipv4-address mask-length argument, and do not specify the longest-match keyword, the command displays flap statistics of the BGP IPv4 unicast or multicast route that matches both the specified destination network address and the mask (or mask length).

By default, the unicast keyword is used if neither the multicast keyword nor the unicast keyword is specified.

Examples

# Display BGP IPv4 unicast route flap statistics.

<Sysname> display bgp routing-table flap-info ipv4

 

 Total number of routes: 1

 

 BGP local router ID is 192.168.1.135

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

     Network            From            Flaps  Duration  Reuse        Path/Ogn

 

  de 20.1.1.0/24        10.1.1.2        1      00:02:36  00:53:58     100i

# Display BGP IPv6 unicast route flap statistics.

<Sysname> display bgp routing-table flap-info ipv6

 

 Total number of routes: 2

 

 BGP local router ID is 192.168.1.135

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

  de Network : 2::                                      PrefixLen : 64

     From    : 10.1.1.1                                 Flaps     : 5

     Duration: 00:03:25                                 Reuse     : 00:39:28

     Path/Ogn: 100i

 

  de Network : 2::                                      PrefixLen : 64

     From    : 1::1                                     Flaps     : 5

     Duration: 00:03:25                                 Reuse     : 00:39:28

     Path/Ogn: 100i

Table 17 Command output

Field

Description

Status codes

Status codes:

·         * – valid—Valid route.

·         > – best—Optimal route.

·         d – dampened—Dampened route.

·         h – history—History route.

·         s – suppressed—Suppressed route.

·         S – stale—Stale route.

·         i – internal—Internal route.

·         e – external—External route.

·         a – additional-path.

Origin

Origin of the route:

·         i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP.

·         e – EGP—Learned through EGP.

·         ?– incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.

Network

Destination network address.

From

Source IP address of the route.

Flaps

Number of routing flaps.

Duration

Duration time of the flap route.

Reuse

Reuse time of the route.

Path/Ogn

AS_PATH and ORIGIN attributes of the route:

·         AS_PATH attribute—Records the ASs the route has passed, which avoids routing loops.

·         ORIGIN attribute—Identifies the origin of the route.

Related commands

dampening

reset bgp flap-info

display bgp routing-table ipv4 multicast

Use display bgp routing-table ipv4 multicast to display BGP IPv4 multicast routing information.

Syntax

display bgp [ instance instance-name ] routing-table ipv4 multicast [ ipv4-address [ { mask-length | mask } [ longest-match ] ] | ipv4-address [ mask-length | mask ] advertise-info | as-path-acl as-path-acl-number | community-list { { basic-community-list-number | comm-list-name } [ whole-match ] | adv-community-list-number } | peer ipv4-address { advertised-routes | received-routes } [ ipv4-address [ mask-length | mask ] | statistics ] | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP IPv4 multicast routing information for the default BGP instance.

ipv4-address: Specifies a destination network address.

mask-length: Specifies a mask length in the range of 0 to 32.

mask: Specifies a network mask in dotted decimal notation.

longest-match: Specifies longest match mode, which selects the longest matching route through the following steps:

1.        ANDs the specified network address with the mask of each route.

2.        Matches a route if the AND result is the same as the network address of the route and the mask of the route is shorter than or equal to the specified mask.

3.        Selects the route with the longest mask among the matching routes.

advertise-info: Displays advertisement information for BGP IPv4 multicast routes.

as-path-acl as-path-acl-number: Displays BGP IPv4 multicast routes that match the AS path list specified by its number in the range of 1 to 256.

community-list: Displays BGP IPv4 multicast routes that match a community list.

basic-community-list-number: Specifies a basic community list by its number in the range of 1 to 99.

comm-list-name: Specifies a community list by its name, a case-sensitive string of 1 to 63 characters.

whole-match: Displays BGP IPv4 multicast routes exactly matching the specified community list. If you do not specify this keyword, the command displays BGP IPv4 multicast routes whose COMMUNITY attributes include the specified community list.

adv-community-list-number: Specifies an advanced community list by its number in the range of 100 to 199.

peer ipv4-address: Displays BGP IPv4 multicast routing information advertised to or received from the specified peer.

advertised-routes: Displays BGP IPv4 multicast routing information advertised to the specified peer.

received-routes: Displays BGP IPv4 multicast routing information received from the specified peer.

statistics: Displays routing statistics.

Usage guidelines

If you do not specify any parameters, this command displays brief information about all BGP IPv4 multicast routes.

If you specify only the ipv4-address argument, the system ANDs the network address with the mask of a route. If the result matches the network address of the route, the command displays information about the route.

If you specify the ipv4-address mask or ipv4-address mask-length argument and do not specify the longest-match keyword, this command displays information about the BGP IPv4 multicast route that matches both the specified destination network address and the mask (or mask length).

Examples

# Display brief information about all BGP IPv4 multicast routes.

<Sysname> display bgp routing-table ipv4 multicast

 

 Total number of routes: 3

 

 BGP local router ID is 192.168.1.62

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

     Network            NextHop         MED        LocPrf     PrefVal Path/Ogn

 

* >  5.5.5.5/32         127.0.0.1       0                     32768   ?

* >  192.168.1.0        192.168.1.62    0                     32768   ?

* >  192.168.1.62/32    127.0.0.1       0                     32768   ?

# Display information about BGP IPv4 multicast routes that match AS path list 20.

<Sysname> display bgp routing-table ipv4 multicast as-path-acl 20

 

 Total number of routes: 3

 

 BGP local router ID is 192.168.1.62

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

     Network            NextHop         MED        LocPrf     PrefVal Path/Ogn

 

* >  5.5.5.5/32         127.0.0.1       0                     32768   ?

* >  192.168.1.0        192.168.1.62    0                     32768   ?

* >  192.168.1.62/32    127.0.0.1       0                     32768   ?

# Display information about BGP IPv4 multicast routes that match BGP community list 100.

<Sysname> display bgp routing-table ipv4 multicast community-list 100

 

 Total number of routes: 3

 

 BGP local router ID is 192.168.1.62

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

     Network            NextHop         MED        LocPrf     PrefVal Path/Ogn

 

* >  5.5.5.5/32         127.0.0.1       0                     32768   ?

* >  192.168.1.0        192.168.1.62    0                     32768   ?

* >  192.168.1.62/32    127.0.0.1       0                     32768   ?

# Display information about all BGP IPv4 multicast routes advertised to peer 192.168.1.139.

<Sysname> display bgp routing-table ipv4 multicast peer 192.168.1.139 advertised-routes

 

 Total number of routes: 2

 

 BGP local router ID is 192.168.1.62

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

     Network            NextHop         MED        LocPrf             Path/Ogn

 

* >  5.5.5.5/32         127.0.0.1       0          100                ?

* >  192.168.1.0        192.168.1.62    0          100                ?

# Display information about all BGP IPv4 multicast routes received from peer 192.168.1.139.

<Sysname> display bgp routing-table ipv4 multicast peer 192.168.1.139 received-routes

 

 Total number of routes: 2

 

 BGP local router ID is 192.168.1.62

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

     Network            NextHop         MED        LocPrf     PrefVal Path/Ogn

 

* >i 8.8.8.8/32         192.168.1.139   0          100        0       ?

*  i 192.168.1.0        192.168.1.139   0          100        0       ?

Table 18 Command output

Field

Description

Status codes

Status codes:

·         * – valid—Valid route.

·         > – best—Optimal route.

·         d – dampened—Dampened route.

·         h – history—History route.

·         s – suppressed—Suppressed route.

·         S – stale—Stale route.

·         i – internal—Internal route.

·         e – external—External route.

·         a – additional-path—Add-Path optimal route.

Origin

Origin of the route:

·         i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP.

·         e – EGP—Learned through EGP.

·         ?– incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.

Network

Destination network address.

NextHop

Next hop IP address.

MED

MULTI_EXIT_DISC attribute.

LocPrf

Local preference value.

PrefVal

Preferred value of the route.

Path/Ogn

AS_PATH and ORIGIN attributes of the route:

·         AS_PATH—Records the ASs the route has passed.

·         ORIGIN—Identifies the origin of the route.

# Display detailed information about BGP IPv4 multicast routes destined to network 5.5.5.5/32.

<Sysname> display bgp routing-table ipv4 multicast 5.5.5.5 32

 

 BGP local router ID: 192.168.1.139

 Local AS number: 100

 

 Paths:   1 available, 1 best

 

 BGP routing table information of 5.5.5.5/32:

 From            : 192.168.1.62 (192.168.1.62)

 Rely nexthop    : 192.168.1.62

 Original nexthop: 192.168.1.62

 OutLabel        : NULL

 RxPathID        : 0x0

 TxPathID        : 0x0

 AS-path         : (null)

 Origin          : incomplete

 Attribute value : MED 0, localpref 100, pref-val 0

 State           : valid, internal, best

 IP precedence   : N/A

 QoS local ID    : N/A

 Traffic index   : N/A

Table 19 Command output

Field

Description

Paths

Number of routes:

·         available—Number of valid routes.

·         best—Number of optimal routes.

From

IP address of BGP peer that advertised the route.

Rely Nexthop

Next hop found by route recursion. If no next hop is found, this field displays not resolved.

Original nexthop

Original next hop of the route. If the route was obtained from a BGP update message, the original next hop is the next hop IP address in the message.

OutLabel

This field is not supported in the current software version.

Outgoing label of the route.

RxPathID

Add-Path ID of received routes.

TxPathID

Add-Path ID of advertised routes.

AS-path

AS_PATH attribute of the route.

Origin

Origin of the route:

·         igp—Originated in the AS. The origin of routes advertised with the network command is IGP.

·         egp—Learned through EGP.

·         incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.

Attribute value

BGP path attributes:

·         MED—MED value.

·         localprefLocal preference value.

·         pref-val—Preferred value.

·         pre—Route preference.

State

Current state of the route:

·         valid.

·         internal.

·         external.

·         local.

·         synchronize.

·         best.

IP precedence

IP precedence in the range of 0 to 7. N/A indicates that the route does not support this field.

QoS local ID

QoS local ID in the range of 1 to 4095. N/A indicates that the route does not support this field.

Traffic index

Traffic index in the range of 1 to 64. N/A indicates that the route does not support this field.

# Display statistics for BGP IPv4 multicast routes advertised to peer 192.168.1.62.

<Sysname> display bgp routing-table ipv4 multicast peer 192.168.1.62 advertised-routes statistics

 

 Advertised routes total: 2

# Display statistics for BGP IPv4 multicast routes received from peer 192.168.1.62.

<Sysname> display bgp routing-table ipv4 multicast peer 192.168.1.62 received-routes statistics

 

 Received routes total: 2

Table 20 Command output

Field

Description

Advertised routes total

Total number of advertised routes.

Received routes total

Total number of received routes.

# Display BGP IPv4 multicast route statistics.

<Sysname> display bgp routing-table ipv4 multicast statistics

 

 Total number of routes: 5

Table 21 Command output

Field

Description

Total number of routes

Total number of routes.

# Display advertisement information for the BGP IPv4 multicast route destined to network 8.8.8.8/32.

<Sysname> display bgp routing-table ipv4 multicast 8.8.8.8 32 advertise-info

 

 BGP local router ID: 192.168.1.139

 Local AS number: 100

 

 Paths:   1 best

 

 BGP routing table information of 8.8.8.8/32(TxPathID:0):

 Advertised to peers (1 in total):

    192.168.1.62

Table 22 Command output

Field

Description

BGP local router ID

Local BGP router ID.

Local AS number

Local AS number.

Paths

Number of optimal routes to the destination.

BGP routing table information of 8.8.8.8/32(TxPathID:0)

Advertisement information for network 8.8.8.8/32.

Advertised to peers (1 in total)

Peers to which the network has been advertised.

Related commands

ip as-path

ip community-list

display bgp routing-table ipv4 unicast

Use display bgp routing-table ipv4 unicast to display BGP IPv4 unicast routing information.

Syntax

display bgp [ instance instance-name ] routing-table ipv4 [ unicast ] [ vpn-instance vpn-instance-name ] [ ipv4-address [ { mask-length | mask } [ longest-match ] ] | ipv4-address [ mask-length | mask ] advertise-info | as-path-acl as-path-acl-number | community-list { { basic-community-list-number | comm-list-name } [ whole-match ] | adv-community-list-number } | peer ipv4-address { advertised-routes | received-routes } [ ipv4-address [ mask-length | mask ] | statistics ] | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP IPv4 unicast routing information for the default BGP instance.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays the BGP IPv4 unicast routing information for the public network.

ipv4-address: Specifies a destination network address.

mask-length: Specifies a mask length in the range of 0 to 32.

mask: Specifies a network mask in dotted decimal notation.

longest-match: Specifies longest match mode, which selects the longest matching route through the following steps:

1.        ANDs the specified network address with the mask of each route.

2.        Matches a route if the AND result is the same as the network address of the route and the mask of the route is shorter than or equal to the specified mask.

3.        Selects the route with the longest mask among the matching routes.

advertise-info: Displays advertisement information for BGP IPv4 unicast routes.

as-path-acl as-path-acl-number: Displays BGP IPv4 unicast routes that match the AS path list specified by its number in the range of 1 to 256.

community-list: Displays BGP IPv4 unicast routes that match a community list.

basic-community-list-number: Specifies a basic community list by its number in the range of 1 to 99.

comm-list-name: Specifies a community list by its name, a case-sensitive string of 1 to 63 characters.

whole-match: Displays routes exactly matching the specified community list. If you do not specify this keyword, the command displays routes whose COMMUNITY attributes include the specified community list.

adv-community-list-number: Specifies an advanced community list by its number in the range of 100 to 199.

peer ipv4-address: Displays BGP IPv4 unicast routing information advertised to or received from the specified peer.

advertised-routes: Displays routing information advertised to the specified peer.

received-routes: Displays routing information received from the specified peer.

statistics: Displays routing statistics.

Usage guidelines

If you do not specify any parameters, this command displays brief information about all BGP IPv4 unicast routes.

If you specify only the ipv4-address argument, the system ANDs the network address with the mask of a route. If the result matches the network address of the route, the command displays information about the route.

If you specify the ipv4-address mask or ipv4-address mask-length argument and do not specify the longest-match keyword, this command displays information about the BGP IPv4 unicast route that matches both the specified destination network address and the mask (or mask length).

This command displays BGP IPv4 unicast routing information regardless of whether the unicast keyword is specified.

Examples

# Display brief information about all BGP IPv4 unicast routes.

<Sysname> display bgp routing-table ipv4

 

 Total number of routes: 4

 

 BGP local router ID is 192.168.100.1

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

     Network            NextHop         MED        LocPrf     PrefVal Path/Ogn

 

* >  10.2.1.0/24        10.2.1.1        0                     0       i

   e                    10.2.1.2        0                     0       200i

* >  192.168.1.0        192.168.1.135   0                     0       i

*  e                    10.2.1.2        0                     0       200i

# Display information about BGP IPv4 unicast routes that match AS path list 1.

<Sysname> display bgp routing-table ipv4 as-path-acl 1

 

 Total number of routes: 1

 

 BGP local router ID is 2.2.2.2

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

     Network            NextHop         MED        LocPrf     PrefVal Path/Ogn

 

* >e 30.1.1.0/24        20.1.1.1                              0       200i

# Display information about all public BGP IPv4 unicast routes advertised to peer 10.2.1.2.

<Sysname> display bgp routing-table ipv4 peer 10.2.1.2 advertised-routes

 

 Total number of routes: 2

 

 BGP local router ID is 192.168.100.1

 Status codes: * - valid, > - best, d - damped, h - history,

               s - suppressed, S - Stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

     Network            NextHop         MED        LocPrf     PrefVal Path/Ogn

 

* >  10.2.1.0/24        10.2.1.1        0                     0       i

* >  192.168.1.0        192.168.1.135   0                     0       i

# Display information about all public BGP IPv4 unicast routes received from peer 10.2.1.2.

<Sysname> display bgp routing-table ipv4 peer 10.2.1.2 received-routes

 

 Total number of routes: 2

 

 BGP local router ID is 192.168.100.1

 Status codes: * - valid, > - best, d - damped, h - history,

               s - suppressed, S - Stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

     Network            NextHop         MED        LocPrf     PrefVal Path/Ogn

 

   e 10.2.1.0/24        10.2.1.2        0                     0       200i

*  e 192.168.1.0        10.2.1.2        0                     0       200i

Table 23 Command output

Field

Description

Status codes

Status codes:

·         * – valid—Valid route.

·         > – best—Optimal route.

·         d – dampened—Dampened route.

·         h – history—History route.

·         s – suppressed—Suppressed route.

·         S – stale—Stale route.

·         i – internal—Internal route.

·         e – external—External route.

·         a – additional-path—Add-Path optimal route.

Origin

Origin of the route:

·         i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP.

·         e – EGP—Learned through EGP.

·         ?– incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.

Network

Destination network address.

NextHop

Next hop IP address.

MED

MULTI_EXIT_DISC attribute.

LocPrf

Local preference value.

PrefVal

Preferred value of the route.

Path/Ogn

AS_PATH and ORIGIN attributes of the route:

·         AS_PATH—Records the ASs the route has passed, which avoids routing loops.

·         ORIGIN—Identifies the origin of the route.

# Display detailed information about BGP IPv4 unicast routes destined to network 10.2.1.0/24.

<Sysname> display bgp routing-table ipv4 10.2.1.0 24

 

 BGP local router ID: 192.168.100.1

 Local AS number: 100

 

 Paths:   2 available, 1 best

 

 BGP routing table information of 10.2.1.0/24:

 Imported route.

 Original nexthop: 10.2.1.1

 OutLabel        : NULL

 RxPathID        : 0x0

 TxPathID        : 0x0

 AS-path         : (null)

 Origin          : igp

 Attribute value : MED 0, pref-val 0, pre 0

 State           : valid, local, best

 IP precedence   : N/A

 QoS local ID    : N/A

 Traffic index   : N/A

 

 From            : 10.2.1.2 (192.168.100.2)

 Rely nexthop   : not resolved

 Original nexthop: 10.2.1.2

 OutLabel        : NULL

 RxPathID        : 0x0

 TxPathID        : 0x0

 AS-path         : 200

 Origin          : igp

 Attribute value : MED 0, pref-val 0, pre 255

 State           : external

 IP precedence   : N/A

 QoS local ID    : N/A

 Traffic index   : N/A

# Display detailed information about the BGP IPv4 unicast route destined to address 1.1.1.1/32.

<Sysname> display bgp routing-table ipv4 1.1.1.1 32

 

 BGP local router ID: 192.168.100.1

 Local AS number: 100

 

 Paths:   2 available, 1 best

 

 BGP routing table information of 1.1.1.1/32:

 From            : 10.2.1.1 (192.168.100.3)

 Rely nexthop    : 10.2.1.1

 Original nexthop: 10.2.1.1

 OutLabel        : NULL

 RxPathID        : 0x0

 TxPathID        : 0x0

 AS-path         : (null)

 Origin          : igp

 Attribute value : MED 0, pref-val 0, pre 0

 State           : valid, local, best

 IP precedence   : N/A

 QoS local ID    : N/A

 Traffic index   : N/A

 

 

 Backup route.

 From            : 10.2.1.2 (192.168.100.2)

 Rely nexthop    : 10.2.1.2

 Original nexthop: 10.2.1.2

 OutLabel        : NULL

 RxPathID        : 0x0

 TxPathID        : 0x0

 AS-path         : 200

 Origin          : igp

 Attribute value : MED 0, pref-val 0, pre 255

 State           : external

 IP precedence   : N/A

 QoS local ID    : N/A

 Traffic index   : N/A

Table 24 Command output

Field

Description

Paths

Number of routes:

·         available—Number of valid routes.

·         best—Number of optimal routes.

Original nexthop

Original next hop of the route. If the route was obtained from a BGP update message, the original next hop is the next hop IP address in the message.

OutLabel

This field is not supported in the current software version.

Outgoing label of the route.

RxPathID

Add-Path ID of received routes.

TxPathID

Add-Path ID of advertised routes.

AS-path

AS_PATH attribute of the route, which records the ASs the route has passed and avoids routing loops.

Origin

Origin of the route:

·         igp—Originated in the AS. The origin of routes advertised with the network command is IGP.

·         egp—Learned through EGP.

·         incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.

Attribute value

BGP path attributes:

·         MED—MED value.

·         localprefLocal preference value.

·         pref-val—Preferred value.

·         pre—Route preference.

State

Current state of the route:

·         valid.

·         internal.

·         external.

·         local.

·         synchronize.

·         best.

From

IP address of the BGP peer that advertised the route.

Rely Nexthop

Next hop found by route recursion. If no next hop is found, this field displays not resolved.

IP precedence

IP precedence in the range of 0 to 7. N/A indicates that the route does not support this field.

QoS local ID

QoS local ID in the range of 1 to 4095. N/A indicates that the route does not support this field.

Traffic index

Traffic index in the range of 1 to 64. N/A indicates that the route does not support this field.

# Display statistics for public BGP IPv4 unicast routes advertised to peer 10.2.1.2.

<Sysname> display bgp routing-table ipv4 peer 10.2.1.2 advertised-routes statistics

 

 Advertised routes total: 2

# Display statistics for public BGP IPv4 unicast routes received from peer 10.2.1.2.

<Sysname> display bgp routing-table ipv4 peer 10.2.1.2 received-routes statistics

 

 Received routes total: 2

Table 25 Command output

Field

Description

Advertised routes total

Total number of advertised routes.

Received routes total

Total number of received routes.

# Display BGP IPv4 unicast route statistics.

<Sysname> display bgp routing-table ipv4 statistics

 

 Total number of routes: 4

Table 26 Command output

Field

Description

Total number of routes

Total number of routes.

# Display advertisement information for the BGP IPv4 unicast route destined to network 10.2.1.0/24.

<Sysname> display bgp routing-table ipv4 10.2.1.0 24 advertise-info

 

 BGP local router ID: 192.168.100.1

 Local AS number: 100

 

 Paths:   1 best

 

 BGP routing table information of 10.2.1.0/24(TxPathID:0):

 Advertised to peers (1 in total):

    10.2.1.2

Table 27 Command output

Field

Description

BGP local router ID

Local BGP router ID.

Local AS number

Local AS number.

Paths

Number of optimal routes to the destination.

BGP routing table information of 10.2.1.0/24(TxPathID:0)

Advertisement information for network 10.2.1.0/24.

Advertised to peers (1 in total)

Peers to which the network has been advertised.

Related commands

ip as-path

ip community-list

display bgp routing-table ipv6 multicast

Use display bgp routing-table ipv6 multicast to display BGP IPv6 multicast routing information.

Syntax

display bgp [ instance instance-name ] routing-table ipv6 multicast  [ ipv6-address prefix-length [ advertise-info ] | as-path-acl as-path-acl-number | community-list { { basic-community-list-number | comm-list-name } [ whole-match ] | adv-community-list-number } | peer ipv6-address { advertised-routes | received-routes } [ ipv6-address prefix-length | statistics ] | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP IPv6 multicast routing information for the default BGP instance.

ipv6-address prefix-length: Specifies the destination network address and prefix length. The value range for the prefix-length argument is 0 to 128. If you do not specify this argument, the command displays brief information about all BGP IPv6 multicast routing information.

advertise-info: Displays advertisement information for BGP IPv6 multicast routes. If you do not specify this keyword, the command displays the BGP IPv6 multicast routing table.

as-path-acl as-path-acl-number: Displays BGP IPv6 multicast routes that match the AS path list specified by its number in the range of 1 to 256.

community-list: Displays BGP IPv6 multicast routes that match a community list.

basic-community-list-number: Specifies a basic community list by its number in the range of 1 to 99.

comm-list-name: Specifies a community list by its name, a case-sensitive string of 1 to 63 characters.

whole-match: Displays BGP IPv6 multicast routes exactly matching the specified community list. If you do not specify this keyword, the command displays BGP IPv6 multicast routes whose COMMUNITY attributes include the specified community list.

adv-community-list-number: Specifies an advanced community list by its number in the range of 100 to 199.

peer: Displays BGP IPv6 multicast routing information advertised to or received from the specified peer.

ipv6-address: Specifies the peer IPv6 address.

advertised-routes: Displays BGP IPv6 multicast routing information advertised to the specified peer.

received-routes: Displays BGP IPv6 multicast routing information received from the specified peer.

statistics: Displays routing statistics.

Examples

# Display brief information about all BGP IPv6 multicast routes.

<Sysname> display bgp routing-table ipv6 multicast

 

 Total number of routes: 5

 

 BGP local router ID is 192.168.1.139

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

* >  Network : 1::                                      PrefixLen : 64

     NextHop : ::                                       LocPrf    :

     PrefVal : 32768                                    OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

 

*  i Network : 1::                                      PrefixLen : 64

     NextHop : 1::1                                     LocPrf    : 100

     PrefVal : 0                                        OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

 

* >  Network : 1::2                                     PrefixLen : 128

     NextHop : ::1                                      LocPrf    :

     PrefVal : 32768                                    OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

 

* >  Network : 2::2                                     PrefixLen : 128

     NextHop : ::1                                      LocPrf    :

     PrefVal : 32768                                    OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

 

* >i Network : 5::5                                     PrefixLen : 128

     NextHop : 1::1                                     LocPrf    : 100

     PrefVal : 0                                        OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

# Display information about BGP IPv6 multicast routes that match AS path list 1.

<Sysname> display bgp routing-table ipv6 multicast as-path-acl 1

 

 Total number of routes: 5

 

 BGP local router ID is 192.168.1.139

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

* >  Network : 1::                                      PrefixLen : 64

     NextHop : ::                                       LocPrf    :

     PrefVal : 32768                                    OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

 

*  i Network : 1::                                      PrefixLen : 64

     NextHop : 1::1                                     LocPrf    : 100

     PrefVal : 0                                        OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

 

* >  Network : 1::2                                     PrefixLen : 128

     NextHop : ::1                                      LocPrf    :

     PrefVal : 32768                                    OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

 

* >  Network : 2::2                                     PrefixLen : 128

     NextHop : ::1                                      LocPrf    :

     PrefVal : 32768                                    OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

 

* >i Network : 5::5                                     PrefixLen : 128

     NextHop : 1::1                                     LocPrf    : 100

     PrefVal : 0                                        OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

# Display information about BGP IPv6 multicast routes that match BGP community list 100.

<Sysname> display bgp routing-table ipv6 multicast community-list 100

 

 Total number of routes: 5

 

 BGP local router ID is 192.168.1.139

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

* >  Network : 1::                                      PrefixLen : 64

     NextHop : ::                                       LocPrf    :

     PrefVal : 32768                                    OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

 

*  i Network : 1::                                      PrefixLen : 64

     NextHop : 1::1                                     LocPrf    : 100

     PrefVal : 0                                        OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

 

* >  Network : 1::2                                     PrefixLen : 128

     NextHop : ::1                                      LocPrf    :

     PrefVal : 32768                                    OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

 

* >  Network : 2::2                                     PrefixLen : 128

     NextHop : ::1                                      LocPrf    :

     PrefVal : 32768                                    OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

 

* >i Network : 5::5                                     PrefixLen : 128

     NextHop : 1::1                                     LocPrf    : 100

     PrefVal : 0                                        OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

# Display information about all BGP IPv6 multicast routes advertised to peer 1::1.

<Sysname> display bgp routing-table ipv6 multicast peer 1::1 advertised-routes

 

 Total number of routes: 2

 

 BGP local router ID is 192.168.1.139

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

* >  Network : 1::                                      PrefixLen : 64

     NextHop : ::                                       LocPrf    : 100

     MED     : 0                                        OutLabel  : NULL

     Path/Ogn: ?

 

* >  Network : 2::2                                     PrefixLen : 128

     NextHop : ::1                                      LocPrf    : 100

     MED     : 0                                        OutLabel  : NULL

     Path/Ogn: ?

# Display information about all BGP IPv6 multicast routes received from peer 1::1.

<Sysname> display bgp routing-table ipv6 multicast peer 1::1 received-routes

 

 Total number of routes: 2

 

 BGP local router ID is 192.168.1.139

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

*  i Network : 1::                                      PrefixLen : 64

     NextHop : 1::1                                     LocPrf    : 100

     PrefVal : 0                                        OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

 

* >i Network : 5::5                                     PrefixLen : 128

     NextHop : 1::1                                     LocPrf    : 100

     PrefVal : 0                                        OutLabel  : NULL

     MED     : 0

     Path/Ogn: ?

Table 28 Command output

Field

Description

Status codes

Status codes:

·         * – valid—Valid route.

·         > – best—Optimal route.

·         d – dampened—Dampened route.

·         h – history—History route.

·         s – suppressed—Suppressed route.

·         S – stale—Stale route.

·         i – internal—Internal route.

·         e – external—External route.

·         a – additional-path—Add-Path optimal route.

Origin

Origin of the route:

·         i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP.

·         e – EGP—Learned through EGP.

·         ?– incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.

Network

Destination network address.

PrefixLen

Prefix length of the destination network address.

NextHop

Next hop IP address.

LocPrf

Local preference value.

PrefVal

Preferred value of the route.

OutLabel

This field is not supported in the current software version.

Outgoing label of the route.

MED

MULTI_EXIT_DISC attribute.

Path/Ogn

AS_PATH and ORIGIN attributes of the route:

·         AS_PATH—Records the ASs the route has passed, which avoids routing loops.

·         ORIGIN—Identifies the origin of the route.

# Display detailed information about BGP IPv6 multicast routes destined to network 2::2/128.

<Sysname> display bgp routing-table ipv6 multicast 2::2 128

 

 BGP local router ID: 192.168.1.139

 Local AS number: 100

 

 Paths:   1 available, 1 best

 

 BGP routing table information of 2::2/128:

 Imported route.

 Original nexthop: ::1

 OutLabel        : NULL

 RxPathID        : 0x0

 TxPathID        : 0x0

 AS-path         : (null)

 Origin          : incomplete

 Attribute value : MED 0, pref-val 32768

 State           : valid, local, best

 IP precedence   : N/A

 QoS local ID    : N/A

 Traffic index   : N/A

Table 29 Command output

Field

Description

Paths

Number of routes:

·         available—Number of valid routes.

·         best—Number of optimal routes.

Original nexthop

Original next hop of the route. If the route was obtained from a BGP update message, the original next hop is the next hop IP address in the message.

OutLabel

This field is not supported in the current software version.

Outgoing label of the route.

RxPathID

Add-Path ID of received routes.

TxPathID

Add-Path ID of advertised routes.

AS-path

AS_PATH attribute of the route, which records the ASs the route has passed and avoids routing loops.

Origin

Origin of the route:

·         igp—Originated in the AS. The origin of routes advertised with the network command is IGP.

·         egp—Learned through EGP.

·         incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.

Attribute value

BGP path attributes:

·         MED—MED value.

·         localprefLocal preference value.

·         pref-val—Preferred value.

·         pre—Route preference.

State

Current state of the route:

·         valid.

·         internal.

·         external.

·         local.

·         synchronize.

·         best.

From

IP address of the BGP peer that advertised the route.

Rely Nexthop

Next hop found by route recursion. If no next hop is found, this field displays not resolved.

IP precedence

IP precedence in the range of 0 to 7. N/A indicates that the route does not support this field.

QoS local ID

QoS local ID in the range of 1 to 4095. N/A indicates that the route does not support this field.

Traffic index

Traffic index in the range of 1 to 64. N/A indicates that the route does not support this field.

# Display advertisement information for BGP IPv6 multicast routes destined to network 2::2/128.

<Sysname> display bgp routing-table ipv6 multicast 2::2 128 advertise-info

 

 BGP local router ID: 192.168.1.139

 Local AS number: 100

 

 Paths:   1 best

 

 BGP routing table information of 2::2/128(TxPathID:0):

 Advertised to peers (1 in total):

    1::1

Table 30 Command output

Field

Description

BGP local router ID

Local BGP router ID.

Local AS number

Local AS number.

Paths

Number of optimal routes to the destination.

BGP routing table information of 2::2/128(TxPathID:0)

Advertisement information for network 2::2/128.

Advertised to peers (1 in total)

Peers to which the network has been advertised.

# Display statistics for BGP IPv6 multicast routes advertised to peer 1::1.

<Sysname> display bgp routing-table ipv6 multicast peer 1::1 advertised-routes statistics

 

 Advertised routes total: 2

# Display statistics for BGP IPv6 multicast routes received from peer 1::1.

<Sysname> display bgp routing-table ipv6 multicast peer 1::1 received-routes statistics

 

 Received routes total: 2

Table 31 Command output

Field

Description

Advertised routes total

Total number of advertised routes.

Received routes total

Total number of received routes.

# Display BGP IPv6 multicast route statistics.

<Sysname> display bgp routing-table ipv6 multicast statistics

 

 Total number of routes: 5

Table 32 Command output

Field

Description

Total number of routes

Total number of routes.

Related commands

ip as-path

ip community-list

display bgp routing-table ipv6 unicast

Use display bgp routing-table ipv6 unicast to display BGP IPv6 unicast routing information.

Syntax

display bgp [ instance instance-name ] routing-table ipv6 [ unicast ] [ vpn-instance vpn-instance-name ] [ ipv6-address prefix-length [ advertise-info ] | as-path-acl as-path-acl-number | community-list { { basic-community-list-number | comm-list-name } [ whole-match ] | adv-community-list-number } | peer ipv6-address { advertised-routes | received-routes } [ ipv6-address prefix-length | statistics ] | statistics ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP IPv6 unicast routing information for the default BGP instance.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays the BGP IPv6 unicast routing information for the public network.

ipv6-address prefix-length: Specifies the destination network address and prefix length. The value range for the prefix-length argument is 0 to 128. If you do not specify this argument, the command displays brief information about all BGP IPv6 unicast routing information.

advertise-info: Displays advertisement information for BGP IPv6 unicast routes. If you do not specify this keyword, the command displays the BGP IPv6 unicast routing table.

as-path-acl as-path-acl-number: Displays BGP IPv6 unicast routes that match the AS path list specified by its number in the range of 1 to 256.

community-list: Displays BGP IPv6 unicast routes that match a community list.

basic-community-list-number: Specifies a basic community list by its number in the range of 1 to 99.

comm-list-name: Specifies a community list by its name, a case-sensitive string of 1 to 63 characters.

whole-match: Displays routes exactly matching the specified community list. If you do not specify this keyword, the command displays routes whose COMMUNITY attributes include the specified community list.

adv-community-list-number: Specifies an advanced community list by its number in the range of 100 to 199.

peer: Displays BGP IPv6 unicast routing information advertised to or received from the specified peer.

ipv4-address: Specifies the peer IPv4 address.

ipv6-address: Specifies the peer IPv6 address.

advertised-routes: Displays routing information advertised to the specified peer.

received-routes: Displays routing information received from the specified peer.

statistics: Displays routing statistics.

Usage guidelines

This command displays BGP IPv6 unicast routing information regardless of whether the unicast keyword is specified.

Examples

# Display brief information about all BGP IPv6 unicast routes.

<Sysname> display bgp routing-table ipv6

 

 Total number of routes: 1

 

 BGP local router ID is 192.168.1.136

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

* >e Network : 3::                                      PrefixLen : 64

     NextHop : 1::2                                     LocPrf    :

     PrefVal : 0                                        OutLabel  : NULL

     MED     :

     Path/Ogn: 100i

# Display information about BGP IPv6 unicast routes that match AS path list 1.

<Sysname> display bgp routing-table ipv6 as-path-acl 1

 

 Total number of routes: 2

 

 BGP local router ID is 192.168.1.136

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

* >e Network : 2::                                      PrefixLen : 64

     NextHop : 1::2                                     LocPrf    :

     PrefVal : 0                                        OutLabel  : NULL

     MED     :

     Path/Ogn: 100i

 

* >e Network : 3::                                      PrefixLen : 64

     NextHop : 1::2                                     LocPrf    :

     PrefVal : 0                                        OutLabel  : NULL

     MED     :

     Path/Ogn: 100i

# Display information about BGP IPv6 unicast routes that match BGP community list 100.

<Sysname> display bgp routing-table ipv6 community-list 100

 

 Total number of routes: 2

 

 BGP local router ID is 192.168.1.136

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

* >e Network : 2::                                      PrefixLen : 64

     NextHop : 1::2                                     LocPrf    :

     PrefVal : 0                                        OutLabel  : NULL

     MED     :

     Path/Ogn: 100i

 

* >e Network : 3::                                      PrefixLen : 64

     NextHop : 1::2                                     LocPrf    :

     PrefVal : 0                                        OutLabel  : NULL

     MED     :

     Path/Ogn: 100i

# Display information about all BGP IPv6 unicast routes advertised to peer 1::1.

<Sysname> display bgp routing-table ipv6 peer 1::1 advertised-routes

 

 Total number of routes: 1

 

 BGP local router ID is 192.168.1.136

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

* >  Network : 2::                                      PrefixLen : 64

     NextHop : ::                                       LocPrf    :

     MED     : 0                                        OutLabel  : NULL

     Path/Ogn: i

# Display information about all BGP IPv6 unicast routes received from peer 1::1.

<Sysname> display bgp routing-table ipv6 peer 1::1 received-routes

 

 Total number of routes: 1

 

 BGP local router ID is 192.168.1.135

 Status codes: * - valid, > - best, d - dampened, h - history,

               s - suppressed, S - stale, i - internal, e - external

               a – additional-path

               Origin: i - IGP, e - EGP, ? - incomplete

 

* >e Network : 2::                                      PrefixLen : 64

     NextHop : ::FFFF:10.1.1.1                          LocPrf    :

     PrefVal : 0                                        OutLabel  : NULL

     MED     : 0

     Path/Ogn: 100i

Table 33 Command output

Field

Description

Status codes

Status codes:

·         * – valid—Valid route.

·         > – best—Optimal route.

·         d – dampened—Dampened route.

·         h – history—History route.

·         s – suppressed—Suppressed route.

·         S – stale—Stale route.

·         i – internal—Internal route.

·         e – external—External route.

·         a – additional-path—Add-Path optimal route.

Origin

Origin of the route:

·         i – IGP—Originated in the AS. The origin of routes advertised with the network command is IGP.

·         e – EGP—Learned through EGP.

·         ?– incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.

Network

Destination network address.

PrefixLen

Prefix length of the destination network address.

NextHop

Next hop IPv6 address.

LocPrf

Local preference value.

PrefVal

Preferred value of the route.

OutLabel

This field is not supported in the current software version.

Outgoing label of the route.

MED

MULTI_EXIT_DISC attribute.

Path/Ogn

AS_PATH and ORIGIN attributes of the route:

·         AS_PATH attribute—Records the ASs the route has passed, which avoids routing loops.

·         ORIGIN attribute—Identifies the origin of the route.

# Display detailed information about BGP IPv6 unicast routes destined to network 2::/64.

<Sysname> display bgp routing-table ipv6 2:: 64

 

 BGP local router ID: 192.168.1.135

 Local AS number: 200

 

 Paths:   2 available, 1 best

 

 BGP routing table information of 2::/64:

 From            : 10.1.1.1 (192.168.1.136)

 Relay nexthop   : ::FFFF:10.1.1.1

 Original nexthop: ::FFFF:10.1.1.1

 OutLabel        : NULL

 RxPathID        : 0x0

 TxPathID        : 0x0

 AS-path         : 100

 Origin          : igp

 Attribute value : MED 0, pref-val 0

 State           : valid, external, best

 IP precedence   : N/A

 QoS local ID    : N/A

 Traffic index   : N/A

 

 From            : 1::1 (192.168.1.136)

 Relay nexthop   : 1::1

 Original nexthop: 1::1

 OutLabel        : NULL

 RxPathID        : 0x0

 TxPathID        : 0x0

 AS-path         : 100

 Origin          : igp

 Attribute value : MED 0, pref-val 0

 State           : valid, external

 IP precedence   : N/A

 QoS local ID    : N/A

 Traffic index   : N/A

Table 34 Command output

Field

Description

Paths

Number of routes:

·         available—Number of valid routes.

·         best—Number of optimal routes.

Original nexthop

Original next hop of the route. If the route was obtained from a BGP update message, the original next hop is the next hop IP address in the message.

OutLabel

This field is not supported in the current software version.

Outgoing label of the route.

RxPathID

Add-Path ID of received routes.

TxPathID

Add-Path ID of advertised routes.

AS-path

AS_PATH attribute of the route, which records the ASs the route has passed and avoids routing loops.

Origin

Origin of the route:

·         igp—Originated in the AS. The origin of routes advertised with the network command is IGP.

·         egp—Learned through EGP.

·         incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is INCOMPLETE.

Attribute value

BGP path attributes:

·         MED—MED value.

·         localprefLocal preference value.

·         pref-val—Preferred value.

·         pre—Route preference.

State

Current state of the route:

·         valid.

·         internal.

·         external.

·         local.

·         best.

From

IP address of the BGP peer that advertised the route.

Relay Nexthop

Next hop found by route recursion. If no next hop is found, this field displays not resolved.

IP precedence

IP precedence in the range of 0 to 7. N/A indicates that the route does not support this field.

QoS local ID

QoS local ID in the range of 1 to 4095. N/A indicates that the route does not support this field.

Traffic index

Traffic index in the range of 1 to 64. N/A indicates that the route does not support this field.

# Display advertisement information for BGP IPv6 unicast routes destined to network 2::/64.

<Sysname> display bgp routing-table ipv6 2:: 64 advertise-info

 

 BGP local router ID: 192.168.1.136

 Local AS number: 100

 

 Paths:   1 best

 

 BGP routing table information of 2::/64(TxPathID:0):

 Advertised to peers (2 in total):

    10.1.1.2

    1::2

Table 35 Command output

Field

Description

Paths

Number of optimal routes destined to the specified network.

BGP routing table information of 2::/64(TxPathID:0)

Advertisement information for BGP routes destined to network 2::/64.

Advertised to peers (2 in total)

Peers to which the route has been advertised, and the number of peers.

# Display statistics for BGP IPv6 unicast routes advertised to peer 1::1.

<Sysname> display bgp routing-table ipv6 peer 1::1 advertised-routes statistics

 

 Advertised routes total: 1

# Display statistics for BGP IPv6 unicast routes received from peer 1::1.

<Sysname> display bgp routing-table ipv6 peer 1::1 received-routes statistics

 

 Received routes total: 1

Table 36 Command output

Field

Description

Advertised routes total

Total number of advertised routes.

Received routes total

Total number of received routes.

# Display BGP IPv6 unicast route statistics.

<Sysname> display bgp routing-table ipv6 statistics

 

 Total number of routes: 4

Table 37 Command output

Field

Description

Total number of routes

Total number of routes.

Related commands

ip as-path

ip community-list

domain-distinguisher

Use domain-distinguisher to specify an AS number and a router ID for BGP LS messages.

Use undo domain-distinguisher to restore the default.

Syntax

domain-distinguisher as-number:router-id

undo domain-distinguisher

Default

The AS number and router ID of the current BGP process are used.

Views

BGP LS address family view

Predefined user roles

network-admin

Parameters

as-number:router-id: Specifies the AS number and router ID. The value range for the as-number argument is 1 to 4294967295, and the router ID is in IP address format.

Examples

# Set the AS number and router ID for BGP LS messages to 65009 and 1.1.1.1, respectively.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family link-state

[Sysname-bgp-default-ls] domain-distinguisher 65009:1.1.1.1

ebgp-interface-sensitive

Use ebgp-interface-sensitive to enable immediate re-establishment of direct EBGP sessions.

Use undo ebgp-interface-sensitive to disable immediate re-establishment of direct EBGP sessions.

Syntax

ebgp-interface-sensitive

undo ebgp-interface-sensitive

Default

Immediate re-establishment of direct EBGP sessions is enabled.

Views

BGP instance view

Predefined user roles

network-admin

Usage guidelines

When a direct link to an EBGP peer fails, BGP tears down the session and re-establishes a session to the peer immediately. If the feature is not enabled, the router does not tear down the session until the hold time expires. However, disabling this feature can prevent routing flaps from affecting EBGP session state.

This command applies only to direct EBGP sessions.

Examples

# Enable immediate re-establishment of direct EBGP sessions.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] ebgp-interface-sensitive

fast-reroute route-policy

Use fast-reroute route-policy to apply a routing policy to fast reroute (FRR) for a BGP address family.

Use undo fast-reroute route-policy to restore the default.

Syntax

fast-reroute route-policy route-policy-name

undo fast-reroute route-policy

Default

No routing policy is applied to FRR.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

Predefined user roles

network-admin

Parameters

route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters.

Usage guidelines

You can use the following methods to configure BGP FRR:

·          Method 1—Execute the pic command in BGP address family view. BGP calculates a backup next hop for a BGP route in the address family if there are two or more unequal-cost routes to reach the destination.

·          Method 2—Execute the fast-reroute route-policy command to use a routing policy in which a backup next hop is specified by using the command apply [ ipv6 ] fast-reroute backup-nexthop. For BGP to generate a backup next hop for the primary route, the backup next hop calculated by BGP must be the same as the specified backup next hop. You can also configure if-match clauses in the routing policy to identify the routes protected by FRR.

If both methods are configured, Method 2 takes precedence over Method 1.

Examples

# Apply routing policy frr-policy to FRR in BGP IPv4 unicast address family view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4

[Sysname-bgp-default-ipv4] fast-reroute route-policy frr-policy

Related commands

apply fast-reroute

apply ipv6 fast-reroute

pic

route-policy

filter-policy export

Use filter-policy export to filter advertised BGP routes.

Use undo filter-policy export to remove the route filter.

Syntax

In BGP IPv4 unicast address family view/BGP-VPN IPv4 unicast address family view/BGP IPv4 multicast address family view:

filter-policy { ipv4-acl-number | prefix-list prefix-list-name } export [ protocol process-id ]

undo filter-policy export [ protocol process-id ]

In BGP IPv6 unicast address family view/BGP-VPN IPv6 unicast address family view/BGP IPv6 multicast address family view:

filter-policy { ipv6-acl-number | prefix-list ipv6-prefix-name } export [ protocol process-id ]

undo filter-policy export [ protocol process-id ]

Default

Advertised BGP routes are not filtered.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

ipv4-acl-number: Specifies an IPv4 ACL by its number in the range of 2000 to 3999, to match routes by destination.

ipv6-acl-number: Specifies an IPv6 ACL by its number in the range of 2000 to 3999, to match routes by destination.

prefix-list prefix-list-name: Specifies an IPv4 prefix list by its name, a case-sensitive string of 1 to 63 characters, to match routes by destination.

prefix-list ipv6-prefix-name: Specifies an IPv6 prefix list by its name, a case-sensitive string of 1 to 63 characters, to match routes by destination.

protocol: Filters routes redistributed from the routing protocol.

process-id: Specifies a routing protocol by its ID in the range of 1 to 65535. For IPv4 routes, this argument is available only when the protocol is isis, ospf, or rip. For IPv6 routes, this argument is available only when the protocol is isisv6, ospfv3, or ripng.

Usage guidelines

If you specify a protocol (such as direct and isis), this command filters only routes redistributed from the specified protocol. If you do not specify a protocol, this command filters all advertised routes, including the following routes:

·          Redistributed from IGP.

·          Injected by the network command.

·          Learned from BGP peers.

If you use a basic ACL (with a number from 2000 to 2999) configured with the rule [ rule-id ] { deny | permit } source source-address source-wildcard command, the command matches routes whose destination network addresses match the source-address source-wildcard argument. However, it does not match the masks of the destination addresses.

To use an advanced ACL (with a number from 3000 to 3999) in the command, configure the ACL using one of the following steps:

·          To deny/permit a route with the specified destination, use the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard command.

·          To deny/permit a route with the specified destination and mask, use the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard destination dest-addr dest-wildcard command.

The source keyword specifies the destination address of a route and the destination keyword specifies the subnet mask of the destination address. For the mask configuration to take effect, specify a contiguous subnet mask.

Examples

# In BGP IPv4 unicast address family view, use IPv4 basic ACL 2000 to filter advertised BGP IPv4 routes.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] filter-policy 2000 export

Related commands

filter-policy import

peer as-path-acl

peer filter-policy

peer prefix-list

peer route-policy

filter-policy import

Use filter-policy import to filter received BGP routes.

Use undo filter-policy import to restore the default.

Syntax

In BGP IPv4 unicast address family view/BGP-VPN IPv4 unicast address family view/BGP IPv4 multicast address family view:

filter-policy { ipv4-acl-number | prefix-list prefix-list-name } import

undo filter-policy import

In BGP IPv6 unicast address family view/BGP-VPN IPv6 unicast address family view/BGP IPv6 multicast address family view:

filter-policy { ipv6-acl-number | prefix-list ipv6-prefix-name } import

undo filter-policy import

Default

Received BGP routes are not filtered.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

ipv4-acl-number: Specifies an IPv4 ACL by its number in the range of 2000 to 3999, to match routes by destination.

ipv6-acl-number: Specifies an IPv6 ACL by its number in the range of 2000 to 3999, to match routes by destination.

prefix-list prefix-list-name: Specifies an IPv4 prefix list by its name, a case-sensitive string of 1 to 63 characters, to match routes by destination.

prefix-list ipv6-prefix-name: Specifies an IPv6 prefix list by its name, a case-sensitive string of 1 to 63 characters, to match routes by destination.

Usage guidelines

If you use a basic ACL (with a number from 2000 to 2999) configured with the rule [ rule-id ] { deny | permit } source source-address source-wildcard command, the command matches routes whose destination network addresses match the source-address source-wildcard argument. However, it does not match the masks of the destination addresses.

To use an advanced ACL (with a number from 3000 to 3999) in the command, configure the ACL using one of the following steps:

·          To deny/permit a route with the specified destination, use the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard command.

·          To deny/permit a route with the specified destination and mask, use the rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard destination dest-addr dest-wildcard command.

The source keyword specifies the destination address of a route and the destination keyword specifies the subnet mask of the destination address. For the mask configuration to take effect, specify a contiguous subnet mask.

Examples

# In BGP IPv4 unicast address family view, use IPv4 basic ACL 2000 to filter received BGP routes.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] filter-policy 2000 import

Related commands

filter-policy export

peer as-path-acl

peer filter-policy

peer prefix-list

peer route-policy

flush suboptimal-route

Use flush suboptimal-route to enable BGP to flush the suboptimal BGP route to the RIB.

Use undo flush suboptimal-route to disable BGP from flushing the suboptimal BGP route to the RIB.

Syntax

flush suboptimal-route

undo flush suboptimal-route

Default

BGP is disabled from flushing the suboptimal BGP route to the RIB. Only the optimal route is flushed to the RIB.

Views

BGP instance view

Predefined user roles

network-admin

Usage guidelines

This command flushes the suboptimal BGP route to the RIB when the following conditions are met:

·          The optimal route is generated by the network command or is redistributed by the import-route command.

·          The suboptimal route is received from a BGP peer.

After the suboptimal route is flushed to the RIB on a network, BGP immediately switches traffic to the suboptimal route when the optimal route fails.

For example, the device has a static route to the subnet 1.1.1.0/24 that has a higher priority than a BGP route. BGP redistributes the static route and receives a route to 1.1.1.0/24 from a peer. After the flush suboptimal-route command is executed, BGP flushes the received BGP route to the RIB as the suboptimal route. When the static route fails, BGP immediately switches traffic to the suboptimal route if inter-protocol FRR is enabled. For more information about inter-protocol FRR, see Layer 3—IP Routing Configuration Guide.

Examples

# Enable BGP to flush the suboptimal BGP route to the RIB.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] flush suboptimal-route

graceful-restart

Use graceful-restart to enable BGP Graceful Restart (GR) capability.

Use undo graceful-restart to disable BGP GR capability.

Syntax

graceful-restart

undo graceful-restart

Default

BGP GR capability is disabled.

Views

BGP instance view

Predefined user roles

network-admin

Usage guidelines

GR ensures continuous forwarding when BGP restarts or an active/standby switchover occurs.

BGP peers exchange Open messages containing GR information. If both parties have GR capability, they establish a GR-capable session.

After you execute this command, the device re-establishes BGP sessions.

Examples

# Enable GR capability for BGP process 100.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] graceful-restart

Related commands

graceful-restart timer purge-time

graceful-restart timer restart

graceful-restart timer wait-for-rib

graceful-restart timer purge-time

Use graceful-restart timer purge-time to set the Routing Information Base (RIB) purge timer.

Use undo graceful-restart timer purge-time to restore the default.

Syntax

graceful-restart timer purge-time timer

undo graceful-restart timer purge-time

Default

The RIB purge timer is 480 seconds.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

timer: Sets the RIB purge timer in the range of 1 to 6000 seconds.

Usage guidelines

BGP starts the RIB purge timer when an active/standby switchover occurs or BGP restarts. If BGP route exchange is not completed within the RIB purge timer, the GR restarter quits the GR process. It updates the RIB with the BGP routes already learned, and removes the stale routes from RIB.

Enable BGP GR before you execute this command.

Set the RIB purge timer to be long enough to complete GR, especially when large numbers of BGP routes exist.

As a best practice, set the RIB purge timer in the following way:

·          Set the timer to be greater than the timer set by the graceful-restart timer wait-for-rib command

·          Set the timer to be less than the timer set by the protocol lifetime command.

Examples

# Set the RIB purge timer to 300 seconds.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] graceful-restart

[Sysname-bgp-default] graceful-restart timer purge-time 300

Related commands

graceful-restart

graceful-restart timer restart

graceful-restart timer wait-for-rib

protocol lifetime (Layer 3—IP Routing Command Reference)

graceful-restart timer restart

Use graceful-restart timer restart to configure the GR timer.

Use undo graceful-restart timer restart to restore the default.

Syntax

graceful-restart timer restart timer

undo graceful-restart timer restart

Default

The GR timer is 150 seconds.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

timer: Specifies the GR timer in the range of 3 to 600 seconds.

Usage guidelines

The GR restarter sends the GR timer to the GR helper in an Open message. When the GR helper detects that an active/standby switchover or a BGP restart occurred on the GR restarter, the GR helper performs the following operations:

1.        Marks all routes learned from the GR restarter as stale.

2.        Starts the GR timer.

3.        If no BGP session is established before the GR timer expires, the GR helper removes the stale routes.

Before you configure this command, enable the BGP GR capability.

To apply a new GR timer, you must re-establish BGP sessions.

Examples

# Set the GR timer to 300 seconds.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] graceful-restart

[Sysname-bgp-default] graceful-restart timer restart 300

Related commands

graceful-restart

graceful-restart timer purge-time

graceful-restart timer wait-for-rib

graceful-restart timer wait-for-rib

Use graceful-restart timer wait-for-rib to configure the time to wait for the End-of-RIB marker.

Use undo graceful-restart timer wait-for-rib to restore the default.

Syntax

graceful-restart timer wait-for-rib timer

undo graceful-restart timer wait-for-rib

Default

The time to wait for the End-of-RIB marker is 600 seconds.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

timer: Specifies the time to wait for the End-of-RIB marker, in the range of 3 to 3600 seconds.

Usage guidelines

BGP uses this timer to control the time to receive updates from the peer. The timer is not advertised to the peer.

After the GR restarter and GR helper re-establish a BGP session, they start this timer. If they do not complete route exchange within the time period, the GR restarter does not receive new routes. It updates its routing table and forwarding table with learned BGP routes, and the GR helper removes the stale routes. Set a large value for the maximum time to wait for the End-of-RIB marker when a large number of routes exist.

This command controls the routing convergence speed. A smaller timer value means faster routing convergence but possibly results in incomplete routing information.

Before configuring this command, you must enable the BGP GR capability.

Examples

# Set the time to wait for the End-of-RIB marker on the local end to 100 seconds.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] graceful-restart

[Sysname-bgp-default] graceful-restart timer wait-for-rib 100

Related commands

graceful-restart

graceful-restart timer purge-time

graceful-restart timer restart

group

Use group to create a peer group.

Use undo group to delete a peer group.

Syntax

group group-name [ external | internal ]

undo group group-name

Default

No peer groups exist.

Views

BGP instance view

BGP-VPN instance view

Predefined user roles

network-admin

Parameters

group-name: Specifies a name for the peer group, a case-sensitive string of 1 to 47 characters.

external: Creates an EBGP peer group.

internal: Creates an IBGP peer group.

Usage guidelines

In a large-scale network, many peers can use the same route selection policy. You can configure a peer group and add these peers into this group. In this way, peers can share the same policy as the peer group. When the policy of the group is modified, the modification also applies to peers in it.

If you do not specify the internal or external keyword, this command creates an IBGP peer group.

If you perform configurations on a peer group and peers of the peer group, the most recent configuration takes effect.

After you create a peer group, you must use the peer enable command to enable BGP to exchange routing information with the specified peer group.

Examples

# In BGP instance view, create EBGP peer group test with AS number 200, and add EBGP peers 10.1.1.1 and 10.1.2.1 into the group.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] group test external

[Sysname-bgp-default] peer test as-number 200

[Sysname-bgp-default] peer 10.1.1.1 group test

[Sysname-bgp-default] peer 10.1.2.1 group test

Related commands

display bgp group

peer enable

ignore all-peers

Use ignore all-peers to disable BGP session establishment with all peers and peer groups.

Use undo ignore all-peers to restore the default.

Syntax

ignore all-peers [ graceful graceful-time { community { community-number | aa:nn } | local-preference preference | med med } * ]

undo ignore all-peers

Default

BGP can establish sessions to all peers and peer groups.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

graceful graceful-time: Gracefully shuts down BGP sessions to all peers and peer groups in the specified graceful shutdown period of time. The value range for the graceful-time argument is 60 to 65535 seconds. If you do not specify this option, the command immediately shuts down the sessions to all peers and peer groups.

community { community-number | aa:nn }: Specifies the community attribute for routes advertised to all peers and peer groups. The community-number argument represents the community sequence number in the range of 1 to 4294967295. The aa:nn argument represents the community number. Both aa and nn are in the range of 0 to 65535. If you do not specify this option, the command does not change the community attribute for routes advertised to all peers and peer groups.

local-preference preference: Specifies the local preference for routes advertised to all peers and peer groups, in the range of 0 to 4294967295. A larger value represents a higher preference. If you do not specify this option, the command does not change the local preference for routes advertised to all peers and peer groups.

med med: Specifies the MED value for routes advertised to all peers and peer groups, in the range of 0 to 4294967295. The smaller the MED value, the higher the route priority. If you do not specify this option, the command does not change the MED value for routes advertised to all peers and peer groups.

Usage guidelines

This command enables you to temporarily tear down the BGP sessions to all peers and peer groups. You can perform network upgrade and maintenance without needing to delete and reconfigure the peers and peer groups. To recover the sessions, execute the undo ignore all-peers command.

If sessions have been established to all peers and peer groups, executing the ignore all-peers command disables the sessions to all peers and peer groups and clears all related routing information.

If you specify the graceful keyword in the ignore all-peers command, BGP performs the following tasks:

·          Gracefully shuts down the sessions to all peers and peer groups in the specified graceful shutdown period of time.

·          Advertises all routes to all peers and peer groups and changes the attribute for the advertised routes to the specified value.

For a BGP peer or peer group, the configuration made by the peer ignore command takes precedence over the configuration made by the ignore all-peers command.

Examples

# In BGP instance view, configure BGP to gracefully shut down the sessions to all peers and peer groups in 60 seconds, advertise all routes to all peers and peer groups, and change the community attribute and local preference for the advertised routes to 1:1 and 200, respectively.

<Sysname> system-view

[Sysname] bgp 1

[Sysname-bgp-default] ignore all-peers graceful 60 community 1:1 local-preference 200

Related commands

peer ignore

ignore-first-as

Use ignore-first-as to configure BGP to ignore the first AS number of EBGP route updates.

Use undo ignore-first-as to restore the default.

Syntax

ignore-first-as

undo ignore-first-as

Default

BGP checks the first AS number of a received EBGP route update. If the first AS number is neither that of the BGP peer nor a private AS number, the BGP router disconnects the BGP session to the peer.

Views

BGP instance view

Predefined user roles

network-admin

Examples

# Configure BGP to ignore the first AS number of EBGP route updates.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] ignore-first-as

import-route

Use import-route to enable BGP to redistribute routes from an IGP protocol.

Use undo import-route to disable route redistribution from an IGP protocol.

Syntax

In BGP IPv4 unicast address family view/BGP-VPN IPv4 unicast address family view/BGP IPv4 multicast address family view:

import-route { isis | ospf | rip } [ { process-id | all-processes } [ allow-direct | med med-value | route-policy route-policy-name ] * ]

import-route { direct | static } [ med med-value | route-policy route-policy-name ]

undo import-route { direct | { isis | ospf | rip } [ process-id | all-processes ] | static }

In BGP IPv6 unicast address family view/BGP-VPN IPv6 unicast address family view/BGP IPv6 multicast address family view:

import-route { isisv6 | ospfv3 | ripng } [ { process-id | all-processes } [ allow-direct | med med-value | route-policy route-policy-name ] * ]

import-route { direct | static } [ med med-value | route-policy route-policy-name ]

undo import-route { direct | { isisv6 | ospfv3 | ripng } [ process-id | all-processes ] | static }

Default

BGP does not redistribute IGP routes.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

direct: Redistributes direct routes.

isis: Redistributes IS-IS routes.

isisv6: Redistributes IPv6 IS-IS routes.

ospf: Redistributes OSPF routes.

ospfv3: Redistributes OSPFv3 routes.

rip: Redistributes RIP routes.

ripng: Redistributes RIPng routes.

static: Redistributes static routes.

process-id: Specifies a process by its ID in the range of 1 to 65535. The default is 1. For IPv4 routes, it is available only when the protocol is isis, ospf, or rip. For IPv6 routes, it is available only when the protocol is isisv6, ospfv3, or ripng.

all-processes: Redistributes routes from all the processes of the specified IGP protocol.

allow-direct: Redistributes the networks of the local interfaces enabled with the specified routing protocol. By default, the networks of the local interfaces are not redistributed. If you specify both the allow-direct keyword and the route-policy route-policy-name option, make sure the if-match rule defined in the routing policy does not conflict with the allow-direct keyword. For example, if you specify the allow-direct keyword, do not configure the if-match route-type rule for the routing policy. Otherwise, the allow-direct keyword does not take effect.

med med-value: Specifies a MED value for redistributed routes, in the range of 0 to 4294967295. If you do not specify an MED, the metric of a redistributed route is used as its MED.

route-policy route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters, to filter redistributed routes or set route attributes for redistributed routes.

Usage guidelines

The import-route command cannot redistribute default IGP routes. To redistribute default IGP routes, use the default-route imported command together with the import-route command.

Only active routes can be redistributed. You can use the display ip routing-table protocol or display ipv6 routing-table protocol command to view route state information.

The ORIGIN attribute of routes redistributed by the import-route command is INCOMPLETE.

Examples

# In BGP IPv4 unicast address family view, redistribute routes from RIP process 1, and set the MED value for redistributed routes to 100.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] import-route rip 1 med 100

Related commands

display ip routing-table protocol

display ipv6 routing-table protocol

ip vpn-instance (BGP instance view)

Use ip vpn-instance to create a BGP-VPN instance and enter its view, or enter the view of an existing BGP-VPN instance.

Use undo ip vpn-instance to remove a BGP-VPN instance and all its configurations.

Syntax

ip vpn-instance vpn-instance-name

undo ip vpn-instance vpn-instance-name

Default

No BGP-VPN instances exist.

Views

BGP instance view

Predefined user roles

network-admin

Parameters

vpn-instance-name: Specifies a VPN instance by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

After you create a BGP peer in BGP-VPN instance view, the BGP routes learned from the peer are added into the routing table of the specified VPN instance.

This command and all commands in BGP-VPN instance view are typically executed on provider edge (PE) or Multi-VPN-Instance CE (MCE) devices. The commands add routes learned from different sites into different VPN instances.

Before you execute this command, you must perform the following tasks:

·          Use the ip vpn-instance command to create the VPN instance in system view.

·          Use the route-distinguisher command to configure a route distinguisher (RD) for the VPN instance.

Examples

# Create a BGP-VPN instance and enter its view.

<Sysname> system-view

[Sysname] ip vpn-instance vpn1

[Sysname-vpn-instance-vpn1] route-distinguisher 100:1

[Sysname-vpn-instance-vpn1] quit

[Sysname] bgp 100

[Sysname-bgp-default] ip vpn-instance vpn1

[Sysname-bgp-default-vpn1]

Related commands

ip vpn-instance (system view)(MCE Command Reference)

route-distinguisher (MCE Command Reference)

log-peer-change

Use log-peer-change to enable logging for BGP session state changes globally.

Use undo log-peer-change to disable logging for BGP session state changes globally.

Syntax

log-peer-change

undo log-peer-change

Default

Logging for BGP session state changes is enabled globally.

Views

BGP instance view

Predefined user roles

network-admin

Usage guidelines

After you execute both the log-peer-change and peer log-change commands, BGP logs session establishment and disconnection events for the peer or peer group. To display the log information, use the display bgp peer ipv4 unicast log-info command or the display bgp peer ipv6 unicast log-info command. The logs are sent to the information center of the device. The output rules of the logs (whether to output the logs and where to output) are determined by the information center configuration. For more information about information center configuration, see Network Management and Monitoring Configuration Guide.

If you disable logging for BGP session state changes globally or disable logging for a peer or peer group, BGP does not generate logs for session establishments and disconnections.

Examples

# Enable logging for session state changes globally.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] log-peer-change

Related commands

display bgp peer

peer log-change

log-route-flap

Use log-route-flap to enable logging for BGP route flapping.

Use undo log-route-flap to restore the default.

Syntax

log-route-flap monitor-time monitor-count [ log-count-limit | route-policy route-policy-name ] *

undo log-route-flap

Default

Logging for BGP route flapping is disabled.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

monitor-time: Specifies the monitoring interval for route flapping, in the range of 1 to 600 minutes.

monitor-count: Specifies the number of route flaps for triggering a log, in the range of 2 to 8.

log-count-limit: Specifies the maximum number of logs allowed to be generated in a minute. The value range for this argument is 1 to 600, and the default value is 200.

route-policy route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters.

Usage guidelines

This feature enables BGP to generate logs for BGP route flappings that trigger log generation. The generated logs are sent to the information center. For the logs to be output correctly, you must also configure information center on the device. For more information about the information center, see Network Management and Monitoring Configuration Guide.

This command is applicable only to incoming routes of the specified address family.

Examples

# In BGP IPv4 unicast address family view, enable logging for BGP route flapping. Set the monitoring interval to 10 minutes, the number of route flaps for triggering a log to 5, and the maximum number of allowed logs in a minute to 100.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] log-route-flap 10 5 100

network

Use network to inject a network to the BGP routing table and configure BGP to advertise the network.

Use undo network to remove a local network.

Syntax

In BGP IPv4 unicast address family view/BGP-VPN IPv4 unicast address family view/BGP IPv4 multicast address family view:

network ipv4-address [ mask-length | mask ] [ route-policy route-policy-name ]

undo network ipv4-address [ mask-length | mask ]

In BGP IPv6 unicast address family view/BGP-VPN IPv6 unicast address family view/BGP IPv6 multicast address family view:

network ipv6-address prefix-length [ route-policy route-policy-name ]

undo network ipv6-address prefix-length

Default

BGP does not advertise local networks.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

ipv4-address: Specifies an IPv4 network address. If you do not specify the mask or mask-length argument, natural mask is used.

mask-length: Specifies a mask length in the range of 0 to 32.

mask: Specifies a mask in dotted decimal notation.

ipv6-address: Specifies an IPv6 network address.

prefix-length: Specifies a prefix length in the range of 0 to 128.

route-policy route-policy-name: Specifies a routing policy by its name, a case-sensitive string of 1 to 63 characters, to filter routes or set the route attributes.

Usage guidelines

The network to be injected must be available and active in the local IP routing table.

The ORIGIN attribute of the route injected with the network command is IGP.

When you execute the undo network command, you must specify the same mask or mask length/prefix length that you specified for the network command. Otherwise, the configuration cannot be removed.

Examples

# In BGP IPv4 unicast address family view, inject local network 10.0.0.0/16 to the BGP routing table.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] network 10.0.0.0 255.255.0.0

network short-cut

Use network short-cut to increase the preference for a received EBGP route. This EBGP route is called a shortcut route.

Use undo network short-cut to remove the configuration.

Syntax

In BGP IPv4 unicast address family view/BGP-VPN IPv4 unicast address family view/BGP IPv4 multicast address family view:

network ipv4-address [ mask-length | mask ] short-cut

undo network ipv4-address [ mask-length | mask ] short-cut

In BGP IPv6 unicast address family view/BGP-VPN IPv6 unicast address family view/BGP IPv6 multicast address family view:

network ipv6-address prefix-length short-cut

undo network ipv6-address prefix-length short-cut

Default

A received EBGP route has a preference of 255.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

BGP IPv4 multicast address family view

BGP IPv6 multicast address family view

Predefined user roles

network-admin

Parameters

ipv4-address: Specifies an IPv4 network address. If you do not specify the mask or mask-length argument, natural mask is used.

mask-length: Specifies a mask length in the range of 0 to 32.

mask: Specifies a mask for the network address, in dotted decimal notation.

ipv6-address: Specifies an IPv6 network address.

prefix-length: Specifies a prefix length in the range of 0 to 128.

Usage guidelines

Different routing protocols might find different routes to the same destination. However, not all of those routes are optimal. For route selection, routing protocols, direct routes, and static routes are assigned different preferences. The route with the highest preference is preferred.

By default, the preference of an EBGP route is lower than a local route. If a device has an EBGP route and a local route to reach the same destination, the device does not select the EBGP route. You can use the network shortcut command to configure the EBGP route to have the same preference as the local route so the EBGP route is more likely to become the optimal route.

You can use the preference command to modify the preferences for external and local BGP routes.

Examples

# In BGP IPv4 unicast address family view, increase the preference of EBGP route 10.0.0.0/16.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] network 10.0.0.0 255.255.0.0 short-cut

Related commands

preference

non-stop-routing

Use non-stop-routing to enable BGP nonstop routing (NSR).

Use undo non-stop-routing to disable BGP NSR.

Syntax

non-stop-routing

undo non-stop-routing

Default

BGP NSR is disabled.

Views

BGP instance view

Predefined user roles

network-admin

Usage guidelines

BGP NSR ensures continuous routing by synchronizing BGP state and data information from the active BGP process to the standby BGP process. The standby BGP process can seamlessly take over all services when the active process fails.

Examples

# Enable BGP NSR.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] non-stop-routing

Related commands

display bgp non-stop-routing status

peer additional-paths

Use peer additional-paths to configure the BGP additional path capabilities.

Use undo peer additional-paths to remove the configuration.

Syntax

In BGP IPv4 unicast address family view/BGP-VPN IPv4 unicast address family view:

peer { group-name | ipv4-address [ mask-length ] } additional-paths { receive | send } *

undo peer { group-name | ipv4-address [ mask-length ] } additional-paths { receive | send } *

In BGP IPv6 unicast address family view:

peer { group-name | ipv6-address [ prefix-length ] } additional-paths { receive | send } *

undo peer { group-name | ipv6-address [ prefix-length ] } additional-paths { receive | send } *

In BGP-VPN IPv6 unicast address family view:

peer { group-name | ipv6-address [ prefix-length ] } additional-paths { receive | send } *

undo peer { group-name | ipv6-address [ prefix-length ] } additional-paths { receive | send } *

Default

No BGP additional path capabilities are configured.

Views

BGP IPv4 unicast address family view

BGP-VPN IPv4 unicast address family view

BGP IPv6 unicast address family view

BGP-VPN IPv6 unicast address family view

Predefined user roles

network-admin

Parameters

group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The peer group must have been created.

ipv4-address: Specifies a peer by its IPv4 address. The peer must have been created.

mask-length: Specifies a mask length in the range of 0 to 32. You can use the ipv4-address and mask-length arguments together to specify a subnet. If you specify a subnet, this command configures the BGP additional path capabilities for all dynamic peers in the subnet.

ipv6-address: Specifies a peer by its IPv6 address. The peer must have been created.

prefix-length: Specifies a prefix length in the range of 0 to 128. You can use the ipv6-address and prefix-length arguments together to specify a subnet. If you specify a subnet, this command configures the BGP additional path capabilities for all dynamic peers in the subnet.

receive: Enables the BGP additional path receiving capability.

send: Enables the BGP additional path sending capability.

Usage guidelines

You can enable the BGP additional path sending, receiving, or both sending and receiving capabilities on a BGP router. For two BGP peers to successfully negotiate the additional path capabilities, make sure one end has the sending capability and the other end has the receiving capability.

Examples

# In BGP IPv4 unicast address family view, enable the BGP additional path receiving capability.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 unicast

[Sysname-bgp-default-ipv4] peer 1.1.1.1 additional-paths receive

peer advertise additional-paths best

Use peer advertise additional-paths best to set the maximum number of Add-Path optimal routes that can be advertised to a peer or peer group.

Use undo peer advertise additional-paths best to remove the configuration.

Syntax

In BGP IPv4 unicast address family view/BGP-VPN IPv4 unicast address family view:

peer { group-name