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.
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.
MO | DN |
---|---|
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 Name | Data Type | Description | Values |
---|---|---|---|
name | naming:Name256 (string:Basic) | The name of the object. | MAX SIZE: 63 |
origIf | nw: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 interfaces | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
srcActiveMsgIntvl | msdp: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 Name | Data Type | Description | Values |
---|---|---|---|
maxGrp | msdp:MaxGrpLimit (scalar:Uint32) | Max Group count | RANGE: [0 , 4294967295] DEFAULT: 4294967295 |
srcPfx | address:Ip | Source prefix | Value must match ipv4 or ipv6 known format |
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
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:
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.
MO | DN |
---|---|
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 Name | Data Type | Description | Values |
---|---|---|---|
name | naming:Name256 (string:Basic) | The name of the object. | MAX SIZE: 63 |
origIf | nw: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 interfaces | Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100 |
srcActiveMsgIntvl | msdp: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 Name | Data Type | Description | Values |
---|---|---|---|
srcPfx | address:Ip | Source prefix | Value must match ipv4 or ipv6 known format |
status | mo: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:
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: