Configuring MSDP Global Parameters

You can configure the optional MSDP global parameters described below:

  • Originator interface name -- IP address used in the RP field of an SA message entry. When Anycast RPs are used, all RPs use the same IP address. You can use this parameter to define a unique IP address for the RP of each MSDP peer. By default, the software uses the RP address of the local system. Note that we recommend that you use a loopback interface for the RP address.
  • Group-limit -- Maximum number of (S, G) entries that the software creates for the specified prefix. The software ignores groups when the group limit is exceeded and logs a violation. By default, no group limit is defined.
  • SA interval -- Interval at which the software transmits Source-Active (SA) messages. The range is from 60 to 65,535 seconds. The default is 60 seconds.

For more information, see the Cisco Nexus 9000 Series NX-OS Multicast Routing Configuration Guide.

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-installation-and-configuration-guides-list.html/

Configuring the MSDP Global Parameters

Configuring the MSDP Global Parameters
POST http://<IP_Address>/api/node/mo/sys/msdp/inst/dom-default.json
{
  "msdpDom": {
    "attributes": {
      "name": "default",
      "origIf": "eth1/9",
      "srcActiveMsgIntvl": "120"
    },
    "children": [
      {
        "msdpMaxGrpP": {
          "attributes": {
            "maxGrp": "100000",
            "srcPfx": "192.0.30.1/24"
}}}]}}
{
    "imdata": []
}
<System>
  <msdp-items>
    <inst-items>
      <dom-items>
        <Dom-list>
          <name>default</name>
          <origIf>eth1/9</origIf>
          <srcActiveMsgIntvl>120</srcActiveMsgIntvl>
          <maxgrp-items>
            <MaxGrpP-list>
              <srcPfx>192.0.30.1/24</srcPfx>
              <maxGrp>100000</maxGrp>
            </MaxGrpP-list>
          </maxgrp-items>
        </Dom-list>
      </dom-items>
    </inst-items>
  </msdp-items>
</System>

Prerequisites:

  • Ensure that you have enabled PIM and MSDP.

This example configures MSDP parameters for the default domain.


CLI Commands

The CLI commands and options listed below are the equivalent to the payload example displayed in the pane on the right.

ip msdp originator-id eth1/9
ip msdp group-limit 100000 source 192.0.30.1/24
ip msdp sa-interval 120

Note: The property information for this example was added in Release 9.3(3).


Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.

MODN
msdpDom sys/msdp/inst/dom-{name}
msdpMaxGrpP sys/msdp/inst/dom-{name}/maxgrp-{[srcPfx]}


msdpDom Properties

The following table contains information about the msdpDom properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Property NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63
origIfnw:IfId
(base:IfIndex)
Originator Interface identifying IP address in RP field of Source-Active message. Supported interfaces include Ethernet-like, port/channel, loopback and vlan interfacesMust match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100
srcActiveMsgIntvlmsdp:SrcActiveMsgIntvl
(scalar:Uint16)
Source Active message Interval
RANGE: [60 , 65535]
DEFAULT: 60


msdpMaxGrpP Properties

The following table contains information about the msdpMaxGrpP properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Property NameData TypeDescriptionValues
maxGrpmsdp:MaxGrpLimit
(scalar:Uint32)
Max Group count
RANGE: [0 , 4294967295]
DEFAULT: 4294967295
srcPfxaddress:Ip
Source prefixValue must match ipv4 or ipv6 known format


Related Documentation

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:

http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Removing Configured MSDP Global Parameters

Removing Configured MSDP Global Parameters
POST http://<IP_Address>/api/node/mo/sys/msdp/inst/dom-default.json
{
"msdpDom": {
  "attributes": {
    "name": "default",
    "origIf": "unspecified",
    "srcActiveMsgIntvl": "60"
  },
  "children": [
    {
      "msdpMaxGrpP": {
        "attributes": {
          "srcPfx": "192.0.30.1/24",
          "status": "deleted"
}}}]}}
{
    "imdata": []
}
<System>
  <msdp-items>
    <inst-items>
      <dom-items>
        <Dom-list>
          <name>default</name>
          <origIf>unspecified</origIf>
          <srcActiveMsgIntvl>60</srcActiveMsgIntvl>
          <maxgrp-items>
            <MaxGrpP-list xc:operation="delete">
              <srcPfx>192.0.30.1/24</srcPfx>
            </MaxGrpP-list>
          </maxgrp-items>
        </Dom-list>
      </dom-items>
    </inst-items>
  </msdp-items>
</System>

This example removes the configured MSDP parameters for the default domain that were configured in Configuring MSDP Global Parameters.


CLI Commands

The CLI commands and options listed below are the equivalent to the payload example displayed in the pane on the right.

no ip msdp originator-id eth1/9
no ip msdp group-limit 100000 source 192.0.30.1/24
no ip msdp sa-interval 120

Note: The property information for this example was added in Release 9.3(3).


Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.

MODN
msdpDom sys/msdp/inst/dom-{name}
msdpMaxGrpP sys/msdp/inst/dom-{name}/maxgrp-{[srcPfx]}


msdpDom Properties

The following table contains information about the msdpDom properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Property NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63
origIfnw:IfId
(base:IfIndex)
Originator Interface identifying IP address in RP field of Source-Active message. Supported interfaces include Ethernet-like, port/channel, loopback and vlan interfacesMust match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100
srcActiveMsgIntvlmsdp:SrcActiveMsgIntvl
(scalar:Uint16)
Source Active message Interval
RANGE: [60 , 65535]
DEFAULT: 60


msdpMaxGrpP Properties

The following table contains information about the msdpMaxGrpP properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Property NameData TypeDescriptionValues
srcPfxaddress:Ip
Source prefixValue must match ipv4 or ipv6 known format
statusmo:ModificationStatus
(scalar:Bitmask32)
The upgrade status. This property is for internal use only.SELECTION:
2 - created
4 - modified
8 - deleted
16 - replaced


Related Documentation

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:

http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html