06-IP组播命令参考

cache-sa-enable

undo cache-sa-enable

【缺省情况】

SA报文缓存机制处于使能状态，即设备在收到SA报文后缓存其中包含的（S，G）表项。

MSDP视图

# 在公网实例中使能SA报文缓存机制，使设备在收到SA报文后缓存其中包含的（S，G）表项。

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] cache-sa-enable

· display msdp sa-cache

· display msdp sa-count

1.1.2 display msdp brief

display msdp brief命令用来显示MSDP对等体的简要信息。

display msdp [ vpn-instance vpn-instance-name ] brief [ state { connect | disabled | established | listen | shutdown } ]

vpn-instance vpn-instance-name：显示指定VPN实例的信息，vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，将显示公网实例的信息。

state：显示处于指定状态下MSDP对等体的简要信息。如果未指定本参数，将显示处于所有状态下MSDP对等体的简要信息。

connect：表示连接状态。

disabled：表示连接失败状态。

established：表示会话状态。

listen：表示监听状态。

shutdown：表示手动关闭状态。

<Sysname> display msdp brief

# 显示公网实例中处于所有状态下MSDP对等体的简要信息。

Configured Established Listen Connect Shutdown Disabled

1 1 0 0 0 0

Peer address State Up/Down time AS SA count Reset count

20.20.20.20 Established 00:00:13 100 0 0

表1-1 display msdp brief命令显示信息描述表

字段	描述
Configured	已配置的MSDP对等体的数量
Established	处于Established状态的MSDP对等体的数量
Listen	处于Listen状态的MSDP对等体的数量
Connect	处于Connect状态的MSDP对等体的数量
Shutdown	处于Shutdown状态的MSDP对等体的数量
Disabled	处于Disabled状态的MSDP对等体的数量
Peer address	MSDP对等体的地址
State	MSDP对等体的状态： · Established：连接建立，处于会话状态 · Listen：连接建立，本地作为服务器端，处于监听状态 · Connect：连接未建立，本地作为客户端，处于连接状态 · Shutdown：被关闭状态 · Disabled：连接失败状态
Up/Down time	MSDP对等体连接已建立/失败的时长
AS	MSDP对等体所在自治系统的号码，“?”表示无法获得自治系统号码
SA count	缓存中从该MSDP对等体获得的（S，G）表项的数量
Reset count	MSDP对等体连接复位的次数

1.1.3 display msdp peer-status

display msdp peer-status命令用来显示MSDP对等体的详细状态信息。

display msdp [ vpn-instance vpn-instance-name ] peer-status [ peer-address ]

peer-address：显示指定MSDP对等体的信息。如果未指定本参数，将显示所有MSDP对等体的信息。

<Sysname> display msdp peer-status 20.20.20.20

# 显示公网实例MSDP对等体20.20.20.20的详细状态信息。

MSDP peer 20.20.20.20; AS 100

Description:

Information about connection status:

State: Disabled

Up/down time: 14:41:08

Resets: 0

Connection interface: LoopBack0 (20.20.20.30)

Received/sent messages: 867/867

Discarded input messages: 0

Discarded output messages: 0

Elapsed time since last connection or counters clear: 14:42:40

Mesh group peer joined: momo

Last disconnect reason: Hold timer expired with truncated message

Truncated packet: 5 bytes in buffer, type: 1, length: 20, without packet time: 75s

Information about (Source, Group)-based SA filtering policy:

Import policy: None

Export policy: None

Information about SA-Requests:

Policy to accept SA-Requests: None

Sending SA-Requests status: Disable

Minimum TTL to forward SA with encapsulated data: 0

SAs learned from this peer: 0, SA cache maximum for the peer: 4294967295

Input queue size: 0, Output queue size: 0

Counters for MSDP messages:

RPF check failure: 0

Incoming/outgoing SA: 0/0

Incoming/outgoing SA-Request: 0/0

Incoming/outgoing SA-Response: 0/0

Incoming/outgoing Keepalive: 867/867

Incoming/outgoing Notification: 0/0

Incoming/outgoing Traceroutes in progress: 0/0

Incoming/outgoing Traceroute reply: 0/0

Incoming/outgoing Unknown: 0/0

Incoming/outgoing data packet: 0/0

表1-2 display msdp peer-status命令显示信息描述表

字段	描述
MSDP peer	MSDP对等体的地址
AS	MSDP对等体所在自治系统的号码，“?”表示无法获得自治系统号码
State	MSDP对等体的状态： · Established：连接建立，处于会话状态 · Listen：连接建立，本地作为服务器端，处于监听状态 · Connect：连接未建立，本地作为客户端，处于连接状态 · Shutdown：关闭状态 · Disabled：连接失败状态
Up/Down time	MSDP对等体连接已建立/失败的时长
Resets	MSDP对等体连接复位的次数
Connection interface	用于与对端对等体地址建立TCP连接的接口及其IP地址
Received/sent messages	MSDP通过该连接接收和发送的报文数目
Discarded input messages	丢弃的入报文数目
Discarded output messages	丢弃的出报文数目
Elapsed time since last connection or counters clear	最近一次清除该MSDP对等体信息时刻距现在的时间
Mesh group peer joined	该对等体加入全连接组的名称，注意如果未加入全连接组则不显示此行信息
Last disconnect reason	与该对等体的连接上一次断开的原因，如果为空表示与该对等体建立连接以来还没有断开过： · Hold timer expired without message：Hold timer超时，且此时接收缓冲区中没有任何报文 · Hold timer expired with truncated message：Hold timer超时，且此时接收缓冲区中有不完整的报文： a. bytes in buffer：断开连接时接收缓冲区中数据的实际长度 b. type：断开连接时接收缓冲区中报文的类型 c. length：断开连接时接收缓冲区中报文的长度，注意如果报文过小无法解析出这个字段则不显示该信息 d. without packet time：断开连接的时间到最后一次处理报文的时间间隔 · Remote peer has been closed：接收报文时发现对等体已经被关闭 · TCP ERROR/HUP event received：发送报文时TCP socket收到ERROR/HUP事件 · Illegal message received：接收到了不合法的报文 · Notification received：接收到了Notification报文 · Reset command executed：用户执行了reset msdp peer命令 · Shutdown command executed：用户执行了shutdown命令 · Interface downed：收到与对等体建立连接的接口down的事件
Information about (Source, Group)-based SA filtering policy	SA报文过滤列表信息： · Import policy：接收指定MSDP对等体的SA报文的过滤列表 · Export policy：转发指定MSDP对等体的SA报文的过滤列表
Information about SA-Requests	SA请求报文信息： · Policy to accept SA-Requests：针对来自指定MSDP对等体SA请求报文的过滤规则，None表示不对SA请求报文进行过滤 · Sending SA-Requests status：是否使能在收到一个新的组加入报文时，向其指定的MSDP对等体发送SA请求报文
Minimum TTL to forward SA with encapsulated data	封装在SA报文中的组播数据包的最小TTL值
SAs learned from this peer	已缓存从指定MSDP对等体学到的（S，G）表项的数量
SA cache maximum for the peer	可缓存从指定MSDP对等体学到的（S，G）表项的最大数量
Input queue size	接收缓冲区中所缓存的数据长度
Output queue size	发送缓冲区中所缓存的数据长度
Counters for MSDP messages	MSDP报文的统计数： · RPF check failure：未通过RPF检查而被丢弃的SA报文的统计数 · Incoming/outgoing SA：接收和发送的SA报文的统计数 · Incoming/outgoing SA-Request：接收和发送的SA请求报文的统计数 · Incoming/outgoing SA-Response：接收和发送的SA回应报文的统计数 · Incoming/outgoing Keepalive：接收和发送的Keepalive报文的统计数 · Incoming/outgoing Notification：接收和发送的Notification报文的统计数 · Incoming/outgoing Traceroutes in progress：接收和发送的Traceroute in progress报文的统计数 · Incoming/outgoing Traceroute reply：接收和发送的Traceroute replys报文的统计数 · Incoming/outgoing Unknown：接收和发送的无法识别类型报文的统计数 · Incoming/outgoing data packet：接收和发送的封装有组播数据的SA报文的统计数

1.1.4 display msdp sa-cache

display msdp sa-cache命令用来显示SA缓存中的（S，G）表项信息。

display msdp [ vpn-instance vpn-instance-name ] sa-cache [ group-address | source-address | as-number ] *

group-address：显示包含指定组播组地址的信息，取值范围为224.0.1.0～239.255.255.255。如果未指定本参数，将显示包含所有组播组地址的信息。

source-address：显示包含指定组播源地址的信息。如果未指定本参数，将显示包含所有组播源地址的信息。

as-number：显示指定自治系统的信息，取值范围为1～4294967295。如果未指定本参数，将显示所有自治系统的信息。

【描述】

只有配置了cache-sa-enable命令之后，执行本命令才会有相应的显示。

<Sysname> display msdp sa-cache

# 显示公网实例SA缓存中的（S，G）表项信息。

Total Source-Active Cache - 5 entries

Matched 5 entries

Source Group Origin RP Pro AS Uptime Expires

