CISCO-IETF-MEGACO-MIB

All MIBs › CISCO-IETF-MEGACO-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2003-04-28

Category: Cisco Devices, Telephony and VoIP

Description: Manages Megaco/H.248 media gateway control protocol connections, terminations, and contexts.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) 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.

What Is CISCO-IETF-MEGACO-MIB?

CISCO-IETF-MEGACO-MIB is a Cisco implementation of the IETF Megaco/H.248 media gateway control protocol MIB, used to manage media gateways that bridge circuit-switched voice networks and packet telephony. It exposes configuration and identification data for gateway links, including gateway IDs, IP addresses, ports, and encoding schemes used for signaling between a media gateway controller and its gateways. This data supports monitoring the software/configuration status of voice gateway links, letting an administrator confirm that a gateway's control-plane link is correctly addressed and using the expected encoding and protocol before troubleshooting call-quality or connectivity issues. The MIB is based on the IETF Megaco MIB draft and complements ITU-T H.248 signaling, and is typically deployed alongside other Cisco voice/media gateway MIBs. It is common in service provider and enterprise voice-over-IP gateway deployments. Engineers can download the CISCO-IETF-MEGACO-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-IETF-MEGACO-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.

Supported Devices

Cisco media gateways
Cisco voice gateway routers

Monitoring Examples

An operator inspects cmedGatewayConfigTable (cmedGatewayConfigEntry rows keyed by cmedGatewayId) to verify cmedGatewayIPAddress and cmedGatewayPort match the expected media gateway controller, and that cmedGatewayEncodingScheme and cmedGatewayProtocol are correctly set for the deployed signaling stack. Cross-referencing cmedLinkIdTable's cmedNextLinkId helps confirm link IDs are being allocated as expected for cmedGatewayLinkId associations. A gateway showing an unexpected IP address or protocol value would indicate a misconfigured or misprovisioned media gateway link.

What Can Be Monitored

gateway link configuration
gateway IP address and port
encoding scheme
signaling protocol in use
gateway link ID allocation

Imported Objects

From CISCO-SMI

ciscoExperiment

OBJECT-IDENTITY

From IF-MIB

InterfaceIndex

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Integer32
IpAddress
MODULE-IDENTITY
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

AutonomousType
RowStatus
TEXTUAL-CONVENTION
TestAndIncr
TimeStamp

How to Use in IPNetwork Monitor

Example using cmedNumInMessages OID:

Select a Cisco media gateways / voice gateway router as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type cmedNumInMessages into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. It reports the total number of messages received on the link. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoIetfMegacoMIB	1.3.6.1.4.1.9.10.99999			This MIB module is based on the Internet Draft draft-ietf-megaco-mib-05.txt. It defines the attributes of Megaco protocol. Reference: ITU H.248 (Rev. COM16-107).
ciscoIetfMegacoMIBConformance	1.3.6.1.4.1.9.10.99999.3
ciscoIetfMegacoMIBNotifs	1.3.6.1.4.1.9.10.99999.0
ciscoIetfMegacoMIBObjects	1.3.6.1.4.1.9.10.99999.1
cmedCompliance	1.3.6.1.4.1.9.10.99999.3.1.1			Compliance statement for entities which implement the CISCO-IETF-MEGACO-MIB.
cmedCompliances	1.3.6.1.4.1.9.10.99999.3.1
cmedConfig	1.3.6.1.4.1.9.10.99999.3.2.1			This group contains of all the configuration Information for a Media Gateway. This group is mandatory for any implementation managing a media gateway or a group of media gateways
cmedConfigGroups	1.3.6.1.4.1.9.10.99999.3.2
cmedConfiguration	1.3.6.1.4.1.9.10.99999.1.1
cmedConnections	1.3.6.1.4.1.9.10.99999.1.3
INT cmedGatewayAdminStatus	1.3.6.1.4.1.9.10.99999.1.1.2.1.9	INTEGER	read-create	The desired state of the gateway. The testing(3) state indicates that no signaling packets can be passed. When a managed system initializes, all gateways start with cmedGatewayAdminStatus in the down(2) state. As a result of either explicit management action or per configuration information retained by the managed system, cmedGatewayAdminStatus is then changed to either the up(1) or testing(3) states (or remains in the down(2) state).
cmedGatewayConfigEntry	1.3.6.1.4.1.9.10.99999.1.1.2.1		not-accessible	Entry holding configuration information about a group of Media Gateway Controllers sharing the same signaling link.
cmedGatewayConfigTable	1.3.6.1.4.1.9.10.99999.1.1.2		not-accessible	A list of cmedGatewayConfigEntry objects.
INT cmedGatewayEncodingScheme	1.3.6.1.4.1.9.10.99999.1.1.2.1.6	INTEGER	read-create	The encoding scheme that would be used to encode the H.248 messages that are sent/received to/from the gateway controller
CME cmedGatewayId	1.3.6.1.4.1.9.10.99999.1.1.2.1.1	CMediaGatewayId	not-accessible	The unique Media Gateway Id which identifies this media gateway
IP cmedGatewayIPAddress	1.3.6.1.4.1.9.10.99999.1.1.2.1.4	IpAddress	read-create	The IP address that the Media Gateway Controller will use to communicate with the Media Gateway. This object reflects the IP address over control PVC that user configures in cMediaGwIpConfigTable. The value 0.0.0.0 is returned if the entry is invalid.
TIM cmedGatewayLastStatusChange	1.3.6.1.4.1.9.10.99999.1.1.2.1.11	TimeStamp	read-only	The value of sysUpTime at the time the associated link entered its current operational status. If the current status was entered prior to the last re-initialization of the local network management subsystem, then this object contains a zero value.
CME cmedGatewayLinkId	1.3.6.1.4.1.9.10.99999.1.1.2.1.2	CMediaGatewayLinkId	not-accessible	The unique link id which identifies the signaling link that this gateway uses to communicate with the Gateway Controllers to form an H.248 association.
STR cmedGatewayLinkName	1.3.6.1.4.1.9.10.99999.1.1.2.1.3	SnmpAdminString	read-create	A descriptive name of this signaling link / media gateway combination
INT cmedGatewayOperStatus	1.3.6.1.4.1.9.10.99999.1.1.2.1.10	INTEGER	read-only	The current operational state of the gateway. up (1) - ready to communicate with MGC down (2) testing(3) - in some test mode unknown(4) - status can not be determined for some reason. The testing(3) state indicates that no signaling packets can be passed. If cmedGatewayAdminStatus is down(2) then cmedGatewayOperStatus should be down(2). If cmedGatewayAdminStatus is changed to up(1) then cmedGatewayOperStatus should change to up(1) if the gateway is ready to transmit and receive signaling traffic; it should remain in the down(2) state if and only if there is a fault that prevents it from going to the up(1) state
I32 cmedGatewayPort	1.3.6.1.4.1.9.10.99999.1.1.2.1.5	Integer32	read-create	TCP/UDP port number that the Media Gateway Controller will use to communicate with the Media Gateway. The value 0 is returned if the entry is invalid.
INT cmedGatewayProtocol	1.3.6.1.4.1.9.10.99999.1.1.2.1.7	INTEGER	read-create	Type of the control protocol in use notApplicable (1) - other (2) - Other (none from the list below) dss1-ip (3) - Q931+ ipdc (4) - IPDC megacov1 (5) - MEGACO/H.248 Version 1 megacov2 (6) - MEGACO/H.248 Version 2 mgcp (7) - MGCP
INT cmedGatewayResetStatistics	1.3.6.1.4.1.9.10.99999.1.1.2.1.12	INTEGER	read-create	This object can be used to reset all statistics collected for this media gateway link so far. Statistics will be reset when the object is SET to 'reset'. Upon reset, the agent changes the value of this object to 'notApplicable'.
ROW cmedGatewayRowStatus	1.3.6.1.4.1.9.10.99999.1.1.2.1.13	RowStatus	read-create	This is used to create new rows, modify existing rows and to delete existing rows.
INT cmedGatewaySigTptProtocol	1.3.6.1.4.1.9.10.99999.1.1.2.1.8	INTEGER	read-create	Type of the transport protocol that is being used to transport the H.248 signaling traffic
cmedGatewayStatsEntry	1.3.6.1.4.1.9.10.99999.1.2.1.1		not-accessible	Entry holding statistics about a group of media Gateway/signaling link pair
cmedGatewayStatsTable	1.3.6.1.4.1.9.10.99999.1.2.1		not-accessible	A list of mediaGatewayTableEntry objects.
INT cmedGwyControllerAdminStatus	1.3.6.1.4.1.9.10.99999.1.1.3.1.4	INTEGER	read-write	The desired state of the gateway. The testing(3) state indicates that no signaling packets can be passed. When a managed system initializes, all gateways start with cmedGwyControllerAdminStatus in the down(2) state. As a result of either explicit management action or per configuration information retained by the managed system, cmedGwyControllerAdminStatus is then changed to either the up(1) or testing(3) states (or remains in the down(2) state).
cmedGwyControllerEntry	1.3.6.1.4.1.9.10.99999.1.1.3.1		not-accessible	Entry holding information about an individual Media Gateway Controller.
cmedGwyControllerGroup	1.3.6.1.4.1.9.10.99999.3.2.3			This group contains of all the configuration Information for a Media Gateway Controller. This group is mandatory for any implementation managing a media gateway controller or a group of media gateway controllers. It is also mandatory for implementations managing media gateway(s)
U32 cmedGwyControllerId	1.3.6.1.4.1.9.10.99999.1.1.3.1.1	Unsigned32	not-accessible	An unique identification number that is assigned to the gateway controller by the manager
IP cmedGwyControllerIPAddress	1.3.6.1.4.1.9.10.99999.1.1.3.1.2	IpAddress	read-write	The IP address of the Media Gateway Controller. The value 0.0.0.0 is returned if the entry is invalid.
INT cmedGwyControllerOperStatus	1.3.6.1.4.1.9.10.99999.1.1.3.1.5	INTEGER	read-only	The current operational state of the gateway controller. The standby(3) state indicates that it is in the standby mode and no signaling packets can be passed. If cmedGwyControllerAdminStatus is down(2) then cmedGwyControllerOperStatus should be down(2). If cmedGwyControllerAdminStatus is changed to up(1), then cmedGwyControllerOperStatus should change to up(1). If the gateway controller is ready to transmit and receive signaling traffic; it should remain in the down(2) state if and only if there is a fault that prevents it from going to the up(1) state
I32 cmedGwyControllerPort	1.3.6.1.4.1.9.10.99999.1.1.3.1.3	Integer32	read-write	TCP port of the Media Gateway Controller. The value 0 is returned if the entry is invalid.
cmedGwyControllerTable	1.3.6.1.4.1.9.10.99999.1.1.3		not-accessible	List of the Media Gateway Controllers that are managed in the network
TIM cmedLastStatisticsReset	1.3.6.1.4.1.9.10.99999.1.2.1.1.12	TimeStamp	read-only	The value of sysUpTime at the time when the statistics were reset. If the reset occurred prior to the last re-initialization of the local network management subsystem, this object contains a zero value.
cmedLinkIdEntry	1.3.6.1.4.1.9.10.99999.1.1.1.1		not-accessible	This table contains the NextLinkId for this Gateway and is indexed by mediaGatewayId.
cmedLinkIdTable	1.3.6.1.4.1.9.10.99999.1.1.1		not-accessible	This table contains a nextLinkId for each Gateway. It provides the manager with the nextLinkId for use in creating new Gateway Table Entries.
cmedNextIdGroup	1.3.6.1.4.1.9.10.99999.3.2.4			Agent provides NextId's to the Manager to assist in selecting and creating new table entries. This group is optional for all the implementations. But when it is not implemented, it is the manager's responsibility to uniquely determine these ids
TES cmedNextLinkId	1.3.6.1.4.1.9.10.99999.1.1.1.1.1	TestAndIncr	read-write	The Next Value for a cmedGatewayLinkId. Assists the manager in selecting a value for cmedGatewayLinkId. Using the TestAndIncr syntax, A Manager will 'lock' this variable, ensuring single access.
TES cmedNextTerminationId	1.3.6.1.4.1.9.10.99999.1.3.1.1.1	TestAndIncr	read-write	The Next Value for a MediaGateway TerminationId. Assists the manager in selecting a value for cmedTermId. Using the TestAndIncr syntax, A Manager will 'lock' this variable, ensuring single access.
C32 cmedNumErrors	1.3.6.1.4.1.9.10.99999.1.2.1.1.5	Counter32	read-only	Total number of signaling-level errors encountered. Includes, but is not limited to, number of bad messages received, number of failures to sent a message and number of other errors.
C32 cmedNumInMessagesEx	1.3.6.1.4.1.9.10.99999.1.2.1.1.1	Counter32	read-only	Total number of messages received on the link.
C32 cmedNumInOctets	1.3.6.1.4.1.9.10.99999.1.2.1.1.2	Counter32	read-only	Total number of octets received on the link.
C32 cmedNumOutMessages	1.3.6.1.4.1.9.10.99999.1.2.1.1.3	Counter32	read-only	Total number of messages sent on the link.
C32 cmedNumOutOctets	1.3.6.1.4.1.9.10.99999.1.2.1.1.4	Counter32	read-only	Total number of octets sent on the link.
C32 cmedNumTimerRecovery	1.3.6.1.4.1.9.10.99999.1.2.1.1.6	Counter32	read-only	Total Number of timer recovery events since the statistics was last reset. This reflects all protocol timers that are supported (For H.248, T - start timer, S - short timer, L - long timer, and Z - long duration timer etc)
cmedProperties	1.3.6.1.4.1.9.10.99999.1.4
cmedPropertyProfileEntry	1.3.6.1.4.1.9.10.99999.1.3.3.1		not-accessible	Each row represents a default property of the Property Profile N-entries per mediaGatewayId/PropertyId, one entry per property.
U32 cmedPropertyProfileId	1.3.6.1.4.1.9.10.99999.1.3.3.1.1	Unsigned32	not-accessible	This PropertyProfile Identifier uniquely identifies this set of properties. This is the value each termination would refer, when they would like to support all the properties in this profile
U32 cmedPropertyProfileIndex	1.3.6.1.4.1.9.10.99999.1.3.3.1.2	Unsigned32	not-accessible	This is the index to the PropertyProfile This is just a 'counter' through the cmedPropertyProfile Table. ie, property=1 property=2 etc.
OID cmedPropertyProfileProperty	1.3.6.1.4.1.9.10.99999.1.3.3.1.3	AutonomousType	read-create	The Property supported by this Profile. This is an Object ID (OID) defined in a package MIB to identify a Particular property (such as AnalogLines, Tones etc).
ROW cmedPropertyProfileRowStatus	1.3.6.1.4.1.9.10.99999.1.3.3.1.4	RowStatus	read-create	It is used to create new rows in this table, modify existing rows, and to delete existing rows.
cmedPropertyProfileTable	1.3.6.1.4.1.9.10.99999.1.3.3		not-accessible	This table contains a list of the properties supported in a Profile. A Manager builds a Profile of properties, then ties each termination to a defined profile
cmedStatistics	1.3.6.1.4.1.9.10.99999.1.2
cmedStatsGroup	1.3.6.1.4.1.9.10.99999.3.2.2			This group contains of all the statistics Information for a Media Gateway. This group is mandatory for any implementation managing a media gateway or a group of media gateways
INT cmedTermAdminStatus	1.3.6.1.4.1.9.10.99999.1.3.2.1.3	INTEGER	read-create	The desired state of the termination. The testing(3) state indicates that no connections can be created for this termination. When a managed system initializes, all terminations start with cmedTermAdminStatus in the outOfService(2) state. As a result of either explicit management action or per configuration information retained by the managed system, cmedTermAdminStatus is then changed to either the inService(1) or testing(3) states (or remains in the outOfService(2) state).
cmedTermGroup	1.3.6.1.4.1.9.10.99999.3.2.5			This group contains of all the configuration Information for a termination. This group is mandatory for any implementation managing termination.
CME cmedTermId	1.3.6.1.4.1.9.10.99999.1.3.2.1.1	CMediaGatewayTermId	not-accessible	An unique identification number that is assigned to the termination by a media gateway. This is the TerminationId that would be used in the protocol messages that are sent from the gateway
cmedTermIdEntry	1.3.6.1.4.1.9.10.99999.1.3.1.1		not-accessible	This table contains a nextTerminationId for each Gateway, and is indexed by mediaGatewayId.
cmedTermIdTable	1.3.6.1.4.1.9.10.99999.1.3.1		not-accessible	This table contains a nextTerminationId for each Gateway. It provides the manager with the nextTerminationId for use in creating a new TerminationsTable Entry.
cmedTerminationsEntry	1.3.6.1.4.1.9.10.99999.1.3.2.1		not-accessible	It contains objects that describe a termination.
cmedTerminationsTable	1.3.6.1.4.1.9.10.99999.1.3.2		not-accessible	This table contains information about terminations in a media gateway. It is a list of terminations. The number of entries equals to the total number of terminations for all contexts in a gateway.
NUM cmedTermInterfaceIdentifier	1.3.6.1.4.1.9.10.99999.1.3.2.1.5	InterfaceIndex	read-create	A number that uniquely identifies the interface in the physical gateway. This is the ifIndex in the ifTable, that this termination would be using to communicate to other gateways
STR cmedTermName	1.3.6.1.4.1.9.10.99999.1.3.2.1.2	SnmpAdminString	read-create	A descriptive name that would describe this termination and its use. For example, 'emergency-ds0-1' indicating that this termination is reserved as an emergency DS0 channel
INT cmedTermOperStatus	1.3.6.1.4.1.9.10.99999.1.3.2.1.4	INTEGER	read-only	The current operational state of the termination. The testing(3) state indicates that it is in the testing mode and no connections can be created on it. If cmedTermAdminStatus is outOfService(2) then cmedTermOperStatus should be down(2). If cmedTermAdminStatus is changed to up(1) then cmedTermOperStatus should change to up (1) and the termination is ready to accept connections; it should remain in the down(2) state if and only if there is a fault that prevents it from going to the up(1) state
U32 cmedTermPropertyProfileId	1.3.6.1.4.1.9.10.99999.1.3.2.1.6	Unsigned32	read-create	This determines the profile of the termination which determines what kind of capabilities this termination has. This is an index into the cmedPropertyProfileTable which identifies all the profile that are available
ROW cmedTermRowStatus	1.3.6.1.4.1.9.10.99999.1.3.2.1.7	RowStatus	read-create	This is used to create new rows in this table, Modify existing rows, and to delete existing rows.
INT cmedTransportLastEvent	1.3.6.1.4.1.9.10.99999.1.2.1.1.10	INTEGER	read-only	Last event reported by the transport layer. notApplicable (1) - Invalid/unknown. other (2) - None from the list below. linkUp (3) - Transport link is up. linkLoss (4) - Transport link loss. persistentError (5) - No link - persistent error. linkShutdown (6) - Link is shut down. switchOver (7) - Fail-over.
TIM cmedTransportLastEventTime	1.3.6.1.4.1.9.10.99999.1.2.1.1.11	TimeStamp	read-only	The value of sysUpTime at the time when the event specified by cmedTransportLastEvent occurred. If the last event occurred prior to the last re-initialization of the local network management subsystem, then this object contains a zero value.
C32 cmedTransportNumLosses	1.3.6.1.4.1.9.10.99999.1.2.1.1.7	Counter32	read-only	Number of times a transport link was lost (excluding switch-over cases). A link loss is defined as loss of communication with the entity (MGC) due to hardware/transient problems in the interface or other related hardware/software
C32 cmedTransportNumSwitchover	1.3.6.1.4.1.9.10.99999.1.2.1.1.8	Counter32	read-only	Number of times when the signaling was switched over to an alternative link. This includes switchover due to the Handoffs initiated by the gateway controllers
C32 cmedTransportTotalNumAlarms	1.3.6.1.4.1.9.10.99999.1.2.1.1.9	Counter32	read-only	Total number of all alarms issued for the transport layer.

RFC description

Cisco SNMP MIB module based on IETF draft standards for managing Media Gateway Control Protocol (Megaco/H.248). Defines objects for gateway configuration, statistics, and controller management in voice networks.

Start monitoring Cisco media gateways / voice gateway routers 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-IETF-MEGACO-MIB