-
Cisco IOS XR Multicast Command Reference, Release 3.8
-
Preface
-
Multicast IPv4 and IPv6 Commands on Cisco IOS XR Software
-
Multicast Routing and Forwarding Commands on Cisco IOS XR Software
-
Multicast Source Discovery Protocol Commands on Cisco IOS XR Software
-
Multicast PIM Commands on Cisco IOS XR Software
-
Multicast Tool and Utility Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
Multicast Source Discovery Protocol Commands on Cisco IOS XR Software
Multicast Source Discovery Protocol Commands on Cisco IOS XR Software
This chapter describes the commands used to configure and monitor the Multicast Source Discovery Protocol (MSDP) on Cisco IOS XR software.
For detailed information about multicast routing concepts, configuration tasks, and examples, refer to the Implementing Multicast Routing on Cisco IOS XR Software configuration module in Cisco IOS XR Multicast Configuration Guide.
cache-sa-holdtime
To configure the cache source-active (SA) state hold-time period on a router, use the cache-sa-holdtime command in router MSDP configuration mode. To return to the default behavior, use the no form of this command.
cache-sa-holdtime holdtime-number
no cache-sa-holdtime holdtime-number
Syntax Description
Defaults
holdtime-number: 150 seconds
Command Modes
Router MSDP configuration
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
The cache-sa-holdtime command is used to increase the cache SA state hold time. Any cache entry that is created usually expires after 150 seconds. For troubleshooting purposes, you may need Multicast Source Discovery Protocol (MSDP) to keep SA cache entries for a longer period.
Task ID
Examples
The following example shows how to set the cache SA state hold-time period to 200 seconds:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# cache-sa-holdtime 200Related Commands
cache-sa-state
To control cache source-active (SA) state on a router, use the cache-sa-state command in router MSDP configuration mode. To return to the default behavior, use the no form of this command.
cache-sa-state {list access-list-number | rp-list access-list-name}
no cache-sa-state {list access-list-number | rp-list access-list-name}
Syntax Description
list access-list-number
Specifies an IP access list that defines which (S, G) pairs to cache.
rp-list access-list-name
Specifies an access list name for the originating rendezvous point (RP).
Defaults
The router creates SA state.
Command Modes
Router MSDP configuration
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
When a new member joins a group immediately after an SA message arrives, latency may occur and an SA message may be missed. To overcome this problem, you can configure this command and the router will supply SA information (from cache memory) to the new member instead of requiring that the member wait until the next SA message is received.
The cache-sa-state command is required in every Multicast Source Discovery Protocol (MSDP) speaker, to cache SA messages received from peers.
Task ID
Examples
The following example shows how to configure the cache state for all sources in 10.0.0.0/16 sending to groups 224.2.0.0/16:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# cache-sa-state list 100RP/0/RP0/CPU0:router(config-msdp)# exitRP/0/RP0/CPU0:router(config)# ipv4 access-list 100 permit 10.0.0.0 0.0.255.255 224.2.0.0 0.0.255.255
Note
The source and destination fields in the access list matches on the (S,G) fields in the SA messages. We recommend that the first address and mask field in the access list is used for the source and the second field in the access list is used for the group or destination.
Related Commands
clear msdp peer
To clear the TCP connection of the specified Multicast Source Discovery Protocol (MSDP) peer, use the clear msdp peer command in EXEC mode.
clear msdp [ipv4] peer peer-address
Syntax Description
ipv4
(Optional) Specifies IPv4 address prefixes.
peer-address
IPv4 address or hostname of the MSDP peer to which the TCP connection is cleared.
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
The clear msdp peer command closes the TCP connection to the MSDP peer, resets all the MSDP peer statistics, and clears the input and output queues to and from the MSDP peer.
Task ID
Examples
The following example shows how to clear the TCP connection of the MSDP peer at address 224.15.9.8:
RP/0/RP0/CPU0:router# clear msdp peer 224.15.9.8Related Commands
clear msdp sa-cache
To clear external Multicast Source Discovery Protocol (MSDP) source-active (SA) cache entries, use the clear msdp sa-cache command in EXEC mode.
clear msdp [ipv4] sa-cache [group-address]
Syntax Description
ipv4
(Optional) Specifies IPv4 address prefixes.
group-address
(Optional) Multicast group address or name for which external SA entries are cleared from the SA cache.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Note
If you do not specify a multicast group by group address or group name with the group-address argument, the clear msdp sa-cache command clears all external SA cache entries.
Note
Task ID
Examples
The following example shows how to clear the external SA entries for the multicast group at address 224.5.6.7 from the cache:
RP/0/RP0/CPU0:router# clear msdp sa-cache 224.5.6.7Related Commands
clear msdp stats
To reset Multicast Source Discovery Protocol (MSDP) peer statistic counters, use the clear msdp stats command in EXEC mode.
clear msdp [ipv4] stats [peer peer-address] [allvalues]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
The clear msdp stats command resets MSDP peer statistic counters such as the number of keepalives sent and received and the number of Source Active (SA) entries sent and received.
If you do not specify an MSDP peer with the peer keyword and peer-address argument, this command clears statistic counters for all MSDP peers.
Task ID
Examples
The following example shows how to clear all statistics for all peers:
RP/0/RP0/CPU0:router# clear msdp stats peer 224.0.1.1Related Commands
connect-source
To configure a source address used for a Multicast Source Discovery Protocol (MSDP) connection, use the connect-source command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
connect-source type [path-id]
no connect-source type [path-id]
Syntax Description
Defaults
If a source address is not configured for the MSDP connection, the IP address of the interface toward the peer is used as a source address.
Command Modes
Router MSDP configuration
Router MSDP peer configurationCommand History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
The connect-source command:
•
•
•
Task ID
Examples
The following example shows how to configure a loopback interface source address for an MSDP connection:
RP/0/RP0/CPU0:router(config)# interface loopback 0RP/0/RP0/CPU0:router(config-if)# ipv4 address 10.1.1.1/24RP/0/RP0/CPU0:router(config-if)# exitRP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# connect-source loopback 0default-peer
To define a default peer from which to accept all Multicast Source Discovery Protocol (MSDP) source-active (SA) messages, use the default-peer command in router MSDP configuration mode. To return to the default behavior, use the no form of this command.
default-peer ip-address
no default-peer
Syntax Description
Defaults
No default MSDP peer exists.
Command Modes
Router MSDP configuration
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
A default peer configuration accepts all MSDP Source-Active (SA) messages, as a last Reverse Path Forwarding (RPF) rule, when all other MSDP RPF rules fail.
Use the default-peer command if you do not want to configure your MSDP peer to be a BGP peer also.
When the prefix-list list keyword and argument are not specified, all SA messages received from the configured default peer are accepted.
Remember to configure a BGP prefix list to configure the prefix-list list keyword and argument with the default-peer command.
Task ID
Examples
The following example shows how to configure the router 172.16.12.0 as the default peer to the local router:
RP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# default-peer 172.16.12.0Related Commands
description (peer)
To add descriptive text to the configuration for a Multicast Source Discovery Protocol (MSDP) peer, use the description command in peer configuration mode. To return to the default behavior, use the no form of this command.
description peer-address text
no description peer-address text
Syntax Description
peer-address
IP address or hostname for the peer to which this description applies.
text
Description of the MSDP peer. Use up to 80 characters to describe this peer.
Defaults
No description is associated with an MSDP peer.
Command Modes
Router MSDP peer configuration
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Configure a description to make the MSDP peer easier to identify. This description is visible in the show msdp peer command output.
Task ID
Examples
The following example shows how to configure the router at the IP address 10.0.5.4 with a description indicating that it is a router at customer site A:
RP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# peer 10.0.5.4RP/0/RP0/CPU0:router(config-msdp-peer)# description 10.0.5.4 router_at_customer_site_ARelated Commands
Enters peer configuration mode and configures an MSDP peer.
Displays information about the MSDP peer.
maximum external-sa
To configure the maximum number of external Multicast Source Discovery Protocol (MSDP) source-active (SA) entries that can be learned by the router or by a specific MSDP peer, use the maximum external-sa command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
maximum external-sa entries
no maximum external-sa
Syntax Description
entries
Maximum number of SA entries that can be learned by the router or a specific MSDP peer. Range is 1 to 75000.
Defaults
entries: 20000
Command Modes
Router MSDP peer configuration
Router MSDP configurationCommand History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
When issued from router MSDP configuration mode, the maximum external-sa command configures the total number of external SA entries (that is, the total cumulative SA state for all peers) that can be learned by the router. This command is used to control router resource utilization under heavy traffic conditions.
Note
When issued from MSDP peer configuration mode, the maximum external-sa command configures the total number of external SA entries that can be learned by a specific MSDP peer. From MSDP configuration mode, this command can also be used to configure a specific MSPD peer to override the maximum external SA entry value configured with the maximum peer-external-sa command.
Note
Task ID
Examples
This example shows how to configure the maximum number of external SA entries that can be learned by the router to 30000 SA entries:
RP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# maximum external-sa 30000This example shows how to configure the maximum number of external SA entries that can be learned by the MSDP peer at address 10.1.5.3 to 25000 SA entries:
RP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# peer 10.1.5.3RP/0/RP0/CPU0:router(config-msdp-peer)# maximum external-sa 25000Related Commands
Configures the maximum number of external SA entries that can be learned from MSDP peers.
Displays MSDP peer status.
maximum peer-external-sa
To configure the maximum number of external Multicast Source Discovery Protocol (MSDP) Source-Active (SA) entries that can be learned from MSDP peers, use the maximum peer-external-sa command in router MSDP configuration mode. To return to the default behavior, use the no form of this command.
maximum peer-external-sa entries
no maximum peer-external-sa
Syntax Description
Defaults
entries: 20000
Command Modes
Router MSDP configuration
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
The maximum peer-external-sa command configures the maximum number of external SA entries that can be learned for each configured MSDP peer, whereas the maximum external-sa command (in router MSDP configuration mode) configures the maximum number of SA entries accepted by the router as a cumulative total.
Note
Task ID
Examples
This example shows how to configure the maximum number of external SA entries that each MSDP peer can learn to 27000 SA entries:
RP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# maximum peer-external-sa 27000Related Commands
Configures the maximum number of external SA entries that can be learned by the router.
Displays MSDP peer status.
mesh-group (peer)
To configure a Multicast Source Discovery Protocol (MSDP) peer to be a member of a mesh group, use the mesh-group command in peer configuration mode. To return to the default behavior, use the no form of this command.
mesh-group name
no mesh-group name
Syntax Description
Defaults
MSDP peers do not belong to a mesh group.
Command Modes
Router MSDP peer configuration
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
A mesh group is a group of MSDP speakers that have fully meshed MSDP connectivity among themselves. Any Source-Active (SA) messages received from a peer in a mesh group are not forwarded to other peers in the same mesh group.
Mesh groups can be used to:
•
•
Task ID
Examples
The following example shows how to configure the MSDP peer at address 10.0.5.4 to be a member of the mesh group named internal:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# peer 10.0.5.4RP/0/RP0/CPU0:router(config-msdp-peer)# mesh-group internaloriginator-id
To identify an interface type and instance to be used as the rendezvous point (RP) address in a Multicast Source Discovery Protocol (MSDP) Source-Active (SA) message, use the originator-id command in router MSDP configuration mode. To return to the default behavior, use the no form of this command.
originator-id type path-id
no originator-id type path-id
Syntax Description
Defaults
The RP address is used as the originator ID.
Command Modes
Router MSDP configuration
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
The originator-id command allows an MSDP speaker that originates an SA message to use the IP address of the interface as the RP address in the SA message.
Task ID
Examples
The following example shows how to configure Packet-over-SONET/SDH (POS) interface 0/1/1/0 to be used as the RP address in SA messages:
RP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# originator-id pos 0/1/1/0password (peer)
To enable Message Digest 5 (MD5) authentication on a TCP connection between two Multicast Source Discovery Protocol (MSDP) peers, use the password command in MSDP peer configuration mode. To return to the default behavior, use the no form of this command.
password {clear | encrypted} password
no password {clear | encrypted} password
Syntax Description
Defaults
No password is configured.
Command Modes
Router MSDP peer configuration
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
The password command supports MD5 signature protection on a TCP connection between two MSDP peers. When MD5 authentication is enabled between two MSDP peers, each segment sent on the TCP connection between the peers is verified. MD5 authentication must be configured with the same password on both MSDP peers; otherwise, the connection between them is not made. Configuring MD5 authentication causes the Cisco IOS XR software to generate and verify the MD5 digest of every segment sent on the TCP connection.
Use the show msdp peer command to check if a password has been configured on a peer.
Task ID
Examples
The following example shows how to configure the MSDP password on a peer:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# peer 10.0.5.4RP/0/RP0/CPU0:router(config-msdp-peer)# password encrypted a34bi5mRelated Commands
peer (MSDP)
To configure a Multicast Source Discovery Protocol (MSDP) peer, use the peer command in router MSDP configuration mode. To return to the default behavior, use the no form of this command.
peer peer-address
no peer peer-address
Syntax Description
Defaults
No MSDP peer is configured.
Command Modes
Router MSDP configuration
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Configure the specified router as a Border Gateway Protocol (BGP) neighbor.
If you are also BGP peering with this MSDP peer, use the same IP address for MSDP as you do for BGP. However, you are not required to run BGP or multiprotocol BGP with the MSDP peer, as long as there is a BGP or multiprotocol BGP path between the MSDP peers. If there is no path, you must configure the default-peer command from router MSDP configuration mode.
Task ID
Examples
The following example shows how to configure the router at the IP address 172.16.1.2 as an MSDP peer to the local router and enter MSDP peer configuration mode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# peer 172.16.1.2RP/0/RP0/CPU0:router(config-msdp-peer)#Related Commands
Defines a default peer from which to accept all MSDP Source-Active (SA) messages.
remote-as (multicast)
To configure the remote autonomous system number of this peer, use the remote-as command in peer configuration mode. To return to the default behavior, use the no form of this command.
remote-as as-number
no remote-as as-number
Syntax Description
as-number
Autonomous system number of this peer. Range for 2-byte numbers is 1 to 65535. Range for 4-byte numbers is 1.0 to 65535.65535.
Defaults
If this command is not issued during peer configuration, the remote autonomous system value is derived from BGP (if also configured) or initialized to zero, when only Interior Gateway Protocol (IGP) is present.
Command Modes
Router MSDP peer configuration
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Use the remote-as command to configure remote autonomous system if deriving the autonomous system value from the configured Border Gateway Protocol (BGP) is not required.
Task ID
Examples
The following example shows how to set the autonomous system number for the specified peer to 250:
RP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# peer 172.16.5.4RP/0/RP0/CPU0:router(config-msdp-peer)# remote-as 250sa-filter
To configure an incoming or outgoing filter list for Source-Active (SA) messages received from the specified Multicast Source Discovery Protocol (MSDP) peer, use the sa-filter command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
sa-filter {in | out} {list access-list-name | rp-list access-list-name}
no sa-filter {in | out} {list access-list-name | rp-list access-list-name}
Syntax Description
Defaults
If the sa-filter command is not configured, no incoming or outgoing messages are filtered; all incoming SA messages are accepted from the peer, and all outgoing SA messages received are forwarded to the peer.
Command Modes
Router MSDP configuration
Router MSDP peer configurationCommand History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Note
Task ID
Examples
In the following example, only (S, G) pairs that pass access list 10 are forwarded in an SA message to the peer with IP address 131.107.5.4:
RP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# peer 131.107.5.4RP/0/RP0/CPU0:router(config-msdp-peer)# sa-filter out list_10In the following example, only (S, G) pairs for the rendezvous point that passes access list 151 are forwarded in an SA message to the peer with the IP address 131.107.5.4:
RP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# peer 131.107.5.4RP/0/RP0/CPU0:router(config-msdp-peer)# sa-filter out rp-list list_151
Note
Related Commands
show msdp globals
To display the Multicast Source Discovery Protocol (MSDP) global variables, use the show msdp globals command in EXEC mode.
show msdp [ipv4] globals
Syntax Description
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Some global variables associated with MSDP sessions are displayed, such as the originator ID, default peer, connection state with Protocol Independent Multicast (PIM), Source, and so on.
Task ID
Examples
The following is sample output from the show msdp globals command:
RP/0/RP0/CPU0:router# show msdp globalsMulticast Source Discovery Protocol - msdp[405672]AS: 10, caching, originator: not set, default peer: not setConnected to PIM: yesActive RP Grange/len Source CountADV/RPF (Total, Active)10.10.2.1 224.0.0.0/4 0,010.10.10.3 0.0.0.0 1,1Max/active group count: 1/1Max/active SA count: 1/1General statsCurrent lists alloced/free: 2/0Total list items alloced/free: 9/1Total source buffers alloced/free: 1/0Total group buffers alloced/free: 1/0Total RP buffers alloced/free: 2/0TLV buffers alloced/free: 1/1Table 23 describes the significant fields shown in the display.
Related Commands
Displays information about the MSDP peer.
Displays (S, G) state learned from MSDP peers.
show msdp peer
To display information about the Multicast Source Discovery Protocol (MSDP) peer, use the show msdp peer command in EXEC mode.
show msdp [ipv4] peer [peer-address]
Syntax Description
ipv4
(Optional) Specifies IPv4 address prefixes.
peer-address
(Optional) IP address or hostname of the MSDP peer for which information is displayed.
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following is sample output from the show msdp peer command:
RP/0/RP0/CPU0:router# show msdp peer 10.10.10.2MSDP Peer 10.10.10.2 (?), AS 20Description:Connection status:State: Up, Resets: 0, Connection Source: 10.10.10.12Uptime(Downtime): 00:00:26, SA messages received: 0TLV messages sent/received: 1/1Output messages discarded: 0Connection and counters cleared 00:00:26 agoSA Filtering:Input (S,G) filter: noneInput RP filter: noneOutput (S,G) filter: noneOutput RP filter: noneSA-Requests:Input filter: noneSending SA-Requests to peer: disabledPassword: NonePeer ttl threshold: 0Input queue size: 0, Output queue size: 0Table 24 describes the significant fields shown in the display.
Related Commands
Enters peer configuration mode and configures an MSDP peer.
Displays (S, G) state learned from MSDP peers.
show msdp rpf
To display the Multicast Source Discovery Protocol (MSDP) Reverse Path Forwarding (RPF) rule that governs whether an Source-Active (SA) from an originating RP will be accepted, use the show msdp rpf command in EXEC mode.
show msdp [ipv4] rpf rpf-address
Syntax Description
ipv4
(Optional) Specifies IPv4 address prefixes.
rpf-address
IP address or hostname of the RPF next hop.
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
The show msdp rpf command displays the peer interface and autonomous system to which the SAs are sent and forwarded based on the MSDP RPF rule. The rule is displayed and applied on the RP address field of the arriving SAs.
Task ID
Examples
The following is sample output from the show msdp rpf command for RP peer 10.1.1.1:
RP/0/RP0/CPU0:router# show msdp rpf 10.1.1.1RP peer for 172.16.1.1 is 10.1.1.1 AS 200, rule: 1bgp/rib lookup: nexthop: 10.1.1.1, asnum: 200Table 25 describes the significant fields shown in the display.
show msdp sa-cache
To display the (S, G) state learned from Multicast Source Discovery Protocol (MSDP) peers, use the show msdp sa-cache command in EXEC mode.
show msdp [ipv4] sa-cache [source-address] [group-address] [all] [asnum as-number] [peer peer-address] [rpaddr rp-address] [summary]
Syntax Description
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
The show msdp sa-cache command is used to examine the (S, G) entries and the attributes, flags (L, E, EA), uptime, autonomous system number, and RP addresses that are stored in the SA cache.
The following guidelines apply when this command is used:
•
•
•
•
•
Task ID
Examples
The following is sample output from the show msdp sa-cache command:
RP/0/RP0/CPU0:router# show msdp sa-cacheMSDP Flags:E - set MRIB E flag, L - domain local source is active,EA - externally active source, PI - PIM is interested in the group,DE - SAs have been denied.Cache Entry:(10.10.5.102, 239.1.1.1), RP 10.10.4.3, MBGP/AS 20, 15:44:03/00:01:17Learned from peer 10.10.2.2, RPF peer 10.10.2.2SA's recvd 1049, Encapsulated data received: 0grp flags: PI, src flags: E, EA, PITable 26 describes the significant fields shown in the display.
The following is sample output using the all keyword option:
RP/0/RP0/CPU0:router# show msdp sa-cache allMSDP Flags:E - set MRIB E flag , L - domain local source is active,EA - externally active source, PI - PIM is interested in the group,DE - SAs have been denied. Timers age/expiration,Cache Entry:(*, 239.1.1.1), RP 0.0.0.0, MBGP/AS 0, 06:32:18/expiredLearned from peer local, RPF peer localSAs recvd 0, Encapsulated data received: 0 grp flags: PI, src flags:Table 27 describes the significant fields shown in the display.
The following is sample output using the summary keyword option:
RP/0/RP0/CPU0:router# show msdp sa-cache summaryTotal # of SAs = 3Total # of RPs = 2Total # of Sources = 1Total # of Groups = 3Originator-RP SA total RPF peer172.16.1.1 0 0.0.0.0172.17.1.1 3 172.17.1.1AS-num SA total200 3Table 28 describes the significant fields shown in the display.
The following is sample output using the asnum keyword option:
RP/0/RP0/CPU0:router# show msdp sa-cache asnum 200MSDP Flags:E - set MRIB E flag , L - domain local source is active,EA - externally active source, PI - PIM is interested in the group,DE - SAs have been denied. Timers age/expiration,Cache Entry:(172.31.1.1, 239.1.1.1), RP 5.1.1.1, MBGP/AS 200, 00:00:25/00:02:04Learned from peer 5.1.1.1, RPF peer 172.17.1.1SAs recvd 1, Encapsulated data received: 100grp flags: none, src flags: EA(172.31.1.1, 239.1.1.2), RP 172.17.1.1, MBGP/AS 200, 00:00:16/00:02:13Learned from peer 172.17.1.1, RPF peer 172.17.1.1SAs recvd 1, Encapsulated data received: 100grp flags: none, src flags: EA(172.31.1.1, 239.1.1.3), RP 172.17.1.1, MBGP/AS 200, 00:00:13/00:02:16Learned from peer 172.17.1.1, RPF peer 172.17.1.1SAs recvd 1, Encapsulated data received: 100grp flags: none, src flags: EARelated Commands
Controls cache SA state on a router.
Enters peer configuration mode and configures an MSDP peer.
show msdp statistics peer
To display Multicast Source Discovery Protocol (MSDP) peer statistic counters, use the show msdp statistics peer command in EXEC mode.
show msdp [ipv4] statistics peer [peer-address]
Syntax Description
ipv4
(Optional) Specifies IPv4 address prefixes.
peer-address
(Optional) IP address or name of the MSDP peer.
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
The show msdp statistics peer command displays MSDP peer statistics such as the number of keepalive messages sent and received and the number of Source-Active (SA) entries sent and received.
If you do not specify an MSDP peer with the peer-address argument, this command displays statistics for all MSDP peers.
Task ID
Examples
The following is sample output from the show msdp statistics peer command:
RP/0/RP0/CPU0:router# show msdp statistics peerMSDP Peer Statistics :-Peer 10.1.2.3 : AS is 10, State is Up, 0 active SAsTLV Rcvd : 57 total57 keepalives, 0 notifications0 SAs, 0 SA Requests0 SA responses, 0 unknownsTLV Sent : 57 total54 keepalives, 0 notifications3 SAs, 0 SA Requests0 SA responsesSA msgs : 0 received, 3 sentPeer 10.2.3.4 : AS is 0, State is Connect, 0 active SAsTLV Rcvd : 0 total0 keepalives, 0 notifications0 SAs, 0 SA Requests0 SA responses, 0 unknownsTLV Sent : 0 total0 keepalives, 0 notifications0 SAs, 0 SA Requests0 SA responsesSA msgs : 0 received, 0 sentTable 29 describes the significant fields shown in the display.
Related Commands
show msdp summary
To display Multicast Source Discovery Protocol (MSDP) peer status, use the show msdp summary command in EXEC mode.
show msdp [ipv4] summary
Syntax Description
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
The show msdp summary command displays peer status such as the following:
•
•
•
•
•
Task ID
Examples
The following is sample output from the show msdp summary command:
RP/0/RP0/CPU0:router# show msdp summaryOut of Resource Handling EnabledMaximum External SA's Global : 20000Current External Active SAs : 0MSDP Peer Status SummaryPeer Address AS State Uptime/ Reset Peer Active Cfg.Max TLVDowntime Count Name SA Cnt Ext.SAs recv/sent10.1.1.1 0 NoIntf 00:10:07 0 ? 0 0 0/0Table 30 describes the significant fields shown in the display.
Related Commands
Displays information about the MSDP peer.
Displays (S, G) state learned from MSDP peers.
shutdown (MSDP)
To shut down a Multicast Source Discovery Protocol (MSDP) peer, use the shutdown command in peer configuration mode. To return to the default behavior, use the no form of this command.
shutdown
no shutdown
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Router MSDP peer configuration
Command History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Use the shutdown command to shut down the peer. To configure many MSDP commands for the same peer, shut down the peer, configure it, and activate the peer later.
You might also want to shut down an MSDP session without losing configuration information for the peer.
When a peer is shut down, the TCP connection is terminated and is not restarted.
Task ID
Examples
The following example shows how to shut down the peer with the address 172.16.5.4:
RP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# peer 172.16.5.4RP/0/RP0/CPU0:router(config-msdp-peer)# shutdownRelated Commands
ttl-threshold (MSDP)
To limit which multicast data packets are sent in Source-Active (SA) messages to a Multicast Source Discovery Protocol (MSDP) peer, use the ttl-threshold command in router MSDP configuration mode or peer configuration mode. To return to the default behavior, use the no form of this command.
ttl-threshold ttl
no ttl-threshold ttl
Syntax Description
Defaults
ttl: 1
Command Modes
Router MSDP configuration
Router MSDP Peer configurationCommand History
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
The ttl-threshold command limits which multicast data packets are sent in data-encapsulated Source-Active (SA) messages. Only multicast packets with an IP header time-to-live (TTL) greater than or equal to the ttl argument are sent to the MSDP peer specified by the IP address or name.
Use the ttl-threshold command to use TTL to examine your multicast data traffic. For example, you can limit internal traffic to a TTL of 8. If you want other groups to go to external locations, send the packets with a TTL greater than 8.
Note
Task ID
Examples
The following example shows how to configure a TTL threshold of eight hops:
RP/0/RP0/CPU0:router(config)# router msdpRP/0/RP0/CPU0:router(config-msdp)# ttl-threshold 8Related Commands
