CISCO-WAN-SRCP-MIB

MIB Reference — IPNetwork Monitor

All MIBsCISCO-WAN-SRCP-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2004-01-30

Category: Telephony and VoIP, Vendor: Cisco Devices

Description:

Manages Cisco WAN SRCP (Simple Resource Coordination Protocol) for media gateway resource control.

Imported Objects

From CISCO-WAN-MGC-REDUN-MIB

mgcRedundancyGrpNumOBJECT-TYPE

From CISCOWAN-SMI

ciscoWanOBJECT-IDENTITY

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Integer32
IpAddress
MODULE-IDENTITY
OBJECT-TYPE

From SNMPv2-TC

DisplayString

What Is CISCO-WAN-SRCP-MIB?

CISCO-WAN-SRCP-MIB manages SRCP (Simple Resource Coordination Protocol) implementations used between a Media Gateway Controller (MGC, acting as SRCP client) and a Media Gateway (MG, acting as SRCP server) on Cisco WAN voice platforms. It exposes protocol version and port configuration along with a peer table tracking each SRCP peer's name, port, heartbeat interval, and time since last heartbeat. Its central monitoring value is software/protocol liveness: srcpPeerTimeSinceHeartbeat rising toward or past srcpPeerHeartbeatInterval indicates a peer MGC or MG has stopped responding, signaling a control-plane failure between the gateway controller and gateway that would disrupt call setup/teardown even if the underlying hardware is otherwise healthy. It explicitly references CISCO-WAN-MG-MIB (abbreviated MGMIB) as a related module for gateway-side objects. It is deployed in Cisco MGX-based media gateway networks using SRCP for controller-to-gateway resource coordination, and administrators often load the module into a CISCO-WAN-SRCP-MIB MIB Browser to inspect peer heartbeat values interactively before scripting automated polling.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-WAN-SRCP-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

What Can Be Monitored

  • peer heartbeat interval and elapsed time since last heartbeat
  • SRCP protocol version
  • peer port configuration
  • maximum PDU size negotiation

Supported Devices

  • Cisco WAN media gateways and media gateway controllers (MGX-based)

Monitoring Examples

An operator would poll srcpPeerTable by srcpPeerId to check srcpPeerTimeSinceHeartbeat against the configured srcpPeerHeartbeatInterval for each peer, flagging any peer where elapsed time exceeds the interval as a lost heartbeat/control-plane outage. srcpPeerMaxPduSize helps verify protocol negotiation parameters match between the MGC and MG, while srcpVersion confirms both ends are running compatible SRCP protocol versions.