10.10.1.2 225.0.0.1 10.10.10.10 BGP 100 00:00:11 00:05:49

10.10.1.2 225.0.0.2 10.10.10.10 BGP 100 00:00:11 00:05:49

10.10.1.2 225.0.0.3 10.10.10.10 BGP 100 00:00:11 00:05:49

10.10.1.2 225.0.0.4 10.10.10.10 BGP 100 00:00:11 00:05:49

10.10.1.2 225.0.0.5 10.10.10.10 BGP 100 00:00:11 00:05:49

表1-3 display msdp sa-cache命令显示信息描述表

字段	描述
Total Source-Active Cache	SA缓存中组播源的总数
Matched	MSDP匹配的组播源总数
Source	组播源源地址
Group	组播源组地址
Origin RP	生成该（S，G）表项的源RP地址
Pro	源RP的自治系统号码来源于何种协议类型，“?”表示无法获得协议类型
AS	源RP的自治系统号码，“?”表示无法获得自治系统号码
Uptime	（S，G）表项缓存已存在的时间
Expires	（S，G）表项缓存超时剩余时间

· cache-sa-enable

1.1.5 display msdp sa-count

display msdp sa-count命令用来显示SA缓存中（S，G）表项的数量。

display msdp [ vpn-instance vpn-instance-name ] sa-count [ as-number ]

as-number：显示指定自治系统的信息，取值范围为1～4294967295。如果未指定本参数，将显示所有自治系统的信息。

【描述】

只有配置了cache-sa-enable命令之后，执行本命令才会有相应的显示。

<Sysname> display msdp sa-count

# 显示公网实例SA缓存中（S，G）表项的数量。

(S, G) entries statistics, counted by peer

Peer address SA count

10.10.10.10 5

(S, G) entries statistics, counted by AS

AS Source count Group count

? 3 3

5 (S, G) entries in total

表1-4 display msdp sa-count命令显示信息描述表

字段	描述
(S, G) entries statistics, counted by peer	按照对等体，统计缓存中（S，G）表项的数量
Peer address	发送SA报文的MSDP对等体地址
SA count	来自该对等体的（S，G）表项数量
(S, G) entries statistics, counted by AS	按照源RP所属的自治系统，统计缓存中（S，G）表项的数量
AS	自治系统号码，“?”表示无法获得自治系统号码
Source count	来自该自治系统的组播源的统计数
Group count	来自该自治系统的组播组的统计数
(S, G) entries in total	（S，G）表项的总数

· cache-sa-enable

1.1.6 encap-data-enable

encap-data-enable命令用来使能在SA报文中封装组播数据报文。

undo encap-data-enable命令用来恢复缺省情况。

undo encap-data-enable

encap-data-enable

【缺省情况】

在SA报文中只包含（S，G）表项，不封装组播数据报文。

MSDP视图

# 在公网实例中使能在SA报文中封装组播数据报文。

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] encap-data-enable

1.1.7 import-source

import-source命令用来配置SA报文的创建规则。

undo import-source命令用来取消SA报文的创建规则。

import-source [ acl acl-number ]

undo import-source

【缺省情况】

在创建SA报文时，对其通告的（S，G）表项不作限制，即SA报文通告域内所有的（S，G）表项。

MSDP视图

acl-number：指定IPv4基本或高级ACL的编号，取值范围为2000～3999。如果指定了本参数，则对通告的（S，G）表项进行过滤；如果未指定本参数、指定的ACL不存在或ACL中未配置有效规则，则过滤掉所有（S，G）表项。在进行规则匹配时，对ACL规则中的协议号将不作检查。

【描述】

· 对于IPv4基本ACL，该ACL规则中的source参数用来指定组播组的地址范围，若指定了vpn-instance参数则此规则不生效，而除fragment和time-range以外的其它可选参数都将被忽略。

· 对于IPv4高级ACL，该ACL规则中的source参数用来指定组播源的地址范围，destination参数用来指定组播组的地址范围，若指定了vpn-instance参数则此规则不生效，而除fragment和time-range以外的其它可选参数都将被忽略。

· 除了可以使用本命令控制SA报文的创建，还可以使用peer sa-policy命令控制SA报文的接收和转发。

# 在公网实例中配置MSDP对等体创建SA报文时，通告组播路由表中的特定的（S，G）表项：组播源在10.10.0.0/16网段，组播组地址为225.1.0.0/16。

<Sysname> system-view

[Sysname] acl number 3101

[Sysname-acl-adv-3101] rule permit ip source 10.10.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255

[Sysname-acl-adv-3101] quit

[Sysname] msdp

[Sysname-msdp] import-source acl 3101