USR-NTP-MIB

All MIBs › USR-NTP-MIB

Organization: CommWorks Corporation

Last Updated: 2002-08-23

Category: CommWorks/3Com Access Equipment

Description: Covers NTP server associations, stratum levels, and clock synchronization on CommWorks equipment.

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 USR-NTP-MIB?

USR-NTP-MIB is a vendor-specific enterprise module from CommWorks (formerly US Robotics) that defines the private interface to the Simple Network Time Protocol (SNTP) client process running on CommWorks equipment, based on RFC 2030 unicast mode. It exposes configuration objects for primary and secondary NTP server addresses, polling interval, retransmit/timeout settings, and protocol version, along with status objects reporting the last successfully contacted server and count of received time datagrams. This MIB directly supports software status monitoring by letting an administrator verify the device's time-sync client is enabled, confirm which server it is actually synchronizing against via usrNTPLastGoodServer, and detect a stalled or failing time sync via usrNTPRcvdDatagrams staying flat, which is important since time drift can break authentication, logging correlation, and billing timestamps. It is based on RFC 2030 (SNTP) as its underlying protocol standard, though implemented as a CommWorks-proprietary management interface. It is typically deployed on CommWorks/3Com carrier access or gateway equipment where accurate time synchronization is required for call detail records and event logging. Network engineers evaluating or troubleshooting this functionality can download the USR-NTP-MIB file directly to load it into their MIB browser.

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

CommWorks/3Com carrier access or gateway equipment

Monitoring Examples

An administrator would poll usrNTPPrimaryServer and usrNTPSecondaryServer to confirm the correct NTP sources are configured, then check usrNTPLastGoodServer to see which one the device actually last synced against, revealing a failover to the secondary server. Watching usrNTPRcvdDatagrams over time and comparing against usrNTPPollingInterval would show whether the client is actively receiving time updates; a flat or zero count combined with usrNTPEnable set to true would indicate a stalled sync, likely due to server unreachability, matching usrNTPTimeOut/usrNTPMaxRetransmits thresholds being exceeded. usrNTPModuleVersion confirms the software revision of the NTP client module itself.

What Can Be Monitored

primary/secondary NTP server configuration
last successfully contacted time server
received time datagram count
NTP client enable state and protocol version
polling interval and retransmit/timeout settings

Imported Objects

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Integer32
IpAddress
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-IDENTITY
OBJECT-TYPE

From SNMPv2-TC

DisplayString

From USR-DEFINITIONS-MIB

UsrConfigStatus
UsrDisplayString
common	OBJECT-IDENTITY

How to Use in IPNetwork Monitor

Example using usrNTPRcvdDatagrams OID:

