本命令用来手动聚合BGP路由。如果BGP路由表中存在属于指定的聚合路由的更具体的路由，即存在目的网络地址属于聚合路由的目的网络地址、且掩码长度大于聚合路由掩码长度的路由，则会在BGP路由表中添加该聚合路由。例如，BGP路由表中存在目的网络地址为10.1.1.0/24和10.1.2.0/24的路由，则配置aggregate 10.1.0.0 16命令后，会生成到达目的网络10.1.0.0/16的聚合路由。

如果参与聚合的具体路由所包含的Origin属性不同，那么聚合路由按照Incomplete、EGP、IGP的顺序选择Origin属性。例如，存在Origin属性为Incomplete和IGP的具体路由时，聚合路由的Origin属性为Incomplete。

如果参与聚合的具体路由包含不同的团体属性（或扩展团体属性）值，且聚合后的路由中不包含ATOMIC_AGGREGATE属性（原子聚合属性），则生成的聚合路由的团体属性（或扩展团体属性）中携带所有的团体属性（或扩展团体属性）值。

本命令中各参数的用法及注意事项如表1-1所示。

表1-1 参数的用法及注意事项

参数	用法及注意事项
as-set	如果指定了该参数，则可以通过AS_PATH属性中携带的AS号避免路由环路。当聚合的具体路由的AS路径信息较多时，如果具体路由的变化较频繁，则指定as-set参数会导致聚合路由随之频繁改变，引起路由震荡。在这种情况下，不建议指定as-set参数
detail-suppressed	该参数用来抑制所有具体路由的通告。如果只想对一部分具体路由进行抑制，可以使用本命令中的suppress-policy参数或peer filter-policy命令

【举例】

# 在BGP IPv4单播地址族视图下，配置在BGP路由表中创建一条聚合路由1.1.0.0/16。

<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

【相关命令】

· display bgp routing-table ipv4 unicast

· display bgp routing-table ipv6 unicast

· summary automatic

1.1.5 bgp

bgp命令用来启动指定的BGP实例，并进入BGP实例视图。

undo bgp命令用来关闭指定的BGP实例。

【命令】

bgp as-number [ instance instance-name ]

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

【缺省情况】

没有运行BGP，不存在BGP实例。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

as-number：本地AS号，取值范围为1～4294967295。

instance instance-name：启动指定BGP实例。instance-name表示BGP实例名称，为1～31个字符的字符串，区分大小写。如果不指定本参数，则表示启动default实例。

【使用指导】

路由器支持四字节AS号。

一台BGP路由器上可以同时启动多个BGP进程，每个BGP进程对应一个BGP实例。BGP为不同的BGP实例维护独立的路由表。

【举例】

# 启动实例default，指定该BGP实例的本地AS号为100，并进入BGP实例视图。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default]

1.1.6 bgp update-delay on-startup

bgp update-delay on-startup命令用来配置设备重启且BGP进程恢复后，延迟发布路由更新消息。

undo bgp update-delay on-startup命令用来恢复缺省情况。

【命令】

bgp update-delay on-startup seconds

undo bgp update-delay on-startup

【缺省情况】

设备重启且BGP进程恢复后，立刻向Established状态的BGP邻居发布路由更新消息。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【参数】

seconds：设备重启且BGP进程恢复后，发送更新消息的延迟时间，取值范围为0～3600，单位为秒。取值为0表示一直不发布路由更新消息。

【使用指导】

配置了本命令时，在经过了重启且BGP进程恢复后，设备不能立刻向邻居发布更新消息，而是在一段延迟时间之后才能发送。这段延迟时间的作用是，设备重启后可以等待路由接收完成并优选后再向其他设备发布，以避免设备重启后路由信息不全，就发布给其他设备导致流量丢失的情况。

【举例】

# 在BGP实例视图下，配置设备重启且BGP进程恢复后，经过100秒的延迟时间才能发送更新消息。

<Sysname> system-view

[Sysname] bgp 100

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

【相关命令】

· bgp update-delay on-startup prefix-list

1.1.7 bgp update-delay on-startup prefix-list

bgp update-delay on-startup prefix-list命令用来配置通过前缀列表控制BGP更新消息延迟发布。

undo bgp update-delay on-startup prefix-list命令用来恢复缺省情况。

【命令】

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

undo bgp update-delay on-startup prefix-list

【缺省情况】

未配置通过前缀列表控制BGP更新消息延迟发布。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【参数】

ipv4-prefix-list-name：IPv4地址前缀列表名称，为1～63个字符的字符串，区分大小写。

【使用指导】

配置bgp update-delay on-startup命令后，如果需要部分路由前缀不受延迟发布控制，可以使用前缀列表进行控制，通过过滤的路由不受延迟发布的影响。

目前只支持IPv4地址前缀列表。

【举例】

# 在BGP实例视图下，配置设备重启且BGP进程恢复后，发布路由更新消息的延迟时间为100秒，并配置通过IPv4地址前缀列表aaa过滤的路由不受延迟发布的影响。

<Sysname> system-view

[Sysname] bgp 100

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

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

【相关命令】

· bgp update-delay on-startup

1.1.8 default-route imported

default-route imported命令用来允许将缺省路由引入到BGP路由表中。

undo default-route imported命令用来恢复缺省情况。

【命令】

default-route imported

undo default-route imported

【缺省情况】

BGP不允许将缺省路由引入到BGP路由表中。

【视图】

BGP IPv4单播地址族视图

BGP IPv6单播地址族视图

【缺省用户角色】

network-admin

【使用指导】

执行import-route命令引入IGP路由时，缺省情况下不会将IGP的缺省路由引入到BGP路由表中。如果执行import-route命令的同时，执行了default-route imported命令，则IGP的缺省路由可以引入到BGP路由表中。

【举例】

# 在BGP IPv4单播地址族视图下，配置允许将OSPF进程1的缺省路由引入到BGP路由表中。

<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

【相关命令】

· import-route

1.1.9 display bgp group

display bgp group命令用来显示BGP对等体组的信息。

【命令】

display bgp [ instance instance-name ] group ipv4 [ unicast ] [ group-name group-name ]

