H323-GATEKEEPER-MIB

All MIBs › H323-GATEKEEPER-MIB

Organization: ITU-T

Last Updated: 1998-12-18

Category: Domain: Telephony/VoIP

Description: ITU-T H.323 Gatekeeper MIB for managing H.323 zone registration, admission control, and endpoint addressing.

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 H323-GATEKEEPER-MIB?

The H323-GATEKEEPER-MIB is a vendor-neutral, ITU-T standards-based MIB for managing H.323 gatekeepers, the control-plane devices that perform zone registration, admission control, and address translation for H.323 VoIP/videoconferencing endpoints. It exposes system identification data (name, manufacturer, contact, location), version and configuration information, and zone-level registration/admission data. It is explicitly useful for monitoring both software and device status: system uptime and local time track availability, while software version number and hardware version number let an operator confirm firmware/hardware revisions after upgrades. As a standards-based module it depends on the broader ITU-T H.323 signaling framework and is typically deployed alongside complementary H.323 terminal/MCU MIBs for full call-control visibility. Deployment context is enterprise or carrier VoIP/videoconferencing networks that use an H.323 gatekeeper to manage a zone of registered endpoints, and the H323-GATEKEEPER-MIB reference defines the standard object set implemented across vendor gatekeeper products.

IPNetwork Monitor allows you to monitor SNMP objects defined in H323-GATEKEEPER-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

H.323 VoIP/videoconferencing gatekeeper (vendor-neutral, standards-based ITU-T H.323 MIB, not tied to a specific manufacturer)

Monitoring Examples

An administrator would poll the h323GatekeeperSystemTable/h323GatekeeperSystemEntry for h323GatekeeperSystemUptime to detect an unexpected gatekeeper restart, and cross-check h323GatekeeperSystemSoftwareVersionNumber and h323GatekeeperSystemHardwareVersionNumber after a firmware or hardware upgrade to confirm the change took effect. h323GatekeeperSystemNameAndMaker and h323GatekeeperSystemContact support asset inventory and identification during an incident, while the h323GatekeeperZone object supports checking zone-level registration/admission configuration for endpoints served by the gatekeeper.

What Can Be Monitored

system uptime
software version number
hardware version number
system contact and location
gatekeeper zone configuration
local time

Imported Objects

From IF-MIB

ifIndex

OBJECT-TYPE

From MULTI-MEDIA-MIB-TC

MmControlsCommands
MmErrorProbableCause
MmErrorSeverity
MmGatekeeperID
MmTAddressTag
mmH323Root	OBJECT-IDENTITY

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Integer32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
TimeTicks
Unsigned32

From SNMPv2-TC

DateAndTime
DisplayString
RowStatus
TAddress
TruthValue

How to Use in IPNetwork Monitor

Example using h323ZoneAdmissions OID:

Select a device implementing H323-GATEKEEPER-MIB 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 h323ZoneAdmissions 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. The number of ACFs by the gatekeeper. If h323ZoneLocalZone is 'false' then the value of this object has no meaning. 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
h323Gatekeeper	0.0.8.341.1.1.6			The MIB Module supports the functions of a H323 gatekeeper.
h323GatekeeperZone	0.0.8.341.1.1.6.1
h323ZoneTable	0.0.8.341.1.1.6.1.1		not-accessible	The table contains the local zones supported by the Gatekeeper and the remote zones which the Gatekeeper may or has interacted with.
h323ZoneEntry	0.0.8.341.1.1.6.1.1.1		not-accessible	An entry (conceptual row) in the h323ZoneTable. An entry may be created administratively or by the gatekeeper during normal gatekeeper operations. Unless otherwise specified, writable objects may be changed while h323ZoneRowStatus is 'active'.
I32 h323ZoneIndex	0.0.8.341.1.1.6.1.1.1.1	Integer32	not-accessible	An unsigned integer value whose only significance is to uniquely identify the conceptual row. The value has no significance.
MMG h323ZoneZoneName	0.0.8.341.1.1.6.1.1.1.2	MmGatekeeperID	read-create	The name of the zone as fully qualifed name. e.g. zone1.area1.company.com
ADR h323ZoneRasSignalAddressTag	0.0.8.341.1.1.6.1.1.1.3	MmTAddressTag	read-create	The tag identifying the underlying type of h323ZoneRasSignalAddress.
ADR h323ZoneRasSignalAddress	0.0.8.341.1.1.6.1.1.1.4	TAddress	read-create	A RAS Signal transport address of the gatekeeper supporting the zone.
U32 h323ZoneMaxBandwidth	0.0.8.341.1.1.6.1.1.1.5	Unsigned32	read-create	The maximum bidirectional bandwidth which a gatekeeper can allocate to all calls in the zone. If h323ZoneLocalFlag is 'false' then this object may be 0, indicating unknown. h323ZoneMaxBandwidth is the total bidirectional data flow in units of hundred bits per second (bps). A value of 10 is 1000bps.
I32 h323ZoneAllocatedBandwidth	0.0.8.341.1.1.6.1.1.1.6	Integer32	read-only	The total bidirectional bandwidth allocated by the gatekeeper to the active calls. If h323ZoneLocalFlag is 'false' then this object does not apply. The value is in units of hundred bits per second, i.e. a value of 10 is 1000 bps. This value may not exceed the value of h323ZoneMaxBandwidth.
INT h323ZoneIrrFrequency	0.0.8.341.1.1.6.1.1.1.7	INTEGER	read-create	The IRR time a gatekeeper returns in a ACF.
T/F h323ZoneLocalZone	0.0.8.341.1.1.6.1.1.1.8	TruthValue	read-create	If this gatekeeper manages the zone, then this value is 'true' otherwise it is false.
C32 h323ZoneAdmissionsEx	0.0.8.341.1.1.6.1.1.1.9	Counter32	read-only	The number of ACFs by the gatekeeper. If h323ZoneLocalZone is 'false' then the value of this object has no meaning.
C32 h323ZoneAdmissionsRejected	0.0.8.341.1.1.6.1.1.1.10	Counter32	read-only	The number of ARJ sent by the gatekeeper. If h323ZoneLocalZone is 'false' then the value of this object has no meaning.
ROW h323ZoneRowStatus	0.0.8.341.1.1.6.1.1.1.11	RowStatus	read-create	The row status of the entry. This object is required to create or delete rows administratively. A agent implementing this object is not required to support the values 'createAndWait' and 'notInService'.
h323GatekeeperSystem	0.0.8.341.1.1.6.2
h323GatekeeperSystemTable	0.0.8.341.1.1.6.2.1		not-accessible	This table describes the system information for instances of a gatekeeper.
h323GatekeeperSystemEntry	0.0.8.341.1.1.6.2.1.1		not-accessible	It contains objects that describe the system.
STR h323GatekeeperSystemNameAndMaker	0.0.8.341.1.1.6.2.1.1.1	DisplayString	read-only	This entity's name and maker name. A textual description of this entity may be appended after the maker name.
STR h323GatekeeperSystemSoftwareVersionNumber	0.0.8.341.1.1.6.2.1.1.2	DisplayString	read-only	Software version number (major and minor)
STR h323GatekeeperSystemHardwareVersionNumber	0.0.8.341.1.1.6.2.1.1.3	DisplayString	read-only	Hardware version number
STR h323GatekeeperSystemContact	0.0.8.341.1.1.6.2.1.1.4	DisplayString	read-only	The textual identification of the contact person for this managed node, together with information on how to contact this person.
INT h323GatekeeperSystemt35CountryCode	0.0.8.341.1.1.6.2.1.1.5	INTEGER	read-only	Country code, per T.35.
INT h323GatekeeperSystemt35CountryCodeExtention	0.0.8.341.1.1.6.2.1.1.6	INTEGER	read-only	Assigned nationally.
INT h323GatekeeperSystemt35ManufacturerCode	0.0.8.341.1.1.6.2.1.1.7	INTEGER	read-only	Assigned nationally.
STR h323GatekeeperSystemLocation	0.0.8.341.1.1.6.2.1.1.8	DisplayString	read-only	The physical location of this system. For instance, closet, terminal room and so on
TIK h323GatekeeperSystemUptime	0.0.8.341.1.1.6.2.1.1.9	TimeTicks	read-only	The amount of time (in hundredths of a second) since this system was last initialized. Note that this is different from sysUpTime in MIB-II because sysUpTime is the uptime of the network management portion of the system.
DAT h323GatekeeperSystemLocalTime	0.0.8.341.1.1.6.2.1.1.10	DateAndTime	read-write	The local date and time of day.
h323GatekeeperConfiguration	0.0.8.341.1.1.6.3
h323GatekeeperConfigurationTable	0.0.8.341.1.1.6.3.1		not-accessible	This table contains configuration information for instances of a gatekeeper.
h323GatekeeperConfigurationEntry	0.0.8.341.1.1.6.3.1.1		not-accessible	It contains objects that describe the configuration.
INT h323GatekeeperConfigurationEnableNotifications	0.0.8.341.1.1.6.3.1.1.1	INTEGER	read-write	Indicates whether notifications should be generated for this entity. The default is disabled.
INT h323GatekeeperConfigurationRegistrationMode	0.0.8.341.1.1.6.3.1.1.2	INTEGER	read-write	Indicates whether gatekeeper allows : 1 - all endpoints to register dynamically 2 - no endpoints to register dynamically 3 - only predefined endpoints to register dynamically
h323GatekeeperStatistics	0.0.8.341.1.1.6.4
h323GatekeeperStatisticsTable	0.0.8.341.1.1.6.4.1		not-accessible	This table contains statistics information for instances of a gatekeeper.
h323GatekeeperStatisticsEntry	0.0.8.341.1.1.6.4.1.1		not-accessible	It contains objects that describe the statistics.
C32 h323GatekeeperStatisticsTotalErrors	0.0.8.341.1.1.6.4.1.1.1	Counter32	read-only	Total number of GK errors that have occurred in the gateway since the last startup
DAT h323GatekeeperStatisticsLastErrorEventTime	0.0.8.341.1.1.6.4.1.1.2	DateAndTime	read-only	The date and time for the most recent error that has occurred in the gatekeeper.
MME h323GatekeeperStatisticsLastErrorSeverity	0.0.8.341.1.1.6.4.1.1.3	MmErrorSeverity	read-only	Severity for the most recent error that has occurred in the gatekeeper.
MME h323GatekeeperStatisticsLastErrorProbableCause	0.0.8.341.1.1.6.4.1.1.4	MmErrorProbableCause	read-only	Probable Cause for the most recent error that has occurred in the gatekeeper. This value must be one of the given probable causes for errors on an entity. Values for probable causes for errors on a call or errors on a connection do not apply.
STR h323GatekeeperStatisticsLastErrorAdditionalText	0.0.8.341.1.1.6.4.1.1.5	DisplayString	read-only	String Description of the most recent error that has occurred in the gatekeeper.
C32 h323GatekeeperStatisticsZoneNo	0.0.8.341.1.1.6.4.1.1.6	Counter32	read-only	The number of h323 local zones supported by the Gatekeeper and the remote zones which the Gatekeeper may or has interacted with.
h323GatekeeperControls	0.0.8.341.1.1.6.5
MMC h323GatekeeperControlsCommands	0.0.8.341.1.1.6.5.1	MmControlsCommands	read-write	A value that represents a command for the gateway. For the list of possible commands, please refer to MmControlsCommands
h323GatekeeperNotifications	0.0.8.341.1.1.6.6
NTF h323GatekeeperStart	0.0.8.341.1.1.6.6.1			Signifies that the gatekeeper has started. All MIB counters have gone to zero.
NTF h323GatekeeperGoingDown	0.0.8.341.1.1.6.6.2			Signifies that the gatekeeper is about to go down
NTF h323GatekeeperError	0.0.8.341.1.1.6.6.3			Signifies that an error has occurred in the Gatekeeper.
h323GatekeeperMIBConformance	0.0.8.341.1.1.6.7
h323GatekeeperMIBCompliance	0.0.8.341.1.1.6.7.1
h323GatekeeperCompliance	0.0.8.341.1.1.6.7.1.1			The set of objects required for compliance.
h323GatekeeperMIBGroups	0.0.8.341.1.1.6.7.2
h323GatekeeperSystemGroup	0.0.8.341.1.1.6.7.2.1			The set of objects a gatekeeper must support for the GK System Description.
h323GatekeeperConfigurationGroup	0.0.8.341.1.1.6.7.2.2			The set of objects a gatekeeper must support for the GK Configuration.
h323GatekeeperZoneGroup	0.0.8.341.1.1.6.7.2.3			The set of objects a gatekeeper must support for local and remote zones.
h323GatekeeperStatisticsGroup	0.0.8.341.1.1.6.7.2.4			The set of objects a gatekeeper must support for statistics.
h323GatekeeperControlsGroup	0.0.8.341.1.1.6.7.2.5			The set of objects a gatekeeper must support for controls.
h323GatekeeperNotificationsGroup	0.0.8.341.1.1.6.7.2.6			The set of notification a gatekeeper must support.

RFC description

An SNMP MIB providing management objects for monitoring and controlling H.323 gatekeeper functions, enabling network administrators to manage call routing, bandwidth allocation, and gatekeeper statistics for VoIP systems.

Start monitoring Vendor-neutral H.323 VoIP/videoconferencing gatekeeper, any manufacturer 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 H323-GATEKEEPER-MIB