Login
- Table of Contents
-
- 07-IP Multicast Command Reference
- 00-Preface
- 01-IGMP Snooping Commands
- 02-PIM Snooping Commands
- 03-Multicast VLAN Commands
- 04-Multicast Routing and Forwarding Commands
- 05-IGMP Commands
- 06-PIM Commands
- 07-MSDP Commands
- 08-MBGP Commands
- 09-Multicast VPN Commands
- 10-MLD Snooping Commands
- 11-IPv6 PIM Snooping Commands
- 12-IPv6 Multicast VLAN Commands
- 13-IPv6 Multicast Routing and Forwarding Commands
- 14-MLD Commands
- 15-IPv6 PIM Commands
- 16-IPv6 MBGP Commands
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 07-MSDP Commands | 150.09 KB |
Contents
cache-sa-enable
Syntax
cache-sa-enable
undo cache-sa-enable
View
Public instance MSDP view, VPN instance MSDP view
Default level
2: System level
Parameters
None
Description
Use the cache-sa-enable command to enable the SA message cache mechanism to cache the (S, G) entries contained in SA messages.
Use the undo cache-sa-enable command to disable the SA message cache mechanism.
By default, the SA message cache mechanism is enabled, that is, the device caches the (S, G) entries contained in received SA messages.
Examples
# Enable the SA message cache mechanism on the public network so that the device caches the (S, G) entries contained in received SA messages.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] cache-sa-enable
# Enable the SA message cache mechanism in VPN instance mvpn, so that the device caches the (S, G) entries contained in the received SA messages.
<Sysname> system-view
[Sysname] msdp vpn-instance mvpn
[Sysname-msdp-mvpn] cache-sa-enable
display msdp brief
Syntax
display msdp [all-instance | vpn-instance vpn-instance-name ] brief [ state { connect | down | listen | shutdown | up } ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
all-instance: Specifies all MPLS L3VPNs.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.
state: Displays the information of MSDP peers in the specified state.
connect: Displays the information of MSDP peers in the connecting state.
down: Displays the information of MSDP peers in the down state.
listen: Displays the information of MSDP peers in the listening state.
shutdown: Displays the information of MSDP peers in the deactivated state.
up: Displays the information of MSDP peers in the in-session state.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display msdp brief command to display brief information about MSDP peers.
If neither all-instance nor vpn-instance is specified, this command displays brief information about MSDP peers on the public instance.
Examples
# Display the brief information of MSDP peers in all states on the public network.
<Sysname> display msdp brief
MSDP Peer Brief Information of VPN-Instance: public net
Configured Up Listen Connect Shutdown Down
1 1 0 0 0 0
Peer's Address State Up/Down time AS SA Count Reset Count
20.20.20.20 Up 00:00:13 100 0 0
Table 1 Output description
|
Field |
Description |
|
MSDP Peer Brief Information of VPN-Instance: public net |
Brief information of MSDP peers of the public network |
|
Configured |
Number of MSDP peers configured |
|
Up |
Number of MSDP peers in the up state |
|
Listen |
Number of MSDP peers in the listen state |
|
Connect |
Number of MSDP peers in the connect state |
|
Shutdown |
Number of MSDP peers in the shutdown state |
|
Down |
Number of MSDP peers in the down state |
|
Peer's Address |
MSDP peer address |
|
State |
MSDP peer status: · Up: Session set up; MSDP peer in session · Listen: Session set up; local device as server, in listening state · Connect: Session not set up; local device as client, in connecting state · Shutdown: Deactivated · Down: Connection failed |
|
Up/Down time |
Length of time since MSDP peer connection was established/failed |
|
AS |
Number of the AS where the MSDP peer is located. “?” indicates that the system was unable to obtain the AS number. |
|
SA Count |
Number of (S, G) entries |
|
Reset Count |
MSDP peer connection reset times |
display msdp peer-status
Syntax
display msdp [all-instance | vpn-instance vpn-instance-name ] peer-status [ peer-address ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
all-instance: Specifies all MPLS L3VPNs.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.
peer-address: Specifies an MSDP peer by its address. If you do not provide this argument, this command displays status of all MSDP peers.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display msdp peer-status command to display MSDP peer status.
If neither all-instance nor vpn-instance is specified, this command displays MSDP peer status on the public instance.
Related commands: peer connect-interface, peer description, peer mesh-group, peer minimum-ttl, peer request-sa-enable, peer sa-cache-maximum, peer sa-policy, and peer sa-request-policy.
Examples
# Display the detailed status information of the MSDP peer with the address of 10.110.11.11 on the public network.
<Sysname> display msdp peer-status 10.110.11.11
MSDP Peer Information of VPN-Instance: public net
MSDP Peer 20.20.20.20, AS 100
Description:
Information about connection status:
State: Up
Up/down time: 14:41:08
Resets: 0
Connection interface: LoopBack0 (20.20.20.30)
Number of sent/received messages: 867/947
Number of discarded output messages: 0
Elapsed time since last connection or counters clear: 14:42:40
Information about (Source, Group)-based SA filtering policy:
Import policy: none
Export policy: none
Information about SA-Requests:
Policy to accept SA-Request messages: 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: none
Input queue size: 0, Output queue size: 0
Counters for MSDP message:
Count of RPF check failure: 0
Incoming/outgoing SA messages: 0/0
Incoming/outgoing SA requests: 0/0
Incoming/outgoing SA responses: 0/0
Incoming/outgoing data packets: 0/0
Table 2 Output description
|
Field |
Description |
|
MSDP Peer Information of VPN-Instance: public net |
MSDP peer information of the public network |
|
MSDP Peer |
MSDP peer address |
|
AS |
Number of the AS where the MSDP peer is located. “?” indicates that the system was unable to obtain the AS number. |
|
State |
MSDP peer status: · Up: Session set up; MSDP peer in session · Listen: Session set up; local device as server, in listening state · Connect: Session not set up; local device as client, in connecting state · Shutdown: Deactivated · Down: Connection failed |
|
Resets |
Number of times the MSDP peer connection is reset |
|
Up/Down time |
Length of time since MSDP peer connection was established/failed |
|
Connection interface |
Interface and its IP address used for setting up a TCP connection with the remote MSDP peer |
|
Number of sent/received messages |
Number of SA messages sent and received through this connection |
|
Number of discarded output messages |
Number of discarded outgoing messages |
|
Elapsed time since last connection or counters clear |
Time passed since the information of the MSDP peer was last cleared |
|
Information about (Source, Group)-based SA filtering policy |
SA message filtering list information · Import policy: Filter list for receiving SA messages from the specified MSDP peer · Export policy: Filter list for forwarding SA messages from the specified MSDP peer |
|
Information about SA-Requests |
SA requests information · Policy to accept SA-Request messages: Filtering rule for receiving or forwarding SA messages from the specified MSDP peer · Sending SA-Requests status: Whether enabled to send an SA request message to the designated MSDP peer upon receiving a new Join message |
|
Minimum TTL to forward SA with encapsulated data |
Minimum TTL of multicast packet encapsulated in SA messages |
|
SAs learned from this peer |
Number of (S, G) entries learned from this MSDP peer |
|
SA-cache maximum for the peer |
Maximum number of (S, G) entries learned from this MSDP peer that the device can cache |
|
Input queue size |
Data size cached in the input queue |
|
Output queue size |
Data size cached in the output queue |
|
Counters for MSDP message |
MSDP peer statistics: · Count of RPF check failure: Number of SA messages discarded due to RPF check failure · Incoming/outgoing SA messages: Number of SA messages received and sent · Incoming/outgoing SA requests: Number of SA request received and sent · Incoming/outgoing SA responses: Number of SA responses received and sent · Incoming/outgoing data packets: Number of received and sent SA messages encapsulated with multicast data |
display msdp sa-cache
Syntax
display msdp [all-instance | vpn-instance vpn-instance-name ] sa-cache [ group-address | source-address | as-number ] * [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
all-instance: Specifies all MPLS L3VPNs.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.
group-address: Multicast group address in the (S, G) entry, in the range of 224.0.1.0 to 239.255.255.255. If you do not provide any group address, this command displays the (S, G) entry information for all multicast groups.
source-address: Multicast source address in the (S, G) entry. If you do not provide any source address, this command displays the (S, G) entry information for all sources.
as-number: AS number, in the range of 1 to 4294967295. If you do not provide any AS number, this command displays the (S, G) entry information of all ASs.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display msdp sa-cache command to display the information of (S, G) entries in the SA cache.
If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.
If you provide neither a group address nor a source address, this command displays the information of all cached (S, G) entries.
This command gives the corresponding output only after the cache-sa-enable command is executed.
Related commands: cache-sa-enable.
Examples
# Display the information of (S, G) entries in the SA cache on the public network.
<Sysname> display msdp sa-cache
MSDP Source-Active Cache Information of VPN-Instance: public net
MSDP Total Source-Active Cache - 5 entries
MSDP matched 5 entries
(Source, Group) Origin RP Pro AS Uptime Expires
(10.10.1.2, 225.1.1.1) 10.10.10.10 BGP 100 00:00:11 00:05:49
(10.10.1.3, 225.1.1.1) 10.10.10.10 BGP 100 00:00:11 00:05:49
(10.10.1.2, 225.1.1.2) 10.10.10.10 BGP 100 00:00:11 00:05:49
(10.10.2.1, 225.1.1.2) 10.10.10.10 BGP 100 00:00:11 00:05:49
(10.10.1.2, 225.1.2.2) 10.10.10.10 BGP 100 00:00:11 00:05:49
Table 3 Output description
|
Field |
Description |
|
MSDP Source-Active Cache Information of VPN-Instance: public net |
SA cache information of the public network |
|
MSDP Total Source-Active Cache - 5 entries |
Total number of (S, G) entries in the SA cache |
|
MSDP matched 5 entries |
Total number of (S, G) entries matched by MSDP |
|
(Source, Group) |
(S, G) entry: (source address, group address) |
|
Origin RP |
Address of the RP that generated the (S, G) entry |
|
Pro |
Type of protocol from which the AS number is originated. “?” indicates that the system was unable to obtain the protocol type. |
|
AS |
AS number of the origin RP. “?” indicates that the system was unable to obtain the AS number. |
|
Uptime |
Length of time for which the cached (S, G) entry has been existing, in hours:minutes:seconds |
|
Expires |
Length of time in which the cached (S, G) entry will expire, in hours:minutes:seconds |
display msdp sa-count
Syntax
display msdp [all-instance | vpn-instance vpn-instance-name ] sa-count [ as-number ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
all-instance: Specifies all MPLS L3VPNs.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.
as-number: AS number, in the range of 1 to 4294967295.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display msdp sa-count command to display the number of (S, G) entries in the SA cache.
If neither all-instance nor vpn-instance is specified, this command displays the number of (S, G) entries in the SA cache on the public instance.
This command gives the corresponding output only after the cache-sa-enable command is executed.
Related commands: cache-sa-enable.
Examples
# Display the number of (S, G) entries in the SA cache on the public network.
<Sysname> display msdp sa-count
MSDP Source-Active Count Information of VPN-Instance: public net
Number of cached Source-Active entries, counted by Peer
Peer's Address Number of SA
10.10.10.10 5
Number of source and group, counted by AS
AS Number of source Number of group
? 3 3
Total 5 Source-Active entries
Table 4 Output description
|
Field |
Description |
|
MSDP Source-Active Count Information of VPN-Instance: public net |
Number of SA messages for the public network cache |
|
Number of cached Source-Active entries, counted by Peer |
Number of cached (S, G) entries per peer |
|
Peer's Address |
Address of the MSDP peer that sent SA messages |
|
Number of SA |
Number of (S, G) entries from this peer |
|
Number of source and group, counted by AS |
Number of cached (S, G) entries, counted by AS |
|
AS |
Number of the AS where the MSDP peer is located. “?” indicates that the system was unable to obtain the AS number. |
|
Number of source |
Number of multicast sources from this AS |
|
Number of group |
Number of multicast groups from this AS |
encap-data-enable
Syntax
encap-data-enable
undo encap-data-enable
View
Public instance MSDP view, VPN instance MSDP view
Default level
2: System level
Parameters
Description
Use the encap-data-enable command to enable register message encapsulation in SA messages.
Use the undo encap-data-enable command to disable register message encapsulation in SA messages.
By default, an SA message contains only an (S, G) entry. No register message is encapsulated in an SA message.
Examples
# Enable register message encapsulation in SA messages on the public network.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] encap-data-enable
# Enable register message encapsulation in SA messages in VPN instance mvpn.
<Sysname> system-view
[Sysname] msdp vpn-instance mvpn
[Sysname-msdp-mvpn] encap-data-enable
import-source
Syntax
import-source [ acl acl-number ]
undo import-source
View
Public instance MSDP view, VPN instance MSDP view
Default level
2: System level
Parameters
acl-number: Basic or advanced ACL number, in the range of 2000 to 3999. A basic ACL is used to filter multicast sources, while an advanced ACL is used to filter multicast sources or multicast groups. If you do not provide this argument in your command, no multicast source information will be advertised.
|
|
NOTE: During ACL matching, the protocol ID in the ACL rule is not checked. |
Description
Use the import-source command to configure a rule of creating (S, G) entries.
Use the undo import-source command to remove any rule of creating (S, G) entries.
By default, when an SA message is created, there are no restrictions on the (S, G) entries to be advertised in it, namely all the (S, G) entries within the domain are advertised in the SA message.
In addition to controlling SA message creation by using this command, you can also configure a filtering rule for forwarding and receiving SA messages by using the peer sa-policy command.
Related commands: peer sa-policy.
Examples
# Configure the MSDP peer on the public network to advertise only the (S, G) entries of multicast sources on the 10.10.0.0/16 subnet and with multicast group address of 225.1.0.0/16 when creating an SA message.
<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
# Configure the MSDP peer in VPN instance mvpn to advertise only the (S, G) entries of multicast sources on the 10.10.0.0/16 subnet and with multicast group address of 225.1.0.0/16 when creating an SA message.
<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 vpn-instance mvpn
[Sysname-msdp-mvpn] import-source acl 3101
msdp
Syntax
msdp [ vpn-instance vpn-instance-name ]
undo msdp [ vpn-instance vpn-instance-name ]
View
System view
Default level
2: System level
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command applies to the public network.
Description
Use the msdp command to enable MSDP on the public network or the specified VPN instance and enter public instance or VPN instance MSDP view.
Use the undo msdp command to disable MSDP on the public network or the specified VPN instance and remove the configurations performed in public instance or VPN instance MSDP view to free the resources occupied by MSDP.
By default, MSDP is disabled.
IP multicast must be enabled in the corresponding instance before this command can take effect.
Related commands: multicast routing-enable.
Examples
# Enable IP multicast routing on the public network, and enable MSDP on the public network to enter public instance MSDP view.
<Sysname> system-view
[Sysname] multicast routing-enable
[Sysname] msdp
[Sysname-msdp]
# Enable IP multicast routing in VPN instance mvpn, and enable MSDP in VPN instance mvpn to enter MSDP view of VPN instance mvpn.
<Sysname> system-view
[Sysname] ip vpn-instance mvpn
[Sysname-vpn-instance-mvpn]route-distinguisher 100:1
[Sysname-vpn-instance-mvpn] multicast routing-enable
[Sysname-vpn-instance-mvpn] quit
[Sysname] msdp vpn-instance mvpn
[Sysname-msdp-mvpn]
originating-rp
Syntax
originating-rp interface-type interface-number
undo originating-rp
View
Public instance MSDP view, VPN instance MSDP view
Default level
2: System level
Parameters
interface-type interface-number: Specifies an interface by its type and number.
Description
Use the originating-rp command to configure the address of the specified interface as the RP address of SA messages.
Use the undo originating-rp command to restore the default.
Be default, the PIM RP address is used as the RP address of SA messages.
Examples
# Specify the IP address of GigabitEthernet 3/1/1 as the RP address of SA messages on the public network.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] originating-rp GigabitEthernet 3/1/1
# In VPN instance mvpn, specify the IP address of GigabitEthernet 3/1/1 as the RP address of SA messages.
<Sysname> system-view
[Sysname] msdp vpn-instance mvpn
[Sysname-msdp-mvpn] originating-rp GigabitEthernet 3/1/1
peer connect-interface
Syntax
peer peer-address connect-interface interface-type interface-number
undo peer peer-address
View
Public instance MSDP view, VPN instance MSDP view
Default level
2: System level
Parameters
peer-address: MSDP peer address.
interface-type interface-number: Specifies an interface by its type and number. The local device will use the IP address of the specified interface as the source IP address when setting up a TCP connection with the remote MSDP peer.
Description
Use the peer connect-interface command to create an MSDP peer connection.
Use the undo peer connect-interface command to remove an MSDP peer connection.
No MSDP peer connection is created by default.
Be sure to execute this command before you use any other peer command. Otherwise, the system gives a prompt that the peer does not exist.
Related commands: static-rpf-peer.
Examples
# Configure the router with the IP address of 125.10.7.6 on the public network as the MSDP peer of the local router, with interface GigabitEthernet 3/1/1 as the local connection port.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 connect-interface GigabitEthernet 3/1/1
# In VPN instance mvpn, configure the router with the IP address of 125.10.7.6 as the MSDP peer of the local router, with interface GigabitEthernet 3/1/1 as the local connection port.
<Sysname> system-view
[Sysname] msdp vpn-instance mvpn
[Sysname-msdp-mvpn] peer 125.10.7.6 connect-interface GigabitEthernet 3/1/1
peer description
Syntax
peer peer-address description text
undo peer peer-address description
View
Public instance MSDP view, VPN instance MSDP view
Default level
2: System level
Parameters
peer-address: MSDP peer address.
text: Description centent, a case-sensitive string of 1 to 80 characters.
Description
Use the peer description command to configure the description information for the specified MSDP peer.
Use the undo peer description command to delete the configured description information of the specified MSDP peer.
By default, an MSDP peer has no description information.
Related commands: display msdp peer-status.
Examples
# In the public instance, add the descriptive text “CustomerA” for the router with the IP address of 125.10.7.6 to indicate that this router is Customer A.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 description Router CustomerA
# In VPN instance mvpn, add the descriptive text “CustomerA” for the router with the IP address of 125.10.7.6 to indicate that this router is Customer A.
<Sysname> system-view
[Sysname] msdp vpn-instance mvpn
[Sysname-msdp-mvpn] peer 125.10.7.6 description CustomerA
peer mesh-group
Syntax
peer peer-address mesh-group name
undo peer peer-address mesh-group
View
Public instance MSDP view, VPN instance MSDP view
Default level
2: System level
Parameters
peer-address: MSDP peer address.
name: Mesh group name, a case-sensitive string of 1 to 32 characters. A VPN instance name must not contain any space.
Description
Use the peer mesh-group command to configure an MSDP peer as a mesh group member.
Use the undo peer mesh-group command to remove an MSDP peer as a mesh group member.
By default, an MSDP peer does not belong to any mesh group.
Examples
# In the public instance, configure the MSDP peer with the IP address of 125.10.7.6 as a member of the mesh group “Group1”.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 mesh-group Grp1
# In VPN instance mvpn, configure the MSDP peer with the IP address of 125.10.7.6 as a member of the mesh group “Group1”.
<Sysname> system-view
[Sysname] msdp vpn-instance mvpn
[Sysname-msdp-mvpn] peer 125.10.7.6 mesh-group Group1
peer minimum-ttl
Syntax
peer peer-address minimum-ttl ttl-value
undo peer peer-address minimum-ttl
View
Public instance MSDP view, VPN instance MSDP view
Default level
2: System level
Parameters
peer-address: MSDP peer address.
ttl-value: Time-to-Live (TTL) threshold, in the range of 0 to 255.
Description
Use the peer minimum-ttl command to configure the TTL threshold for multicast data packets encapsulated in SA messages.
Use the undo peer minimum-ttl command to restore the default.
By default, the TTL threshold for a multicast data packet encapsulated in an SA message is 0.
Related commands: display msdp peer-status.
Examples
# In the public instance, set the TTL threshold for multicast data packets to be encapsulated in SA messages to 10 so that only multicast packets whose TTL value is larger than or equal to 10 can be forwarded to the MSDP peer 110.10.10.1.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] peer 110.10.10.1 minimum-ttl 10
# In VPN instance mvpn, set the TTL threshold for multicast packets to be encapsulated in SA messages to 10 so that only multicast data packets whose TTL value is larger than or equal to 10 can be encapsulated in SA messages and forwarded to the MSDP peer 110.10.10.1.
<Sysname> system-view
[Sysname] msdp vpn-instance mvpn
[Sysname-msdp-mvpn] peer 110.10.10.1 minimum-ttl 10
peer request-sa-enable
Syntax
peer peer-address request-sa-enable
undo peer peer-address request-sa-enable
View
Public instance MSDP view, VPN instance MSDP view
Default level
2: System level
Parameters
peer-address: MSDP peer address.
Description
Use the peer request-sa-enable command to enable the router to send an SA request message to the specified MSDP peer upon receiving a new Join message.
Use the undo peer request-sa-enable command to disable the device from sending SA request messages.
By default, upon receiving a new Join message, the router does not send an SA request message to its MSDP peer; instead, it waits for the next SA message from its MSDP peer.
Before you can enable the device to send SA requests, you must disable the SA message cache mechanism.
Related commands: cache-sa-enable.
Examples
# Disable the SA message cache mechanism on the public network, and enable the router to send an SA request message to the MSDP peer 125.10.7.6 upon receiving a new Join message.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] undo cache-sa-enable
[Sysname-msdp] peer 125.10.7.6 request-sa-enable
# Disable the SA message cache mechanism in VPN instance mvpn, and enable the router to send an SA request message to the MSDP peer 125.10.7.6 upon receiving a new Join message.
<Sysname> system-view
[Sysname] msdp vpn-instance mvpn
[Sysname-msdp-mvpn] undo cache-sa-enable
[Sysname-msdp-mvpn] peer 125.10.7.6 request-sa-enable
peer sa-cache-maximum
Syntax
peer peer-address sa-cache-maximum sa-limit
undo peer peer-address sa-cache-maximum
View
Public instance MSDP view, VPN instance MSDP view
Default level
2: System level
Parameters
peer-address: MSDP peer address.
sa-limit: Maximum number of (S, G) entries that the device can cache, in the range of 1 to 8,192.
Description
Use the peer sa-cache-maximum command to configure the maximum number of (S, G) entries learned from the specified MSDP peer that the device can cache.
Use the undo peer sa-cache-maximum command to restore the default.
By default, the device can cache a maximum of 8,192 (S, G) entries learned from any MSDP peer.
Related commands: display msdp brief, display msdp peer-status, and display msdp sa-count.
Examples
# In the public instance allow the device to cache a maximum of 100 (S, G) entries learned from the MSDP peer 125.10.7.6.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 sa-cache-maximum 100
# In VPN instance mvpn, enable the device to cache a maximum of 100 (S, G) entries learned from its MSDP peer 125.10.7.6.
<Sysname> system-view
[Sysname] msdp vpn-instance mvpn
[Sysname-msdp-mvpn] peer 125.10.7.6 sa-cache-maximum 100
peer sa-policy
Syntax
peer peer-address sa-policy { import | export } [ acl acl-number ]
undo peer peer-address sa-policy { import | export }
View
Public instance MSDP view, VPN instance MSDP view
Default level
2: System level
Parameters
import: Specifies to filter SA messages from the specified MSDP peer.
export: Specifies to filter SA messages forwarded to the specified MSDP peer.
peer-address: MSDP peer address.
acl-number: Advanced ACL number, in the range of 3000 to 3999. If you do not provide an ACL number, all SA messages carrying (S, G) entries will be filtered off.
Description
Use the peer sa-policy command to configure a filtering rule for receiving or forwarding SA messages.
Use the undo peer sa-policy command to restore the default.
By default, SA messages received or to be forwarded are not filtered, namely, all SA messages are accepted or forwarded.
In addition to controlling SA message receiving and forwarding by using this command, you can also configure a filtering rule for creating SA messages using the import-source command.
Related commands: display msdp peer-status and import-source.
Examples
# Configure a filtering rule on the public network so that SA messages will be forwarded to MSDP peer 125.10.7.6 only if they match ACL 3100.
<Sysname> system-view
[Sysname] acl number 3100
[Sysname-acl-adv-3100] rule permit ip source 170.15.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255
[Sysname-acl-adv-3100] quit
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 connect-interface GigabitEthernet 3/1/1
[Sysname-msdp] peer 125.10.7.6 sa-policy export acl 3100
# In VPN instance mvpn, configure a filtering rule so that SA messages will be forwarded to the MSDP peer 125.10.7.6 only if they match ACL 3100.
<Sysname> system-view
[Sysname] acl number 3100
[Sysname-acl-adv-3100] rule permit ip source 170.15.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255
[Sysname-acl-adv-3100] quit
[Sysname] msdp vpn-instance mvpn
[Sysname-msdp-mvpn] peer 125.10.7.6 connect-interface vlan-interface 100
[Sysname-msdp-mvpn] peer 125.10.7.6 sa-policy export acl 3100
peer sa-request-policy
Syntax
peer peer-address sa-request-policy [ acl acl-number ]
undo peer peer-address sa-request-policy
View
Public instance MSDP view, VPN instance MSDP view
Default level
2: System level
Parameters
peer-address: MSDP peer address.
acl-number: Basic ACL number, in the range of 2000 to 2999. If you provide this argument, the SA requests of only the multicast groups that match the ACL will be accepted and other SA requests will be ignored. If you do not provide this argument, all SA requests will be ignored.
Description
Use the peer sa-request-policy command to configure a filtering rule for SA request messages.
Use the undo peer sa-request-policy command to remove the configured SA request filtering rule.
Be default, SA request messages are not filtered.
Related commands: display msdp peer-status.
Examples
# Configure an SA request filtering rule on the public network so that SA messages from the MSDP peer 175.58.6.5 will be accepted only if the multicast group address in the SA messages is in the range of 225.1.1.0/24.
<Sysname> system-view
[Sysname] acl number 2001
[Sysname-acl-basic-2001] rule permit source 225.1.1.0 0.0.0.255
[Sysname-acl-basic-2001] quit
[Sysname] msdp
[Sysname-msdp] peer 175.58.6.5 sa-request-policy acl 2001
# Configure an SA request filtering rule in VPN instance mvpn so that SA messages from the MSDP peer 175.58.6.5 will be accepted only if the multicast group address in the SA messages is in the range of 225.1.1.0/24.
<Sysname> system-view
[Sysname] acl number 2001
[Sysname-acl-basic-2001] rule permit source 225.1.1.0 0.0.0.255
[Sysname-acl-basic-2001] quit
[Sysname] msdp vpn-instance mvpn
[Sysname-msdp-mvpn] peer 175.58.6.5 sa-request-policy acl 2001
reset msdp peer
Syntax
reset msdp [all-instance | vpn-instance vpn-instance-name ] peer [ peer-address ]
View
User view
Default level
2: System level
Parameters
all-instance: Specifies all MPLS L3VPNs.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.
peer-address: Specifies an MSDP peer by its address. If you do not provide this argument, the TCP connections with all MSDP peers will be reset.
Description
Use the reset msdp peer command to reset the TCP connection with the specified MSDP peer and clear statistics for the MSDP peers.
If neither all-instance nor vpn-instance is specified, this command resets the TCP connection with the MSDP peers and clear statistics for the MSDP peers on the public instance.
This command takes effect after IP multicast routing is enabled in the specified VPN.
Related commands: display msdp peer-status.
Examples
# Reset the TCP connection on the public network with the MSDP peer 125.10.7.6 and clear statistics for this MSDP peer.
<Sysname> reset msdp peer 125.10.7.6
reset msdp sa-cache
Syntax
reset msdp [all-instance | vpn-instance vpn-instance-name ] sa-cache [ group-address ]
View
User view
Default level
2: System level
Parameters
all-instance: Specifies all MPLS L3VPNs.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.
group-address: Specifies a multicast group related to which the (S, G) entries are to be cleared from the SA cache. The value ranges from 224.0.1.0 to 239.255.255.255. If you do not provide this argument, the command clears the (S, G) entries for all multicast groups from the SA cache.
Description
Use the reset msdp sa-cache command to clear (S, G) entries from the SA cache.
If neither all-instance nor vpn-instance is specified, this command clears (S, G) entries from the SA cache on the public instance.
Related commands: cache-sa-enable and display msdp sa-cache.
Examples
# Clear the (S, G) entries for the multicast group 225.5.4.3 from the SA cache on the public network.
<Sysname> reset msdp sa-cache 225.5.4.3
reset msdp statistics
Syntax
reset msdp [all-instance | vpn-instance vpn-instance-name ] statistics [ peer-address ]
View
User view
Default level
2: System level
Parameters
all-instance: Specifies all MPLS L3VPNs.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.
peer-address: Specifies an MSDP peer. If you do not provide this argument, the command clears statistics for all MSDP peers.
Description
Use the reset msdp statistics command to clear statistics for the specified MSDP peer without resetting the connection with the MSDP peers.
If neither all-instance nor vpn-instance is specified, this command clear statistics for the specified MSDP peers on the public instance.
Examples
# Clear statistics for the MSDP peer 125.10.7.6 on the public network.
<Sysname> reset msdp statistics 125.10.7.6
shutdown (MSDP View)
Syntax
shutdown peer-address
undo shutdown peer-address
View
Public instance MSDP view, VPN instance MSDP view
Default level
2: System level
Parameters
peer-address: MSDP peer address.
Description
Use the shutdown command to deactivate manually the connection with the specified MSDP peer.
Use the undo shutdown command to reactivate the connection with the specified MSDP peer.
By default, the connections with all MSDP peers are active.
Related commands: display msdp peer-status.
Examples
# Deactivate the connection with the MSDP peer 125.10.7.6 on the public network.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] shutdown 125.10.7.6
# Terminate the connection with the MSDP peer 125.10.7.6 in VPN instance mvpn.
<Sysname> system-view
[Sysname] msdp vpn-instance mvpn
[Sysname-msdp-mvpn] shutdown 125.10.7.6
static-rpf-peer
Syntax
static-rpf-peer peer-address [ rp-policy ip-prefix-name ]
undo static-rpf-peer peer-address
View
Public instance MSDP view, VPN instance MSDP view
Default level
2: System level
Parameters
peer-address: MSDP peer address.
rp-policy ip-prefix-name: Specifies a filtering policy based on the RP address in SA messages, where ip-prefix-name is the filtering policy name, a case-sensitive string of 1 to 19 characters.
Description
Use the static-rpf-peer command to configure a static RPF peer.
Use the undo static-rpf-peer command to remove a static RPF peer.
No static RPF peer is configured by default.
When you configure multiple static RPF peers, observe the follow rules:
1. If you use the rp-policy keyword for all the static RPF peers, all the static RPF peers take effect concurrently. SA messages will be filtered as per the configured prefix list and only those SA messages whose RP addresses pass the filtering will be accepted. If multiple static RPF peers use the same filtering policy at the same time, when a peer receives an SA message, it will forward the SA message to the other peers.
2. If you use the rp-policy keyword for none of the static RPF peers, according to the configuration sequence, only the first static RPF peer whose connection is in the UP state will be activated, and all SA messages from this peer will be accepted while the SA messages from other static RPF peers will be discarded. When this active static RPF peer fails (for example, when the configuration is removed or when the connection is torn down), still the first RPF peer whose connection is in UP state will be selected as the activated RPF peer according to the configuration sequence.
Related commands: display msdp peer-status and ip prefix-list.
Examples
# Configure static RPF peers on the public network.
<Sysname> system-view
[Sysname] ip ip-prefix list1 permit 130.10.0.0 16 great-equal 16 less-equal 32
[Sysname] msdp
[Sysname-msdp] peer 130.10.7.6 connect-interface GigabitEthernet 3/1/1
[Sysname-msdp] static-rpf-peer 130.10.7.6 rp-policy list1
# Configure static RPF peers in VPN instance mvpn.
<Sysname> system-view
[Sysname] ip ip-prefix list1 permit 130.10.0.0 16 great-equal 16 less-equal 32
[Sysname] msdp vpn-instance mvpn
[Sysname-msdp-mvpn] peer 130.10.7.6 connect-interface GigabitEthernet 3/1/1
[Sysname-msdp-mvpn] static-rpf-peer 130.10.7.6 rp-policy list1
timer retry
Syntax
timer retry interval
undo timer retry
View
Public instance MSDP view, VPN instance MSDP view
Default level
2: System level
Parameters
interval: Interval between MSDP peer connection retries, in seconds. The value ranges from 1 to 60.
Description
Use the timer retry command to configure the interval between MSDP peer connection retries.
Use the undo timer retry command to restore the default.
By default, the interval between MSDP peer connection retries is 30 seconds.
Related commands: display msdp peer-status.
Examples
# Set the MSDP peer connection retry interval to 60 seconds on the public network.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] timer retry 60
# Set the MSDP peer connection retry interval to 60 seconds in VPN instance mvpn.
<Sysname> system-view
[Sysname] msdp vpn-instance mvpn
[Sysname-msdp-mvpn] timer retry 60