display bgp [ instance instance-name ] group ipv6 [ unicast ] [ group-name group-name ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

instance instance-name：显示指定BGP实例的信息。instance-name表示BGP实例的名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则显示default实例的信息。

ipv4：显示BGP IPv4对等体组的信息。

ipv6：显示BGP IPv6对等体组的信息。

unicast：显示BGP单播对等体组的信息。

group-name group-name：显示指定BGP对等体组的详细信息，group-name为BGP对等体组的名称，为1～47个字符的字符串，区分大小写。如果没有指定本参数，则显示指定地址族所有BGP对等体组的简要信息。

【使用指导】

如果没有指定unicast参数，则缺省为unicast。

【举例】

# 显示所有BGP IPv4单播对等体组的简要信息。

<Sysname> display bgp group ipv4

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

# 显示BGP IPv4单播对等体组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

# 显示BGP IPv6单播对等体组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

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

表1-2 display bgp group命令输出信息描述表

字段	描述
BGP peer group	BGP对等体组名称
Remote AS	对等体组的AS号
Type	对等体组类型，取值包括： · external：表示EBGP对等体组 · internal：表示IBGP对等体组
Maximum number of prefixes allowed	允许从对等体学习的最大路由数
Threshold	路由器产生日志信息的阈值，即从对等体接收的路由前缀数量与允许的最大路由数的百分比达到此值时，路由器将产生日志信息
Configured hold time	配置的保持时间间隔，单位为秒
Keepalive time	存活时间间隔，单位为秒
Minimum time between advertisements	路由发布的最小时间间隔，单位为秒
Peer preferred value	为来自对等体的路由指定的首选值
Site-of-Origin	为对等体组指定的SoO属性值
Routing policy configured	（暂不支持）为对等体组指定的路由策略如果未指定路由策略，则显示为No routing policy is configured
Members	对等体组包括的对等体信息
* - Dynamically created peer	如果对等体的地址前存在“*”，则表示该对等体为动态创建的对等体
Peer	对等体的IPv4地址或IPv6地址
AS	对等体所在的自治系统号
MsgRcvd	从该对等体收到的消息数目
MsgSent	向该对等体发送的消息数目
OutQ	等待发往该对等体的消息数目
PrefRcv	对于IPv4和IPv6地址族，表示从该对等体收到的前缀数目
Up/Down	BGP会话处于当前状态的时长
State	该对等体的状态

1.1.10 display bgp instance-info

display bgp instance-info命令用来显示所有BGP实例的信息。

【命令】

display bgp instance-info

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示所有BGP实例的信息。

<Sysname> display bgp instance-info

Total BGP instances: 3

BGP instance name AS

BGP1 100

BGP2 200

BGP3 300

表1-3 display bgp instance-info命令输出信息描述表

字段	描述
Total BGP instances	BGP实例总数
BGP instance name	BGP实例名称
AS	BGP实例对应的AS号

1.1.11 display bgp network

display bgp network命令用来显示通过network命令发布的路由信息。

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

ipv4：显示IPv4地址族的信息。

ipv6：显示IPv6地址族的信息。

unicast：显示BGP单播地址族的信息。

【使用指导】

如果没有指定unicast参数，则缺省为unicast。

【举例】

# 显示BGP IPv4单播地址族下所有通过network命令通告的路由信息。

<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

# 显示BGP IPv6单播地址族下所有通过network命令通告的路由信息。

<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

表1-4 display bgp network命令显示信息描述表

字段	描述
BGP local router ID	本地的路由器ID
Local AS number	本地的AS号
Network	通过network命令发布的路由的目的网络地址
Mask	目的网络地址的掩码
PrefixLen	目的网络地址的前缀长度
Route-policy	为该路由应用的路由策略
Short-cut	（暂不支持）该路由是否为Short-cut路由，取值包括Yes和No

1.1.12 display bgp paths

display bgp paths命令用来显示BGP的路由属性信息。

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

as-regular-expression：显示AS路径与指定正则表达式匹配的BGP路由属性的信息。as-regular-expression表示正则表达式，为1～256个字符的字符串。如果不指定本参数，则显示所有的BGP路由属性信息。

【举例】

# 显示所有的BGP路由属性信息。

<Sysname> display bgp paths

RefCount MED Path/Origin

3 0 ?

2 0 100i

3 0 100i

1 0 ?

表1-5 display bgp paths命令显示信息描述表

字段	描述
RefCount	使用该路由属性的BGP路由条数
MED	MED属性值
Path/Origin	路由的AS路径（AS_PATH）属性和路由信息的来源（ORIGIN）属性，其中： · AS_PATH属性记录了此路由经过的所有AS，可以避免路由环路的出现 · ORIGIN属性标记了此路由如何成为BGP路由，取值包括： ¡ i：表示路由产生于本AS内。通过network命令发布路由的路由信息来源为IGP ¡ e：表示路由是通过EGP（Exterior Gateway Protocol，外部网关协议）学到的 ¡ ?：表示路由的来源无法确定。从IGP协议引入路由的路由信息来源为incomplete

1.1.13 display bgp peer

display bgp peer命令用来显示BGP对等体或对等体组的状态和统计信息。

【命令】

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

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

display bgp [ instance instance-name ] peer ipv4 [ unicast ] [ ipv6-address prefix-length | ipv6-address log-info | [ ipv6-address ] verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

ipv4：显示BGP IPv4对等体或对等体组的信息。

ipv6：显示BGP IPv6对等体或对等体组的信息。

unicast：显示BGP单播对等体或对等体组的信息。

ipv4-address mask-length：显示指定网段内的动态对等体的信息。ipv4-address为对等体的IPv4地址；mask-length为网络掩码，取值范围为0～32。

ipv4-address：显示指定对等体的信息。ipv4-address为对等体的IPv4地址。

ipv6-address prefix-length：显示指定网段内的动态对等体的信息。ipv6-address为对等体的IPv6地址；prefix-length为前缀长度，取值范围为0～128。

ipv6-address：显示指定对等体的信息。ipv6-address为对等体的IPv6地址。

group-name group-name：显示指定对等体组内对等体的信息。group-name为对等体组的名称，为1～47个字符的字符串，区分大小写。

log-info：显示指定对等体或对等体组的日志信息。

verbose：显示对等体的详细信息。如果不指定本参数，则显示对等体的简要信息。

【使用指导】

如果没有指定任何参数，则显示指定地址族所有BGP对等体的简要信息。

如果没有指定unicast参数，则缺省为unicast。

【举例】

# 显示所有BGP IPv4单播对等体的简要信息。

<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

表1-6 display bgp peer命令显示信息描述表

字段	描述
BGP local router ID	本地的路由器ID
Local AS number	本地的AS号
Total number of peers	对等体的总数
Peers in established state	处于Established状态的对等体的总数
* - Dynamically created peer	如果对等体的地址前存在“*”，则表示该对等体为动态创建的对等体
Peer	对等体的IPv4地址或IPv6地址
AS	对等体所在的AS号
MsgRcvd	从对等体接收的消息数目
MsgSent	向对等体发送的消息数目
OutQ	等待发往对等体的消息数目
PrefRcv	对于IPv4和IPv6地址族，表示从对等体接收到的加入到本地BGP路由表中的前缀数目
Up/Down	BGP会话处于当前状态的时长
State	本地路由器与该对等体之间BGP会话的当前状态

# 显示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

Address family IPv4 Label: Configured

Address family IPv6 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

# 显示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

表1-7 display bgp peer命令显示信息描述表（动态对等体）

字段	描述
Type	本地路由器与该动态对等体之间的BGP连接类型，取值包括： · IBGP link：IBGP连接 · EBGP link：EBGP连接
Dynamic address range	动态对等体的地址范围
Configured	本地配置的定时器值，包括会话保持时间间隔（Active Hold Time）和存活时间间隔（Keepalive Time），单位为秒
Address family IPv4 Unicast	IPv4单播地址族能力
Address family IPv6 Unicast	IPv6单播地址族能力
Maximum allowed prefix number	允许从对等体学习的最大路由数
Threshold	路由器产生日志信息的阈值，即从对等体接收的路由数量与允许的最大路由数的百分比达到此值时，路由器将产生日志信息
Minimum time between advertisements	路由发布最小时间间隔，单位为秒
Optional capabilities	本端支持的可选扩展能力
Multi-protocol extended capability has been enabled	本端支持BGP多协议扩展能力
Route refresh capability has been enabled	本端支持BGP路由刷新能力
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	允许本地路由器同非直连网络上的邻居建立EBGP会话
Peer Preferred Value	为来自对等体的路由配置的首选值
BFD	是否配置通过BFD检测本地路由器和指定BGP对等体之间的链路
Site-of-Origin	为对等体指定的SoO属性值
Routing policy configured	（暂不支持）为对等体指定的路由策略如果未指定路由策略，则显示为No routing policy is configured
Dynamic peers	动态对等体中包括的对等体的地址

# 显示BGP IPv4单播对等体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 supports BGP multi-protocol extension

Peer supports BGP route refresh capability

Peer supports 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

# 显示BGP IPv6单播对等体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 supports BGP multi-protocol extension

Peer supports BGP route refresh capability

Peer supports 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

Site-of-Origin: Not specified

Routing policy configured:

No routing policy is configured

表1-8 display bgp peer verbose命令显示信息描述表

字段	描述
Peer	对等体的IPv4地址或IPv6地址
Local	本地的路由器ID
Type	本地路由器与该对等体之间的BGP连接类型，取值包括： · IBGP link：IBGP连接 · EBGP link：EBGP连接
BGP version	协议版本号
remote router ID	对等体的路由器ID
BGP current state	本地路由器与该对等体之间BGP会话的当前状态
Up for	BGP会话建立的持续时间
BGP current event	本地路由器与该对等体之间BGP会话的当前事件
BGP last state	BGP会话的前一个状态
Port	建立TCP连接时本地（Local）和对等体（Remote）使用的端口号
Configured	本地配置的定时器值，包括会话保持时间间隔（Active Hold Time）和存活时间间隔（Keepalive Time），单位为秒
Received	收到的定时器值，即对等体上配置的定时器值，包括会话保持时间间隔（Active Hold Time），单位为秒
Negotiated	协商后的定时器值，包括会话保持时间间隔（Active Hold Time）和存活时间间隔（Keepalive Time），单位为秒
Peer optional capabilities	对等体支持的可选扩展能力
Peer supports BGP multi-protocol extension	对等体支持BGP多协议扩展能力
Peer supports BGP route refresh capability	对等体支持BGP路由刷新能力
Peer supports BGP route AS4 capability	对等体支持四字节AS号能力
Address family IPv4 Unicast	IPv4单播地址族能力，可以接收（received）和发送（advertised）该地址族的路由
Address family IPv6 Unicast	IPv6单播地址族能力，可以接收（received）和发送（advertised）该地址族的路由
InQ updates	待处理的接收到的Update消息数目
OutQ updates	等待发送给对等体的Update消息数目
NLRI statistics	NLRI统计信息，包括建立BGP会话后，从对等体累计接收到的可达路由数目和不可达路由数目，向对等体累计发送的可达路由数目和不可达路由数目
Message statistics	BGP消息统计信息
Msg type	BGP消息类型
Last rcvd time/Last sent time	最近一次从对等体接收到BGP消息的时间/最近一次向对等体发送BGP消息的时间
Current rcvd count/Current sent count	在当前BGP会话上，从对等体接收到的BGP消息数目/在当前BGP会话上，向对等体发送的BGP消息数目
History rcvd count/History sent count	配置BGP对等体以来，累计从对等体接收到的BGP消息数目/累计向对等体发送的BGP消息数目
Total	接收/发送所有类型消息的总数
Maximum allowed prefix number	允许从对等体学习的最大路由数
Threshold	路由器产生日志信息的阈值，即从对等体接收的路由数量与允许的最大路由数的百分比达到此值时，路由器将产生日志信息
Minimum time between advertisements	路由发布最小时间间隔，单位为秒
Optional capabilities	本端支持的可选扩展能力
Multi-protocol extended capability has been enabled	本端支持BGP多协议扩展能力
Route refresh capability has been enabled	本端支持BGP路由刷新能力
Peer Preferred Value	为来自对等体的路由配置的首选值
the maximum number of hops	指定对等体到达本地设备的最大跳数
BFD	是否配置通过BFD检测本地路由器和指定BGP对等体之间的链路
Site-of-Origin	为对等体指定的SoO属性值
Routing policy configured	（暂不支持）为对等体指定的路由策略如果未指定路由策略，则显示为No routing policy is configured

# 显示BGP IPv4单播对等体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

表1-9 display bgp peer log-info命令显示信息描述表

字段	描述
Peer	对等体的IPv4地址或IPv6地址
Date	发送或接收到Notification消息的日期
Time	发送或接收到Notification消息的时间
State	本地与对等体之间BGP会话的状态，取值包括： · Up：表示BGP会话处于Established状态 · Down：表示BGP会话断开
Notification Error/SubError	Notification消息中的错误码，表明了BGP会话处于Down状态的原因 Error表示Notification消息差错码，指定错误类型；SubError表示Notification消息差错子码，指定错误类型的详细信息如果是本端发送Notification消息通知对等体邻居异常断开，则会显示邻居断开的详细原因（详见表1-10）

表1-10 邻居断开的详细原因列表

差错码/差错子码	邻居断开的详细原因	说明
1/1	connection not synchronized	连接不同步，目前实现为收到的报文的报文头前16字节不全为F
1/2	bad message length	报文长度无效
1/3	bad message type	报文的类型无效
3/1	the withdrawn length is too large	撤销信息长度过长
	the attribute length is too large	属性长度过长
	one attribute appears more than once	同一个属性在一个Update消息中出现了多次
	the attribute length is too small	属性长度字段不足2字节
	exntended length field is less than two octets	属性长度为可扩展长度，但长度字段不足2字节
	the length field is less than one octet	属性长度为正常长度，但长度字段不足1字节
	link-state attribute error	链路状态属性形式错误
3/2	unrecognized well-known attribute	不支持的公认属性
3/3	attribute-type attribute missed	attribute-type类型的属性丢失，attribute-type取值包括： · ORIGIN · AS_PATH · LOCAL_PREF · NEXT_HOP
3/4	attribute flags error	属性标记错误
3/5	attribute-type attribute length error	attribute-type类型的属性长度错误，attribute-type取值包括： · AS_PATH · AS4_PATH · CLUSTER_LIST · AGGREGATOR · AS4_AGGREGATOR · ORIGIN · NEXT_HOP · MED · LOCAL_PREF · ATOMIC_AGGREGATE · ORIGINATOR_ID · MP_REACH_NLRI · COMMUNITIES · extended communities
3/5	attribute length exceeds	属性长度越界
3/6	invalid ORIGIN attribute	ORIGIN属性无效
3/8	invalid NEXT_HOP attribute	下一跳属性无效
3/9	invalid nexthop length in MP_REACH_NLRI (address-family)	address-family地址族MP_REACH_NLRI属性的Nexthop长度错误，address-family的取值包括： · 4u：表示IPv4单播地址族 · 6u：表示IPv6单播地址族
	the length of MP_UNREACH_NLRI is too small	MP_UNREACH_NLRI的长度小于3字节
	the MP NLRI attribute length exceeds	MP_REACH_NLRI 或MP_UNREACH_NLRI属性长度越界
	erroneous MP NLRI attribute end position	可达或不可达前缀结束位置与报文属性结束位置不同
3/10	invalid network field	网络字段无效
3/11	malformed AS_PATH	AS路径形式不对
4/0	hold timer expiration caused by local device	本地导致holdtimer超时
4/0	hold timer expiration caused by peer device	对端导致holdtimer超时
5/0	connection retry timer expires	ConnectRetry定时器超时
	TCP_CR_Acked event received	收到了TCP_CR_Acked事件
	TCP_Connection_Confirmed event received	收到了TCP_Connection_Confirmed事件
5/3	open message received	收到open消息
6/0	manualstop event received	收到manualstop事件
	physical interface configuration changed	物理配置改变，比如接口变化
	session down event received from BFD	收到BFD会话down事件
6/1	maximum number of prefixes reached	前缀数超过peer route-limit所配置的数目
6/1	maximum number of address-family prefixes reached	address-family地址族的前缀数超过peer route-limit所配置的数目，address-family的取值包括： · IPv4 unicast：表示IPv4单播地址族 · IPv6 unicast：表示IPv6单播地址族
6/2	configuration of peer ignore changed	配置peer ignore命令
6/3	address family deleted	地址族被删除
6/3	peer disabled	关闭对等体
6/4	administrative reset	执行reset bgp命令或者配置改变导致BGP会话重启
6/5	connection rejected	连接被拒绝
6/6	other configuration change	其他配置变化
6/7	connection collision resolution	连接冲突
6/7	two connections exist and one uses MD5	存在两个连接，且其中一个配置了MD5认证
6/8	no memory to process the attribute	解析属性时内存不够
	no memory for the route	生成路由或者标签块信息时，获取不到内存
	no memory to generate unreachable NLRI	封装unreachable NLRI时申请不到内存
	no memory to generate a message	封装报文时申请不到内存
	can’t get the VPN RD	解析前缀时获取不到RD
	can’t get the VPN routing table	解析前缀时获取不到VPN路由表
	can’t get the attributes	解析前缀时获取不到属性
	entered severe memory state	进入二级门限告警
	entered critical memory state	进入三级门限告警

1.1.14 display bgp routing-table flap-info

display bgp routing-table flap-info命令用来显示BGP路由的震荡统计信息。

【命令】

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

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

ipv4：显示BGP IPv4路由的震荡统计信息。

ipv6：显示BGP IPv6路由的震荡统计信息。

unicast：显示BGP单播路由的震荡统计信息。

ipv4-address：显示匹配指定目的网络地址的BGP IPv4单播路由的震荡统计信息。

mask-length：目的网络地址的掩码长度，取值范围为0～32。

mask：目的网络地址的掩码，点分十进制格式。

longest-match：指定根据如下方法判断显示哪条BGP IPv4单播路由的震荡统计信息：

(1) 将用户输入的网络地址和路由的掩码进行与操作；

(2) 计算结果与路由的网段地址相同，且掩码小于等于用户输入子网掩码的路由中，子网掩码最长的路由将被显示出来。

ipv6-address prefix-length：显示匹配指定目的网络地址及前缀长度的BGP IPv6单播路由的震荡统计信息。prefix-length为目的网络地址的前缀长度，取值范围为0～128。

as-path-acl as-path-acl-number：显示匹配指定AS路径过滤列表的BGP路由的震荡统计信息。as-path-acl-number为AS路径过滤列表号，取值范围为1～256。

【使用指导】

执行display bgp routing-table flap-info ipv4命令时：

· 如果只指定了ipv4-address参数，则将指定的网络地址和路由的掩码进行与操作，若计算结果与路由的网段地址相同，则显示该BGP IPv4单播路由的震荡统计信息。

· 如果指定了ipv4-address mask或ipv4-address mask-length参数，没有指定longest-match参数，则显示与指定目的网络IPv4地址和网络掩码（或掩码长度）精确匹配的BGP IPv4单播路由的震荡统计信息。

如果没有指定unicast参数，则缺省为unicast。

【举例】

# 显示所有BGP IPv4单播路由的震荡统计信息。

<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

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

# 显示所有BGP IPv6单播路由的震荡统计信息。

<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

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

表1-11 display bgp routing-table flap-info命令显示信息描述表

字段	描述
Total number of routes	震荡路由的总数
BGP local router ID	本地的路由器ID
Status codes	路由状态代码： · * – valid：合法路由 · > – best：优选最佳路由 · d - dampened：震荡抑制路由 · h – history：历史路由 · s – suppressed：聚合抑制路由 · S – stale：过期路由 · i – internal：内部路由 · e – external：外部路由
Origin	路由信息的来源，取值包括： · i – IGP：表示路由产生于本AS内。通过network命令发布路由的路由信息来源为IGP · e – EGP：表示路由是通过EGP（Exterior Gateway Protocol，外部网关协议）学到的 · ? – incomplete：表示路由的来源无法确定。从IGP协议引入路由的路由信息来源为incomplete
Network	目的网络地址
PrefixLen	目的网络地址的前缀长度
From	发布该路由的BGP对等体的IP地址
Flaps	路由震荡的次数，即路由从可达状态变为不可达状态，及可达路由的属性发生变化的次数
Duration	路由发生震荡的持续时间
Reuse	路由恢复可用的时间，即还需要等待多长时间该路由将由不可用状态转为可用状态
Path/Ogn	路由的AS路径（AS_PATH）属性和路由信息的来源（ORIGIN）属性，其中： · AS_PATH属性记录了此路由经过的所有AS，可以避免路由环路的出现 · ORIGIN属性标记了此路由如何成为BGP路由

【相关命令】

· dampening

· reset bgp flap-info

1.1.15 display bgp routing-table ipv4 unicast

display bgp routing-table ipv4 unicast命令用来显示BGP IPv4单播路由信息。

【命令】

display bgp [ instance instance-name ] routing-table ipv4 [ unicast ] [ ipv4-address [ { mask-length | mask } [ longest-match ] ] | ipv4-address [ mask-length | mask ] advertise-info | peer { ipv4-address | ipv6-address } { advertised-routes | received-routes } [ ipv4-address [ mask-length | mask ] | statistics ] | statistics ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

ipv4-address：目的网络的IPv4地址。

mask-length：网络掩码长度，取值范围为0～32。

mask：网络掩码，点分十进制格式。

longest-match：指定根据如下方法判断显示哪条BGP IPv4单播路由信息：

(1) 将用户输入的网络地址和路由的掩码进行与操作；

(2) 计算结果与路由的网段地址相同，且掩码小于等于用户输入子网掩码的路由中，子网掩码最长的路由将被显示出来。

advertise-info：显示BGP IPv4单播路由的通告信息。

peer { ipv4-address | ipv6-address }：显示向指定对等体发布或者从指定对等体收到的BGP IPv4单播路由信息。ipv4-address为对等体的IPv4地址，ipv6-address为对等体的IPv6地址。

advertised-routes：显示向指定的对等体发布的路由信息。

received-routes：显示从指定的对等体接收到的路由信息。

statistics：显示路由的统计信息。

【使用指导】

如果没有指定任何参数，则显示所有BGP IPv4单播路由的简要信息。

如果只指定了ipv4-address参数，则将指定的网络地址和路由的掩码进行与操作，若计算结果与路由的网段地址相同，则显示该路由的信息。

如果指定了ipv4-address mask或ipv4-address mask-length参数，没有指定longest-match参数，则显示与指定目的网络IPv4地址和网络掩码（或掩码长度）精确匹配的BGP IPv4单播路由的信息。

执行本命令时指定unicast参数和不指定unicast参数的效果相同。

【举例】

# 显示所有BGP IPv4单播路由的简要信息。

<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 4294967295

4294967294 4294967293 4294967292 4294967291 4294967290 4294967215 4294967225 4294967235 4294967245 4294967295 4294967294 4294967293 4294967292 4294967291 4294967290 i

* > 192.168.1.0 192.168.1.135 0 0 i

* e 10.2.1.2 0 0 200i

# 显示匹配AS路径过滤列表1的BGP IPv4单播路由信息。

<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

# 显示向对等体10.2.1.2发布的所有公网BGP IPv4单播路由信息。

<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

# 显示从对等体10.2.1.2收到的所有公网BGP IPv4单播路由信息。

<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

表1-12 display bgp routing-table ipv4 unicast命令简要显示信息描述表

字段	描述
Total number of routes	路由总数
BGP local router ID	本地的路由器ID
Status codes	路由状态代码： · * – valid：合法路由 · > – best：普通优选最佳路由 · d - dampened：震荡抑制路由 · h – history：历史路由 · s – suppressed：聚合抑制路由 · S – stale：过期路由 · i – internal：内部路由 · e – external：外部路由 · a – additional-path：Add-Path优选路由
Origin	路由信息的来源，取值包括： · i – IGP：表示路由产生于本AS内。通过network命令发布路由的路由信息来源为IGP · e – EGP：表示路由是通过EGP（Exterior Gateway Protocol，外部网关协议）学到的 · ? – incomplete：表示路由的来源无法确定。从IGP协议引入路由的路由信息来源为incomplete
Network	目的网络地址
NextHop	下一跳IP地址
MED	MED（Multi-Exit Discriminator，多出口区分）属性值
LocPrf	本地优先级
PrefVal	路由首选值
Path/Ogn	路由的AS路径（AS_PATH）属性和路由信息的来源（ORIGIN）属性，其中： · AS_PATH属性记录了此路由经过的所有AS，可以避免路由环路的出现。本字段最多显示16个AS号，超出的部分以“…”表示，被省略的部分可以通过显示路由的详细信息查看 · ORIGIN属性标记了此BGP路由如何生成的

# 显示到达目的网络10.2.1.0/24的BGP IPv4单播路由的详细信息。

<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, bgp-rib-only

Originator : 176.1.1.2

Cluster list : 80

IP precedence : N/A

QoS local ID : N/A

Traffic index : N/A

VPN-Peer UserID : N/A

DSCP : N/A

EXP : 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

VPN-Peer UserID : N/A

DSCP : N/A

EXP : N/A

# 显示到达目的网络1.1.1.1/32的BGP IPv4单播路由的详细信息。

<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

VPN-Peer UserID : N/A

DSCP : N/A

EXP : 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

VPN-Peer UserID : N/A

DSCP : N/A

EXP : N/A

表1-13 display bgp routing-table ipv4 unicast命令详细显示信息描述表

字段	描述
BGP local router ID	本地的路由器ID
Local AS number	本地的AS号
Paths	路由数信息 · available：有效路由数目 · best：最佳路由数目
BGP routing table information of 10.2.1.0/24	到达目的网络10.2.1.0/24的BGP路由表项信息
Imported route	该路由为引入的路由
Original nexthop	路由的原始下一跳地址，如果是从BGP更新消息中获得的路由，则该地址为接收到的消息中的下一跳IP地址
OutLabel	路由的出标签值
RxPathID	接收到的路由的Add-Path ID值
TxPathID	发送的路由的Add-Path ID值
AS-path	路由的AS路径（AS_PATH）属性，记录了此路由经过的所有AS，可以避免路由环路的出现
Origin	路由信息的来源，取值包括： · igp：表示路由产生于本AS内。通过network命令发布路由的路由信息来源为IGP · egp：表示路由是通过EGP（Exterior Gateway Protocol，外部网关协议）学到的。 · incomplete：表示路由的来源无法确定。从IGP协议引入路由的路由信息来源为incomplete
Attribute value	BGP路由属性信息，包括： · MED：与目的网络关联的MED值 · localpref：本地优先级 · pref-val：路由首选值 · pre：协议优先级
State	路由当前状态，取值包括： · valid：有效路由 · internal：内部路由 · external：外部路由 · local：本地产生路由 · synchronize：同步路由 · best：最佳路由
Originator	将路由发布给路由反射器的对等体的Router ID
Cluster list	路由反射器的集群ID
From	发布该路由的BGP对等体的IP地址
Rely Nexthop	路由迭代后的下一跳IP地址，如果没有迭代出下一跳地址，则显示为“not resolved”
IP precedence	路由的IP优先级，取值范围是0～7，N/A表示无效值
QoS local ID	路由的Qos-Local-ID属性，取值范围是1～4095，N/A表示无效值
Traffic index	流量索引值，取值范围是1～64，N/A表示无效值
VPN-Peer UserID	（暂不支持）路由所属的VPN peer ID值，取值范围为1～134217727，N/A表示无效值
DSCP	（暂不支持）路由的DSCP优先级，取值范围为0～63，N/A表示无效值
EXP	（暂不支持）路由的EXP优先级，N/A表示无效值
Rely Tunnel IDs	（暂不支持）路由迭代后的隧道索引值列表，存在等价隧道时，可能对应多个NHLFE表项索引值，如果未迭代隧道，显示为N/A

# 显示向对等体10.2.1.2发布的公网BGP IPv4单播路由的统计信息。

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

Advertised routes total: 2

# 显示从对等体10.2.1.2收到的公网BGP IPv4单播路由的统计信息。

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

Received routes total: 2

表1-14 display bgp routing-table ipv4 unicast peer statistics命令显示信息描述表

字段	描述
Advertised routes total	向指定对等体发布的路由总数
Received routes total	从指定对等体收到的路由总数

# 显示BGP IPv4单播路由的统计信息。

<Sysname> display bgp routing-table ipv4 statistics

Total number of routes: 4

表1-15 display bgp routing-table ipv4 unicast statistics命令显示信息描述表

字段	描述
Total number of routes	路由总数

# 显示到达目的网段10.2.1.0/24的BGP IPv4单播路由的通告信息。

<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:

Advertised to peers (1 in total):

10.2.1.2

表1-16 display bgp routing-table ipv4 unicast advertise-info命令显示信息描述表

字段	描述
BGP local router ID	本地的路由器ID
Local AS number	本地的AS号
Paths	到达指定目的网络的优选路由数目
BGP routing table information of 10.2.1.0/24	到达目的网络10.2.1.0/24的BGP路由的通告信息
Advertised to peers (1 in total)	该路由已经向哪些对等体发送，以及对等体的数目

1.1.16 display bgp routing-table ipv6 unicast

display bgp routing-table ipv6 unicast命令用来显示BGP IPv6单播路由信息。

【命令】

display bgp [ instance instance-name ] routing-table ipv6 [ unicast ] [ ipv6-address prefix-length [ advertise-info ] | peer ipv6-address { advertised-routes | received-routes } [ ipv6-address prefix-length | statistics ] | statistics ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

ipv6-address prefix-length：显示与指定的目的网络地址和前缀长度精确匹配的BGP IPv6单播路由信息。prefix-length为目的网络地址的前缀长度，取值范围为0～128。如果没有指定本参数，则显示所有BGP IPv6单播路由的简要信息。

advertise-info：显示BGP IPv6单播路由的通告信息。如果没有指定本参数，则显示BGP IPv6单播路由表的信息。

peer：显示向指定的对等体发布或者从指定的对等体收到的BGP IPv6单播路由信息。

ipv4-address：对等体的IPv4地址。

ipv6-address：对等体的IPv6地址。

advertised-routes：显示向指定的对等体发布的路由信息。

received-routes：显示从指定的对等体接收到的路由信息。

statistics：显示路由的统计信息。

【使用指导】

执行本命令时指定unicast参数和不指定unicast参数的效果相同。

【举例】

# 显示所有BGP IPv6单播路由的简要信息。

<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: 4294967295 4294967294 4294967293 4294967292 4294967291 4294967290 4294967215 4294967225 4294967235 4294967245 4294967295 4294967294 4294967293 4294967292 4294967291 4294967290 i

# 显示匹配AS路径过滤列表1的BGP IPv6单播路由信息。

<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

# 显示匹配BGP团体列表100的BGP IPv6单播路由信息。

<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

# 显示向对等体1::1发布的所有BGP IPv6单播路由信息。

<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

# 显示从对等体1::1收到的所有BGP IPv6单播路由信息。

<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

表1-17 display bgp routing-table ipv6 unicast命令简要显示信息描述表

字段	描述
Total number of routes	路由总数
BGP local router ID	本地的路由器ID
Status codes	路由状态代码： · * – valid：合法路由 · > – best：普通优选最佳路由 · d - dampened：震荡抑制路由 · h – history：历史路由 · s – suppressed：聚合抑制路由 · S – stale：过期路由 · i – internal：内部路由 · e – external：外部路由 · a – additional-path：Add-Path优选路由
Origin	路由信息的来源，取值包括： · i – IGP：表示路由产生于本AS内。通过network命令发布路由的路由信息来源为IGP · e – EGP：表示路由是通过EGP（Exterior Gateway Protocol，外部网关协议）学到的 · ? – incomplete：表示路由的来源无法确定。从IGP协议引入路由的路由信息来源为incomplete
Network	目的网络地址
PrefixLen	目的网络地址的前缀长度
NextHop	下一跳IP地址
LocPrf	本地优先级
PrefVal	路由首选值
OutLabel	（暂不支持）路由的出标签值
MED	MED（Multi-Exit Discriminator，多出口区分）属性值
Path/Ogn	路由的AS路径（AS_PATH）属性和路由信息的来源（ORIGIN）属性，其中： · AS_PATH属性记录了此路由经过的所有AS，可以避免路由环路的出现。本字段最多显示16个AS号，超出的部分以“…”表示，被省略的部分可以通过显示路由的详细信息查看 · ORIGIN属性标记了此BGP路由如何生成的

# 显示到达目的网络2::/64的BGP IPv6单播路由的详细信息。

<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)

Rely 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, bgp-rib-only

Originator : 176.1.1.2

Cluster list : 80

IP precedence : N/A

QoS local ID : N/A

Traffic index : N/A

EXP : N/A

Backup route.

From : 1::1 (192.168.1.136)

Rely 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

EXP : N/A

表1-18 display bgp routing-table ipv6 unicast命令详细显示信息描述表

字段	描述
BGP local router ID	本地的路由器ID
Local AS number	本地的AS号
Paths	路由数信息 · available：有效路由数目 · best：最佳路由数目
BGP routing table information of 2::/64	到达目的网络2::/64的BGP路由表项信息
Imported route	该路由为引入的路由
Original nexthop	路由的原始下一跳地址，如果是从BGP更新消息中获得的路由，则该地址为接收到的消息中的下一跳IP地址
OutLabel	路由的出标签值
RxPathID	接收到的路由的Add-Path ID值
TxPathID	发送的路由的Add-Path ID值
AS-path	路由的AS路径（AS_PATH）属性，记录了此路由经过的所有AS，可以避免路由环路的出现
Origin	路由信息的来源，取值包括： · igp：表示路由产生于本AS内。通过network命令发布路由的路由信息来源为IGP · egp：表示路由是通过EGP（Exterior Gateway Protocol，外部网关协议）学到的。 · incomplete：表示路由的来源无法确定。从IGP协议引入路由的路由信息来源为incomplete
Attribute value	BGP路由属性信息，包括： · MED：与目的网络关联的MED值 · localpref：本地优先级 · pref-val：路由首选值 · pre：协议优先级
State	路由当前状态，取值包括： · valid：有效路由 · internal：内部路由 · external：外部路由 · local：本地产生路由 · best：最佳路由（暂不支持）
Originator	将路由发布给路由反射器的对等体的Router ID
Cluster list	路由反射器的集群ID
From	发布该路由的BGP对等体的IP地址
Rely Nexthop	路由迭代后的下一跳IP地址，如果没有迭代出下一跳地址，则显示为“not resolved”
IP precedence	路由的IP优先级，取值范围是0～7，N/A表示无效值
QoS local ID	路由的Qos-Local-ID属性，取值范围是1～4095，N/A表示无效值
Traffic index	流量索引值，取值范围是1～64，N/A表示无效值
Tag	路由标记
VPN-Peer UserID	（暂不支持）路由所属的VPN peer ID值，取值范围为1～134217727，N/A表示无效值
EXP	（暂不支持）路由的EXP优先级，N/A表示无效值
Tunnel policy	（暂不支持）路由生效的隧道策略，NULL表示无生效的隧道策略
Rely Tunnel IDs	（暂不支持）路由迭代后的隧道索引值列表，存在等价隧道时，可能对应多个NHLFE表项索引值，如果未迭代隧道，显示为N/A

# 显示到达目的网段2::/64的BGP IPv6单播路由的通告信息。

<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:

Advertised to peers (2 in total):

10.1.1.2

1::2

表1-19 display bgp routing-table ipv6 unicast advertise-info命令显示信息描述表

字段	描述
BGP local router ID	本地的路由器ID
Local AS number	本地的AS号
Paths	到达指定目的网络的优选路由数目
BGP routing table information of 2::/64	到达目的网络2::/64的BGP路由的通告信息
Advertised to peers (2 in total)	该路由已经向哪些对等体发送，以及对等体的数目

# 显示向对等体1::1发布的BGP IPv6单播路由的统计信息。

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

Advertised routes total: 1

# 显示从对等体1::1收到的BGP IPv6单播路由的统计信息。

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

Received routes total: 1

表1-20 display bgp routing-table ipv6 unicast peer statistics命令显示信息描述表

字段	描述
Advertised routes total	向指定对等体发布的路由总数
Received routes total	从指定对等体收到的路由总数

# 显示BGP IPv6单播路由的统计信息。

<Sysname> display bgp routing-table ipv6 statistics

Total number of routes: 4

表1-21 display bgp routing-table ipv6 unicast statistics命令显示信息描述表

字段	描述
Total number of routes	路由总数

1.1.17 display bgp update-group

display bgp update-group命令用来显示BGP打包组的相关信息。

【命令】

display bgp [ instance instance-name ] update-group ipv4 [ unicast ] [ ipv4-address ]

display bgp [ instance instance-name ] update-group ipv4 [ unicast ] [ ipv6-address ]

display bgp [ instance instance-name ] update-group ipv6 [ unicast ] [ ipv6-address ]

display bgp [ instance instance-name ] update-group ipv6 [ unicast ] [ ipv4-address ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

ipv4：显示BGP IPv4地址族的打包组信息。

ipv6：显示BGP IPv6地址族的打包组信息。

unicast：显示BGP单播地址族的打包组信息。

ipv4-address：显示指定对等体所在打包组的信息。ipv4-address为对等体的IPv4地址。

ipv6-address：显示指定对等体所在打包组的信息。ipv6-address为对等体的IPv6地址。

【使用指导】

按组打包技术是指将出口策略相同的对等体归为一组，形成一个打包组，设备向打包组中的对等体发布路由时，统一对路由进行策略过滤，并构造路由更新报文（即打包），以避免重复地进行策略过滤和构造报文。

实现按组打包后，每条路由前缀信息只需要经过一次策略过滤并打包一次，然后发布给打包组内的所有对等体。例如，如果不采用按组打包，1000条路由向1000个对等体发布时，需要匹配1000×1000次策略，并进行1000×1000次打包处理；如果采用按组打包，1000个对等体的出口策略相同（如数据中心组网中）时，只需要匹配1000×1次策略，并进行1000×1次打包处理，打包效率提高了1000倍。

如果没有指定任何参数，则显示指定地址族公网所有BGP打包组信息。

如果没有指定unicast参数，则缺省为unicast。

【举例】

# 显示BGP IPv4单播地址族的所有打包组信息。

<Sysname> display bgp update-group ipv4

Update-group ID: 0

Type: EBGP link

4-byte AS number: Supported

Site-of-Origin: Not specified

Minimum time between advertisements: 30 seconds

OutQ: 0

Members: 1

99.1.1.1

表1-22 display bgp update-group命令显示信息描述表

字段	描述
Update-group ID	打包组ID
Type	打包组中对等体的BGP连接类型，取值包括： · IBGP link：IBGP连接 · EBGP link：EBGP连接 · Confed IBGP link：联盟IBGP连接 · Confed EBGP link：联盟EBGP连接
4-byte AS number: Supported	没有为打包组中的对等体使能4字节AS号抑制功能，即打包组中的对等体支持4字节AS号
4-byte AS number: Suppressed	为打包组中的对等体使能4字节AS号抑制功能
Site-of-Origin	为打包组中的对等体指定的SoO属性值
Minimum time between advertisements: number seconds	向打包组中对等体发布同一路由的最小时间间隔，单位为秒
Export filter-policy	为打包组中的对等体设置了基于ACL的BGP路由出发向过滤策略
OutQ	等待发往打包组中对等体的前缀数目
Members	打包组中对等体的数目及对等体的地址

1.1.18 filter-policy export

filter-policy export命令用来配置对发布的路由信息进行过滤。

undo filter-policy export命令用来取消对发布的路由信息进行过滤。

【命令】

BGP IPv4单播地址族视图：

filter-policy { ipv4-acl-number | prefix-list ipv4-prefix-list-name } export [ direct | { isis | ospf | rip } process-id | static ]

undo filter-policy export [ direct | { isis | ospf | rip } process-id | static ]

BGP IPv6单播地址族视图：

filter-policy { ipv6-acl-number | prefix-list ipv6-prefix-list-name } export [ direct | { isisv6 | ospfv3 | ripng } process-id | static ]

undo filter-policy export [ direct | { isisv6 | ospfv3 | ripng } process-id | static ]

【缺省情况】

不对发布的路由信息进行过滤。

【视图】

BGP IPv4单播地址族视图

BGP IPv6单播地址族视图

【缺省用户角色】

network-admin

【参数】

ipv4-acl-number：指定用于匹配路由信息目的网络地址的访问列表号，取值范围为2000～3999。

ipv6-acl-number：指定用于匹配路由信息目的网络地址的IPv6 ACL编号，取值范围为2000～3999。

prefix-list ipv4-prefix-list-name：指定用于匹配路由信息目的网络地址的IPv4地址前缀列表。ipv4-prefix-list-name表示IPv4地址前缀列表名称，为1～63个字符的字符串，区分大小写。

prefix-list ipv6-prefix-list-name：指定用于匹配路由信息目的网络地址的IPv6地址前缀列表。ipv6-prefix-list-name表示IPv6地址前缀列表名称，为1～63个字符的字符串，区分大小写。

direct：对引入的直连路由进行过滤。

eigrp：对从EIGRP协议引入的路由进行过滤。

isis：对从ISIS协议引入的路由进行过滤。

isisv6：对从IPv6 ISIS协议引入的路由进行过滤。

ospf：对从OSPF协议引入的路由进行过滤。

ospfv3：对从OSPFv3协议引入的路由进行过滤。

rip：对从RIP协议引入的路由进行过滤。

ripng：对从RIPng路由协议引入的路由进行过滤。

static：对引入的静态路由进行过滤。

process-id：路由协议的进程号，取值范围为1～65535。

【使用指导】

如果指定了路由协议参数（direct、isis等），则只对从这种协议引入到BGP的路由进行过滤，其他BGP路由不受影响。如果没有指定路由协议参数，则对所有BGP路由都进行过滤，包括从IGP引入的路由、使用network命令发布的路由、从BGP对等体学习的路由等。

通过基本ACL（2000～2999）对发布的路由信息进行过滤时，如果配置了rule [ rule-id ] { deny | permit } source source-address source-wildcard命令，则只要路由的目的网络地址与rule命令中的source-address source-wildcard匹配，则该路由与rule命令配置的规则匹配，不会再比较路由的目的网络地址掩码。

通过高级ACL（3000～3999）对发布的路由信息进行过滤时：

· rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard命令配置的规则用来过滤指定目的网络地址的路由；

· rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard destination dest-addr dest-wildcard命令配置的规则用来过滤指定目的网络地址和掩码的路由。其中source sour-addr sour-wildcard用来过滤路由目的网络地址，destination dest-addr dest-wildcard用来过滤路由掩码。destination dest-addr dest-wildcard指定的掩码应该是连续的，如果指定的掩码不连续，则该过滤掩码的条件不生效。

引用ACL时，需要注意的是，若引用的ACL不存在，或者引用的ACL中没有配置规则，则表示所有BGP路由都可以通过本命令的过滤。

【举例】

# 在BGP IPv4单播地址族视图下，使用编号为2000的IPv4基本ACL对BGP发布的所有路由进行过滤。

<Sysname> system-view

[Sysname] bgp 100

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

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

【相关命令】

· filter-policy import

· peer filter-policy

1.1.19 filter-policy import

filter-policy import命令用来配置对接收的路由信息进行过滤。

undo filter-policy import命令用来恢复缺省情况。

【命令】

BGP IPv4单播地址族视图：

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

undo filter-policy import

BGP IPv6单播地址族视图：

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

undo filter-policy import

【缺省情况】

不对接收的路由信息进行过滤。

【视图】

BGP IPv4单播地址族视图

BGP IPv6单播地址族视图

【缺省用户角色】

network-admin

【参数】

ipv4-acl-number：指定用于匹配路由信息目的网络地址的访问列表号，取值范围为2000～3999。

ipv6-acl-number：指定用于匹配路由信息目的网络地址的IPv6访问列表号，取值范围为2000～3999。

【使用指导】

通过基本ACL（2000～2999）对接收的路由信息进行过滤时，如果配置了rule [ rule-id ] { deny | permit } source source-address source-wildcard命令，则只要路由的目的网络地址与rule命令中的source-address source-wildcard匹配，则该路由与rule命令配置的规则匹配，不会再比较路由的目的网络地址掩码。

通过高级ACL（3000～3999）对接收的路由信息进行过滤时：

· rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard命令配置的规则用来过滤指定目的网络地址的路由；

引用ACL时，需要注意的是，若引用的ACL不存在，或者引用的ACL中没有配置规则，则表示所有BGP路由都可以通过本命令的过滤。

【举例】

# 在BGP IPv4单播地址族视图下，使用编号为2000的IPv4基本ACL对BGP接收的路由进行过滤。

<Sysname> system-view

[Sysname] bgp 100

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

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

【相关命令】

· filter-policy export

· peer filter-policy

1.1.20 group

group命令用来创建一个对等体组。

undo group命令用来删除指定的对等体组。

【命令】

group group-name [ external | internal ]

undo group group-name

【缺省情况】

不存在对等体组。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【参数】

group-name：对等体组的名称，为1～47个字符的字符串，区分大小写。

external：创建EBGP对等体组。

internal：创建IBGP对等体组。

【使用指导】

在大规模BGP网络中，对等体的数量很多，其中很多对等体具有相同的策略，在配置时会重复使用一些命令。此时，利用对等体组可以简化配置。

对等体组是具有某些相同属性的对等体的集合。当一个对等体加入对等体组中时，此对等体将获得与所在对等体组相同的配置。当对等体组的配置改变时，组内成员的配置也相应改变。

如果没有指定internal和external参数，则创建的是IBGP对等体组。

如果分别对对等体组和对等体组中的对等体进行了某项BGP配置，则以最后一次配置为准。

通过本命令创建对等体组后，还需要执行peer enable命令，本地路由器才具有与指定对等体组交换相应地址族路由信息的能力。

【举例】

# 在BGP实例视图下，创建一个EBGP对等体组test，其AS号为200，并在test中添加EBGP对等体10.1.1.1和10.1.2.1。

<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

【相关命令】

· display bgp group

· peer enable

1.1.21 import-route

import-route命令用来将IGP路由协议的路由信息引入到BGP路由表中，以便通过BGP发布引入的路由信息。

undo import-route命令用来取消引入IGP路由协议的路由信息。

【命令】

BGP IPv4单播地址族视图：

import-route { isis | ospf | rip } [ { process-id | all-processes } [ allow-direct | med med-value ] * ]

import-route { direct | guard | static } [ med med-value ] *

undo import-route { direct | guard | { isis | ospf | rip } [ process-id | all-processes ] | static }

BGP IPv6单播地址族视图：

import-route { isisv6 | ospfv3 | ripng } [ { process-id | all-processes } [ allow-direct | med med-value ] * ]

import-route { direct | guard | static } [ med med-value ] *

undo import-route { direct | guard | { isisv6 | ospfv3 | ripng } [ process-id | all-processes ] | static }

【缺省情况】

BGP不会引入IGP路由协议的路由信息。

【视图】

BGP IPv4单播地址族视图

BGP IPv6单播地址族视图

【缺省用户角色】

network-admin

【参数】

direct：引入直连路由。

eigrp：引入EIGRP协议的路由。

guard：引入Guard路由。

isis：引入ISIS协议的路由。

isisv6：引入IPv6 ISIS协议的路由。

ospf：引入OSPF协议的路由。

ospfv3：引入OSPFv3协议的路由。

rip：引入RIP协议的路由。

ripng：引入RIPng协议的路由。

static：引入静态路由。

process-id：路由协议的进程号，取值范围为1～65535。

all-processes：引入指定路由协议所有进程的路由。

allow-direct：指定引入IGP路由协议的路由时，同时引入使能了该协议的接口网段路由。如果不指定本参数，则在引入协议路由时不会引入使能了该协议的接口网段路由。

med med-value：指定引入路由的MED度量值，取值范围为0～4294967295。如果没有指定MED度量值，则被引入路由的metric值将作为引入BGP之后路由的MED值。

【使用指导】

通过import-route命令引入指定IGP路由协议的路由时，不会引入该协议的缺省路由。只有同时执行default-route imported命令，才会引入该协议的缺省路由。

只能引入路由表中状态为active的路由。可以通过display ip routing-table protocol命令或display ipv6 routing-table protocol命令来查看路由的状态是否为active。

引入IS-IS、IPv6 ISIS、OSPF、OSPFv3、RIP或RIPng协议的路由时，如果没有指定任何参数，则引入process-id为1的IS-IS、IPv6 ISIS、OSPF、OSPFv3、RIP或RIPng协议的路由。

通过import-route命令引入到BGP路由表中的路由的ORIGIN属性为incomplete。

通过all-processes参数引入指定路由协议所有进程的路由后，对此协议的任意进程配置本命令均不生效。

【举例】

# 在BGP IPv4单播地址族视图下，引入RIP进程1的路由，并指定引入后BGP路由的MED值为100。

<Sysname> system-view

[Sysname] bgp 100

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

[Sysname-bgp-default-ipv4] import-route rip 1 med 100

【相关命令】

· import-route-append

1.1.22 import-route-append

import-route-append命令用来以附加的方式将IGP路由协议的路由信息引入到BGP路由表中，以便通过BGP发布引入的路由信息。

undo import-route-append命令用来取消以附加的方式引入IGP路由协议的路由信息。

【命令】

BGP IPv4单播地址族视图：

import-route-append { isis | ospf | rip } [ { process-id | all-processes } [ allow-direct | med med-value ] * ]

import-route-append { direct | static } [ med med-value ] *

undo import-route-append { direct | { isis | ospf | rip } [ process-id | all-processes ] | static }

BGP IPv6单播地址族视图：

import-route-append { isisv6 | ospfv3 | ripng } [ { process-id | all-processes } [ allow-direct | med med-value ] * ]

import-route-append { direct | static } [ med med-value ] *

undo import-route-append { direct | { isisv6 | ospfv3 | ripng } [ process-id | all-processes ] | static }

【缺省情况】

BGP未以附加的方式引入IGP路由协议的路由信息。

【视图】

BGP IPv4单播地址族视图

BGP IPv6单播地址族视图

【缺省用户角色】

network-admin

【参数】

direct：引入直连路由。

isis：引入ISIS协议的路由。

isisv6：引入IPv6 ISIS协议的路由。

ospf：引入OSPF协议的路由。

ospfv3：引入OSPFv3协议的路由。

rip：引入RIP协议的路由。

ripng：引入RIPng协议的路由。

static：引入静态路由。

process-id：路由协议的进程号，取值范围为1～65535。

all-processes：引入指定路由协议所有进程的路由。

med med-value：指定引入路由的MED度量值，取值范围为0～4294967295。如果没有指定MED度量值，则被引入路由的metric值将作为引入BGP之后路由的MED值。

【使用指导】

本命令与import-route命令在分别单独配置时功能完全一致，同时配置时本命令可以在不覆盖现有import-route命令配置的情况下附加引入IGP路由。

针对同一协议进程同时配置本命令与import-route命令时，如果均指定了引入路由的MED度量值，以import-route-append命令的配置为准。

通过all-processes参数引入指定路由协议所有进程的路由后，对此协议的任意进程配置本命令均不生效。

【举例】

# 在BGP IPv4单播地址族视图下，附加引入ISIS进程1的路由。

<Sysname> system-view

[Sysname] bgp 100

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

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

[Sysname-bgp-default-ipv4] import-route-append isis 1

【相关命令】

· display ip routing-table protocol（网络互通命令参考/IP路由基础）

· display ipv6 routing-table protocol（网络互通命令参考/IP路由基础）

· import-route

1.1.23 log-peer-change

log-peer-change命令用来全局使能BGP日志记录功能。

undo log-peer-change命令用来全局关闭BGP日志记录功能。

【命令】

log-peer-change

undo log-peer-change

【缺省情况】

全局BGP日志记录功能处于开启状态。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【使用指导】

通过log-peer-change命令全局使能BGP日志记录功能，并执行peer log-change命令使能与指定对等体/对等体组之间BGP会话的日志记录功能后，与该对等体/对等体组之间BGP会话建立以及断开时会生成日志信息，通过display bgp peer ipv4 unicast log-info命令或display bgp peer ipv6 unicast log-info命令可以查看记录的日志信息。生成的日志信息还将被发送到设备的信息中心，通过设置信息中心的参数，决定日志信息的输出规则（即是否允许输出以及输出方向）。（有关信息中心参数的配置请参见“设备管理配置指导”中的“信息中心”。）

如果全局关闭BGP日志记录功能，或关闭与指定对等体/对等体组之间BGP会话的日志记录功能，则BGP会话建立或断开时不会生成日志信息。

【举例】

# 全局使能BGP日志记录功能。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] log-peer-change

【相关命令】

· display bgp peer

· peer log-change

1.1.24 network

network命令用来配置BGP发布的本地网段路由，即将本地路由表中指定网段的路由添加到BGP路由表中，并发布给对等体。

undo network命令用来删除指定的BGP发布的本地网段路由。

【命令】

BGP IPv4单播地址族视图：

network ipv4-address [ mask-length | mask ]

undo network ipv4-address [ mask-length | mask ]

BGP IPv6单播地址族视图：

network ipv6-address prefix-length

undo network ipv6-address prefix-length

【缺省情况】

BGP不发布本地的网段路由。

【视图】

BGP IPv4单播地址族视图

BGP IPv6单播地址族视图

【缺省用户角色】

network-admin

【参数】

ipv4-address：目的网络的IPv4地址。如果没有指定mask和mask-length参数，则采用自然掩码。

mask-length：网络掩码长度，取值范围为0～32。

mask：网络掩码，点分十进制格式。

ipv6-address：目的网络的IPv6地址。

prefix-length：目的网络地址的前缀长度，取值范围为0～128。

【使用指导】

network命令指定的网段路由必须存在于本地的IP路由表中，且处于Active状态，否则无法将该网段路由添加到BGP路由表中。

使用network命令添加到BGP路由表中的网段路由的ORIGIN属性为IGP。

执行undo network命令时指定的掩码、掩码长度或前缀长度必须与执行network命令时指定的掩码、掩码长度或前缀长度相同，否则无法删除配置。

【举例】

# 在BGP IPv4单播地址族视图下，将本地路由表中到达10.0.0.0/16网段的路由添加到BGP路由表中。

<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

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

peer as-number命令用来指定对等体组的AS号。

undo peer as-number命令用来删除指定对等体组的AS号。

【命令】

peer group-name as-number as-number

undo peer group-name as-number

【缺省情况】

未指定对等体组的AS号。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【参数】

group-name：对等体组的名称，为1～47个字符的字符串，区分大小写。指定的对等体组必须已经创建。

as-number：对等体组的AS号，取值范围为1～4294967295。

【使用指导】

只有当对等体组中不包含对等体时，才允许为对等体组配置AS号。

为对等体组配置AS号后，需要加入该对等体组的对等体的AS号必须与对等体组的AS号相同。

如果没有指定对等体组的AS号，则加入该对等体组的对等体保留自己的AS号，即对等体组中对等体的AS号可以相同，也可以不同。

【举例】

# 在BGP实例视图下，指定对等体组test的AS号为100。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] peer test as-number 100

【相关命令】

· peer group

1.1.26 peer as-number (for a BGP peer)

peer as-number命令用来创建BGP对等体，并指定对等体的AS号。

undo peer命令用来删除指定的BGP对等体。

【命令】

peer { ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } as-number as-number

undo peer { ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] }

【缺省情况】

不存在BGP对等体。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【参数】

ipv4-address：对等体的IPv4地址。

mask-length：网络掩码，取值范围为0～32。如果指定本参数，则表示指定网段内的动态对等体。

ipv6-address：对等体的IPv6地址。

prefix-length：前缀长度，取值范围为0～128。如果指定本参数，则表示指定网段内的动态对等体。

as-number：对等体的AS号，取值范围为1～4294967295。如果对等体的AS号与本地路由器的AS号相同，则该对等体为IBGP对等体；如果对等体的AS号与本地路由器的AS号不同，则该对等体为EBGP对等体。

【使用指导】

除了本命令外，还可以通过peer group命令创建对等体。执行peer group命令创建对等体的同时，还可以将对等体加入对等体组。

不能通过重复执行peer as-number命令修改对等体的AS号。只能先删除对等体，再为对等体配置新的AS号。

通过本命令创建对等体后，还需要执行peer enable命令，本地路由器才具有与指定对等体交换相应地址族路由信息的能力。

配置动态对等体时，设备和邻居只能有一端配置网段地址，另一端必须配置实际IP地址。

【举例】

# 在BGP实例视图下，创建BGP对等体1.1.1.1，指定对等体的AS号为100。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] peer 1.1.1.1 as-number 100

【相关命令】

· display bgp peer

· peer enable

· peer group

1.1.27 peer connect-interface

peer connect-interface命令用来指定与对等体/对等体组创建BGP会话时建立TCP连接使用的源接口，即采用指定源接口的IPv4地址/IPv6地址与对等体/对等体组建立TCP连接。

undo peer connect-interface命令用来取消该配置。

【命令】

peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } connect-interface interface-type interface-number

undo peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } connect-interface

【缺省情况】

BGP使用到达BGP对等体的最佳路由出接口的主IPv4地址或IPv6地址与对等体/对等体组建立TCP连接。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【参数】

group-name：对等体组的名称，为1～47个字符的字符串，区分大小写。指定的对等体组必须已经创建。

ipv4-address：对等体的IPv4地址。指定的对等体必须已经创建。

mask-length：网络掩码，取值范围为0～32。如果指定本参数，则表示指定网段内的动态对等体。

ipv6-address：对等体的IPv6地址。指定的对等体必须已经创建。

prefix-length：前缀长度，取值范围为0～128。如果指定本参数，则表示指定网段内的动态对等体。

interface-type interface-number：接口类型和接口编号。

【使用指导】

本命令的作用与peer source-address命令的作用类似：peer source-address命令直接指定建立TCP连接的源地址；本命令通过指定源接口，间接指定建立TCP连接的源地址。在一台BGP路由器上如果同时执行本命令和peer source-address命令，则后执行的配置覆盖之前的配置。

在如下场合需要通过本命令或peer source-address命令指定建立TCP连接使用的源接口或源地址：

· 当指定的对等体的IPv4地址/IPv6地址不是本地路由器与对等体之间直连接口的IPv4地址/IPv6地址时，需要在对等体上通过本配置将建立TCP连接使用的源接口指定为对等体IPv4地址/IPv6地址所在的接口或者指定TCP连接的源地址为对等体IP地址/IPv6地址。

· 当通过IPv6链路本地地址创建对等体或向对等体组中添加指定的对等体时，必须使用直连接口建立对等关系，且必须通过peer connect-interface命令将本地直连出接口指定为建立TCP连接使用的源接口。

· 当建立BGP连接的路由器之间存在冗余链路时，如果路由器上的一个接口发生故障，链路状态变为down，建立TCP连接的源地址可能会随之发生变化，导致BGP需要重新建立TCP连接，造成网络震荡。为了避免该情况的发生，建议网络管理员将建立TCP连接所使用的源地址配置为Loopback接口的地址，或将源接口配置为Loopback接口，以提高TCP连接的可靠性和稳定性。

· 当BGP对等体之间同时建立多条BGP会话时，如果没有明确指定建立TCP连接的源地址，可能会导致根据最优路由选择TCP连接源地址错误，并影响BGP会话的建立。如果多条BGP会话基于不同接口的IP地址建立，则建议用户在配置BGP对等体时，通过配置源接口或源地址明确指定每个BGP会话的TCP连接源地址；如果多条BGP会话基于同一接口的不同IP地址建立，则建议用户通过配置源地址，明确指定每个BGP会话的TCP连接源地址。

本地路由器源接口的地址和对等体源接口的地址之间必须路由可达。

如果在EBGP对等体上指定非直连接口作为源接口，则需要配置peer ebgp-max-hop命令允许本地路由器同非直连网络上的邻居建立EBGP连接。

如果接口上存在多个IPv4地址，则建立TCP连接时使用接口的主IPv4地址；如果接口上存在多个IPv6地址，则设备根据内部定义的原则从中选择一个IPv6地址作为TCP连接的源地址。源IPv6地址的选择具有不确定性，因此，在这种情况下，建议用户通过peer source-address命令明确指定TCP连接的源IPv6地址。

【举例】

# 在BGP实例视图下，配置与对等体组test创建BGP会话时，使用接口Loopback0作为建立TCP连接的源接口。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] peer test connect-interface loopback 0

【相关命令】

· peer ebgp-max-hop

· peer source-address

1.1.28 peer default-route-advertise

peer default-route-advertise命令用来向对等体/对等体组发送缺省路由。

undo peer default-route-advertise命令用来取消向指定对等体/对等体组发送缺省路由。

【命令】

peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } default-route-advertise

undo peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } default-route-advertise

【缺省情况】

不向对等体/对等体组发送缺省路由。

【视图】

BGP IPv4单播地址族视图

BGP IPv6单播地址族视图

【缺省用户角色】

network-admin

【参数】

group-name：对等体组的名称，为1～47个字符的字符串，区分大小写。指定的对等体组必须已经创建。

ipv4-address：对等体的IPv4地址。指定的对等体必须已经创建。

mask-length：网络掩码，取值范围为0～32。如果指定本参数，则表示指定网段内的动态对等体。

ipv6-address：对等体的IPv6地址。指定的对等体必须已经创建。

prefix-length：前缀长度，取值范围为0～128。如果指定本参数，则表示指定网段内的动态对等体。

【使用指导】

如果配置了peer default-route-advertise命令，则本地路由器会向指定的对等体/对等体组发布一条下一跳为自身的缺省路由。在本地路由器的路由表中不需要存在缺省路由。

【举例】

# 在BGP IPv4单播地址族视图下，设置向对等体组test发布缺省路由。

<Sysname> system-view

[Sysname] bgp 100

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

[Sysname-bgp-default-ipv4] peer test default-route-advertise

1.1.29 peer description

peer description命令用来配置对等体/对等体组的描述信息。

undo peer description命令用来删除指定对等体/对等体组的描述信息。

