MSDP-MIB
Functions Overview
RFC 4624 defines MSDP-MIB. This MIB is mainly used to manage and monitor MSDP.
Root directory:
iso(1).org(3).dod(6).internet(1).experimental(3).msdpMIB(92)
Relationships Between Tables
Figure 166-1 shows the relationship between msdpPeerTable, msdpSACacheTable, and msdpMeshGroupTable. SA entries in msdpSACacheTable are generated on the local switch when SA messages are received from peers. Therefore, you can find the corresponding peer record in msdpPeerTable based on the msdpSACachePeerLearnedFrom and msdpSACacheRPFPeer objects in msdpSACacheTable. Similarly, mesh groups should be configured after peer relationship is set up. Therefore, msdpMeshGroupPeerAddress in msdpMeshGroupTable has a corresponding msdpPeerRemoteAddress in msdpPeerTable.
Description of Single Objects
msdpEnabled
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
---|---|---|---|---|---|
1.3.6.1.3.92.1.1.1 |
msdpEnabled |
INTEGER{true(1),false(2)} |
Read-write |
The state of MSDP on this MSDP speaker - globally enabled or disabled. |
This object is implemented as defined in the corresponding MIB files. |
msdpCacheLifetime
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
---|---|---|---|---|---|
1.3.6.1.3.92.1.1.2 |
msdpCacheLifetime |
INTEGER (0..4294967295) |
Read-write |
The lifetime given to SA cache entries when created or refreshed. This is the [SG-State-Period] in the MSDP spec. A value of 0 means no SA caching is done by this MSDP speaker. |
Currently, the Set operation is not supported. If the Set operation is performed to set the value within the range defined by the protocol for this object, an error code "Generic error" is returned. |
msdpNumSACacheEntries
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
---|---|---|---|---|---|
1.3.6.1.3.92.1.1.3 |
msdpNumSACacheEntries |
INTEGER (0..4294967295) |
Read-only |
The total number of entries in the SA Cache table. |
This object is implemented as defined in the corresponding MIB files. |
msdpRPAddress
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
---|---|---|---|---|---|
1.3.6.1.3.92.1.1.11 |
msdpRPAddress |
OCTET STRING (SIZE (4)) |
Read-write |
The Rendezvous Point (RP) address used when sourcing MSDP SA messages. May be 0.0.0.0 on non-RPs. |
The RP address is the address of the configured MSDP Originating-RP. If the MSDP Originating-RP is not configured, the value 0.0.0.0 is returned. Currently, the Set operation is not supported. If the Set operation is performed, an error code "Generic error" is returned. |
Description of MIB Tables
msdpPeerTable
This table lists information about MSDP peers and packet transmission between peers.
The index of the table is msdpPeerRemoteAddress.
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
---|---|---|---|---|---|
1.3.6.1.3.92.1.1.5.1.1 |
msdpPeerRemoteAddress |
OCTET STRING (SIZE (4)) |
Not-accessible |
TThe address of the remote MSDP peer. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.3 |
msdpPeerState |
INTEGER { inactive(1), listen(2), connecting(3), established(4), disabled(5) } |
Read-only |
The state of the MSDP TCP connection with this peer. The values are as follows:
|
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.4 |
msdpPeerRPFFailures |
INTEGER (0..4294967295) |
Read-only |
The number of SA messages received from this peer that failed the Peer-RPF check. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.5 |
msdpPeerInSAs |
INTEGER (0..4294967295) |
Read-only |
The number of MSDP SA messages received on this connection. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.6 |
msdpPeerOutSAs |
INTEGER (0..4294967295) |
Read-only |
The number of MSDP SA messages transmitted on this connection. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.7 |
msdpPeerInSARequests |
INTEGER (0..4294967295) |
Read-only |
The number of MSDP SA-Request messages received on this connection. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.8 |
msdpPeerOutSARequests |
INTEGER (0..4294967295) |
Read-only |
The number of MSDP SA-Request messages transmitted on this connection. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.9 |
msdpPeerInSAResponses |
INTEGER (0..4294967295) |
Read-only |
The number of MSDP SA-Response messages received on this connection. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.10 |
msdpPeerOutSAResponses |
INTEGER (0..4294967295) |
Read-only |
The number of MSDP SA Response messages transmitted on this TCP connection. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.11 |
msdpPeerInControlMessages |
INTEGER (0..4294967295) |
Read-only |
The total number of MSDP messages, excluding encapsulated data packets, received on this TCP connection. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.12 |
msdpPeerOutControlMessages |
INTEGER (0..4294967295) |
Read-only |
The total number of MSDP messages, excluding encapsulated data packets, transmitted on this TCP connection. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.13 |
msdpPeerInDataPackets |
INTEGER (0..4294967295) |
Read-only |
The total number of encapsulated data packets received from this peer. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.14 |
msdpPeerOutDataPackets |
INTEGER (0..4294967295) |
Read-only |
The total number of encapsulated data packets sent to this peer. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.15 |
msdpPeerFsmEstablishedTransitions |
INTEGER (0..4294967295) |
Read-only |
The total number of times the MSDP FSM transitioned into the ESTABLISHED state. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.16 |
msdpPeerFsmEstablishedTime |
TimeTicks |
Read-only |
This timestamp is set to the value of sysUpTime when a peer transitions into or out of the ESTABLISHED state. It is set to zero when the MSDP speaker is booted. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.17 |
msdpPeerInMessageTime |
TimeTicks |
Read-only |
The sysUpTime value when the last MSDP message was received from the peer. It is set to zero when the MSDP speaker is booted. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.18 |
msdpPeerLocalAddress |
OCTET STRING (SIZE (4)) |
Read-create |
The local IP address used for this entry's MSDP TCP connection. |
Currently, the Set operation is not supported. If the Set operation is performed to set the value within the range defined by the protocol for this object, an error code "Generic error" is returned. |
1.3.6.1.3.92.1.1.5.1.20 |
msdpPeerConnectRetryInterval |
Integer32 (1..65535) |
Read-create |
Time interval, in seconds, for the [ConnectRetry-period] for this peer. The value ranges from 1 to 65535 seconds. The default value is 30. |
Currently, the Set operation is not supported. If the Set operation is performed to set the value within the range defined by the protocol for this object, an error code "Generic error" is returned. |
1.3.6.1.3.92.1.1.5.1.21 |
msdpPeerHoldTimeConfigured |
Integer32 (0|3..65535) |
Read-create |
Time interval, in seconds, for the [HoldTime-Period] configured for this MSDP speaker with this peer. If the value of this object is zero (0), the MSDP connection is never torn down due to the absence of messages from the peer. The value ranges from 0 or 3 to 65535. The default value is 75. |
Currently, the Set operation is not supported. If the Set operation is performed to set the value within the range defined by the protocol for this object, an error code "Generic error" is returned. When you perform the Get operation on this object, 90 is returned. |
1.3.6.1.3.92.1.1.5.1.22 |
msdpPeerKeepAliveConfigured |
Integer32 (0|1..21845) |
Read-create |
Time interval, in seconds, for the [KeepAlive-Period] configured for this MSDP speaker with this peer. If the value of this object is zero (0), no periodic KEEPALIVE messages are sent to the peer after the MSDP connection has been established. The value ranges from 0 or 1 to 21845. The default value is 60. |
Currently, the Set operation is not supported. If the Set operation is performed to set the value within the range defined by the protocol for this object, an error code "Generic error" is returned. |
1.3.6.1.3.92.1.1.5.1.23 |
msdpPeerDataTtl |
Integer32 (0..255) |
Read-create |
The minimum TTL a packet is required to have before it may be forwarded using SA encapsulation to this peer. The value ranges from 0 to 255. The default value is 1. |
When you perform the Get operation on this object, 0 is returned. |
1.3.6.1.3.92.1.1.5.1.24 |
msdpPeerProcessRequestsFrom |
INTEGER{true(1),false(2)} |
Read-create |
This object indicates whether to process MSDP SA Request messages from this peer. If True(1), MSDP SA Request messages from this peer are processed and replied to (if appropriate) with SA Response messages. If False(2), MSDP SA Request messages from this peer are silently ignored. It defaults to False when msdpCacheLifetime is 0 and to True when msdpCacheLifetime is non-0. |
The restriction is not made for a single SA message. After a random sa-request-policy is successfully configured, the value of False is returned; otherwise, the value of True is returned. |
1.3.6.1.3.92.1.1.5.1.25 |
msdpPeerStatus |
INTEGER{active(1),notInService(2),notReady(3),createAndGo(4),createAndWait(5),destroy(6)} |
Read-create |
The RowStatus object by which peers can be added and deleted. |
Currently, the Set operation is not supported. If the Set operation is performed to set the value within the range defined by the protocol for this object, an error code "Generic error" is returned. When you perform the Get operation on this object, 1 is returned. |
1.3.6.1.3.92.1.1.5.1.26 |
msdpPeerRemotePort |
Integer32 (0..65535) |
Read-only |
The remote port for the TCP connection between the MSDP peers. The value ranges from 0 to 65535. The default value is 639. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.27 |
msdpPeerLocalPort |
Integer32 (0..65535) |
Read-only |
The local port for the TCP connection between the MSDP peers. The value ranges from 0 to 65535. The default value is 639. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.29 |
msdpPeerEncapsulationType |
INTEGER { none(0), tcp(1) } |
Read-create |
The encapsulation in use when encapsulating data in SA messages to this peer. 0: none, indicating that this peer does not encapsulate multicast data in SA messages. 1: tcp, indicating that this peer encapsulates multicast data in SA messages. |
Currently, the Set operation is not supported. If the Set operation is performed to set the value within the range defined by the protocol for this object, an error code "Generic error" is returned. When you perform the Get operation on this object, 1 is returned. |
1.3.6.1.3.92.1.1.5.1.30 |
msdpPeerConnectionAttempts |
INTEGER (0..4294967295) |
Read-only |
The number of times the state machine has transitioned from INACTIVE to CONNECTING. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.5.1.31 |
msdpPeerInNotifications |
INTEGER (0..4294967295) |
Read-only |
The number of MSDP Notification messages received from this peer. |
Currently, the return value 0 is supported only. |
1.3.6.1.3.92.1.1.5.1.32 |
msdpPeerOutNotifications |
INTEGER (0..4294967295) |
Read-only |
The number of MSDP Notification messages transmitted to this peer. |
Currently, the return value 0 is supported only. |
1.3.6.1.3.92.1.1.5.1.33 |
msdpPeerLastError |
OCTET STRING (SIZE (2)) |
Read-only |
The last error code and subcode received via Notification from this peer. If no error has occurred, this field is zero. Otherwise, the first byte of this two-byte OCTET STRING contains the O-bit and error code, and the second byte contains the subcode. The default value is 0000. |
Currently, the return value 00 is supported only. |
1.3.6.1.3.92.1.1.5.1.34 |
msdpPeerDiscontinuityTime |
TimeTicks |
Read-only |
The value of sysUpTime on the most recent occasion at which one or more of this entry's counters suffered a discontinuity. See the DESCRIPTION of each object to see it is expected to have discontinuities. These discontinuities may occur at peer connection establishment. |
Currently, the return value 0 is supported only. |
Creation Restriction
No entry can be created in this table.
Modification Restriction
The entries in this table can be read without restriction.
Deletion Restriction
The entries in this table cannot be deleted.
Access Restriction
The entries in this table can be read only when MSDP is enabled and MSDP peer relationship is established.
The value of msdpPeerProcessRequestsFrom defined in the MIB can be True or False. If True, MSDP SA Request messages from this peer are processed. If False, MSDP SA Request messages from this peer are silently ignored. In the command line, you can also configure the device to process the MSDP SA Request messages from parts of the group. In this occasion, the value False is returned when the table in this MIB is read.
msdpSACacheTable
This table lists information about MSDP SA messages in the current MSDP SA cache.
The indexes of this table are msdpSACacheGroupAddr, msdpSACacheSourceAddr, and msdpSACacheOriginRP.
OID |
Object |
Syntax |
Max Access |
Description |
Implemented Specifications |
---|---|---|---|---|---|
1.3.6.1.3.92.1.1.6.1.1 |
msdpSACacheGroupAddr |
OCTET STRING (SIZE (4)) |
Not-accessible |
The group address of the SA Cache entry. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.6.1.2 |
msdpSACacheSourceAddr |
OCTET STRING (SIZE (4)) |
Not-accessible |
The source address of the SA Cache entry. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.6.1.3 |
msdpSACacheOriginRP |
OCTET STRING (SIZE (4)) |
Not-accessible |
The RP of the SA Cache entry. This field is in the INDEX in order to catch multiple RP's advertising the same source and group. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.6.1.4 |
msdpSACachePeerLearnedFrom |
OCTET STRING (SIZE (4)) |
Read-only |
The peer from which this SA Cache entry was last accepted. This address must correspond to the msdpPeerRemoteAddress value for a row in the MSDP Peer Table. This should be 0.0.0.0 on the router that originated the entry. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.6.1.5 |
msdpSACacheRPFPeer |
OCTET STRING (SIZE (4)) |
Read-only |
The peer from which an SA message corresponding to this cache entry would be accepted (that is, the RPF peer for msdpSACacheOriginRP). |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.6.1.6 |
msdpSACacheInSAs |
INTEGER (0..4294967295) |
Read-only |
The number of MSDP SA messages received relevant to this cache entry. This object must be initialized to zero when creating a cache entry. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.6.1.7 |
msdpSACacheInDataPackets |
INTEGER (0..4294967295) |
Read-only |
The number of MSDP-encapsulated data packets received relevant to this cache entry. This object must be initialized to zero when creating a cache entry. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.6.1.8 |
msdpSACacheUpTime |
INTEGER (0..4294967295) |
Read-only |
The time since this entry was first placed in the SA cache. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.6.1.9 |
msdpSACacheExpiryTime |
INTEGER (0..4294967295) |
Read-only |
The time remaining before this entry will expire from the SA cache. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.6.1.10 |
msdpSACacheStatus |
INTEGER{active(1),notInService(2),notReady(3),createAndGo(4),createAndWait(5),destroy(6)} { active(1), destroy(6) } |
Read-write |
The status of this row in the table. The only allowable actions are to retrieve the status, which will be 'active', or to set the status to 'destroy' in order to remove this entry from the cache. Row creation is not permitted.
|
Currently, the Set operation is not supported. If the Set operation is performed, an error code "Generic error" is returned. |
Creation Restriction
No entry can be created in this table.
Modification Restriction
The entries in this table cannot be modified.
Deletion Restriction
The entries in this table cannot be deleted.
Access Restriction
This table can be read when MSDP is enabled globally and MSDP peer relationship is set up. In addition, information about the received SA messages should have been stored in the SA-cache.
msdpMeshGroupTable
This table lists MSDP mesh group configurations.
The indexes of this table are msdpMeshGroupName and msdpMeshGroupPeerAddress.
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
---|---|---|---|---|---|
1.3.6.1.3.92.1.1.12.1.1 |
msdpMeshGroupName |
DisplayString (SIZE(1..64)) |
Not-accessible |
The name of the mesh group. The value is a string of 1 to 64 characters. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.12.1.2 |
msdpMeshGroupPeerAddress |
OCTET STRING (SIZE (4)) |
Not-accessible |
A peer address that is a member of the mesh group with name msdpMeshGroupName. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.3.92.1.1.12.1.3 |
msdpMeshGroupStatus |
INTEGER{active(1),notInService(2),notReady(3),createAndGo(4),createAndWait(5),destroy(6)} |
Read-create |
This entry's status, by which new entries may be added to the table and old entries deleted.
|
Currently, the Set operation supports CreateAndGo and Destroy. When you perform the Set operation on the object, only the value within the range from the "!" character to the "~" character, corresponding to ANSIC codes from 33 to 126, is allowed. |
Creation Restriction
An entry can be created successfully when msdpPeerTable has a corresponding row. This table supports only CreateAndGo. You must set msdpMeshGroupName, msdpMeshGroupPeerAddress, and msdpMeshGroupStatus together to succeed in creating a row.
The value range of msdpMeshGroupName supported by the MIB protocol is 1 to 64 but the command line supports only 1 to 32. Therefore, when the length of msdpMeshGroupName is set to be longer than 32, only the first 32 characters take effect.
Modification Restriction
The entries in this table can be read without restriction.
Deletion Restriction
The entries in this table can be deleted without restriction.
Access Restriction
The entries in this table can be read only when MSDP is enabled and the peer is specified for the member in the mesh group.
Description of Alarm Objects
msdpEstablished
OID |
Object Name |
Bound Variable |
Description |
Implemented Specifications |
---|---|---|---|---|
1.3.6.1.3.92.1.1.0.1 |
msdpEstablished |
msdpPeerFsmEstablishedTransitions |
The MSDP Established event is generated when the MSDP FSM enters the ESTABLISHED state. |
Binding variable hwMsdpInstanceName is added. |
msdpBackwardTransition
OID |
Object Name |
Bound Variable |
Description |
Implemented Specifications |
---|---|---|---|---|
1.3.6.1.3.92.1.1.0.2 |
msdpBackwardTransition |
msdpPeerState |
The MSDP BackwardTransition Event is generated when the MSDP FSM moves from a higher-numbered state to a lower-numbered state. |
Binding variables hwMsdpInstanceName and hwMsdpNotificationReason are added. |