Select a CommWorks/3Com carrier gateway 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 usrNTPRcvdDatagrams into the Find box to locate it in the OID tree, then select it and click OK. It reports the number of datagrams received at the port on which NTP is listening to. 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
usrNTPMib	1.3.6.1.4.1.429.4.34			This MIB Module defines the CommWorks private interface to the Simple Network Time Protocol client process. The process can be configured with up to two alternate servers, a primary server and a secondary server. The primary server is always contacted first, the secondary server is contacted after all retransmissions to the primary failed have failed. The implementation is based on RFC 2030, using unicast mode only. Note that all the writable objects include a 'DEFVAL' clause. The clause is intended to be used as a reference only, in case an agent has no previously saved configuration. Typically, at start-up, an agent will load data saved from a previous session - thus 'DEFVAL' is used mainly for new systems.
usrNTPObjects	1.3.6.1.4.1.429.4.34.1
STR usrNTPPrimaryServer	1.3.6.1.4.1.429.4.34.1.1	DisplayString	read-write	The IP address or host name of the primary NTP server that the module will query for time synchronization. An empty string means that no primary server is defined.
STR usrNTPSecondaryServer	1.3.6.1.4.1.429.4.34.1.2	DisplayString	read-write	The IP address or host name of the secondary NTP server that the module will query for time synchronization whenever the primary server is unavailable. An empty string means that no secondary server is defined.
I32 usrNTPPollingInterval	1.3.6.1.4.1.429.4.34.1.3	Integer32	read-write	The polling interval used by the NTP process to gather time synchronization information. In seconds. The range available is 64 seconds to 1024 seconds. The default is 600 seconds (10 minutes).
I32 usrNTPMaxRetransmits	1.3.6.1.4.1.429.4.34.1.4	Integer32	read-write	The maximum number of times a request will be retransmitted to a given server before the server is considered unavailable. The range allowed is 1 to 200 times. The default is 5 times.
I32 usrNTPTimeOut	1.3.6.1.4.1.429.4.34.1.5	Integer32	read-write	The number of seconds since a request has been sent to a server, after which period the request is considered timed-out. The range for this is 1 second to 1 minute. The default is 10 seconds.
INT usrNTPEnable	1.3.6.1.4.1.429.4.34.1.6	INTEGER	read-write	This object enables or disables NTP synchronization in a system. Default is disabled.
INT usrNTPProtocolVersion	1.3.6.1.4.1.429.4.34.1.7	INTEGER	read-write	The protocol version that the NTP client will use when sending NTP client requests to a server.
STR usrNTPCfmFileName	1.3.6.1.4.1.429.4.34.1.8	DisplayString	read-only	The name of the configuration file currently in use.
USR usrNTPCfmSaveFlag	1.3.6.1.4.1.429.4.34.1.9	UsrConfigStatus	read-write	Setting the value of this object to `save' causes the values of the NTP Group to be written out to the current config file, which is stored in the usrNTPCfmFileName object. While the new ConfigFile is being written, the NTP process will set the value of this flag set to `saving''. Any attempts to set the value while it is not `normal' (i.e. the file is currently being written to the ConfigFile) will result in a badValue error being returned. Setting the value to `normal' will result in no action.
STR usrNTPModuleVersion	1.3.6.1.4.1.429.4.34.1.10	DisplayString	read-only	The current software version of the NTP module.
STR usrNTPLastGoodServer	1.3.6.1.4.1.429.4.34.1.11	DisplayString	read-only	The symbolic host name of the last server from which time synchronization information was received (if there was a numeric address defined, this will be a numeric address in dot notation).
C32 usrNTPRcvdDatagramsEx	1.3.6.1.4.1.429.4.34.1.12	Counter32	read-only	Number of datagrams received at the port on which NTP is listening to.
C32 usrNTPRcvdTooShorts	1.3.6.1.4.1.429.4.34.1.13	Counter32	read-only	Number of datagrams received which were too short for NTP version four.
C32 usrNTPRcvdBadVersions	1.3.6.1.4.1.429.4.34.1.14	Counter32	read-only	Number of datagrams received with a wrong NTP version.
C32 usrNTPRcvdRequests	1.3.6.1.4.1.429.4.34.1.15	Counter32	read-only	Number of NTP requests received.
C32 usrNTPRcvdReplies	1.3.6.1.4.1.429.4.34.1.16	Counter32	read-only	Number of NTP replies received.
C32 usrNTPRcvdUnsuportedModes	1.3.6.1.4.1.429.4.34.1.17	Counter32	read-only	Number of NTP datagrams received which had a mode value not supported by this entity.
C32 usrNTPSentRequests	1.3.6.1.4.1.429.4.34.1.18	Counter32	read-only	Number of NTP requests sent.
C32 usrNTPSentReplies	1.3.6.1.4.1.429.4.34.1.19	Counter32	read-only	Number of NTP replies sent since the system was last rebooted.
C32 usrNTPSentRexmits	1.3.6.1.4.1.429.4.34.1.20	Counter32	read-only	Number of NTP requests that were retransmitted due to lack of a timely reply.
C32 usrNTPSendErrors	1.3.6.1.4.1.429.4.34.1.21	Counter32	read-only	Number of NTP requests that could not be sent due to internal errors.
C32 usrNTPDnsErrors	1.3.6.1.4.1.429.4.34.1.22	Counter32	read-only	Number of times an error was returned by DNS when processing a name resolution request from the NTP module.
C32 usrNTPServerTimeouts	1.3.6.1.4.1.429.4.34.1.23	Counter32	read-only	Number of times a server was considered unavailable after requests were sent to it a maximum number of retransmissions without a reply.
C32 usrNTPAllocErrors	1.3.6.1.4.1.429.4.34.1.24	Counter32	read-only	Number of times an operation could not be performed due to a failure to allocate memory resources.
IP usrNTPResolvedIPAddress	1.3.6.1.4.1.429.4.34.1.25	IpAddress	read-only	The IP address resolved from the 'current' server with which synchronization is being attempted. If there is no resolution, or there is no current server defined, this object returns zero.
I32 usrNTPLastRcvdLeapIndicator	1.3.6.1.4.1.429.4.34.1.26	Integer32	read-only	The value of the last received Leap Indicator field.
I32 usrNTPLastRcvdMode	1.3.6.1.4.1.429.4.34.1.27	Integer32	read-only	The value of the last received Mode field.
I32 usrNTPLastRcvdStratum	1.3.6.1.4.1.429.4.34.1.28	Integer32	read-only	The value of the last received Stratum field.
I32 usrNTPLastRcvdPoll	1.3.6.1.4.1.429.4.34.1.29	Integer32	read-only	The value of the last received Poll field.
I32 usrNTPLastRcvdPrecision	1.3.6.1.4.1.429.4.34.1.30	Integer32	read-only	The value of the last received Precision field.
I32 usrNTPLastRcvdRootDelay	1.3.6.1.4.1.429.4.34.1.31	Integer32	read-only	The value of the last received Root Delay field.
I32 usrNTPLastRcvdRootDispersion	1.3.6.1.4.1.429.4.34.1.32	Integer32	read-only	The value of the last received Root Dispersion field.
I32 usrNTPLastRcvdReferenceIdentifier	1.3.6.1.4.1.429.4.34.1.33	Integer32	read-only	The value of the last received Reference Identifier field.
I32 usrNTPLastRcvdReferenceTimestampHigh	1.3.6.1.4.1.429.4.34.1.34	Integer32	read-only	The value of the last received Reference Timestamp field (high octets).
I32 usrNTPLastRcvdReferenceTimestampLow	1.3.6.1.4.1.429.4.34.1.35	Integer32	read-only	The value of the last received Reference Timestamp field (low octets).
I32 usrNTPLastRcvdOriginateTimestampHigh	1.3.6.1.4.1.429.4.34.1.36	Integer32	read-only	The value of the last received Originate Timestamp field (high octets).
I32 usrNTPLastRcvdOriginateTimestampLow	1.3.6.1.4.1.429.4.34.1.37	Integer32	read-only	The value of the last received Originate Timestamp field (low octets).
I32 usrNTPLastRcvdReceiveTimestampHigh	1.3.6.1.4.1.429.4.34.1.38	Integer32	read-only	The value of the last received Receive Timestamp field (high octets).
I32 usrNTPLastRcvdReceiveTimestampLow	1.3.6.1.4.1.429.4.34.1.39	Integer32	read-only	The value of the last received Receive Timestamp field (low octets).
I32 usrNTPLastRcvdTransmitTimestampHigh	1.3.6.1.4.1.429.4.34.1.40	Integer32	read-only	The value of the last received Transmit Timestamp field (high octets).
I32 usrNTPLastRcvdTransmitTimestampLow	1.3.6.1.4.1.429.4.34.1.41	Integer32	read-only	The value of the last received Transmit Timestamp field (low octets).
STR usrNTPTimeZone	1.3.6.1.4.1.429.4.34.1.42	UsrDisplayString	read-write	Timezone variables; should be one of the following, Egypt, Libya, PRC, ROC, Hongkong, Iran, Israel, Japan, ROK, Singapore, Australia/Tasmania, Australia/Queensland, Australia/North, Australia/West, Australia/South, Australia/Victoria, Australia/NSW, Australia/Yancowinna, Australia/LHI, NZ, GMT, GMT-12, GMT-11, GMT-10, GMT-9, GMT-8, GMT-7, GMT-6, GMT-5, GMT-4, GMT-3, GMT-2, GMT-1, GMT+1, GMT+2, GMT+3, GMT+4, GMT+5, GMT+6, GMT+7, GMT+8, GMT+9, GMT+10, GMT+11, GMT+12, GMT+13, UTC, Universal, Greenwich, Zulu, GMT-0, GMT+0, GB-Eire, WET, Iceland, MET, EET, Turkey, W-SU, CET, Factory, US/Eastern, US/Central, US/Mountain, US/Pacific, US/Alaska, US/East-Indiana, US/Arizona, US/Michigan, US/Samoa, US/Aleutian, US/Hawaii, Canada/Newfoundland, Canada/Atlantic, Canada/Eastern, Canada/Central, Canada/East-Saskatchewan, Canada/Mountain, Canada/Pacific, Canada/Yukon, Mexico/BajaNorte, Mexico/BajaSur, Mexico/General, Cuba, Navajo, Jamaica, Brazil/East, Brazil/West, Brazil/Acre, Brazil/DeNoronha, Chile/Continental, Chile/EasterIsland.
usrNTPTimeZoneTable	1.3.6.1.4.1.429.4.34.1.43		not-accessible
timeZoneEntry	1.3.6.1.4.1.429.4.34.1.43.1		not-accessible
I32 usrNTPIndex	1.3.6.1.4.1.429.4.34.1.43.1.1	Integer32	not-accessible	The key field
STR usrNTPNextTimeZone	1.3.6.1.4.1.429.4.34.1.43.1.2	DisplayString	read-only	Time zone list name
usrNTPConformance	1.3.6.1.4.1.429.4.34.2
usrNTPCompliances	1.3.6.1.4.1.429.4.34.2.1
usrNTPCompliance	1.3.6.1.4.1.429.4.34.2.1.1			The compliance statement for entities which implement the MIB.
usrNTPGroups	1.3.6.1.4.1.429.4.34.2.2
usrNTPGroup	1.3.6.1.4.1.429.4.34.2.2.1			All objects in this MIB.
usrNTPTraps	1.3.6.1.4.1.429.4.34.3
usrNTPTrapsV2	1.3.6.1.4.1.429.4.34.3.0			Events for NTP
NTF usrNTPServerFailure	1.3.6.1.4.1.429.4.34.3.0.1			This trap is generated for NTP Server connectivity failure.

RFC description

Manages NTP server associations, stratum, and clock synchronization on CommWorks equipment.

Start monitoring CommWorks/3Com carrier gateways 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 USR-NTP-MIB