【命令】

peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } description text

undo peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } description

【缺省情况】

对等体/对等体组没有描述信息。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【参数】

group-name：对等体组的名称，为1～47个字符的字符串，区分大小写。指定的对等体组必须已经创建。

ipv4-address：对等体的IPv4地址。指定的对等体必须已经创建。

mask-length：网络掩码，取值范围为0～32。如果指定本参数，则表示指定网段内的动态对等体。

ipv6-address：对等体的IPv6地址。指定的对等体必须已经创建。

prefix-length：前缀长度，取值范围为0～128。如果指定本参数，则表示指定网段内的动态对等体。

text：对等体的描述信息，为1～79个字符的字符串，区分大小写。

【举例】

# 在BGP实例视图下，配置对等体组test的描述信息为ISP1。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] peer test description ISP1

1.1.30 peer enable

peer enable命令用来允许本地路由器与指定对等体/对等体组交换路由信息。

undo peer enable命令用来禁止本地路由器与指定对等体/对等体组交换路由信息。

【命令】

peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } enable

undo peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } enable

【缺省情况】

本地路由器不能与对等体/对等体组交换路由信息。

【视图】

BGP IPv4单播地址族视图

BGP IPv6单播地址族视图

【缺省用户角色】

network-admin

【参数】