OIDs
OID symbolicOID numericTypeAccessDescription
ciscoWanSrcpMIB1.3.6.1.4.1.351.150.11The MIB module for managing SRCP(Simple Resource Coordination Protocol) implementations. SRCP is a resource coordination protocol used between a MGC(Media Gateway Controller) and a MG(Media Gateway). SRCP MIB is applicable to both controllers (SRCP clients) and gateways (SRCP servers). MGMIB: This is the short name used for CISCO-WAN-MG-MIB in this MIB.
srcpObjects1.3.6.1.4.1.351.150.11.1
srcpAdminObjects1.3.6.1.4.1.351.150.11.1.1
STR srcpVersion1.3.6.1.4.1.351.150.11.1.1.1DisplayStringread-onlyThe name of the SRCP protocol version for exmaple SRCP 1.0.2. If MGMIB is supported, this name corresponds to mgProtocolName (defined in CISCO-WAN-MG-MIB MIB) in an entry to mgSupportedProtocolTable.
I32 srcpPortNumber1.3.6.1.4.1.351.150.11.1.1.2Integer32read-writeThis object is used to configure the UDP port used for SRCP on the system (local UDP port). It is configurable only if the system is in a locked or disabled state (i.e If MGMIB Is supported, mgAdministrativeState(defined in CISCO-WAN-MG-MIB MIB) should be 'locked' before the UDP port can be configured).
srcpPeerTable1.3.6.1.4.1.351.150.11.1.1.3not-accessibleThis is a table which is used to provision peer-specific SRCP configuration and administration information. Each table entry corresponds to an SRCP peer as identified by its domain name(srcpPeerName).
srcpPeerEntry1.3.6.1.4.1.351.150.11.1.1.3.1not-accessibleRepresents an individual table entry in srcpPeerTable. Each row corresponds to an SRCP peer and is identified by its domain name (srcpPeerName). Entries in this table are implicitly created by the agent. If the agent supports MGMIB, this occurs as follows: An entry shall be created when an entry is created in the mgcRedundancyGrpProtocolTable(defined in CISCO-WAN-MGC-REDUN-MIB MIB) and when mgProtocolNumber (defined in CISCO-WAN-MG-MIB MIB) refers to SRCP as supported protocol. An entry will be made for all MGC(Media Gateway Controller) in that MGC Redundancy Group. Accordingly, an entry shall be deleted if the corresponding entry in the mgcRedundancyGrpProtocolTable is deleted. If the agent does not support MGMIB, entry creation might occur when the first SRCP communication with an IP address/domain name occurs. if MGC Redundacy feature is supported the following objects: srcpPeerHeartbeatInterval, srcpPeerTimeSinceHeartbeat rcpPeerMaxPduSize are not meaningful here. These objects are defined per MGC Redundancy Group rather than per MGC.
I32 srcpPeerId1.3.6.1.4.1.351.150.11.1.1.3.1.1Integer32not-accessibleThis object identifies the SRCP peer and serves as index to this table. If MGMIB is supported, this is the same as the mgcNumber(defined in CISCO-WAN-MG-MIB MIB) from the mgcTable.
STR srcpPeerName1.3.6.1.4.1.351.150.11.1.1.3.1.2DisplayStringread-onlyThis object identifies the name of the SRCP peer. If MGMIB is supported, this is the same as the mgcName from the mgcTable.
I32 srcpPeerPortNumber1.3.6.1.4.1.351.150.11.1.1.3.1.3Integer32read-writeThis object is used to configure the UDP port of the SRCP peer.
I32 srcpPeerHeartbeatInterval1.3.6.1.4.1.351.150.11.1.1.3.1.4Integer32read-writeThis object is used to configure the length of the heartbeat interval, in milliseconds. The heartbeat interval indicate when the GW(Gateway) is expected to receive a heartbeat from a specific peer or MGC group. If value is 0, heartbeat for this peer is not monitored. The heartbeat interval less than 100 is not allowed (except 0). If MGC Redundancy is supported, this object is not effective. Instead, the user should use srcpPeerGrpHeartbeatInterval.
I32 srcpPeerTimeSinceHeartbeat1.3.6.1.4.1.351.150.11.1.1.3.1.5Integer32read-onlyThe time since the last heartbeat was received, in milliseconds. This represents the difference between the current time and the last time an SRCP command was received. A value of 0 shall be returned if the heartbeat is not monitored. Even if the heartbeat is monitored, a value of 0 shall be returned if any of the following is true: i) The system is locked or disabled (as indicated by mgAdministrativeState). ii) The srcpPeer is unassociated as indicated by mgcAssociationState(defined in CISCO-WAN-MG-MIB MIB). If MGC Redundancy is supported, this object is not effective. Instead, the user should use srcpPeerGrpTimeSinceHeartbeat.
I32 srcpPeerMaxPduSize1.3.6.1.4.1.351.150.11.1.1.3.1.6Integer32read-writeThis object is used to configure the maximum UDP PDU(Protocol Data Unit) size, in octets, that may be used for SRCP communications with the peer. This value may not be configurable for all agents. If MGC Redundancy is supported, this object is not effective. Instead, the user should use srcpPeerGrpMaxPduSize.
srcpPeerGrpParamTable1.3.6.1.4.1.351.150.11.1.1.4not-accessibleThis table is used to provision SRCP parameters for an MGC Redundancy group. MGCs can be configured as part of MGC Redundancy groups. This feature allows for redundant call agents. Each table entry corresponds to an SRCP peer entry that is identified by the MGC Redundancy group number.
srcpPeerGrpParamEntry1.3.6.1.4.1.351.150.11.1.1.4.1not-accessibleRepresents an individual table entry in the srcpPeerGrpParamTable. Each row corresponds to an MGC Redundancy Group and is identified by the MGC Redundancy Group Number. Entries are implicitly created when the SRCP protocol is added for an MGC Redundancy Group. The entry will be removed if the SRCP protocol is removed for an MGC Redundancy Group.
I32 srcpPeerGrpHeartbeatInterval1.3.6.1.4.1.351.150.11.1.1.4.1.1Integer32read-writeThis object is used to configure the length of the heartbeat interval, in milliseconds. If 0, heartbeat for this peer Group is not monitored. The heartbeat interval less than 100 is not allowed (except 0).
I32 srcpPeerGrpTimeSinceHeartbeat1.3.6.1.4.1.351.150.11.1.1.4.1.2Integer32read-onlyThe time since the last heartbeat was received, in milliseconds. This represents the difference between the current time and the last time an SRCP command was received. A value of 0 shall be returned if the heartbeat is not monitored. Even if the heartbeat is monitored, a value of 0 shall be returned if any of the following is true: i) The system is locked or disabled (as indicated by mgAdministrativeState). ii) The stateChangeNtfy flag is disabled for the srcpPeer Group (as indicated by mgcRedundancyGrpStateChangeNtfy of CISCO-WAN-MGC-REDUN-MIB).
I32 srcpPeerGrpMaxPduSize1.3.6.1.4.1.351.150.11.1.1.4.1.3Integer32read-writeThis object is used to configure the maximum UDP PDU size, in octets, that may be used for SRCP communications with the peer. This value may not be configurable for all agents.
srcpStatsObjects1.3.6.1.4.1.351.150.11.1.2
srcpPeerStatsTable1.3.6.1.4.1.351.150.11.1.2.1not-accessibleThis table contains SRCP statistics information since reset. SRCP statistics are kept in this table, with each table entry containing the statistics of SRCP messages that communicated with a peer at a specific IP address of the peer. It differs from the SRCP peer table which maintains information on a per call agent basis as identified by their domain names.
srcpPeerStatsEntry1.3.6.1.4.1.351.150.11.1.2.1.1not-accessibleThe row of the srcpPeerStatsTable contains information about SRCP message statistics per IP address of the MGC. An entry is implicitly created and deleted by the agent. There can be two cases: 1. Case of Internal address resolution : In this case IP addresses of all SRCP peers are resolved internally. If the agent supports the MGMIB, the following referential integrity rules apply: When an entry is added to mgcResolutionTable defined in CISCO-WAN-MG-MIB with a specific IP address, an entry is created in this srcpPeerStatsTable for that IP address. When an entry is deleted from mgcResolutionTable, the row with the corresponding IP address in this table will be deleted. 2. Case of External address resolution : If there is at least one Call agent whose IP address is resolved externally, an entry is created whenever SRCP communication occurs with a new IP address. Table entries are never deleted, but must be nonpersistent in agent implementations, i.e. must be purged in case of a system shutdown/restart.
IP srcpStatsPeerIpAddress1.3.6.1.4.1.351.150.11.1.2.1.1.1IpAddressnot-accessibleThis object specifies the IP address of the SRCP peer and serves as index to the table.
STR srcpStatsPeerName1.3.6.1.4.1.351.150.11.1.2.1.1.2DisplayStringread-onlyDenotes the name of the SRCP peer. This is the same as the mgcName from the mgcTable. It is provided here as a read-only parameter as a convinience feature.
C32 packetsDiscardedCnts1.3.6.1.4.1.351.150.11.1.2.1.1.3Counter32read-onlyThe number of packets that were received and discarded. The packets may get discarded because of indecipherable PDUs like bad protocol version, bad command verb etc, or because of unknown transaction IDs (in case of SRCP clients).
C32 augwCnts1.3.6.1.4.1.351.150.11.1.2.1.1.4Counter32read-onlyThe total number of AUGW(Audit Gateway) commands received from the peer on this IP address.
C32 aulnCnts1.3.6.1.4.1.351.150.11.1.2.1.1.5Counter32read-onlyThe total number of AULN(Audit Line) commands received from or sent to the peer on this IP address.
C32 rqntCnts1.3.6.1.4.1.351.150.11.1.2.1.1.6Counter32read-onlyThe total number of RQNT(Notification Request) commands received from or sent to the peer on this IP address.
C32 ntfyCnts1.3.6.1.4.1.351.150.11.1.2.1.1.7Counter32read-onlyThe total number of NTFY(Notify) commands received from or sent to the peer on this IP address.
C32 augwFailCnts1.3.6.1.4.1.351.150.11.1.2.1.1.8Counter32read-onlyFor MG : The total number of AUGW commands received that were responded to with a failure return code. For MGC : The total number of AUGW commands sent which were timed out without a response or for which a response with failure return code was received.
C32 aulnFailCnts1.3.6.1.4.1.351.150.11.1.2.1.1.9Counter32read-onlyMedia gateway : The total number of AULN commands received that were responded to with a failure return code. Media gateway controller : The total number of AULN commands sent which were timed out without a response or For which a response with failure return code was received.
C32 rqntFailCnts1.3.6.1.4.1.351.150.11.1.2.1.1.10Counter32read-onlyMedia gateway : The total number of RQNT commands received that were responded to with a failure return code. Media gateway controller : The total number of RQNT commands sent which were timed out without a response or for which a response with failure return code was received.
C32 ntfyFailCnts1.3.6.1.4.1.351.150.11.1.2.1.1.11Counter32read-onlyMedia gateway : The total number of NTFY commands sent which were timed out without a response or for which a response with failure return code was received. Media gateway controller: The total number of NTFY commands received that were responded to with a failure return code.
srcpAdminRetyObjects1.3.6.1.4.1.351.150.11.1.3
I32 srcpRequestTimeOut1.3.6.1.4.1.351.150.11.1.3.1Integer32read-writeThis object specifies the minimum timeout value. This value along with srcpRequestMaxTimeout and srcpRequestRetries is used to determine the exponential retry interval for retransmitting unacknowledged SRCP messages. It is the responsibility of the requesting entity to provide suitable timeouts for all outstanding commands, and to retry commands when timeouts exceeded. The default value of this object is 500 milliseconds. When the value of this object changes srcpAdminObjects group changed trap will be sent as specify by vismConfigChangeTypeBitMap in CISCO-VISM-MODULE-MIB.
I32 srcpRequestRetries1.3.6.1.4.1.351.150.11.1.3.2Integer32read-writeThis object specifies the number of retries for a SRCP request that exceeds timeout. It is the responsibility of the requesting entity to provide suitable timeouts for all outstanding commands, and to retry when times out. The default value of this object is 3. When the value of this object changes srcpAdminObjects group changed trap will be sent as specify by vismConfigChangeTypeBitMap in CISCO-VISM-MODULE-MIB.
I32 srcpRequestMaxTimeout1.3.6.1.4.1.351.150.11.1.3.3Integer32read-writeThis object specifies the maximum timeout value. This timer value is used along with srcpRequestTimeOut and srcpRequestRetries to determine the exponential retry interval for retransmitting unacknowledged SRCP messages. The value of this timer has to be greater than or equal to srcpRequestTimeOut. The default value of this object is 500 milliseconds. When the value of this object changes srcpAdminObjects group changed trap will be sent as specify by vismConfigChangeTypeBitMap in CISCO-VISM-MODULE-MIB.
srcpMIBConformance1.3.6.1.4.1.351.150.11.3
srcpMIBCompliances1.3.6.1.4.1.351.150.11.3.1
srcpMIBCompliance1.3.6.1.4.1.351.150.11.3.1.1The compliance statement for the SNMPv2 entities which implement SRCP MIB.
srcpMIBComplaince21.3.6.1.4.1.351.150.11.3.1.2The compliance statement for the SNMPv2 entities which implement SRCP MIB.
srcpMIBComplaince31.3.6.1.4.1.351.150.11.3.1.3The compliance statement for the SNMPv2 entities which implement SRCP MIB.
srcpMIBGroups1.3.6.1.4.1.351.150.11.3.2
srcpConfigurationGroup1.3.6.1.4.1.351.150.11.3.2.1This group contains objects related to configuration of SRCP. Min Access of read only is permissible for system providing only a fixed SRCP port.
srcpStatisticsGroup1.3.6.1.4.1.351.150.11.3.2.2This group contains the statistics per SRCP peer.
srcpConfigurationGroup21.3.6.1.4.1.351.150.11.3.2.3This group contains objects related to configuration of SRCP. Min Access of read only is permissible for system providing only a fixed SRCP port.
srcpStatisticsGroup21.3.6.1.4.1.351.150.11.3.2.4This group contains the statistics per SRCP peer.
srcpConfigurationGroup31.3.6.1.4.1.351.150.11.3.2.5This group contains objects related to configuration of SRCP. Min Access of read only is permissible for system providing only a fixed SRCP port.

RFC description

Cisco WAN MIB for managing Simple Resource Coordination Protocol (SRCP) implementations between Media Gateway Controllers and Media Gateways, including administrative and statistics objects.

Start monitoring Cisco WAN media gateways and controllers (MGX-based, legacy) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download CISCO-WAN-SRCP-MIB