draft-ietf-ntp-ntpv4-mib-03.txt   draft-ietf-ntp-ntpv4-mib-04.txt 
NTP H. Gerstung NTP H. Gerstung
Internet-Draft Meinberg Internet-Draft Meinberg
Expires: June 7, 2008 C. Elliott Expires: August 28, 2008 C. Elliott
Cisco Cisco
December 5, 2007 February 25, 2008
Definitions of Managed Objects for Network Time Protocol Version 4 Definitions of Managed Objects for Network Time Protocol Version 4
(NTPv4) (NTPv4)
draft-ietf-ntp-ntpv4-mib-03 draft-ietf-ntp-ntpv4-mib-04
Status of this Memo Status of this Memo
By submitting this Internet-Draft, each author represents that any By submitting this Internet-Draft, each author represents that any
applicable patent or other IPR claims of which he or she is aware applicable patent or other IPR claims of which he or she is aware
have been or will be disclosed, and any of which he or she becomes have been or will be disclosed, and any of which he or she becomes
aware will be disclosed, in accordance with Section 6 of BCP 79. aware will be disclosed, in accordance with Section 6 of BCP 79.
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that Task Force (IETF), its areas, and its working groups. Note that
skipping to change at page 1, line 36 skipping to change at page 1, line 36
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
The list of current Internet-Drafts can be accessed at The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt. http://www.ietf.org/ietf/1id-abstracts.txt.
The list of Internet-Draft Shadow Directories can be accessed at The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html. http://www.ietf.org/shadow.html.
This Internet-Draft will expire on June 7, 2008. This Internet-Draft will expire on August 28, 2008.
Copyright Notice Copyright Notice
Copyright (C) The IETF Trust (2007). Copyright (C) The IETF Trust (2008).
Abstract Abstract
The Network Time Protocol (NTP) is used in networks of all types and The Network Time Protocol (NTP) is used in networks of all types and
sizes for time synchronization of servers, workstations and other sizes for time synchronization of servers, workstations and other
networked equipment. As time synchronization is more and more a networked equipment. As time synchronization is more and more a
mission critical service, standardized means for monitoring and mission critical service, standardized means for monitoring and
management of this subsystem of a networked host are required to management of this subsystem of a networked host are required to
allow operators of such a service to setup a monitoring system that allow operators of such a service to setup a monitoring system that
is platform- and vendor-independant. This Internet draft provides a is platform- and vendor-independant. This Internet draft provides a
standardized collection of data objects for monitoring the NTP entity standardized collection of data objects for monitoring the NTP entity
of such a network participant and it is part of the NTP Version 4 of such a network participant and it is part of the NTP Version 4
standardization effort. standardization effort.
Table of Contents Table of Contents
1. The Internet-Standard Management Framework . . . . . . . . . . 3 1. The Internet-Standard Management Framework . . . . . . . . . . 3
2. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
3. Technical Description . . . . . . . . . . . . . . . . . . . . 3 3. Technical Description . . . . . . . . . . . . . . . . . . . . 3
4. MIB Definition . . . . . . . . . . . . . . . . . . . . . . . . 4 4. MIB Definition . . . . . . . . . . . . . . . . . . . . . . . . 4
5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 24 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 25
6. Security Considerations . . . . . . . . . . . . . . . . . . . 24 6. Security Considerations . . . . . . . . . . . . . . . . . . . 25
7. References . . . . . . . . . . . . . . . . . . . . . . . . . . 24 7. References . . . . . . . . . . . . . . . . . . . . . . . . . . 26
7.1. Normative References . . . . . . . . . . . . . . . . . . . 24 7.1. Normative References . . . . . . . . . . . . . . . . . . . 26
7.2. Informative References . . . . . . . . . . . . . . . . . . 25 7.2. Informative References . . . . . . . . . . . . . . . . . . 26
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 25 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 26
Intellectual Property and Copyright Statements . . . . . . . . . . 26 Intellectual Property and Copyright Statements . . . . . . . . . . 27
1. The Internet-Standard Management Framework 1. The Internet-Standard Management Framework
For a detailed overview of the documents that describe the current For a detailed overview of the documents that describe the current
Internet-Standard Management Framework, please refer to section 7 of Internet-Standard Management Framework, please refer to section 7 of
RFC3410 [4]. RFC3410 [4].
Managed objects are accessed via a virtual information store, termed Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. MIB objects are generally the Management Information Base or MIB. MIB objects are generally
accessed through the Simple Network Management Protocol (SNMP). accessed through the Simple Network Management Protocol (SNMP).
skipping to change at page 4, line 30 skipping to change at page 4, line 30
most important ones ("core events") and additionally provides a most important ones ("core events") and additionally provides a
heartbeat notification as well as a test notification to allow heartbeat notification as well as a test notification to allow
management systems to test the reception of NTP related notifications management systems to test the reception of NTP related notifications
as well as enable heartbeat-based monitoring systems to assure that as well as enable heartbeat-based monitoring systems to assure that
the NTP entity is still up and running. the NTP entity is still up and running.
4. MIB Definition 4. MIB Definition
-- ********************************************************************* -- *********************************************************************
-- --
--$Id: draft-ietf-ntp-ntpv4-mib-04.xml 1.12 2007/11/28 00:00:00Z chelliot $
--$Name: SUBMIT_1 $ --$Name: SUBMIT_1 $
-- --
-- The Network Time Protocol Version 4 -- The Network Time Protocol Version 4
-- Management Information Base (MIB) -- Management Information Base (MIB)
-- --
-- Authors: Heiko Gerstung (heiko.gerstung@meinberg.de) -- Authors: Heiko Gerstung (heiko.gerstung@meinberg.de)
-- Chris Elliott (chelliot@cisco.com) -- Chris Elliott (chelliot@cisco.com)
-- --
-- for the Internet Engineering Task Force (IETF) -- for the Internet Engineering Task Force (IETF)
-- NTP Working Group (ntpwg) -- NTP Working Group (ntpwg)
-- --
-- --
-- ********************************************************************* -- *********************************************************************
-- --
-- $Log: draft-ietf-ntp-ntpv4-mib-04.xml $
-- Revision 1.13 2008/02/25 00:00:00Z chelliot
-- MIB:
-- - Added statistics table on a per-packet mode basis
-- (ntpEntStatPktModeTable)
-- Revision 1.12 2007/11/28 00:00:00Z chelliot -- Revision 1.12 2007/11/28 00:00:00Z chelliot
-- MIB: -- MIB:
-- - Added protocol statistics at the entity and association level -- - Added protocol statistics at the entity and association level
-- XML/RFC: -- XML/RFC:
-- - Changed a couple of instances of "instance" to "entity" and "srv" -- - Changed a couple of instances of "instance" to "entity" and "srv"
-- to "ent". -- to "ent".
-- - Changed Meinberg address and Heiko's phone number. -- - Changed Meinberg address and Heiko's phone number.
-- Revision 1.11 2007/07/23 00:00:00Z chelliot -- Revision 1.11 2007/07/23 00:00:00Z chelliot
-- MIB: -- MIB:
-- - Modified Contact Info -- - Modified Contact Info
-- - Added Stratum and NTP time TCs -- - Added Stratum and NTP time TCs
-- - Changed ntpEntNotifNotInSync to ntpEntNotifCurrentMode and -- - Changed ntpEntNotifNotInSync to ntpEntNotifCurrentMode and
-- deleted ntpEntNotifEntityStarted and ntpEntNotifEntityStopped -- deleted ntpEntNotifEntityStarted and ntpEntNotifEntityStopped
-- - Added compliance for SNTP entities -- - Added compliance for SNTP entities
-- - Changed ntpTime to ntpDateTime -- - Changed ntpTime to ntpDateTime
-- Revision 1.10 2007/07/09 00:00:00Z chelliot -- Revision 1.10 2007/07/09 00:00:00Z chelliot
skipping to change at page 6, line 33 skipping to change at page 6, line 37
-- Revision 1.2 2006/01/23 08:58:11Z heiko -- Revision 1.2 2006/01/23 08:58:11Z heiko
-- - changed the datatype of offset, jitter and delay objects from -- - changed the datatype of offset, jitter and delay objects from
-- Integer32 to REAL -- Integer32 to REAL
-- --
-- ********************************************************************* -- *********************************************************************
NTPv4-MIB DEFINITIONS ::= BEGIN NTPv4-MIB DEFINITIONS ::= BEGIN
IMPORTS IMPORTS
MODULE-IDENTITY, OBJECT-TYPE , mib-2, Integer32, NOTIFICATION-TYPE, MODULE-IDENTITY, OBJECT-TYPE , mib-2, Integer32, NOTIFICATION-TYPE,
Unsigned32 Unsigned32, Counter32
FROM SNMPv2-SMI FROM SNMPv2-SMI
MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
FROM SNMPv2-CONF FROM SNMPv2-CONF
DisplayString, TEXTUAL-CONVENTION DisplayString, TEXTUAL-CONVENTION
FROM SNMPv2-TC FROM SNMPv2-TC
InetAddressType, InetAddress InetAddressType, InetAddress
FROM INET-ADDRESS-MIB; FROM INET-ADDRESS-MIB;
ntpSnmpMIB MODULE-IDENTITY ntpSnmpMIB MODULE-IDENTITY
LAST-UPDATED "200712050000Z" -- December 5, 2007 LAST-UPDATED "200802250000Z" -- February 25, 2008
ORGANIZATION "The IETF NTP Working Group (ntpwg)" ORGANIZATION "The IETF NTP Working Group (ntpwg)"
CONTACT-INFO CONTACT-INFO
" WG Email: ntpwg@lists.ntp.isc.org " WG Email: ntpwg@lists.ntp.isc.org
Subscribe: Subscribe:
https://lists.ntp.isc.org/mailman/listinfo/ntpwg https://lists.ntp.isc.org/mailman/listinfo/ntpwg
Heiko Gerstung Heiko Gerstung
Meinberg Funkuhren Gmbh & Co. KG Meinberg Funkuhren Gmbh & Co. KG
Lange Wand 9 Lange Wand 9
Bad Pyrmont 31812 Bad Pyrmont 31812
Germany Germany
Phone: +49 5281 9309 25 Phone: +49 5281 9309 25
Email: heiko.gerstung@meinberg.de Email: heiko.gerstung@meinberg.de
skipping to change at page 7, line 21 skipping to change at page 7, line 26
Chris Elliott Chris Elliott
Cisco Systems, Inc. Cisco Systems, Inc.
7025 Kit Creek Rd., P.O. Box 14987 7025 Kit Creek Rd., P.O. Box 14987
Research Triangle Park 27709 Research Triangle Park 27709
USA USA
Phone: +1 919-392-2146 Phone: +1 919-392-2146
Email: chelliot@cisco.com" Email: chelliot@cisco.com"
DESCRIPTION DESCRIPTION
"The Management Information Base for NTP time entities." "The Management Information Base for NTP time entities."
REVISION "200712050000Z" REVISION "200802250000Z"
DESCRIPTION
"Added ntpEntStatPktModeTable"
REVISION "200711280000Z"
DESCRIPTION DESCRIPTION
"Multiple proposed changes for IETF 70" "Multiple proposed changes for IETF 70"
REVISION "200707230000Z" REVISION "200707230000Z"
DESCRIPTION DESCRIPTION
"Multiple proposed changes for IETF 69" "Multiple proposed changes for IETF 69"
REVISION "200707090000Z" REVISION "200707090000Z"
DESCRIPTION DESCRIPTION
"Multiple changes from IETF 68" "Multiple changes from IETF 68"
REVISION "200703040000Z" REVISION "200703040000Z"
DESCRIPTION DESCRIPTION
skipping to change at page 7, line 45 skipping to change at page 8, line 4
"Modifications from MIB review." "Modifications from MIB review."
REVISION "200606190000Z" REVISION "200606190000Z"
DESCRIPTION DESCRIPTION
"First Draft Version" "First Draft Version"
REVISION "200512190000Z" REVISION "200512190000Z"
DESCRIPTION DESCRIPTION
"revised edition (added traps and stuff)" "revised edition (added traps and stuff)"
REVISION "200511160000Z" REVISION "200511160000Z"
DESCRIPTION DESCRIPTION
"Initial draft" "Initial draft"
::= { mib-2 XXX } ::= { mib-2 XXXXX }
ntpSnmpMIBObjects OBJECT IDENTIFIER ::= { ntpSnmpMIB 1 } ntpSnmpMIBObjects OBJECT IDENTIFIER ::= { ntpSnmpMIB 1 }
-- MIB contains 6 groups -- MIB contains 6 groups
ntpEntInfo OBJECT IDENTIFIER ::= { ntpSnmpMIBObjects 1 } ntpEntInfo OBJECT IDENTIFIER ::= { ntpSnmpMIBObjects 1 }
ntpEntStatus OBJECT IDENTIFIER ::= { ntpSnmpMIBObjects 2 } ntpEntStatus OBJECT IDENTIFIER ::= { ntpSnmpMIBObjects 2 }
ntpAssociation OBJECT IDENTIFIER ::= { ntpSnmpMIBObjects 3 } ntpAssociation OBJECT IDENTIFIER ::= { ntpSnmpMIBObjects 3 }
ntpEntControl OBJECT IDENTIFIER ::= { ntpSnmpMIBObjects 4 } ntpEntControl OBJECT IDENTIFIER ::= { ntpSnmpMIBObjects 4 }
ntpEntNotifObjects OBJECT IDENTIFIER ::= { ntpSnmpMIBObjects 5 } ntpEntNotifObjects OBJECT IDENTIFIER ::= { ntpSnmpMIBObjects 5 }
skipping to change at page 15, line 30 skipping to change at page 15, line 37
ntpEntStatusNotifications OBJECT-TYPE ntpEntStatusNotifications OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The total number of SNMP notifications which this NTP "The total number of SNMP notifications which this NTP
entity has generated." entity has generated."
::= { ntpEntStatus 17 } ::= { ntpEntStatus 17 }
ntpEntStatPktModeTable OBJECT-TYPE
SYNTAX SEQUENCE OF NtpEntStatPktModeEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The number of packets sent and received by packet mode."
::= { ntpEntStatus 18 }
ntpEntStatPktModeEntry OBJECT-TYPE
SYNTAX NtpEntStatPktModeEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The number of packets sent and received by packet mode."
INDEX { ntpEntStatPktMode }
::= { ntpEntStatPktModeTable 1 }
NtpEntStatPktModeEntry ::= SEQUENCE {
ntpEntStatPktMode INTEGER,
ntpEntStatPktSent Counter32,
ntpEntStatPktReceived Counter32
}
ntpEntStatPktMode OBJECT-TYPE
SYNTAX INTEGER {
symetricactive(1),
symetricpassive(2),
client(3),
server(4),
broadcastserver(5),
broadcastclient(6)
}
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The NTP packet mode."
::= { ntpEntStatPktModeEntry 1 }
ntpEntStatPktSent OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of NTP packets sent with this packet mode."
::= { ntpEntStatPktModeEntry 2 }
ntpEntStatPktReceived OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of NTP packets received with this packet mode."
::= { ntpEntStatPktModeEntry 3 }
-- --
-- Section 3: The status of all currently mobilized associations -- Section 3: The status of all currently mobilized associations
-- --
ntpAssociationTable OBJECT-TYPE ntpAssociationTable OBJECT-TYPE
SYNTAX SEQUENCE OF NtpAssociationEntry SYNTAX SEQUENCE OF NtpAssociationEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The table of currently mobilized associations." "The table of currently mobilized associations."
skipping to change at page 18, line 36 skipping to change at page 19, line 49
ntpAssocStatProtocolError Counter32 ntpAssocStatProtocolError Counter32
} }
ntpAssocStatInPkts OBJECT-TYPE ntpAssocStatInPkts OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The total number of NTP messages delivered to the "The total number of NTP messages delivered to the
NTP entity from this association." NTP entity from this association."
::= { ntpAssocStatisticsEntry 1 } ::= { ntpAssociationStatisticsEntry 1 }
ntpAssocStatOutPkts OBJECT-TYPE ntpAssocStatOutPkts OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The total number of NTP messages delivered to the "The total number of NTP messages delivered to the
transport service by this NTP entity for this transport service by this NTP entity for this
association." association."
::= { ntpAssocStatisticsEntry 2 } ::= { ntpAssociationStatisticsEntry 2 }
ntpAssocStatProtocolError OBJECT-TYPE ntpAssocStatProtocolError OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The total number of NTP messages which were delivered "The total number of NTP messages which were delivered
to this NTP entity from this association and this entity to this NTP entity from this association and this entity
was not able to process due to an NTP protocol error." was not able to process due to an NTP protocol error."
::= { ntpAssocStatisticsEntry 3 } ::= { ntpAssociationStatisticsEntry 3 }
-- --
-- Section 4: Control objects -- Section 4: Control objects
-- --
ntpEntHeartbeatInterval OBJECT-TYPE ntpEntHeartbeatInterval OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
skipping to change at page 23, line 18 skipping to change at page 24, line 31
ntpEntStatusActiveOffset, ntpEntStatusActiveOffset,
ntpEntStatusNumberOfRefSources, ntpEntStatusNumberOfRefSources,
ntpEntStatusDispersion, ntpEntStatusDispersion,
ntpEntStatusLeapSecond, ntpEntStatusLeapSecond,
ntpEntStatusLeapSecDirection, ntpEntStatusLeapSecDirection,
ntpEntStatusInPkts, ntpEntStatusInPkts,
ntpEntStatusOutPkts, ntpEntStatusOutPkts,
ntpEntStatusBadVersion, ntpEntStatusBadVersion,
ntpEntStatusProtocolError, ntpEntStatusProtocolError,
ntpEntStatusNotifications, ntpEntStatusNotifications,
ntpEntStatPktSent,
ntpEntStatPktReceived,
ntpAssocOffset, ntpAssocOffset,
ntpAssocStratum, ntpAssocStratum,
ntpAssocStatusJitter, ntpAssocStatusJitter,
ntpAssocStatusDelay, ntpAssocStatusDelay,
ntpAssocStatusDispersion, ntpAssocStatusDispersion,
ntpAssocStatInPkts, ntpAssocStatInPkts,
ntpAssocStatOutPkts, ntpAssocStatOutPkts,
ntpAssocStatProtocolError, ntpAssocStatProtocolError,
ntpEntHeartbeatInterval, ntpEntHeartbeatInterval,
ntpEntNotifBits, ntpEntNotifBits,
skipping to change at page 26, line 7 skipping to change at page 27, line 7
Cisco Systems, Inc. Cisco Systems, Inc.
7025 Kit Creek Rd., P.O. Box 14987 7025 Kit Creek Rd., P.O. Box 14987
Research Triangle Park 27709 Research Triangle Park 27709
USA USA
Phone: +1 919-392-2146 Phone: +1 919-392-2146
Email: chelliot@cisco.com Email: chelliot@cisco.com
Full Copyright Statement Full Copyright Statement
Copyright (C) The IETF Trust (2007). Copyright (C) The IETF Trust (2008).
This document is subject to the rights, licenses and restrictions This document is subject to the rights, licenses and restrictions
contained in BCP 78, and except as set forth therein, the authors contained in BCP 78, and except as set forth therein, the authors
retain all their rights. retain all their rights.
This document and the information contained herein are provided on an This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND
THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
 End of changes. 21 change blocks. 
21 lines changed or deleted 87 lines changed or added

This html diff was produced by rfcdiff 1.34. The latest version is available from http://tools.ietf.org/tools/rfcdiff/