group-name：对等体组的名称，为1～47个字符的字符串，区分大小写。指定的对等体组必须已经创建。

ipv4-address：对等体的IPv4地址。指定的对等体必须已经创建。

mask-length：网络掩码，取值范围为0～32。如果指定本参数，则表示指定网段内的动态对等体。

ipv6-address：对等体的IPv6地址。指定的对等体必须已经创建。

prefix-length：前缀长度，取值范围为0～128。如果指定本参数，则表示指定网段内的动态对等体。

【使用指导】

在不同的视图下执行peer enable命令，可以使能本地路由器与指定对等体交换不同地址族路由信息的能力：

· BGP IPv4单播地址族视图下，使能的是交换IPv4单播路由信息的能力，并且学习到的路由将添加到公网BGP路由表中。

· BGP IPv6单播地址族视图下，使能的是交换IPv6单播路由信息的能力，并且学习到的路由将添加到公网IPv6 BGP路由表中。

· BGP VPNv4 Flowspec地址族视图下，使能的是交换VPNv4 Flowspec路由信息的能力。

如果在某个视图下执行了undo peer enable命令，则本地路由器与指定对等体之间不再交换对应地址族的路由信息。

【举例】

# 在BGP IPv4单播地址族视图下，使能本地路由器与对等体1.1.1.1交换IPv4单播路由信息的能力。

