[no] msdp
config>router
7210 SAS-Sx/S 1/10GE (standalone)
This command enables a Multicast Source Discovery Protocol (MSDP) instance. When an MSDP instance is created, the protocol is enabled. To start or suspend execution of the MSDP without affecting the configuration, use the [no] shutdown command.
For the MSDP to function, at least one peer must be configured.
When MSDP is configured and started, an appropriate event message is generated.
When the no form of this command is executed, all sessions are terminated and an appropriate event message is generated.
When all peering sessions are terminated, an event message per peer is not generated.
The no form of this command deletes the MSDP instance, removing all associated configuration parameters.
no msdp
active-source-limit number
no active-source-limit
config>router>msdp
config>router>msdp>group
config>router>msdp>group>peer
config>router>msdp>peer
config>router>msdp>source
7210 SAS-Sx/S 1/10GE (standalone)
This command configures the maximum number of active source messages that are accepted by MSDP, effectively controlling the number of active sources that can be stored on the system.
The no form of this command removes the user-configured limit on the number of source-active (SA) records.
no active-source-limit
Specifies the number of active sources that can be maintained by MSDP stored on the system.
[no] data-encapsulation
config>router>msdp
7210 SAS-Sx/S 1/10GE (standalone)
This command configures a rendezvous point (RP) using MSDP to encapsulate multicast data received in MSDP register messages inside forwarded MSDP SA messages.
The no form of this command disables the encapsulation of multicast data in SA register messages.The system sends only multicast (S,G) sender information to the remote MSDP peer.
data-encapsulation
export policy-name [policy-name...(up to 5 max)]
no export
config>router>msdp
config>router>msdp>peer
config>router>msdp>group
config>router>msdp>group>peer
7210 SAS-Sx/S 1/10GE (standalone)
This command specifies the policies to export the SA state from the SA list into MSDP.
If multiple policy names are specified, the policies are evaluated in the order they are specified. The first policy that matches is applied. If multiple export commands are issued, the last command entered overrides the previous command. The user can specify a maximum of five policy names.
The no form of this command applies no export policies and all SA entries are announced.
no export
Specifies the export policy name, up to 32 characters. Up to five policy-name arguments can be specified.
If you configure an export policy at the global level, each individual peer inherits the global policy. If you configure an export policy at the group level, each individual peer in a group inherits the group policy. If you configure an export policy at the peer level, the policy only applies to the peer where it is configured.
[no] group group-name
config>router>msdp
7210 SAS-Sx/S 1/10GE (standalone)
This command creates or modifies an MSDP group. To configure multiple MSDP groups, include multiple group statements.
By default, the group options are inherited from the global MSDP options. To override these global options, group-specific options within the group statement can be configured.
If the specified group name is already configured, this command only provides the context to configure the options pertaining to this group.
If the group name provided is not already configured, the group name must be created and the commands in the config>router>msdp>group context, which configure parameters for the group, become available.
For a group to be of use, at least one peer must be configured.
The no form of this command removes the group name from the MSDP configuration.
no group
Species a MSDP group name, up to 32 characters.
import policy-name[policy-name...(up to 5 max)]
no import
config>router>msdp
config>router>msdp>peer
config>router>msdp>group
config>router>msdp>group>peer
7210 SAS-Sx/S 1/10GE (standalone)
This command specifies the policies to import the SA state from MSDP into the SA list.
If multiple policy names are specified, the policies are evaluated in the order they are specified. The first policy that matches is applied. If multiple import commands are issued, the last command entered overrides the previous command. A maximum of five policy names can be specified.
If an import policy is configured at the global level, each individual peer inherits the global policy.
If an import policy is configured at the group level, each individual peer in a group inherits the group policy.
If an import policy is configured at the peer level, the policy only applies to the peer where it is configured.
The no form of this command applies no import policies and all source active messages are allowed.
no import
Specifies the import policy name, up to 32 characters. Up to five policy-name arguments can be specified.
local-address ip-address
no local-address
config>router>msdp
config>router>msdp>peer
config>router>msdp>group
config>router>msdp>group>peer
7210 SAS-Sx/S 1/10GE (standalone)
This command configures the local end of an MSDP session. For MSDP to function, at least one peer must be configured. When configuring a peer, you must include this local-address command to configure the local end of the MSDP session. This address must be present on the node and is used to validate incoming connections to the peer and to establish connections to the remote peer.
If the user enters this command, the specified address is validated and used as the local address for MSDP peers from that point. If a subsequent local-address command is entered, it replaces the existing configuration and the existing sessions are terminated.
Similarly, when the no form of this command is entered, the existing local-address is removed from the configuration and the existing sessions are terminated.
When a session is terminated, all information pertaining to and learned from that peer is removed.
When a new peering session is created or a peering session is lost, an event message should be generated.
The no form of this command removes the local address from the configuration.
no local-address
Specifies an existing address on the node.
[no] peer ip-address
config>router>msdp
config>router>msdp>group
7210 SAS-Sx/S 1/10GE (standalone)
This command configures peer parameters. MSDP must have at least one peer configured. A peer is defined by configuring a local address that can be used by the node to set up a peering session and the address of a remote MSDP router. It is the address of this remote peer that is configured in this command and it identifies the remote MSDP router address.
After peer relationships are established, the MSDP peers exchange messages to advertise active multicast sources. Multiple peering sessions may be required, in which case multiple peer statements should be included in the configurations.
By default, the options applied to a peer are inherited from the global or group level. To override these inherited options, include peer-specific options within the peer statement.
If the peer address provided is already a configured peer, this command only provides the context to configure the parameters pertaining to this peer.
If the peer address provided is not already a configured peer, the peer instance must be created and the commands in the config>router>msdp>peer or config>router>msdp>group>peer contexts, which configure parameters for the peer instance, become available.
The peer address provided is validated and, if valid, is used as the remote address for an MSDP peering session.
At least one peer must be configured for MSDP to function.
The no form of this command removes the existing peering address from the configuration and the existing session is terminated. When a session is terminated, all SA information pertaining to and learned from that peer is removed. When a new peering session is created or a peering session is lost, an event message should be generated.
Specifies the peer IP address. The address configured in this statement must identify the remote MSDP router with which the peering session must be established.
authentication-key {authentication-key | hash-key} [hash | hash2]
no authentication-key
config>router>msdp>peer
config>router>msdp>group>peer
7210 SAS-Sx/S 1/10GE (standalone)
This command configures a Message Digest 5 (MD5) authentication key to be used with a specific MSDP peering session. The authentication key must be configured per peer; therefore, no global or group configuration is possible.
The no form of this command configures acceptance of all MSDP messages and disables the MD5 signature option authentication key.
no authentication-key
Specifies the authentication key. The key can be any combination of printable, 7-bit ASCII characters, up to 255 characters in the config>router>msdp>peer context, or up to 127 characters in the config>router>msdp>group>peer context. If the string contains special characters (#, $, spaces, and so on), enclose the entire string in quotation marks (‟ ”).
Specifies a hash key. The key can be any combination of ASCII characters up to 451 characters (encrypted). If spaces are used in the string, enclose the entire string in quotation marks (‟ ”).
This is useful when a user must configure the parameter, although, for security purposes, the actual unencrypted key value is not provided.
Keyword to specify that the key is entered in an encrypted form. If the hash or hash2 parameter is not used, the key is assumed to be in an unencrypted, clear text form. For security, all keys are stored in encrypted form in the configuration file with the hash or hash2 parameter specified
Keyword to specify that the key is entered in a more complex encrypted form that involves more variables than the key value alone, meaning that the hash2 encrypted variable cannot be copied and pasted. If the hash or hash2 parameter is not used, the key is assumed to be in an unencrypted, clear text form. For security, all keys are stored in encrypted form in the configuration file with the hash or hash2 parameter specified.
[no] default-peer
config>router>msdp>peer
config>router>msdp>group>peer
7210 SAS-Sx/S 1/10GE (standalone)
This command enables the use of a default peer. Using the default peer mechanism, a peer can be selected as the default MSDP peer. As a result, all SA messages from the peer are accepted without the usual peer-reverse path forwarding (RPF) check.
The MSDP peer-RPF check is different from the normal multicast RPF checks. The peer-RPF check is used to stop SA messages from looping. A router validates SA messages originated from other routers in a deterministic fashion.
A set of rules is applied to validate received SA messages, and the first rule that applies determines the peer-RPF neighbor. All SA messages from other routers are rejected. The rules applied to SA messages originating at Router S received at Router R from Router N are as follows:
If Router N and Router S are the same, the message is originated by a direct peer-RPF neighbor and is accepted.
If Router N is a configured peer or a member of the Router R mesh group, its SA messages are accepted.
If Router N is the Border Gateway Protocol (BGP) next hop of the active multicast RPF route toward Router S, Router N is the peer-RPF neighbor and its SA messages are accepted.
If Router N is an external BGP peer of Router R and the last autonomous system (AS) number in the BGP AS-path to Router S is the same as Router N’s AS number, Router N is the peer-RPF neighbor, and its SA messages are accepted.
If Router N uses the same next hop as the next hop to Router S, Router N is the peer-RPF neighbor, and its SA messages are accepted.
If Router N does not fit any of the preceding rules, Router N is not a peer-RPF neighbor, and its SA messages are rejected.
The no form of this command removes the default peer configuration.
no default-peer
receive-msg-rate number interval seconds [threshold threshold]
no receive-msg-rate
config>router>msdp
config>router>msdp>peer
config>router>msdp>group
config>router>msdp>group>peer
7210 SAS-Sx/S 1/10GE (standalone)
This command limits the number of MSDP messages that are read from the TCP session. An MSDP/ RP router may receive a large number of MSDP protocol message packets in a particular SA message.
After the number of MSDP packets (including SA messages) defined in the threshold have been processed, the rate of all other MSDP packets is rate limited by no longer accepting messages from the TCP session until the time (seconds) has elapsed.
The no form of this command sets no limit on the number of MSDP and SA limit messages that are accepted.
no receive-msdp-msg-rate
Specifies the number of MSDP messages (including SA messages) that are read from the TCP session per the specified number of seconds.
Specifies the time that, together with the number parameter, defines the number of MSDP messages (including SA messages) that are read from the TCP session within the configured number of seconds.
Specifies the number of MSDP messages that can be processed before the MSDP message rate limiting function is activated; this is particularly useful during system startup and initialization.
[no] shutdown
config>router>msdp
config>router>msdp>peer
config>router>msdp>group
7210 SAS-Sx/S 1/10GE (standalone)
This command administratively enables or disables an entity. When disabled, an entity does not change, reset, or remove any configuration settings or statistics. Many entities must be explicitly enabled using the no shutdown command and must be shut down before they may be deleted.
Unlike other commands and parameters where the default state is not indicated in the configuration file, shutdownand no shutdownare always indicated in system generated configuration files.
The no form of this command puts an entity into the administratively enabled state.
no shutdown
mode {mesh-group | standard}
config>router>msdp>group
7210 SAS-Sx/S 1/10GE (standalone)
This command configures groups of peers in a full mesh topology to limit excessive flooding of SA messages to neighboring peers.
MSDP peers can be configured and grouped in a full-mesh topology that prevents excessive flooding of SA messages to neighboring peers.
In a meshed configuration, all members of the group must have a peer connection with every other mesh group member. If this rule is not followed, unpredictable results may occur.
mode standard
Keyword to specify that SA messages received from a mesh group member are always accepted but are not flooded to other members of the same mesh group. These SA messages are only flooded to non-mesh group peers or members of other mesh groups.
Keyword to specify a non-meshed mode.
rpf-table {rtable-m | rtable-u | both}
no rpf-table
config>router>msdp
7210 SAS-Sx/S 1/10GE (standalone)
This command configures the sequence of route tables used to find an RPF interface for a particular multicast route.
By default, only the unicast route table is looked up to calculate the RPF interface toward the source or RP. However, the user can specify one of the following options:
use the unicast route table only
use the multicast route table only
use both route tables
The no form of this command reverts to the default value.
rpf-table rtable-u
Specifies that only the multicast route table is used by the multicast protocol (MSDP) for IPv4 RPF checks. This route table contains routes submitted by static routes, IS-IS, and OSPF.
Specifies that only the unicast route table is used by the multicast protocol (MSDP) for IPv4 RPF checks. This route table contains routes submitted by all the unicast routing protocols.
Specifies that the multicast route table is always looked up first and, if there is a route, use it. If MSDP does not find a route in the first lookup, it tries to find it in the unicast route table. The multicast route table (rtable-m) is checked before the unicast route table (rtable-u).
sa-timeout seconds
no sa-timeout
config>router>msdp
7210 SAS-Sx/S 1/10GE (standalone)
This command configures the value for the SA entries in the cache. If these entries are not refreshed within the timeout value, they are removed from the cache. Normally, entries are refreshed at least once a minute. But under a high load with many MSDP peers, the refresh cycle could be incomplete. A higher timeout value (more than 90 seconds) could be useful to prevent instabilities in the MSDP cache.
The no form of this command reverts to the default value.
sa-timeout 90
Specifies the time, in seconds, to wait for a response from the peer before declaring the peer unavailable.
[no] source ip-prefix/mask
config>router>msdp
7210 SAS-Sx/S 1/10GE (standalone)
This command limits the number of active source messages that the router accepts from sources in the specified address range.
If the specified prefix and mask are already configured, this command only provides the context to configure the parameters pertaining to this active source message filter.
If the prefix and mask provided are not already configured, the source node instance must be created and the commands in the config>router>msdp>source context, which configure parameters for the source node instance, become available.
The source active msdp messages are not rate limited based on the source address range.
The no form of this message removes the SA rate limiter for this source address range.
Specifies the IP prefix in dotted decimal notation for the range used by the ABR to advertise that summarizes the area into another area.
Specifies the subnet mask for the range expressed as a decimal integer mask length or in dotted decimal notation.