draft-ietf-ccamp-mw-yang-07.txt   draft-ietf-ccamp-mw-yang-08.txt 
CCAMP Working Group J. Ahlberg CCAMP Working Group J. Ahlberg
Internet-Draft Ericsson AB Internet-Draft Ericsson AB
Intended status: Standards Track M. Ye Intended status: Standards Track M. Ye
Expires: January 1, 2019 Huawei Technologies Expires: February 9, 2019 Huawei Technologies
X. Li X. Li
NEC Laboratories Europe NEC Laboratories Europe
D. Spreafico D. Spreafico
Nokia - IT Nokia - IT
M. Vaupotic M. Vaupotic
Aviat Networks Aviat Networks
June 30, 2018 August 8, 2018
A YANG Data Model for Microwave Radio Link A YANG Data Model for Microwave Radio Link
draft-ietf-ccamp-mw-yang-07 draft-ietf-ccamp-mw-yang-08
Abstract Abstract
This document defines a YANG data model for control and management of This document defines a YANG data model for control and management of
the radio link interfaces, and their connectivity to packet the radio link interfaces, and their connectivity to packet
(typically Ethernet) interfaces in a microwave/millimeter wave node. (typically Ethernet) interfaces in a microwave/millimeter wave node.
The data nodes for management of the interface protection The data nodes for management of the interface protection
functionality is broken out into a separate and generic YANG data functionality is broken out into a separate and generic YANG data
model in order to make it available also for other interface types. model in order to make it available also for other interface types.
skipping to change at page 1, line 47 skipping to change at page 1, line 47
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at https://datatracker.ietf.org/drafts/current/. Drafts is at https://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
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."
This Internet-Draft will expire on January 1, 2019. This Internet-Draft will expire on February 9, 2019.
Copyright Notice Copyright Notice
Copyright (c) 2018 IETF Trust and the persons identified as the Copyright (c) 2018 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(https://trustee.ietf.org/license-info) in effect on the date of (https://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents publication of this document. Please review these documents
skipping to change at page 2, line 37 skipping to change at page 2, line 37
3.1. YANG Tree . . . . . . . . . . . . . . . . . . . . . . . . 4 3.1. YANG Tree . . . . . . . . . . . . . . . . . . . . . . . . 4
3.2. Explanation of the Microwave Data Model . . . . . . . . . 7 3.2. Explanation of the Microwave Data Model . . . . . . . . . 7
4. Microwave Radio Link YANG Module . . . . . . . . . . . . . . 7 4. Microwave Radio Link YANG Module . . . . . . . . . . . . . . 7
5. Interface Protection YANG Module . . . . . . . . . . . . . . 26 5. Interface Protection YANG Module . . . . . . . . . . . . . . 26
6. Microwave Types YANG Module . . . . . . . . . . . . . . . . . 32 6. Microwave Types YANG Module . . . . . . . . . . . . . . . . . 32
7. Security Considerations . . . . . . . . . . . . . . . . . . . 39 7. Security Considerations . . . . . . . . . . . . . . . . . . . 39
8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 41 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 41
9. References . . . . . . . . . . . . . . . . . . . . . . . . . 42 9. References . . . . . . . . . . . . . . . . . . . . . . . . . 42
9.1. Normative References . . . . . . . . . . . . . . . . . . 42 9.1. Normative References . . . . . . . . . . . . . . . . . . 42
9.2. Informative References . . . . . . . . . . . . . . . . . 44 9.2. Informative References . . . . . . . . . . . . . . . . . 44
Appendix A. Example: 1+0 and 2+0 configuration instances . . . . 44 Appendix A. Example: 1+0 and 2+0 configuration instances . . . . 45
Appendix B. Contributors . . . . . . . . . . . . . . . . . . . . 49 Appendix B. Contributors . . . . . . . . . . . . . . . . . . . . 50
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 50 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 50
1. Introduction 1. Introduction
This document defines a YANG data model for management and control of This document defines a YANG data model for management and control of
the radio link interface(s) and the relationship to packet (typically the radio link interface(s) and the relationship to packet (typically
Ethernet) and/or TDM interfaces in a microwave/millimeter wave node. Ethernet) and/or TDM interfaces in a microwave/millimeter wave node.
ETSI EN 302 217 series defines the characteristics and requirements ETSI EN 302 217 series defines the characteristics and requirements
of microwave/millimeter wave equipment and antennas. Especially ETSI of microwave/millimeter wave equipment and antennas. Especially ETSI
EN 302 217-2 [EN302217-2] specifies the essential parameters for the EN 302 217-2 [EN302217-2] specifies the essential parameters for the
skipping to change at page 5, line 33 skipping to change at page 5, line 33
+--rw mode identityref +--rw mode identityref
+--rw carrier-terminations* if:interface-ref +--rw carrier-terminations* if:interface-ref
+--rw rlp-groups* +--rw rlp-groups*
| -> /radio-link-protection-groups/protection-group/name | -> /radio-link-protection-groups/protection-group/name
+--rw xpic-pairs* -> /xpic-pairs/xpic-pair/name +--rw xpic-pairs* -> /xpic-pairs/xpic-pair/name
| {xpic}? | {xpic}?
+--rw mimo-groups* -> /mimo-groups/mimo-group/name +--rw mimo-groups* -> /mimo-groups/mimo-group/name
| {mimo}? | {mimo}?
+--rw tdm-connections* [tdm-type] {tdm}? +--rw tdm-connections* [tdm-type] {tdm}?
+--rw tdm-type identityref +--rw tdm-type identityref
+--rw tdm-connections uint16 +--rw tdm-connections uint16
augment /if:interfaces/if:interface: augment /if:interfaces/if:interface:
+--rw carrier-id? string +--rw carrier-id? string
+--rw tx-enabled? boolean +--rw tx-enabled? boolean
+--ro tx-oper-status? enumeration +--ro tx-oper-status? enumeration
+--rw tx-frequency uint32 +--rw tx-frequency uint32
+--rw (freq-or-distance) +--rw (freq-or-distance)
| +--:(rx-frequency) | +--:(rx-frequency)
| | +--rw rx-frequency? uint32 | | +--rw rx-frequency? uint32
| +--:(duplex-distance) | +--:(duplex-distance)
| +--rw duplex-distance? int32 | +--rw duplex-distance? int32
+--ro actual-rx-frequency? uint32 +--ro actual-rx-frequency? uint32
+--ro actual-duplex-distance? uint32 +--ro actual-duplex-distance? uint32
+--rw channel-separation uint32 +--rw channel-separation uint32
+--rw polarization? enumeration +--rw polarization? enumeration
+--rw (power-mode) +--rw (power-mode)
| +--:(rtpc) | +--:(rtpc)
| | +--rw rtpc | | +--rw rtpc
| | +--rw maximum-nominal-power power | | +--rw maximum-nominal-power power
| +--:(atpc) | +--:(atpc)
| +--rw atpc | +--rw atpc
| +--rw maximum-nominal-power power | +--rw maximum-nominal-power power
| +--rw atpc-lower-threshold power | +--rw atpc-lower-threshold power
| +--rw atpc-upper-threshold power | +--rw atpc-upper-threshold power
+--ro actual-transmitted-level? power +--ro actual-transmitted-level? power
+--ro actual-received-level? power +--ro actual-received-level? power
+--rw (coding-modulation-mode) +--rw (coding-modulation-mode)
| +--:(single) | +--:(single)
| | +--rw single | | +--rw single
| | +--rw selected-cm identityref | | +--rw selected-cm identityref
| +--:(adaptive) | +--:(adaptive)
| +--rw adaptive | +--rw adaptive
| +--rw selected-min-acm identityref | +--rw selected-min-acm identityref
| +--rw selected-max-acm identityref | +--rw selected-max-acm identityref
+--ro actual-tx-cm? identityref +--ro actual-tx-cm? identityref
+--ro actual-snir? decimal64 +--ro actual-snir? decimal64
+--ro actual-xpi? decimal64 {xpic}? +--ro actual-xpi? decimal64 {xpic}?
+--rw ct-performance-thresholds +--rw ct-performance-thresholds
| +--rw received-level-alarm-threshold? power | +--rw received-level-alarm-threshold? power
| +--rw transmitted-level-alarm-threshold? power | +--rw transmitted-level-alarm-threshold? power
| +--rw ber-alarm-threshold? enumeration | +--rw ber-alarm-threshold? enumeration
+--rw if-loop? enumeration +--rw if-loop? enumeration
+--rw rf-loop? enumeration +--rw rf-loop? enumeration
+--ro capabilities +--ro capabilities
skipping to change at page 41, line 44 skipping to change at page 42, line 13
Registry" [RFC3688] as follows: Registry" [RFC3688] as follows:
URI: urn:ietf:params:xml:ns:yang:ietf-microwave-radio-link URI: urn:ietf:params:xml:ns:yang:ietf-microwave-radio-link
Registrant Contact: The IESG Registrant Contact: The IESG
XML: N/A; the requested URI is an XML namespace. XML: N/A; the requested URI is an XML namespace.
URI: urn:ietf:params:xml:ns:yang:ietf-interface-protection URI: urn:ietf:params:xml:ns:yang:ietf-interface-protection
Registrant Contact: The IESG Registrant Contact: The IESG
XML: N/A; the requested URI is an XML namespace. XML: N/A; the requested URI is an XML namespace.
URI: urn:ietf:params:xml:ns:yang:ietf-microwave-types
Registrant Contact: The IESG
XML: N/A; the requested URI is an XML namespace.
It is proposed that IANA should record YANG module names in the "YANG It is proposed that IANA should record YANG module names in the "YANG
Module Names" registry [RFC6020] as follows: Module Names" registry [RFC6020] as follows:
Name: ietf-microwave-radio-link Name: ietf-microwave-radio-link
Namespace: urn:ietf:params:xml:ns:yang:ietf-microwave-radio-link Namespace: urn:ietf:params:xml:ns:yang:ietf-microwave-radio-link
Prefix: mrl Prefix: mrl
Reference: RFC XXXX Reference: RFC XXXX
Name: ietf-interface-protection Name: ietf-interface-protection
Namespace: urn:ietf:params:xml:ns:yang:ietf-interface-protection Namespace: urn:ietf:params:xml:ns:yang:ietf-interface-protection
Prefix: ifprot Prefix: ifprot
Reference: RFC XXXX Reference: RFC XXXX
Name: ietf-microwave-types
Namespace: urn:ietf:params:xml:ns:yang:ietf-microwave-types
Prefix: mw-types
Reference: RFC XXXX
9. References 9. References
9.1. Normative References 9.1. Normative References
[EN301129]
"Transmission and Multiplexing (TM); Digital Radio Relay
Systems (DRRS); Synchronous Digital Hierarchy (SDH);
System performance monitoring parameters of SDH DRRS", EN
301 129 V1.1.2 , May 1995.
[EN302217-1]
"Fixed Radio Systems; Characteristics and requirements for
point-to-point equipment and antennas; Part 1: Overview,
common characteristics and system-dependent requirements",
EN 302 217-1 V3.0.5 , June 2016.
[EN302217-2]
"Fixed Radio Systems; Characteristics and requirements for
point to-point equipment and antennas; Part 2: Digital
systems operating in frequency bands from 1 GHz to 86 GHz;
Harmonised Standard covering the essential requirements of
article 3.2 of Directive 2014/53/EU", EN 302 217-2
V3.1.1 , May 2017.
[G.808.1] "SERIES G: TRANSMISSION SYSTEMS AND MEDIA, DIGITAL SYSTEMS
AND NETWORKS; Digital networks ; General aspects Generic
protection switching ; Linear trail and subnetwork
protection", ITU-T Rec. G.808.1 , May 2014.
[G.826] "SERIES G: TRANSMISSION SYSTEMS AND MEDIA, DIGITAL SYSTEMS
AND NETWORKS; Digital networks ; Quality and availability
targets End-to-end error performance parameters and
objectives for international, constant bit-rate digital
paths and connections", ITU-T Rec. G.826 , December 2002.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, Requirement Levels", BCP 14, RFC 2119,
DOI 10.17487/RFC2119, March 1997, DOI 10.17487/RFC2119, March 1997,
<https://www.rfc-editor.org/info/rfc2119>. <https://www.rfc-editor.org/info/rfc2119>.
[RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688,
DOI 10.17487/RFC3688, January 2004, DOI 10.17487/RFC3688, January 2004,
<https://www.rfc-editor.org/info/rfc3688>. <https://www.rfc-editor.org/info/rfc3688>.
[RFC5246] Dierks, T. and E. Rescorla, "The Transport Layer Security [RFC5246] Dierks, T. and E. Rescorla, "The Transport Layer Security
skipping to change at page 44, line 9 skipping to change at page 44, line 5
[RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration [RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration
Access Control Model", STD 91, RFC 8341, Access Control Model", STD 91, RFC 8341,
DOI 10.17487/RFC8341, March 2018, DOI 10.17487/RFC8341, March 2018,
<https://www.rfc-editor.org/info/rfc8341>. <https://www.rfc-editor.org/info/rfc8341>.
[RFC8343] Bjorklund, M., "A YANG Data Model for Interface [RFC8343] Bjorklund, M., "A YANG Data Model for Interface
Management", RFC 8343, DOI 10.17487/RFC8343, March 2018, Management", RFC 8343, DOI 10.17487/RFC8343, March 2018,
<https://www.rfc-editor.org/info/rfc8343>. <https://www.rfc-editor.org/info/rfc8343>.
[TR102311]
"Fixed Radio Systems; Point-to-point equipment; Specific
aspects of the spatial frequency reuse method", ETSI TR
102 311 V1.2.1 , November 2015.
9.2. Informative References 9.2. Informative References
[EN301129]
"Transmission and Multiplexing (TM); Digital Radio Relay
Systems (DRRS); Synchronous Digital Hierarchy (SDH);
System performance monitoring parameters of SDH DRRS", EN
301 129 V1.1.2 , May 1995.
[EN302217-1]
"Fixed Radio Systems; Characteristics and requirements for
point-to-point equipment and antennas; Part 1: Overview,
common characteristics and system-dependent requirements",
EN 302 217-1 V3.0.5 , June 2016.
[EN302217-2]
"Fixed Radio Systems; Characteristics and requirements for
point to-point equipment and antennas; Part 2: Digital
systems operating in frequency bands from 1 GHz to 86 GHz;
Harmonised Standard covering the essential requirements of
article 3.2 of Directive 2014/53/EU", EN 302 217-2
V3.1.1 , May 2017.
[G.808.1] "SERIES G: TRANSMISSION SYSTEMS AND MEDIA, DIGITAL SYSTEMS
AND NETWORKS; Digital networks ; General aspects Generic
protection switching ; Linear trail and subnetwork
protection", ITU-T Rec. G.808.1 , May 2014.
[G.826] "SERIES G: TRANSMISSION SYSTEMS AND MEDIA, DIGITAL SYSTEMS
AND NETWORKS; Digital networks ; Quality and availability
targets End-to-end error performance parameters and
objectives for international, constant bit-rate digital
paths and connections", ITU-T Rec. G.826 , December 2002.
[I-D.ahlberg-ccamp-microwave-radio-link] [I-D.ahlberg-ccamp-microwave-radio-link]
Ahlberg, J., Carlson, J., Lund, H., Olausson, T., Ye, M., Ahlberg, J., Carlson, J., Lund, H., Olausson, T., Ye, M.,
and M. Vaupotic, "Microwave Radio Link YANG Data Models", and M. Vaupotic, "Microwave Radio Link YANG Data Models",
draft-ahlberg-ccamp-microwave-radio-link-01 (work in draft-ahlberg-ccamp-microwave-radio-link-01 (work in
progress), May 2016. progress), May 2016.
[I-D.ietf-ccamp-microwave-framework] [I-D.ietf-ccamp-microwave-framework]
Ahlberg, J., Ye, M., Li, X., Contreras, L., and C. Ahlberg, J., Ye, M., Li, X., Contreras, L., and C.
Bernardos, "A framework for Management and Control of Bernardos, "A framework for Management and Control of
microwave and millimeter wave interface parameters", microwave and millimeter wave interface parameters",
skipping to change at page 44, line 45 skipping to change at page 45, line 21
[RFC8340] Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams", [RFC8340] Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams",
BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018, BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018,
<https://www.rfc-editor.org/info/rfc8340>. <https://www.rfc-editor.org/info/rfc8340>.
[RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K., [RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K.,
and R. Wilton, "Network Management Datastore Architecture and R. Wilton, "Network Management Datastore Architecture
(NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018, (NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018,
<https://www.rfc-editor.org/info/rfc8342>. <https://www.rfc-editor.org/info/rfc8342>.
[TR102311]
"Fixed Radio Systems; Point-to-point equipment; Specific
aspects of the spatial frequency reuse method", ETSI TR
102 311 V1.2.1 , November 2015.
Appendix A. Example: 1+0 and 2+0 configuration instances Appendix A. Example: 1+0 and 2+0 configuration instances
This section gives simple examples of 1+0 and 2+0 instance using the This section gives simple examples of 1+0 and 2+0 instance using the
YANG module defined in this draft. The examples are not intended as YANG module defined in this draft. The examples are not intended as
a complete module for 1+0 and 2+0 configuration. a complete module for 1+0 and 2+0 configuration.
A.1 1+0 instance A.1 1+0 instance
Figure A-1 shows a 1+0 example. Figure A-1 shows a 1+0 example.
/--------- Radio Link ---------\ /--------- Radio Link ---------\
Near End Far End Near End Far End
+---------------+ +---------------+ +---------------+ +---------------+
| Radio Link | | Radio Link | | Radio Link | | Radio Link |
| Terminal - A | | Terminal - B | | Terminal - A | | Terminal - B |
| | | | | | | |
| | | | | | | |
 End of changes. 17 change blocks. 
48 lines changed or deleted 58 lines changed or added

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