<Sysname> system-view

[Sysname] bgp 100

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

[Sysname-bgp-default-ipv4] peer 1.1.1.1 enable

【相关命令】

· display bgp peer

1.1.31 peer filter-policy

peer filter-policy命令用来为对等体/对等体组设置基于ACL的BGP路由过滤策略。

undo peer filter-policy命令用来删除为指定对等体/对等体组设置基于ACL的BGP路由过滤策略。

【命令】

peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } filter-policy ipv6-acl-number { export | import }

undo peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } filter-policy { export | import }

【缺省情况】

未配置基于ACL的BGP路由过滤策略。

【视图】

BGP IPv4单播地址族视图

BGP IPv6单播地址族视图

【缺省用户角色】

network-admin

【参数】

group-name：对等体组的名称，为1～47个字符的字符串，区分大小写。指定的对等体组必须已经创建。

ipv4-address：对等体的IPv4地址。指定的对等体必须已经创建。

mask-length：网络掩码，取值范围为0～32。如果指定本参数，则表示指定网段内的动态对等体。

ipv6-address：对等体的IPv6地址。指定的对等体必须已经创建。

prefix-length：前缀长度，取值范围为0～128。如果指定本参数，则表示指定网段内的动态对等体。

ipv4-acl-number：访问控制列表号，取值范围为2000～3999。

ipv6-acl-number：IPv6访问控制列表号，取值范围为2000～3999。

export：对向指定对等体/对等体组发布的路由应用过滤策略。

import：对从指定对等体/对等体组接收的路由应用过滤策略。

【使用指导】

配置peer filter-policy命令时需要同时在系统视图下通过acl命令配置对应的ACL。如果本命令中指定的ACL尚未创建，则所有路由均通过过滤。

通过基本ACL（2000～2999）对BGP路由信息进行过滤时，如果配置了rule [ rule-id ] { deny | permit } source source-address source-wildcard命令，则只要路由的目的网络地址与rule命令中的source-address source-wildcard匹配，则该路由与rule命令配置的规则匹配，不会再比较路由的目的网络地址掩码。

通过高级ACL（3000～3999）对BGP路由信息进行过滤时，rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard命令配置的规则用来过滤指定目的网络地址的路由；rule [ rule-id ] { deny | permit } ip source sour-addr sour-wildcard destination dest-addr dest-wildcard命令配置的规则用来过滤指定目的网络地址和掩码的路由，其中source sour-addr sour-wildcard用来过滤路由目的网络地址，destination dest-addr dest-wildcard用来过滤路由掩码。destination dest-addr dest-wildcard指定的掩码应该是连续的。如果指定的掩码不连续，则该过滤掩码的条件不生效。

引用ACL时，需要注意的是，若引用的ACL不存在，或者引用的ACL中没有配置规则，则表示所有BGP路由都可以通过本命令的过滤。

【举例】

# 在BGP IPv4单播地址族视图下，配置利用编号为2000的访问控制列表过滤向对等体组test发布的路由。

<Sysname> system-view

[Sysname] bgp 100

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

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

【相关命令】

· acl（安全命令参考/ACL）

· filter-policy export

· filter-policy import

1.1.32 peer group

peer group命令用来向对等体组中添加指定的对等体。

undo peer group命令用来从对等体组中删除指定的对等体。

【命令】

peer { ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } group group-name [ as-number as-number ]

undo peer { ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } group group-name

【缺省情况】

对等体组中不存在任何对等体。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【参数】

ipv4-address：对等体的IPv4地址。

mask-length：网络掩码，取值范围为0～32。如果指定本参数，则表示指定网段内的动态对等体。

ipv6-address：对等体的IPv6地址。

prefix-length：前缀长度，取值范围为0～128。如果指定本参数，则表示指定网段内的动态对等体。

group-name：对等体组的名称，为1～47个字符的字符串，区分大小写。指定的对等体组必须已经创建。

as-number as-number：对等体的AS号，取值范围为1～4294967295。

【使用指导】

可以通过以下方式将对等体加入对等体组：

· 先通过peer as-number命令创建对等体并指定对等体的AS号，再通过peer group命令将其加入对等体组。采用这种方式时，需要注意：

¡ 执行peer group命令时可以指定as-number参数，指定的as-number参数，必须与peer as-number命令中配置的对等体AS号相同。

¡ 如果通过peer as-number命令指定了对等体组的AS号，则对等体的AS号必须与对等体组的AS号相同，否则无法将对等体加入对等体组。

¡ 如果将对等体加入IBGP对等体组，则该对等体必须是IBGP对等体。

· 通过peer group命令创建对等体的同时，将其加入对等体组。采用这种方式时，需要注意：

¡ 如果通过peer as-number命令指定了对等体组的AS号，则执行peer group命令时无需指定as-number参数，对等体的AS号为该对等体组的AS号。执行peer group命令时如果指定了as-number参数，则as-number参数必须与对等体组的AS号相同。

¡ 如果没有指定对等体组的AS号，且该对等体组为EBGP对等体组，则执行peer group命令时必须指定as-number参数。

¡ 如果没有指定对等体组的AS号，且该对等体组为IBGP对等体组，则执行peer group命令时无需指定as-number参数，对等体的AS号为本地AS号。执行peer group命令时如果指定了as-number参数，则as-number参数必须与本地AS号相同。

如果通过peer as-number命令指定了对等体组的AS号，则只有与该对等体组AS号相同的对等体才能加入该对等体组，即对等体组中所有对等体的AS号均相同；如果没有指定对等体组的AS号，则加入该对等体组的对等体保留自己的AS号，即对等体组中对等体的AS号可以相同，也可以不同。

通过本命令将对等体加入对等体组后，还需要执行peer enable命令，本地路由器才具有与指定对等体组交换相应地址族路由信息的能力。

【举例】

# 在BGP实例视图下，将IPv4地址为10.1.1.1的对等体加入到EBGP对等体组test。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] group test external

[Sysname-bgp-default] peer 10.1.1.1 group test as-number 2004

【相关命令】

· group

· peer as-number

· peer enable

1.1.33 peer log-change

peer log-change命令用来使能与指定对等体/对等体组之间BGP会话的日志记录功能。

undo peer log-change命令用来关闭与指定对等体/对等体组之间BGP会话的日志记录功能。

【命令】

peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } log-change

undo peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } log-change

【缺省情况】

与所有对等体/对等体组之间BGP会话的日志记录功能均处于开启状态。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【参数】

group-name：对等体组的名称，为1～47个字符的字符串，区分大小写。指定的对等体组必须已经创建。

ipv4-address：对等体的IPv4地址。指定的对等体必须已经创建。

mask-length：网络掩码，取值范围为0～32。如果指定本参数，则表示指定网段内的动态对等体。

ipv6-address：对等体的IPv6地址。指定的对等体必须已经创建。

prefix-length：前缀长度，取值范围为0～128。如果指定本参数，则表示指定网段内的动态对等体。

【使用指导】

通过log-peer-change命令全局使能BGP日志记录功能，并执行本命令后，与指定对等体/对等体组之间BGP会话建立以及断开时会生成日志信息，通过display bgp peer ipv4 unicast log-info命令或display bgp peer ipv6 unicast log-info命令可以查看记录的日志信息。生成的日志信息还将被发送到设备的信息中心，通过设置信息中心的参数，决定日志信息的输出规则（即是否允许输出以及输出方向）。（有关信息中心参数的配置请参见“设备管理配置指导”中的“信息中心”。）

如果全局关闭BGP日志记录功能，或关闭与指定对等体/对等体组之间BGP会话的日志记录功能，则BGP会话建立或断开时不会生成日志信息。

【举例】

# 在BGP实例视图下，使能与对等体1.1.1.1之间BGP会话的日志记录功能。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] peer 1.1.1.1 as-number 200

[Sysname-bgp-default] peer 1.1.1.1 log-change

【相关命令】

· display bgp peer

· log-peer-change

1.1.34 peer route-update-interval

peer route-update-interval命令用来配置向指定对等体/对等体组发布同一路由的时间间隔。

undo peer route-update-interval命令用来取消该配置。

【命令】

peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } route-update-interval interval

undo peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } route-update-interval

【缺省情况】

向IBGP对等体发布同一路由的时间间隔为15秒，向EBGP对等体发布同一路由的时间间隔为30秒。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【参数】

group-name：对等体组的名称，为1～47个字符的字符串，区分大小写。指定的对等体组必须已经创建。

ipv4-address：对等体的IPv4地址。指定的对等体必须已经创建。

mask-length：网络掩码，取值范围为0～32。如果指定本参数，则表示指定网段内的动态对等体。

ipv6-address：对等体的IPv6地址。指定的对等体必须已经创建。

prefix-length：前缀长度，取值范围为0～128。如果指定本参数，则表示指定网段内的动态对等体。

interval：发布同一路由的最小时间间隔，取值范围为0～600，单位为秒。

【使用指导】

BGP路由发生变化时，BGP路由器会发送Update消息通知对等体。如果同一路由频繁变化，BGP路由器会频繁发送Update消息更新路由，导致路由震荡。通过本命令指定向对等体/对等体组发布同一路由的更新时间间隔，可以避免每次路由变化都发送Update消息，避免路由震荡。对于需要撤销的路由，BGP路由器会立即向邻居发送路由撤销消息，不受本命令的控制。

【举例】

# 在BGP实例视图下，配置向对等体组test发布同一路由的时间间隔为10秒。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] peer test as-number 100

[Sysname-bgp-default] peer test route-update-interval 10

1.1.35 peer soo

peer soo命令用来为对等体/对等体组配置SoO（Site of Origin，源站点）属性。

undo peer soo命令用来取消为指定对等体/对等体组配置的SoO属性。

【命令】

peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } soo site-of-origin

undo peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } soo

【缺省情况】

没有为BGP对等体/对等体组配置SoO属性。

【视图】

BGP IPv4单播地址族视图

BGP IPv6单播地址族视图

【缺省用户角色】

network-admin

【参数】

group-name：对等体组的名称，为1～47个字符的字符串，区分大小写。指定的对等体组必须已经创建。

ipv4-address：对等体的IPv4地址。指定的对等体必须已经创建。

mask-length：网络掩码，取值范围为0～32。如果指定本参数，则表示指定网段内的动态对等体。

ipv6-address：对等体的IPv6地址。指定的对等体必须已经创建。

prefix-length：前缀长度，取值范围为0～128。如果指定本参数，则表示指定网段内的动态对等体。

site-of-origin：SoO扩展团体属性，为3～21个字符的字符串。site-of-origin有三种形式：

· 16位自治系统号:32位用户自定义数，例如：101:3。

· 32位IP地址:16位用户自定义数，例如：192.168.122.15:1。

· 32位自治系统号:16位用户自定义数，其中的自治系统号最小值为65536。例如：65536:1。

【使用指导】

SoO扩展团体属性用来标识路由的原始站点。路由器不会将带有SoO属性的路由发布给该SoO标识的站点，确保来自某个站点的路由不会再被发布到该站点，从而避免路由环路。在AS路径信息丢失时，可以通过SoO属性来避免发生环路。

