--- 1/draft-ietf-tictoc-1588v2-yang-02.txt 2016-12-05 06:13:13.736863173 -0800 +++ 2/draft-ietf-tictoc-1588v2-yang-03.txt 2016-12-05 06:13:13.784864397 -0800 @@ -1,20 +1,20 @@ Internet Working Group Y. Jiang, Ed. X. Liu Internet-Draft J. Xu Huawei Intended status: Standards Track R. Cummings, Ed. National Instruments -Expires: May 2017 November 25, 2016 +Expires: June 2017 December 5, 2016 YANG Data Model for IEEE 1588v2 - draft-ietf-tictoc-1588v2-yang-02 + draft-ietf-tictoc-1588v2-yang-03 Abstract This document defines a YANG data model for the configuration of IEEE 1588-2008 devices and clocks, and also retrieval of the configuration information, data set and running states of IEEE 1588-2008 clocks. Status of this Memo @@ -31,21 +31,21 @@ documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html - This Internet-Draft will expire on May 25, 2017. + This Internet-Draft will expire on June 5, 2017. Copyright Notice Copyright (c) 2016 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents @@ -63,21 +63,21 @@ 2. IEEE 1588-2008 YANG Model hierarchy ....................... 5 2.1. Interpretations from IEEE 1588 Working Group ........... 8 3. IEEE 1588-2008 YANG Module ................................ 9 4. Security Considerations .................................. 21 5. IANA Considerations ...................................... 22 6. References ............................................... 22 6.1. Normative References .................................. 22 6.2. Informative References ................................ 22 7. Acknowledgments .......................................... 23 Appendix A Transferring YANG Work to IEEE 1588 WG (Informational) - ................................................................. 23 + ............................................................... 23 A.1. Assumptions for the Transfer .......................... 24 A.2. Intellectual Property Considerations .................. 25 A.3. Namespace and Module Name ............................. 25 A.4. IEEE 1588 YANG Modules in ASCII Format ................ 26 1. Introduction As a synchronization protocol, IEEE 1588-2008 (also known as IEEE 1588v2) [IEEE1588] is widely supported in the carrier networks, industrial networks, automotive networks, and many other @@ -88,22 +88,22 @@ quality messages. The configuration parameters and state data sets of IEEE 1588-2008 are numerous. According to the concepts described in [RFC3444], IEEE 1588-2008 itself provides an information model in its normative specifications for the data sets (in IEEE 1588-2008 clause 8). Some standardization organizations including the IETF have specified data models in MIBs (Management Information Bases) for IEEE 1588- 2008 data sets (e.g. [PTP-MIB], [IEEE8021AS]). These MIBs are typically focused on retrieval of state data using the Simple - Network Management Protocol (SNMP), while configuration of PTP data - sets is not considered. + Network Management Protocol (SNMP), furthermore, configuration of + PTP data sets is not considered in [PTP-MIB]. Some service providers and applications require that the management of the IEEE 1588-2008 synchronization network be flexible and more Internet-based (typically overlaid on their transport networks). Software Defined Network (SDN) is another driving factor, which demands an improved configuration capability of synchronization networks. YANG [RFC6020] is a data modeling language used to model configuration and state data manipulated by network management @@ -328,21 +328,21 @@ The instance number has no usage within PTP messages. Based on statements in IEEE 1588-2008 subclauses 8.3.1. and 10.1, most transparent clock products have interpreted the transparent clock data sets to reside as a singleton at the root level of the managed product. Since 1588-2008 transparent clocks are domain independent, the instance concept is not applicable for domains. 3. IEEE 1588-2008 YANG Module - file "ietf-ptp-dataset@2016-11-25.yang" + file "ietf-ptp-dataset@2016-12-05.yang" module ietf-ptp-dataset{ namespace "urn:ietf:params:xml:ns:yang:ietf-ptp-dataset"; prefix "ptp-dataset"; organization "IETF TICTOC Working Group"; contact "WG Web: http://tools.ietf.org/wg/tictoc/ WG List: WG Chair: Karen O'Donoghue @@ -350,22 +350,22 @@ Editor: Yuanlong Jiang Editor: Rodney Cummings "; description "This YANG module defines a data model for the configuration of IEEE 1588-2008 clocks, and also for retrieval of the state data of IEEE 1588-2008 clocks."; - revision "2016-11-25" { - description "Version 2.0"; + revision "2016-12-05" { + description "Version 3.0"; reference "draft-ietf-tictoc-1588v2-yang"; } grouping default-ds-entry { description "Collection of members of the default data set."; leaf two-step-flag { type boolean; description @@ -691,27 +691,27 @@ description "The base-two logarithm of the mean SyncInterval for multicast messages. The rates for unicast transmissions are negotiated separately on a per port basis and are not constrained by this attribute."; } leaf delay-mechanism { type enumeration { enum E2E { - value 01; + value 1; description "The port uses the delay request-response mechanism."; } enum P2P { - value 02; + value 2; description "The port uses the peer delay mechanism."; } enum DISABLED { value 254; description "The port does not implement any delay mechanism."; } } @@ -982,21 +982,23 @@ [RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure Shell (SSH)", RFC 6242, June 2011 [RFC6536] Bierman, A. and M. Bjorklund, "Network Configuration Protocol (NETCONF) Access Control Model", RFC 6536, March 2012 7. Acknowledgments The authors would like to thank Joe Gwinn, Mahesh Jethanandani and - Tal Mizrahi for their valuable reviews and suggestions. + Tal Mizrahi for their valuable reviews and suggestions, and thank + Benoit Claise and Radek Krejci for their validation of the YANG + module. Appendix A Transferring YANG Work to IEEE 1588 WG (Informational) This appendix describes a future plan to transition responsibility for IEEE 1588 YANG modules from the IETF TICTOC Working Group (WG) to the IEEE 1588 WG, which develops the time synchronization technology that the YANG modules are designed to manage. This appendix is forward-looking with regard to future standardization roadmaps in IETF and IEEE. Since those roadmaps