PE使用不同接口连接同一站点的多个CE时，如果配置了BGP的AS号替换功能，则会导致路由环路。这种情况下，需要在PE上通过本命令为从同一站点不同CE学习到的路由添加相同的SoO属性，且PE向CE发布路由时检查SoO属性，如果路由的SoO属性与为CE配置的SoO属性相同，则不将该路由发布给CE，从而避免路由环路。

【举例】

# 在BGP IPv4单播地址族视图下，为对等体1.1.1.1配置SoO属性为100:1。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4

[Sysname-bgp-default-ipv4] peer 1.1.1.1 soo 100:1

【相关命令】

· peer substitute-as

1.1.36 peer source-address

peer source-address命令用来指定与对等体/对等体组创建BGP会话时建立TCP连接使用的源IPv4地址/IPv6地址。

undo peer source-address命令用来取消该配置。

【命令】

peer ipv4-address [ mask-length ] source-address source-ipv4-address

peer ipv6-address [ prefix-length ] source-address source-ipv6-address

undo peer { ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } source-address

peer group-name source-address { source-ipv4-address | source-ipv6-address } *

undo peer group-name source-address [ source-ipv4-address | source-ipv6-address ]

【缺省情况】

BGP使用到达BGP对等体的最佳路由出接口的主IPv4地址或IPv6地址与对等体/对等体组建立TCP连接。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【参数】

ipv4-address：对等体的IPv4地址。指定的对等体必须已经创建。

mask-length：网络掩码，取值范围为0～32。如果指定本参数，则表示指定网段内的动态对等体。

source-ipv4-address：源IPv4地址。

ipv6-address：对等体的IPv6地址。指定的对等体必须已经创建。

prefix-length：前缀长度，取值范围为0～128。如果指定本参数，则表示指定网段内的动态对等体。

source-ipv6-address：源IPv6地址。

group-name：对等体组的名称，为1～47个字符的字符串，区分大小写。指定的对等体组必须已经创建。

【使用指导】

本命令的作用与peer connect-interface命令的作用类似：本命令直接指定建立TCP连接的源地址；peer connect-interface命令通过指定源接口，间接指定建立TCP连接的源地址。在一台BGP路由器上如果同时执行本命令和peer connect-interface命令，则后执行的配置覆盖之前的配置。

在如下场合需要通过本命令或peer connect-interface命令指定建立TCP连接使用的源地址：

本地路由器的源地址和对等体的源地址之间必须路由可达。

如果在EBGP对等体上指定非直连接口的地址作为源地址，则需要配置peer ebgp-max-hop命令允许本地路由器同非直连网络上的邻居建立EBGP连接。

可以为BGP对等体组同时指定source-ipv4-address和source-ipv6-address参数。本地路由器与对等体组中IPv4地址的对等体建立BGP会话时，采用source-ipv4-address作为TCP连接的源IPv4地址；本地路由器与对等体组中IPv6地址的对等体建立BGP会话时，采用source-ipv6-address作为TCP连接的源IPv6地址。

【举例】

# 在BGP实例视图下，配置与对等体组test创建BGP会话时，TCP连接的源地址为1.1.1.1。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] peer test source-address 1.1.1.1

【相关命令】

· peer connect-interface

· peer ebgp-max-hop

1.1.37 peer timer

peer timer命令用来配置本地路由器与指定对等体/对等体组之间BGP会话的存活时间间隔和保持时间。

undo peer timer命令用来取消该配置。

【命令】

peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } timer keepalive keepalive hold holdtime

undo peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } timer

【缺省情况】

本地路由器与指定对等体/对等体组之间BGP会话的存活时间间隔为60秒，保持时间为180秒。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【参数】

group-name：对等体组的名称，为1～47个字符的字符串，区分大小写。指定的对等体组必须已经创建。

ipv4-address：对等体的IPv4地址。指定的对等体必须已经创建。

mask-length：网络掩码，取值范围为0～32。如果指定本参数，则表示指定网段内的动态对等体。

ipv6-address：对等体的IPv6地址。指定的对等体必须已经创建。

prefix-length：前缀长度，取值范围为0～128。如果指定本参数，则表示指定网段内的动态对等体。

keepalive keepalive：指定存活时间间隔。keepalive的取值范围为0～21845，单位为秒。

hold holdtime：指定保持时间。holdtime的取值范围为0或3～65535，单位为秒。保持时间必须大于或等于存活时间的三倍。

【使用指导】

当对等体间建立了BGP会话后，它们定时向对端发送Keepalive消息，以防止路由器认为BGP会话已中断。Keepalive消息的发送时间间隔称为存活时间间隔。

若路由器在设定的会话保持时间（Holdtime）内未收到对端的Keepalive消息或Update消息，则认为此BGP会话已中断，从而断开此BGP会话。

使用该命令配置的定时器比使用timer命令配置的定时器优先级高。

如果当前路由器上配置的保持时间与对端设备（对等体）上配置的保持时间不一致，则数值较小者作为协商后的保持时间。

保持时间为0时，不向该对等体发送keepalive消息，与该对等体之间的会话永远不会超时断开；当保持时间和存活时间间隔都不为0时，将协商的保持时间的三分之一与配置的存活时间间隔比较，取最小值作为存活时间间隔。

配置该命令后，不会马上断开会话，而是等到其他条件触发会话重建（如复位BGP会话）时，再以配置的保持时间协商建立会话。

【举例】

# 在BGP实例视图下，配置本地路由器与对等体组test之间BGP会话的存活时间间隔与保持时间分别为60秒和180秒。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] peer test timer keepalive 60 hold 180

【相关命令】

· display bgp peer

· timer

1.1.38 peer timer connect-retry

peer timer connect-retry命令用来配置本地路由器与指定对等体/对等体组之间重新建立BGP会话的时间间隔。

undo peer timer connect-retry命令用来取消该配置。

【命令】

peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } timer connect-retry retry-time

undo peer { group-name | ipv4-address [ mask-length ] | ipv6-address [ prefix-length ] } timer connect-retry

【缺省情况】

本地路由器与指定对等体/对等体组之间重新建立BGP会话的时间间隔为32秒。

【视图】

BGP视图

【缺省用户角色】

network-admin

【参数】

group-name：对等体组的名称，为1～47个字符的字符串，区分大小写。指定的对等体组必须已经创建。

ipv4-address：对等体的IPv4地址。指定的对等体必须已经创建。

mask-length：网络掩码，取值范围为0～32。如果指定本参数，则表示指定网段内的动态对等体。

ipv6-address：对等体的IPv6地址。指定的对等体必须已经创建。

prefix-length：前缀长度，取值范围为0～128。如果指定本参数，则表示指定网段内的动态对等体。

retry-time：指定重新建立BGP会话的时间间隔，取值范围为1～65535，单位为秒。

【使用指导】

如果要加快本地路由器与指定对等体/对等体组之间重新建立BGP会话的速度，可以将retry-time的值调小，便于路由快速收敛。如果BGP会话反复up/down，可以将retry-time的值调大，从而减轻路由震荡。

使用本命令配置的定时器比使用timer connect-retry命令配置的定时器优先级高。

【举例】

# 在BGP实例视图下，配置本地路由器与对等体1.1.1.1之间重新建立BGP会话的时间间隔为30秒。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] peer 1.1.1.1 timer connect-retry 30

【相关命令】

· timer connect-retry

1.1.39 refresh bgp

refresh bgp命令用来手工对BGP会话进行软复位。

【命令】

refresh bgp [ instance instance-name ] { ipv4-address [ mask-length ] | all | external | group group-name | internal } { export | import } ipv4 [ unicast ]

refresh bgp [ instance instance-name ] { ipv6-address [ prefix-length ] | all | external | group group-name | internal } { export | import } ipv6 [ unicast ]

refresh bgp [ instance instance-name ] ipv6-address [ prefix-length ] { export | import } ipv4 [ unicast ]

refresh bgp [ instance instance-name ] ipv4-address [ mask-length ] { export | import } ipv6 [ unicast ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

instance instance-name：软复位指定BGP实例内的BGP会话。instance-name表示BGP实例名称，为1～31个字符的字符串，区分大小写。如果不指定本参数，则表示软复位BGP实例default内的BGP会话。

ipv4-address：软复位与指定对等体的BGP会话。ipv4-address为对等体的IPv4地址。

mask-length：网络掩码，取值范围为0～32。如果指定本参数，则表示指定网段内的动态对等体。

ipv6-address：软复位与指定对等体的BGP会话。ipv6-address为对等体的IPv6地址。

prefix-length：前缀长度，取值范围为0～128。如果指定本参数，则表示指定网段内的动态对等体。

all：软复位指定地址族下的所有BGP会话。

external：软复位指定地址族下的所有EBGP会话。

group group-name：软复位与指定对等体组中对等体的BGP会话。group-name表示对等体组的名称，为1～47个字符的字符串，区分大小写。

internal：软复位指定地址族下的所有IBGP会话。

export：触发出方向的软复位，即采用新的配置对向对等体发布的路由进行过滤。

import：触发入方向的软复位，即采用新的配置对从对等体接收的路由进行过滤。

ipv4：软复位IPv4地址族下的BGP会话。

ipv6：软复位IPv6地址族下的BGP会话。

unicast：软复位单播地址族下的BGP会话。

【使用指导】

软复位BGP会话是指在不断开BGP邻居关系的情况下，更新BGP路由信息，使新的配置生效。

选路策略发生改变后，如果指定了export参数，则会触发本地路由器根据新的路由发布策略过滤路由信息，并将通过过滤的路由信息发送给BGP对等体；如果指定了import参数，则本地路由器会向BGP对等体发送Route-refresh消息，收到Route-refresh消息的对等体将其路由信息重新发给本地路由器，以便本地路由器根据新的路由策略对接收到的路由信息进行过滤。

执行本命令软复位BGP会话时，要求当前路由器和对等体都支持Route-refresh功能，否则本命令不会生效。

如果没有指定unicast参数，则缺省为unicast。

【举例】

# 手工对所有IPv4单播地址族下的BGP会话进行入方向的软复位。

<Sysname> refresh bgp all import ipv4

【相关命令】

· peer capability-advertise route-refresh

· peer keep-all-routes

1.1.40 reset bgp

reset bgp命令用来复位指定地址族下的BGP会话。

【命令】

reset bgp [ instance instance-name ] { as-number | ipv4-address [ mask-length ] | all | external | group group-name | internal } ipv4 [ unicast ]

reset bgp [ instance instance-name ] { as-number | ipv6-address [ prefix-length ] | all | external | group group-name | internal } ipv6[ unicast ]

reset bgp [ instance instance-name ] ipv6-address [ prefix-length ] ipv4 [ unicast ]

reset bgp [ instance instance-name ] ipv4-address [ mask-length ] ipv6 [ unicast ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

instance instance-name：复位指定BGP实例内的BGP会话。instance-name表示BGP实例名称，为1～31个字符的字符串，区分大小写。如果不指定本参数，则表示复位BGP实例default内的BGP会话。

as-number：复位与指定自治系统内对等体的BGP会话。as-number为自治系统号，取值范围为1～4294967295。

ipv4-address：复位与指定对等体的BGP会话。ipv4-address为对等体的IPv4地址。

mask-length：网络掩码，取值范围为0～32。如果指定本参数，则表示指定网段内的动态对等体。

ipv6-address：复位与指定对等体的BGP会话。ipv6-address为对等体的IPv6地址。

prefix-length：前缀长度，取值范围为0～128。如果指定本参数，则表示指定网段内的动态对等体。

all：复位指定地址族下的所有BGP会话。

external：复位指定地址族下的所有EBGP会话。

group group-name：复位与指定对等体组中对等体的BGP会话。group-name表示对等体组的名称，为1～47个字符的字符串，区分大小写。

internal：复位指定地址族下的所有IBGP会话。

ipv4：复位IPv4地址族下的BGP会话。

ipv6：复位IPv6地址族下的BGP会话。

unicast：复位单播地址族下的BGP会话。

【使用指导】

复位BGP会话时，会造成短暂的BGP会话中断。

BGP的选路策略改变后，为了使新的策略生效，可以复位BGP会话，即删除并重新建立BGP会话，以便重新发布路由信息，并应用新的策略对路由信息进行过滤。

如果没有指定unicast参数，则缺省为unicast

【举例】

# 复位公网IPv4单播地址族下的所有BGP会话。

<Sysname> reset bgp all ipv4

1.1.41 reset bgp all

reset bgp all命令用来复位所有BGP会话。

【命令】

reset bgp [ instance instance-name ] all

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

【使用指导】

复位BGP会话时，会造成短暂的BGP会话中断。

【举例】

# 复位所有BGP会话。

<Sysname> reset bgp all

1.1.42 reset bgp flap-info

reset bgp flap-info命令用来清除BGP路由的震荡统计信息。

【命令】

reset bgp [ instance instance-name ] flap-info ipv4[ unicast ] [ ipv4-address [ mask-length | mask ] | as-path-acl as-path-acl-number | peer ipv4-address [ mask-length ] ]

reset bgp [ instance instance-name ] flap-info ipv6[ unicast ] [ ipv6-address prefix-length | as-path-acl as-path-acl-number | peer ipv6-address [ prefix-length ] ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

instance instance-name：清除指定BGP实例的BGP路由震荡统计信息。instance-name表示BGP实例名称，为1～31个字符的字符串，区分大小写。如果不指定本参数，则表示清除default实例的BGP路由震荡统计信息。

ipv4：清除BGP IPv4路由的震荡统计信息。

ipv6：清除BGP IPv6路由的震荡统计信息。

unicast：清除BGP单播路由的震荡统计信息。

ipv4-address：清除匹配指定目的网络IPv4地址的BGP路由的震荡统计信息。

mask-length：目的网络IPv4地址的掩码长度，取值范围为0～32。

mask：目的网络IPv4地址的掩码，点分十进制格式。

ipv6-address：清除匹配指定目的网络IPv6地址的BGP路由的震荡统计信息。

prefix-length：目的网络IPv6地址的前缀长度，取值范围为0～128。

as-path-acl as-path-acl-number：清除匹配指定AS路径过滤列表的BGP路由的震荡统计信息。as-path-acl-number为AS路径过滤列表号，取值范围为1～256。

peer ipv4-address [ mask-length ]：清除从指定BGP对等体学习到的BGP路由的震荡统计信息。ipv4-address为BGP对等体的IPv4地址。mask-length为网络掩码，取值范围为0～32，如果指定本参数，则表示指定网段内的动态对等体。

peer ipv6-address [ prefix-length ]：清除从指定BGP对等体学习到的BGP路由的震荡统计信息。ipv6-address为对等体的IPv6地址。prefix-length为前缀长度，取值范围为0～128，如果指定本参数，则表示指定网段内的动态对等体。

【使用指导】

执行reset bgp flap-info ipv4命令时：

· 如果只指定了ipv4-address参数，则将指定的网络地址和路由的掩码进行与操作，若计算结果与路由的网段地址相同，则清除该BGP IPv4单播路由的震荡统计信息。

· 如果指定了ipv4-address mask或ipv4-address mask-length参数，则清除与指定目的网络IPv4地址和网络掩码（或掩码长度）精确匹配的BGP IPv4单播路由的震荡统计信息。

如果没有指定unicast参数，则缺省为unicast。

【举例】

# 清除到达网络20.1.0.0/16的BGP IPv4单播路由的震荡统计信息。

<Sysname> reset bgp flap-info ipv4 20.1.0.0 16

【相关命令】

· dampening

· display bgp routing-table flap-info

1.1.43 router id

router id命令用来配置全局Router ID。

undo router id命令用来恢复缺省情况。

【命令】

router id router-id

undo router id

【缺省情况】

未配置全局Router ID。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

router-id：全局Router ID，用IP地址的形式标识。

【使用指导】

一些动态路由协议要求使用Router ID，如果在启动这些路由协议时没有指定Router ID，则缺省使用全局Router ID。

如果配置了全局Router ID，则使用配置的值作为Router ID。如果未配置全局Router ID，则按照下面的规则进行选择：

(1) 如果存在配置IP地址的Loopback接口，则选择Loopback接口地址中最大的作为Router ID。

(2) 如果未配置IP地址的Loopback接口，则从其他接口的IP地址中选择最大的作为Router ID（不考虑接口的up/down状态）。

(3) 如果所有接口上都未配置IP地址，则Router ID为无效值0.0.0.0，BGP不能使用该Route ID来建立BGP会话。

存在主备的情况下，系统将备份命令行配置的Router ID或从接口地址中选择出来的Router ID。主备倒换后，系统将检查从地址中选出的Router ID的有效性，如果无效将重新进行选择。

当且仅当被选为Router ID的接口IP地址被删除或被修改时，才触发重新选择过程，其他情况（例如：接口down；已经选取了一个非Loopback接口地址后又配置了一个Loopback接口地址；配置一个更大的接口地址等）不触发重新选择的过程。

全局Router ID改变后，执行reset命令重启BGP会话，不会改变BGP路由器的Router ID。只能在BGP实例视图下通过Router ID命令改变BGP路由器的Router ID。

【举例】

# 配置全局Router ID为1.1.1.1。

<Sysname> system-view

[Sysname] router id 1.1.1.1

【相关命令】

· router-id (BGP instance view)

1.1.44 router-id (BGP instance view)

router-id命令用来为指定的BGP实例配置BGP路由器的Router ID。

undo router-id命令用来恢复缺省情况。

【命令】

router-id router-id

undo router-id

【缺省情况】

未配置BGP路由器在BGP实例内的Router ID，为系统视图下通过router id命令配置的全局Router ID。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【参数】

router-id：BGP路由器的Router ID，用IP地址的形式标识。

【使用指导】

如果要在BGP实例下运行BGP协议，则必须为BGP实例指定Router ID。它是一个32比特无符号整数，是一台路由器在自治系统中的唯一标识。

BGP路由器的Router ID一旦确定为非零值后不会随着系统视图下router id命令配置的改变而改变。只能在BGP实例视图下通过router-id命令改变BGP路由器的Router ID。

为了增加网络的可靠性，建议将Router ID手工配置为Loopback接口的IP地址。

在同一个视图下多次执行本命令，最后一次执行的命令生效。

不同BGP实例的Router ID可以相同。

【举例】

# 在BGP实例视图下，指定BGP路由器的Router ID为1.1.1.1。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] router-id 1.1.1.1

【相关命令】

· router id

1.1.45 snmp context-name

snmp context-name命令用来配置BGP实例的SNMP上下文。

undo snmp context-name命令用来恢复缺省情况。

【命令】

snmp context-name context-name

undo snmp context-name

【缺省情况】

未配置BGP实例的SNMP上下文。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【参数】

context-name：SNMP上下文名称，为1～32个字符的字符串，区分大小写。

【使用指导】

通过MIB（Management Information Base，管理信息库）节点对BGP进行管理时，BGP无法获知被管理的节点属于哪个BGP实例。为不同的BGP实例配置不同的SNMP上下文可以解决上述问题。

设备接收到SNMP报文后，根据报文中携带的上下文（对于SNMPv3）或团体名称（对于SNMPv1/v2c），判断如何进行处理：

· 对于SNMPv3报文：

¡ 如果报文中不携带上下文，且没有为default实例配置SNMP上下文，则对BGP default实例的MIB节点进行相应处理。

¡ 如果报文中携带上下文，设备上存在对应的SNMP上下文（通过系统视图下的snmp-agent context命令创建），且该上下文与为某一个BGP实例配置的上下文相同，则对该BGP实例的MIB节点进行相应处理。

¡ 其他情况下，不允许对任何MIB节点进行处理。

· 对于SNMPv1/v2c报文：

¡ 如果设备上没有通过系统视图下的snmp-agent community-map命令将报文中的团体名映射为SNMP上下文，且没有为default实例配置SNMP上下文，则对BGP default实例的MIB节点进行相应处理。

¡ 如果设备上将团体名映射为SNMP上下文，设备上存在对应的SNMP上下文，且该上下文与为某一个BGP实例配置的上下文相同，则对该BGP实例的MIB节点进行相应处理。

¡ 其他情况下，不允许对任何MIB节点进行处理。

SNMP上下文和团体名的详细介绍，请参见“网络管理和监控配置指导”中的“SNMP”。

为不同BGP实例配置的SNMP上下文不能相同。

在同一个BGP实例下多次执行本命令，最后一次执行的命令生效。

【举例】

# 配置BGP实例abc的SNMP上下文为bgp-abc。

<Sysname> system-view

[Sysname] bgp 100 instance abc

[Sysname-bgp-abc] snmp context-name bgp-abc

【相关命令】

· snmp-agent context（网络管理和监控命令参考/SNMP）

· snmp-agent community-map（网络管理和监控命令参考/SNMP）

1.1.46 snmp-agent trap enable bgp

snmp-agent trap enable bgp命令用来开启BGP模块的告警功能。

undo snmp-agent trap enable bgp命令用来关闭BGP模块的告警功能。

【命令】

snmp-agent trap enable bgp [ instance instance-name ]

undo snmp-agent trap enable bgp [ instance instance-name ]

【缺省情况】

BGP模块的告警功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

instance instance-name：开启指定BGP实例的告警功能。instance-name表示BGP实例名称，为1～31个字符的字符串，区分大小写。如果不指定本参数，则表示开启default实例的BGP告警功能。

【使用指导】

开启BGP模块的告警功能后，当BGP的邻居状态变化时BGP会产生RFC 4273中规定的告警信息，该信息包含邻居地址、最近一次出现错误的错误码和错误子码、当前的邻居状态。生成的告警信息将发送到设备的SNMP模块，通过设置SNMP中告警信息的发送参数，来决定告警信息输出的相关属性。

有关告警信息的详细介绍，请参见“网络管理和监控配置指导”中的“SNMP”。

【举例】

# 开启BGP告警功能。

<Sysname> system-view

[Sysname] snmp-agent trap enable bgp

1.1.47 summary automatic

summary automatic命令用来配置对引入的IGP子网路由进行自动聚合。

undo summary automatic命令用来恢复缺省情况。

【命令】

summary automatic

undo summary automatic

【缺省情况】

不对引入的IGP子网路由进行自动聚合。

【视图】

BGP IPv4单播地址族视图

【缺省用户角色】

network-admin

【使用指导】

配置summary automatic命令后，BGP将对通过import-route命令引入的IGP子网路由进行聚合，从而减少路由信息的数量。

自动聚合生成的路由可以参与手动聚合。

自动聚合生成的路由不会加入到IP路由表中。

【举例】

# 在BGP IPv4单播地址族视图下，对引入的IGP子网路由进行自动聚合。

<Sysname> system-view

[Sysname] bgp 100

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

[Sysname-bgp-default-ipv4] summary automatic

【相关命令】

· aggregate

· import-route

1.1.48 timer

timer命令用来配置BGP会话的存活时间间隔和保持时间。

undo timer命令用来恢复缺省情况。

【命令】

timer keepalive keepalive hold holdtime

undo timer

【缺省情况】

BGP会话的存活时间间隔为60秒，保持时间为180秒。

【视图】

BGP实例视图

【缺省用户角色】

network-admin

【参数】

keepalive keepalive：指定BGP会话的存活时间间隔。keepalive取值范围为0～21845，单位为秒。

hold holdtime：指定BGP会话的保持时间。holdtime取值范围为0或3～65535，单位为秒。保持时间必须大于或等于存活时间的三倍。

【使用指导】

当对等体间建立了BGP会话后，它们定时向对端发送Keepalive消息，以防止路由器认为BGP会话已中断。Keepalive消息的发送时间间隔称为存活时间间隔。

若路由器在设定的会话保持时间（Holdtime）内未收到对端的Keepalive消息或Update消息，则认为此BGP会话已中断，从而断开此BGP会话。

timer命令用来配置本地路由器与所有对等体之间BGP会话的存活时间间隔和保持时间；peer timer命令用来配置本地路由器与指定对等体之间BGP会话的存活时间间隔和保持时间。如果同时配置了二者，则使用timer命令配置的定时器比使用peer timer命令配置的定时器优先级要低。

如果当前路由器上配置的保持时间与对端设备（对等体）上配置的保持时间不一致，则数值较小者作为协商后的保持时间。

保持时间为0时，不向该对等体发送Keepalive消息，与该对等体之间的会话永远不会超时断开；当保持时间和存活时间间隔都不为0时，将协商的保持时间的三分之一与配置的存活时间间隔比较，取最小值作为存活时间间隔。

配置timer命令后，不会影响已建立的BGP会话，只对新建立的会话生效。

配置timer命令后，不会马上断开会话，而是等到其他条件触发会话重建（如复位BGP会话）时，再以配置的保持时间协商建立会话。

【举例】

# 在BGP实例视图下，配置BGP会话的存活时间间隔和保持时间分别为60秒和180秒。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] timer keepalive 60 hold 180

【相关命令】

· display bgp peer

· peer timer

1.1.49 timer connect-retry

timer connect-retry命令用来配置本地路由器与所有对等体/对等体组之间重新建立BGP会话的时间间隔。

undo timer connect-retry命令用来恢复缺省情况。

【命令】

timer connect-retry retry-time

undo timer connect-retry

【缺省情况】

本地路由器与所有对等体/对等体组之间重新建立BGP会话的时间间隔为32秒。

【视图】

BGP视图

【缺省用户角色】

network-admin

【参数】

retry-time：指定重新建立BGP会话的时间间隔，取值范围为1～65535，单位为秒。

【使用指导】

使用本命令配置的定时器比使用peer timer connect-retry命令配置的定时器优先级要低。

【举例】

# 在BGP实例视图下，配置本地路由器与所有对等体之间重新建立BGP会话的时间间隔为30秒。

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] timer connect-retry 30

【相关命令】

· peer timer connect-retry

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!

热门推荐

热门推荐

H3C服务器

HPE服务器

热门推荐

H3C存储

HPE存储

热门推荐

商用台式机

商用笔记本

商用显示器

配件

热门推荐

热门推荐

智能终端

技术解决方案

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

专业安全服务

安全运营服务

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

技术支持

自助服务

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

公司刊物

加入我们

国家/地区

05-网络互通命令参考

目录

30-BGP命令

1.1 BGP配置命令

1.1.1 address-family ipv4

1.1.2 address-family ipv6

1.1.3 advertise-rib-active

1.1.4 aggregate

1.1.5 bgp

1.1.6 bgp update-delay on-startup

1.1.7 bgp update-delay on-startup prefix-list

1.1.8 default-route imported

1.1.9 display bgp group

1.1.11 display bgp network

1.1.12 display bgp paths

1.1.14 display bgp routing-table flap-info

1.1.15 display bgp routing-table ipv4 unicast

1.1.16 display bgp routing-table ipv6 unicast

1.1.17 display bgp update-group

1.1.18 filter-policy export

1.1.20 group

1.1.21 import-route

1.1.23 log-peer-change

1.1.24 network

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

1.1.27 peer connect-interface

1.1.30 peer enable

1.1.31 peer filter-policy

1.1.32 peer group

1.1.33 peer log-change

1.1.34 peer route-update-interval

1.1.36 peer source-address

1.1.37 peer timer

1.1.39 refresh bgp

1.1.40 reset bgp

1.1.41 reset bgp all

1.1.42 reset bgp flap-info

1.1.43 router id

1.1.45 snmp context-name