Internet DRAFT - draft-ietf-ccamp-mw-yang
draft-ietf-ccamp-mw-yang
CCAMP Working Group J. Ahlberg
Internet-Draft Ericsson AB
Intended status: Standards Track M. Ye
Expires: June 1, 2019 Huawei Technologies
X. Li
NEC Laboratories Europe
D. Spreafico
Nokia - IT
M. Vaupotic
Aviat Networks
November 28, 2018
A YANG Data Model for Microwave Radio Link
draft-ietf-ccamp-mw-yang-13
Abstract
This document defines a YANG data model for control and management of
the radio link interfaces, and their connectivity to packet
(typically Ethernet) interfaces in a microwave/millimeter wave node.
The data nodes for management of the interface protection
functionality is broken out into a separate and generic YANG data
model in order to make it available also for other interface types.
RFC Ed. Note
// RFC Ed.: replace all XXXX throughout the document with actual RFC
numbers and remove this note
Status of This Memo
This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet-
Drafts is at https://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
This Internet-Draft will expire on June 1, 2019.
Ahlberg, et al. Expires June 1, 2019 [Page 1]
Internet-Draft Microwave YANG Model November 2018
Copyright Notice
Copyright (c) 2018 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
(https://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License.
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1. Terminology and Definitions . . . . . . . . . . . . . . . 3
1.2. Tree Structure . . . . . . . . . . . . . . . . . . . . . 4
2. Requirements Language . . . . . . . . . . . . . . . . . . . . 4
3. Microwave Radio Link YANG Data Model . . . . . . . . . . . . 5
3.1. YANG Tree . . . . . . . . . . . . . . . . . . . . . . . . 5
3.2. Explanation of the Microwave Data Model . . . . . . . . . 7
4. Microwave Radio Link YANG Module . . . . . . . . . . . . . . 7
5. Interface Protection YANG Module . . . . . . . . . . . . . . 27
6. Microwave Types YANG Module . . . . . . . . . . . . . . . . . 33
7. Security Considerations . . . . . . . . . . . . . . . . . . . 40
8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 42
9. References . . . . . . . . . . . . . . . . . . . . . . . . . 43
9.1. Normative References . . . . . . . . . . . . . . . . . . 43
9.2. Informative References . . . . . . . . . . . . . . . . . 44
Appendix A. Example: 1+0 and 2+0 configuration instances . . . . 45
A.1. 1+0 instance . . . . . . . . . . . . . . . . . . . . . . 46
A.2. 2+0 instance . . . . . . . . . . . . . . . . . . . . . . 47
A.3. 2+0 XPIC instance . . . . . . . . . . . . . . . . . . . . 49
Appendix B. Contributors . . . . . . . . . . . . . . . . . . . . 50
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 51
1. Introduction
This document defines a YANG data model for management and control of
the radio link interface(s) and the relationship to packet (typically
Ethernet) and/or TDM interfaces in a microwave/millimeter wave node.
ETSI EN 302 217 series defines the characteristics and requirements
of microwave/millimeter wave equipment and antennas. Especially ETSI
EN 302 217-2 [EN302217-2] specifies the essential parameters for the
systems operating from 1.4GHz to 86GHz. The data model includes
Ahlberg, et al. Expires June 1, 2019 [Page 2]
Internet-Draft Microwave YANG Model November 2018
configuration and state data according to the new Network Management
Datastore Architecture [RFC8342].
The design of the data model follows the framework for management and
control of microwave and millimeter wave interface parameters defined
in [RFC8432]. This framework identifies the need and the scope of
the YANG data model, the use cases and requirements that the model
needs to support. Moreover, it provides a detailed gap analysis to
identify the missing parameters and functionalities of the existing
and established models to support the specified use cases and
requirements, and based on that recommends how the gaps should be
filled with the development of the new model. According to the
conclusion of the gap analysis, the structure of the data model is
based on the structure defined in
[I-D.ahlberg-ccamp-microwave-radio-link] and it augments [RFC8343] to
align with the same structure for management of the packet
interfaces. More specifically, the model will include interface
layering to manage the capacity provided by a radio link terminal for
the associated Ethernet and TDM interfaces, using the principles for
interface layering described in [RFC8343] as a basis.
The data nodes for management of the interface protection
functionality is broken out into a separate and generic YANG data
module in order to make it available also for other interface types.
The designed YANG data model uses established microwave equipment and
radio standards, such as ETSI EN 302 217-2, and the IETF: Radio Link
Model [I-D.ahlberg-ccamp-microwave-radio-link] and the ONF: Microwave
Modeling [ONF-model] as the basis for the definition of the detailed
leafs/parameters, and proposes new ones to cover identified gaps
which are analyzed in [RFC8432].
1.1. Terminology and Definitions
The following terms are used in this document:
Carrier Termination (CT) is an interface for the capacity provided
over the air by a single carrier. It is typically defined by its
transmitting and receiving frequencies.
Radio Link Terminal (RLT) is an interface providing packet capacity
and/or TDM capacity to the associated Ethernet and/or TDM interfaces
in a node and used for setting up a transport service over a
microwave/millimeter wave link.
The following acronyms are used in this document:
ACM Adaptive Coding Modulation
Ahlberg, et al. Expires June 1, 2019 [Page 3]
Internet-Draft Microwave YANG Model November 2018
ATPC Automatic Transmit Power Control
BBE Background Block Errors
BER Bit Error Ratio
BPSK Binary Phase-Shift Keying
CM Coding Modulation
CT Carrier Termination
ES Errored Seconds
IF Intermediate Frequency
MIMO Multiple-Input Multiple-Output
RF Radio Frequency
RLT Radio Link Terminal
QAM Quadrature Amplitude Modulation
QPSK Quadrature Phase-Shift Keying
RTPC Remote Transmit Power Control
SES Severely Errored Seconds
TDM Time-Division Multiplexing
UAS Unavailable Seconds
XPIC Cross Polarization Interference Cancellation
1.2. Tree Structure
A simplified graphical representation of the data model is used in
chapter 3.1 of this this document. The meaning of the symbols in
these diagrams is defined in [RFC8340].
2. Requirements Language
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
"OPTIONAL" in this document are to be interpreted as described in BCP
Ahlberg, et al. Expires June 1, 2019 [Page 4]
Internet-Draft Microwave YANG Model November 2018
14 [RFC2119] [RFC8174] when, and only when, they appear in all
capitals, as shown here.
3. Microwave Radio Link YANG Data Model
3.1. YANG Tree
module: ietf-microwave-radio-link
+--rw radio-link-protection-groups
| +--rw protection-group* [name]
| +--rw name string
| +--rw protection-architecture-type? identityref
| +--rw members* if:interface-ref
| +--rw operation-type? enumeration
| +--rw working-entity* if:interface-ref
| +--rw revertive-wait-to-restore? uint16
| +--rw hold-off-timer? uint16
| +--ro status? identityref
| +---x manual-switch-working
| +---x manual-switch-protection
| +---x forced-switch
| +---x lockout-of-protection
| +---x freeze
| +---x exercise
| +---x clear
+--rw xpic-pairs {xpic}?
| +--rw xpic-pair* [name]
| +--rw name string
| +--rw enabled? boolean
| +--rw members* if:interface-ref
+--rw mimo-groups {mimo}?
+--rw mimo-group* [name]
+--rw name string
+--rw enabled? boolean
+--rw members* if:interface-ref
augment /if:interfaces/if:interface:
+--rw id? string
+--rw mode identityref
+--rw carrier-terminations* if:interface-ref
+--rw rlp-groups*
| -> /radio-link-protection-groups/protection-group/name
+--rw xpic-pairs* -> /xpic-pairs/xpic-pair/name
| {xpic}?
+--rw mimo-groups* -> /mimo-groups/mimo-group/name
| {mimo}?
+--rw tdm-connections* [tdm-type] {tdm}?
+--rw tdm-type identityref
Ahlberg, et al. Expires June 1, 2019 [Page 5]
Internet-Draft Microwave YANG Model November 2018
+--rw tdm-connections uint16
augment /if:interfaces/if:interface:
+--rw carrier-id? string
+--rw tx-enabled? boolean
+--ro tx-oper-status? enumeration
+--rw tx-frequency uint32
+--rw (freq-or-distance)
| +--:(rx-frequency)
| | +--rw rx-frequency? uint32
| +--:(duplex-distance)
| +--rw duplex-distance? int32
+--ro actual-rx-frequency? uint32
+--ro actual-duplex-distance? uint32
+--rw channel-separation uint32
+--rw polarization? enumeration
+--rw (power-mode)
| +--:(rtpc)
| | +--rw rtpc
| | +--rw maximum-nominal-power power
| +--:(atpc)
| +--rw atpc
| +--rw maximum-nominal-power power
| +--rw atpc-lower-threshold power
| +--rw atpc-upper-threshold power
+--ro actual-transmitted-level? power
+--ro actual-received-level? power
+--rw (coding-modulation-mode)
| +--:(single)
| | +--rw single
| | +--rw selected-cm identityref
| +--:(adaptive)
| +--rw adaptive
| +--rw selected-min-acm identityref
| +--rw selected-max-acm identityref
+--ro actual-tx-cm? identityref
+--ro actual-snir? decimal64
+--ro actual-xpi? decimal64 {xpic}?
+--rw ct-performance-thresholds
| +--rw received-level-alarm-threshold? power
| +--rw transmitted-level-alarm-threshold? power
| +--rw ber-alarm-threshold? enumeration
+--rw if-loop? enumeration
+--rw rf-loop? enumeration
+--ro capabilities
| +--ro min-tx-frequency? uint32
| +--ro max-tx-frequency? uint32
| +--ro min-rx-frequency? uint32
| +--ro max-rx-frequency? uint32
Ahlberg, et al. Expires June 1, 2019 [Page 6]
Internet-Draft Microwave YANG Model November 2018
| +--ro minimum-power? power
| +--ro maximum-available-power? power
| +--ro available-min-acm? identityref
| +--ro available-max-acm? identityref
+--ro error-performance-statistics
| +--ro bbe? yang:counter32
| +--ro es? yang:counter32
| +--ro ses? yang:counter32
| +--ro uas? yang:counter32
+--ro radio-performance-statistics
+--ro min-rltm? power
+--ro max-rltm? power
+--ro min-tltm? power
+--ro max-tltm? power
3.2. Explanation of the Microwave Data Model
The leafs in the Interface Management Module augmented by Radio Link
Terminal (RLT) and Carrier Termination (CT) are not always
applicable.
"/interfaces/interface/enabled" is not applicable for RLT. Enable
and disable of an interface is done in the constituent CTs.
The packet related measurements "in-octets", "in-unicast-pkts", "in-
broadcast-pkts", "in-multicast-pkts", "in-discards", "in-errors",
"in-unknown-protos", "out-octets", "out-unicast-pkts", "out-
broadcast-pkts", "out-multicast-pkts", "out-discards", "out-errors"
are not within the scope of the microwave radio link domain and
therefore not applicable for RLT and CT.
4. Microwave Radio Link YANG Module
This module imports typedefs and modules from [RFC6991], [RFC8343]
and [RFC7224], and it references [TR102311], [EN302217-1],
[EN301129], and [G.826].
<CODE BEGINS> file "ietf-microwave-radio-link@2018-11-28.yang"
module ietf-microwave-radio-link {
yang-version 1.1;
namespace "urn:ietf:params:xml:ns:yang:ietf-microwave-radio-link";
prefix mrl;
import ietf-yang-types {
prefix yang;
Ahlberg, et al. Expires June 1, 2019 [Page 7]
Internet-Draft Microwave YANG Model November 2018
reference "RFC 6991";
}
import iana-if-type {
prefix ianaift;
}
import ietf-interfaces {
prefix if;
reference "RFC 8343";
}
import ietf-interface-protection {
prefix ifprot;
reference "RFC XXXX";
}
import ietf-microwave-types {
prefix mw-types;
reference "RFC XXXX";
}
organization
"Internet Engineering Task Force (IETF) CCAMP WG";
contact
"WG List: <mailto:ccamp@ietf.org>
ID-draft editors:
// RFC Ed.: replace ID-draft editors with Editors and remove
// this note
Jonas Ahlberg (jonas.ahlberg@ericsson.com);
Min Ye (amy.yemin@huawei.com);
Xi Li (Xi.Li@neclab.eu);
Daniela Spreafico (daniela.spreafico@nokia.com)
Marko Vaupotic (Marko.Vaupotic@aviatnet.com)";
description
"This is a module for the entities in
a generic microwave system.
Copyright (c) 2018 IETF Trust and the persons identified as
authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or
without modification, is permitted pursuant to, and subject
to the license terms contained in, the Simplified BSD License
set forth in Section 4.c of the IETF Trust's Legal Provisions
Relating to IETF Documents
Ahlberg, et al. Expires June 1, 2019 [Page 8]
Internet-Draft Microwave YANG Model November 2018
(http://trustee.ietf.org/license-info).
This version of this YANG module is part of RFC XXXX; see
the RFC itself for full legal notices.
Copyright (c) 2018 IETF Trust and the persons identified as
authors of the code. All rights reserved.";
revision 2018-11-28 {
description "Initial revision.";
reference "RFC XXXX: A YANG Data Model for Microwave Radio Link";
}
/*
* Features
*/
feature xpic {
description
"Indicates that the device supports XPIC.";
reference "ETSI TR 102 311";
}
feature mimo {
description
"Indicates that the device supports MIMO.";
reference "ETSI TR 102 311";
}
feature tdm {
description
"Indicates that the device supports TDM.";
}
/*
* Typedefs
*/
typedef power {
type decimal64 {
fraction-digits 1;
}
description
"Type used for power values, selected and measured.";
}
/*
* Radio Link Terminal (RLT)
Ahlberg, et al. Expires June 1, 2019 [Page 9]
Internet-Draft Microwave YANG Model November 2018
*/
augment "/if:interfaces/if:interface" {
when "derived-from-or-self(if:type,"
+ "'ianaift:radio-link-terminal')";
description
"Addition of data nodes for radio link terminal to
the standard Interface data model, for interfaces of
the type 'radio-link-terminal'.";
leaf id {
type string;
description
"Descriptive identity of the radio link terminal used by
far-end RLT to check that it's connected to the correct
near-end RLT. Does not need to be configured if this check
is not used.";
}
leaf mode {
type identityref {
base mw-types:rlt-mode;
}
mandatory true;
description
"A description of the mode in which the radio link
terminal is configured. The format is X plus Y.
X represent the number of bonded carrier terminations.
Y represent the number of protecting carrier
terminations.";
}
leaf-list carrier-terminations {
type if:interface-ref;
must "derived-from-or-self(/if:interfaces/if:interface"
+ "[if:name = current()]"
+ "/if:type, 'ianaift:carrier-termination')" {
description
"The type of interface must be
'carrier-termination'.";
}
min-elements 1;
description
"A list of references to carrier terminations
included in the radio link terminal.";
}
leaf-list rlp-groups {
Ahlberg, et al. Expires June 1, 2019 [Page 10]
Internet-Draft Microwave YANG Model November 2018
type leafref {
path "/mrl:radio-link-protection-groups/"
+ "mrl:protection-group/mrl:name";
}
description
"A list of references to the carrier termination
groups configured for radio link protection in this
radio link terminal.";
}
leaf-list xpic-pairs {
if-feature xpic;
type leafref {
path "/mrl:xpic-pairs/mrl:xpic-pair/mrl:name";
}
description
"A list of references to the XPIC pairs used in this
radio link terminal. One pair can be used by two
terminals.";
reference "ETSI TR 102 311";
}
leaf-list mimo-groups {
if-feature mimo;
type leafref {
path "/mrl:mimo-groups/mrl:mimo-group/mrl:name";
}
description
"A reference to the MIMO group used in this
radio link terminal. One group can be used by more
than one terminal.";
reference "ETSI TR 102 311";
}
list tdm-connections {
if-feature tdm;
key "tdm-type";
description
"A list stating the number of active TDM connections
of a specified tdm-type that is configured to be
supported by the RLT.";
leaf tdm-type {
type identityref {
base mw-types:tdm-type;
}
description
"The type of TDM connection, which also indicates
Ahlberg, et al. Expires June 1, 2019 [Page 11]
Internet-Draft Microwave YANG Model November 2018
the supported capacity.";
}
leaf tdm-connections {
type uint16;
mandatory true;
description
"Number of connections of the specified type.";
}
}
}
/*
* Carrier Termination
*/
augment "/if:interfaces/if:interface" {
when "derived-from-or-self(if:type,"
+ "'ianaift:carrier-termination')";
description
"Addition of data nodes for carrier termination to
the standard Interface data model, for interfaces
of the type 'carrier-termination'.";
leaf carrier-id {
type string;
default "A";
description
"ID of the carrier. (e.g. A, B, C or D)
Used in XPIC & MIMO configurations to check that
the carrier termination is connected to the correct
far-end carrier termination. Should be the same
carrier ID on both sides of the hop.
Left as default value when MIMO and XPIC are not in use.";
}
leaf tx-enabled {
type boolean;
default "false";
description
"Disables (false) or enables (true) the transmitter.
Only applicable when the interface is enabled
(interface:enabled = true) otherwise it's always
disabled.";
}
leaf tx-oper-status {
type enumeration {
Ahlberg, et al. Expires June 1, 2019 [Page 12]
Internet-Draft Microwave YANG Model November 2018
enum "off" {
description "Transmitter is off.";
}
enum "on" {
description "Transmitter is on.";
}
enum "standby" {
description "Transmitter is in standby.";
}
}
config false;
description
"Shows the operative status of the transmitter.";
}
leaf tx-frequency {
type uint32;
units "kHz";
mandatory true;
description
"Selected transmitter frequency.";
}
choice freq-or-distance {
leaf rx-frequency {
type uint32;
units "kHz";
description
"Selected receiver frequency.";
}
leaf duplex-distance {
type int32;
units "kHz";
description
"Distance between transmitter and receiver frequencies.";
}
mandatory true;
description
"A choice to configure rx-frequency directly or by computing
it as duplex-distance subtracted from tx-frequency." ;
}
leaf actual-rx-frequency {
type uint32;
units "kHz";
config false;
description
"Computed receiver frequency.";
Ahlberg, et al. Expires June 1, 2019 [Page 13]
Internet-Draft Microwave YANG Model November 2018
}
leaf actual-duplex-distance {
type uint32;
units "kHz";
config false;
description
"Computed distance between Tx & Rx frequencies.";
}
leaf channel-separation {
type uint32;
units "kHz";
mandatory true;
description
"The amount of bandwidth allocated to a carrier. The distance
between adjacent channels in a radio frequency channels
arrangement";
reference "ETSI EN 302 217-1";
}
leaf polarization {
type enumeration {
enum "horizontal" {
description "Horizontal polarization.";
}
enum "vertical" {
description "Vertical polarization.";
}
enum "not-specified" {
description "Polarization not specified.";
}
}
default "not-specified";
description
"Polarization - A textual description for info only.";
}
choice power-mode {
container rtpc {
description
"Remote Transmit Power Control (RTPC).";
reference "ETSI EN 302 217-1";
leaf maximum-nominal-power {
type power {
range "-99..99";
}
Ahlberg, et al. Expires June 1, 2019 [Page 14]
Internet-Draft Microwave YANG Model November 2018
units "dBm";
mandatory true;
description
"Selected output power.";
reference "ETSI EN 302 217-1";
}
}
container atpc {
description
"Automatic Transmit Power Control (ATPC).";
reference "ETSI EN 302 217-1";
leaf maximum-nominal-power {
type power {
range "-99..99";
}
units "dBm";
mandatory true;
description
"Selected maximum output power. Minimum output
power is the same as the system capability,
available-min-output-power.";
reference "ETSI EN 302 217-1";
}
leaf atpc-lower-threshold {
type power {
range "-99..-20";
}
units "dBm";
must "current() <= ../atpc-upper-threshold";
mandatory true;
description
"The lower threshold for the input power at far-end
used in the ATPC mode.";
reference "ETSI EN 302 217-1";
}
leaf atpc-upper-threshold {
type power {
range "-99..-20";
}
units "dBm";
mandatory true;
description
"The upper threshold for the input power at far-end
used in the ATPC mode.";
reference "ETSI EN 302 217-1";
Ahlberg, et al. Expires June 1, 2019 [Page 15]
Internet-Draft Microwave YANG Model November 2018
}
}
mandatory true;
description
"A choice of Remote Transmit Power Control (RTPC)
or Automatic Transmit Power Control (ATPC).";
}
leaf actual-transmitted-level {
type power {
range "-99..99";
}
units "dBm";
config false;
description
"Actual transmitted power level (0.1 dBm resolution).";
reference "ETSI EN 301 129";
}
leaf actual-received-level {
type power {
range "-99..-20";
}
units "dBm";
config false;
description
"Actual received power level (0.1 dBm resolution).";
reference "ETSI EN 301 129";
}
choice coding-modulation-mode {
container single {
description "A single modulation order only.";
reference "ETSI EN 302 217-1";
leaf selected-cm {
type identityref {
base mw-types:coding-modulation;
}
mandatory true;
description
"Selected the single coding/modulation.";
}
}
container adaptive {
description "Adaptive coding/modulation.";
reference "ETSI EN 302 217-1";
Ahlberg, et al. Expires June 1, 2019 [Page 16]
Internet-Draft Microwave YANG Model November 2018
leaf selected-min-acm {
type identityref {
base mw-types:coding-modulation;
}
mandatory true;
description
"Selected minimum coding/modulation.
Adaptive coding/modulation shall not go
below this value.";
}
leaf selected-max-acm {
type identityref {
base mw-types:coding-modulation;
}
mandatory true;
description
"Selected maximum coding/modulation.
Adaptive coding/modulation shall not go
above this value.";
}
}
mandatory true;
description
"A selection of single or
adaptive coding/modulation mode.";
}
leaf actual-tx-cm {
type identityref {
base mw-types:coding-modulation;
}
config false;
description
"Actual coding/modulation in transmitting direction.";
}
leaf actual-snir {
type decimal64 {
fraction-digits 1;
range "0..99";
}
units "dB";
config false;
description
"Actual signal to noise plus interference ratio.
(0.1 dB resolution).";
}
Ahlberg, et al. Expires June 1, 2019 [Page 17]
Internet-Draft Microwave YANG Model November 2018
leaf actual-xpi {
if-feature xpic;
type decimal64 {
fraction-digits 1;
range "0..99";
}
units "dB";
config false;
description
"The actual carrier to cross-polar interference.
Only valid if XPIC is enabled. (0.1 dB resolution).";
reference "ETSI TR 102 311";
}
container ct-performance-thresholds {
description
"Specification of thresholds for when alarms should
be sent and cleared for various performance counters.";
leaf received-level-alarm-threshold {
type power {
range "-99..-20";
}
units "dBm";
default "-99";
description
"An alarm is sent when the received power level is
below the specified threshold.";
reference "ETSI EN 301 129";
}
leaf transmitted-level-alarm-threshold {
type power {
range "-99..99";
}
units "dBm";
default "-99";
description
"An alarm is sent when the transmitted power level
is below the specified threshold.";
reference "ETSI EN 301 129";
}
leaf ber-alarm-threshold {
type enumeration {
enum "1e-9" {
description "Threshold at 1e-9 (10^-9).";
}
Ahlberg, et al. Expires June 1, 2019 [Page 18]
Internet-Draft Microwave YANG Model November 2018
enum "1e-8" {
description "Threshold at 1e-8 (10^-8).";
}
enum "1e-7" {
description "Threshold at 1e-7 (10^-7).";
}
enum "1e-6" {
description "Threshold at 1e-6 (10^-6).";
}
enum "1e-5" {
description "Threshold at 1e-5 (10^-5).";
}
enum "1e-4" {
description "Threshold at 1e-4 (10^-4).";
}
enum "1e-3" {
description "Threshold at 1e-3 (10^-3).";
}
enum "1e-2" {
description "Threshold at 1e-2 (10^-2).";
}
enum "1e-1" {
description "Threshold at 1e-1 (10^-1).";
}
}
default "1e-6";
description
"Specification of at which BER an alarm should
be raised.";
reference "ETSI EN 302 217-1";
}
}
leaf if-loop {
type enumeration {
enum disabled {
description "Disables the IF Loop.";
}
enum client {
description
"Loops the signal back to the client side.";
}
enum radio {
description
"Loops the signal back to the radio side.";
}
}
default "disabled";
Ahlberg, et al. Expires June 1, 2019 [Page 19]
Internet-Draft Microwave YANG Model November 2018
description
"Enable (client/radio) or disable (disabled)
the IF loop, which loops the signal back to
the client side or the radio side.";
}
leaf rf-loop {
type enumeration {
enum disabled {
description "Disables the RF Loop.";
}
enum client {
description
"Loops the signal back to the client side.";
}
enum radio {
description
"Loops the signal back to the radio side.";
}
}
default "disabled";
description
"Enable (client/radio) or disable (disabled)
the RF loop, which loops the signal back to
the client side or the radio side.";
}
container capabilities {
config false;
description
"Capabilities of the installed equipment and
some selected configurations.";
leaf min-tx-frequency {
type uint32;
units "kHz";
description
"Minimum Tx frequency possible to use.";
}
leaf max-tx-frequency {
type uint32;
units "kHz";
description
"Maximum Tx frequency possible to use.";
}
leaf min-rx-frequency {
Ahlberg, et al. Expires June 1, 2019 [Page 20]
Internet-Draft Microwave YANG Model November 2018
type uint32;
units "kHz";
description
"Minimum Rx frequency possible to use.";
}
leaf max-rx-frequency {
type uint32;
units "kHz";
description
"Maximum Tx frequency possible to use.";
}
leaf minimum-power {
type power;
units "dBm";
description
"The minimum output power supported.";
reference "ETSI EN 302 217-1";
}
leaf maximum-available-power {
type power;
units "dBm";
description
"The maximum output power supported.";
reference "ETSI EN 302 217-1";
}
leaf available-min-acm {
type identityref {
base mw-types:coding-modulation;
}
description
"Minimum coding-modulation possible to use.";
}
leaf available-max-acm {
type identityref {
base mw-types:coding-modulation;
}
description
"Maximum coding-modulation possible to use.";
}
}
container error-performance-statistics {
config false;
Ahlberg, et al. Expires June 1, 2019 [Page 21]
Internet-Draft Microwave YANG Model November 2018
description
"ITU-T G.826 error performance statistics relevant for
a microwave/millimeter wave carrier.";
leaf bbe {
type yang:counter32;
units "number of block errors";
description
"Number of Background Block Errors (BBE). A BBE is an
errored block not occurring as part of an SES.
Discontinuities in the value of this counter can occur
at re-initialization of the management system and at
other times as indicated by the value of
'discontinuity-time' in ietf-interfaces.";
reference "ITU-T G.826";
}
leaf es {
type yang:counter32;
units "seconds";
description
"Number of Errored Seconds (ES).
An ES is a one-second period with one or more errored
blocks or at least one defect.
Discontinuities in the value of this counter can occur
at re-initialization of the management system and at
other times as indicated by the value of
'discontinuity-time' in ietf-interfaces.";
reference "ITU-T G.826";
}
leaf ses {
type yang:counter32;
units "seconds";
description
"Number of Severely Errored Seconds (SES).
SES is a one-second period which contains
equal or more than 30% errored blocks or at least
one defect. SES is a subset of ES.
Discontinuities in the value of this counter can occur
at re-initialization of the management system and at
other times as indicated by the value of
'discontinuity-time' in ietf-interfaces.";
reference "ITU-T G.826";
}
leaf uas {
type yang:counter32;
Ahlberg, et al. Expires June 1, 2019 [Page 22]
Internet-Draft Microwave YANG Model November 2018
units "seconds";
description
"Number of Unavailable Seconds (UAS), that is, the
total time that the node has been unavailable.
Discontinuities in the value of this counter can occur
at re-initialization of the management system and at
other times as indicated by the value of
'discontinuity-time' in ietf-interfaces.";
reference "ITU-T G.826";
}
}
container radio-performance-statistics {
config false;
description
"ETSI EN 301 129 radio physical interface statistics relevant
for a carrier termination.";
leaf min-rltm {
type power {
range "-99..-20";
}
units "dBm";
description
"Minimum received power level.
Discontinuities in the value of this counter can occur
at re-initialization of the management system and at
other times as indicated by the value of
'discontinuity-time' in ietf-interfaces.";
reference "ETSI EN 301 129";
}
leaf max-rltm {
type power {
range "-99..-20";
}
units "dBm";
description
"Maximum received power level.
Discontinuities in the value of this counter can occur
at re-initialization of the management system and at
other times as indicated by the value of
'discontinuity-time' in ietf-interfaces.";
reference "ETSI EN 301 129";
}
leaf min-tltm {
type power {
Ahlberg, et al. Expires June 1, 2019 [Page 23]
Internet-Draft Microwave YANG Model November 2018
range "-99..99";
}
units "dBm";
description
"Minimum transmitted power level.
Discontinuities in the value of this counter can occur
at re-initialization of the management system and at
other times as indicated by the value of
'discontinuity-time' in ietf-interfaces.";
reference "ETSI EN 301 129";
}
leaf max-tltm {
type power {
range "-99..99";
}
units "dBm";
description
"Maximum transmitted power level.
Discontinuities in the value of this counter can occur
at re-initialization of the management system and at
other times as indicated by the value of
'discontinuity-time' in ietf-interfaces.";
reference "ETSI EN 301 129";
}
}
}
/*
* Radio Link Protection Groups
*/
container radio-link-protection-groups {
description
"Configuration of radio link protected groups (1+1) of
carrier terminations in a radio link. More than one
protected group per radio-link-terminal is allowed.";
uses ifprot:protection-groups {
refine protection-group/members {
must "derived-from-or-self(/if:interfaces/if:interface"
+ "[if:name = current()]"
+ "/if:type, 'ianaift:carrier-termination')" {
description
"The type of a protection member must be
'carrier-termination'.";
}
Ahlberg, et al. Expires June 1, 2019 [Page 24]
Internet-Draft Microwave YANG Model November 2018
}
refine protection-group/working-entity {
must "derived-from-or-self(/if:interfaces/if:interface"
+ "[if:name = current()]"
+ "/if:type, 'ianaift:carrier-termination')" {
description
"The type of a working-entity must be
'carrier-termination'.";
}
}
}
}
/*
* XPIC & MIMO groups - Configuration data nodes
*/
container xpic-pairs {
if-feature xpic;
description
"Configuration of carrier termination pairs
for operation in XPIC mode.";
reference "ETSI TR 102 311";
list xpic-pair {
key "name";
description
"List of carrier termination pairs in XPIC mode.";
leaf name {
type string;
description
"Name used for identification of the XPIC pair.";
}
leaf enabled {
type boolean;
default "false";
description
"Enable(true)/disable(false) XPIC";
}
leaf-list members {
type if:interface-ref;
must "derived-from-or-self(/if:interfaces/if:interface"
+ "[if:name = current()]"
+ "/if:type, 'ianaift:carrier-termination')" {
Ahlberg, et al. Expires June 1, 2019 [Page 25]
Internet-Draft Microwave YANG Model November 2018
description
"The type of a member must be 'carrier-termination'.";
}
min-elements 2;
max-elements 2;
description
"Association to XPIC pairs used in the radio link
terminal.";
}
}
}
container mimo-groups {
if-feature mimo;
description
"Configuration of carrier terminations
for operation in MIMO mode.";
reference "ETSI TR 102 311";
list mimo-group {
key "name";
description
"List of carrier terminations in MIMO mode.";
leaf name {
type string;
description
"Name used for identification of the MIMO group.";
}
leaf enabled {
type boolean;
default "false";
description
"Enable(true)/disable(false) MIMO";
}
leaf-list members {
type if:interface-ref;
must "derived-from-or-self(/if:interfaces/if:interface"
+ "[if:name = current()]"
+ "/if:type, 'ianaift:carrier-termination')" {
description
"The type of a member must be 'carrier-termination'.";
}
min-elements 2;
description
Ahlberg, et al. Expires June 1, 2019 [Page 26]
Internet-Draft Microwave YANG Model November 2018
"Association to a MIMO group if used in the radio
link terminal.";
}
}
}
}
<CODE ENDS>
5. Interface Protection YANG Module
The data nodes for management of the interface protection
functionality is broken out from the Microwave Radio Link Module into
a separate and generic YANG data module in order to make it available
also for other interface types.
This module imports modules from [RFC8343], and it references
[G.808.1].
<CODE BEGINS> file "ietf-interface-protection@2018-11-28.yang"
module ietf-interface-protection {
yang-version 1.1;
namespace "urn:ietf:params:xml:ns:yang:ietf-interface-protection";
prefix ifprot;
import ietf-interfaces {
prefix if;
reference "RFC8343";
}
organization
"Internet Engineering Task Force (IETF) CCAMP WG";
contact
"WG List: <mailto:ccamp@ietf.org>
ID-draft editors:
Jonas Ahlberg (jonas.ahlberg@ericsson.com);
Min Ye (amy.yemin@huawei.com);
Xi Li (Xi.Li@neclab.eu);
Daniela Spreafico (daniela.spreafico@nokia.com)
Marko Vaupotic (Marko.Vaupotic@aviatnet.com)";
description
"This is a module for the entities in
a generic interface protection mechanism.
Ahlberg, et al. Expires June 1, 2019 [Page 27]
Internet-Draft Microwave YANG Model November 2018
Copyright (c) 2018 IETF Trust and the persons identified as
authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or
without modification, is permitted pursuant to, and subject
to the license terms contained in, the Simplified BSD License
set forth in Section 4.c of the IETF Trust's Legal Provisions
Relating to IETF Documents
(http://trustee.ietf.org/license-info).
This version of this YANG module is part of RFC XXXX; see
the RFC itself for full legal notices.
Copyright (c) 2018 IETF Trust and the persons identified as
authors of the code. All rights reserved.";
revision 2018-11-28 {
description "Initial revision.";
reference "RFC XXXX: A YANG Data Model for Microwave Radio Link";
}
/*
* Protection architecture type identities
*/
identity protection-architecture-type {
description
"protection architecture type";
reference "ITU-T G.808.1";
}
identity one-plus-one-type {
base protection-architecture-type;
description
"1+1, One interface protects
another one interface.";
reference "ITU-T G.808.1";
}
identity one-to-n-type {
base protection-architecture-type;
description
"1:N, One interface protects
n other interfaces.";
reference "ITU-T G.808.1";
}
/*
Ahlberg, et al. Expires June 1, 2019 [Page 28]
Internet-Draft Microwave YANG Model November 2018
* Protection states identities
*/
identity protection-states {
description
"Identities describing the status of the protection,
in a group of interfaces configured in
a protection mode.";
}
identity unprotected {
base protection-states;
description "Not protected";
}
identity protected {
base protection-states;
description "Protected";
}
identity unable-to-protect {
base protection-states;
description "Unable to protect";
}
/*
* Protection Groups
*/
grouping protection-groups {
description
"Configuration of protected groups (1+1) of interfaces
providing protection for each other. More than one protected
group per higher-layer-interface is allowed.";
list protection-group {
key "name";
description
"List of protected groups of interfaces
in a higher-layer-interface.";
leaf name {
type string;
description
"Name used for identification of the protection group";
}
leaf protection-architecture-type {
Ahlberg, et al. Expires June 1, 2019 [Page 29]
Internet-Draft Microwave YANG Model November 2018
type identityref {
base protection-architecture-type;
}
default "ifprot:one-plus-one-type";
description
"The type of protection architecture used, e.g. one
interface protecting one or several other interfaces.";
reference "ITU-T G.808.1";
}
leaf-list members {
type if:interface-ref;
min-elements 2;
description
"Association to a group of interfaces configured for
protection and used by a higher-layer-interface.";
}
leaf operation-type {
type enumeration {
enum "non-revertive" {
description
"In non revertive operation, the traffic does not
return to the working interface if the switch requests
are terminated.";
reference "ITU-T G.808.1";
}
enum "revertive" {
description
"In revertive operation, the traffic always
returns to (or remains on) the working interface
if the switch requests are terminated.";
reference "ITU-T G.808.1";
}
}
default "non-revertive";
description
"The type of protection operation, i.e. revertive
or non-revertive operation.";
}
leaf-list working-entity {
when "../operation-type = 'revertive'";
type if:interface-ref;
min-elements 1;
description
"The interfaces over which the traffic normally should
be transported over when there is no need to use the
Ahlberg, et al. Expires June 1, 2019 [Page 30]
Internet-Draft Microwave YANG Model November 2018
protecting interface.";
}
leaf revertive-wait-to-restore {
when "../operation-type = 'revertive'";
type uint16;
units "seconds";
default "0";
description
"The time to wait before switching back to the working
interface if operation-type is revertive.";
reference "ITU-T G.808.1";
}
leaf hold-off-timer {
type uint16;
units "milliseconds";
default "0";
description
"Time interval after the detection of a fault and its
confirmation as a condition requiring the protection
switching procedure.";
reference "ITU-T G.808.1";
}
leaf status {
type identityref {
base protection-states;
}
config false;
description
"Status of the protection, in a group of interfaces
configured in a protection mode.";
reference "ITU-T G.808.1";
}
action manual-switch-working {
description
"A switch action initiated by an operator command.
It switches normal traffic signal to the working
transport entity.";
reference "ITU-T G.808.1";
}
action manual-switch-protection {
description
"A switch action initiated by an operator command.
It switches normal traffic signal to the protection
Ahlberg, et al. Expires June 1, 2019 [Page 31]
Internet-Draft Microwave YANG Model November 2018
transport entity.";
reference "ITU-T G.808.1";
}
action forced-switch {
description
"A switch action initiated by an operator command.
It switches normal traffic signal to the protection
transport entity and forces it to remain on that
entity even when criteria for switching back to
the original entity are fulfilled.";
reference "ITU-T G.808.1";
}
action lockout-of-protection {
description
"A switch action temporarily disables access to the
protection transport entity for all signals.";
reference "ITU-T G.808.1";
}
action freeze {
description
"A switch action temporarily prevents any switch action
to be taken and, as such, freezes the current state.
Until the freeze is cleared, additional near-end external
commands are rejected and fault condition changes and
received APS messages are ignored..";
reference "ITU-T G.808.1";
}
action exercise {
description
"A switch action to test if the APS communication is
operating correctly. It is lower priority than any 'real'
switch request..";
reference "ITU-T G.808.1";
}
action clear {
description
"An action clears all switch commands.";
reference "ITU-T G.808.1";
}
}
}
}
Ahlberg, et al. Expires June 1, 2019 [Page 32]
Internet-Draft Microwave YANG Model November 2018
<CODE ENDS>
6. Microwave Types YANG Module
This module defines a collection of common data types using the YANG
data modeling language. These common types are designed to be
imported by other modules defined in the microwave area.
<CODE BEGINS> file "ietf-microwave-types@2018-11-28.yang"
module ietf-microwave-types {
yang-version 1.1;
namespace "urn:ietf:params:xml:ns:yang:ietf-microwave-types";
prefix mw-types;
organization
"Internet Engineering Task Force (IETF) CCAMP WG";
contact
"WG List: <mailto:ccamp@ietf.org>
ID-draft editors:
Jonas Ahlberg (jonas.ahlberg@ericsson.com);
Min Ye (amy.yemin@huawei.com);
Xi Li (Xi.Li@neclab.eu);
Daniela Spreafico (daniela.spreafico@nokia.com)
Marko Vaupotic (Marko.Vaupotic@aviatnet.com)";
description
"This module contains a collection of YANG data types
considered generally useful for microwave interfaces.
Copyright (c) 2018 IETF Trust and the persons identified as
authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or
without modification, is permitted pursuant to, and subject
to the license terms contained in, the Simplified BSD License
set forth in Section 4.c of the IETF Trust's Legal Provisions
Relating to IETF Documents
(http://trustee.ietf.org/license-info).
This version of this YANG module is part of RFC XXXX; see
the RFC itself for full legal notices.
Copyright (c) 2018 IETF Trust and the persons identified as
authors of the code. All rights reserved.";
Ahlberg, et al. Expires June 1, 2019 [Page 33]
Internet-Draft Microwave YANG Model November 2018
revision 2018-11-28 {
description "Initial revision.";
reference "RFC XXXX: A YANG Data Model for Microwave Radio Link";
}
/*
* Radio-link-terminal mode identities
*/
identity rlt-mode {
description
"A description of the mode in which the radio link
terminal is configured. The format is X plus Y.
X represent the number of bonded carrier terminations.
Y represent the number of protecting carrier
terminations.";
}
identity one-plus-zero {
base rlt-mode;
description
"1 carrier termination only.";
}
identity one-plus-one {
base rlt-mode;
description
"1 carrier termination
and 1 protecting carrier termination.";
}
identity two-plus-zero {
base rlt-mode;
description
"2 bonded carrier terminations.";
}
/*
* Coding and modulation identities
*/
identity coding-modulation {
description
"The coding and modulation schemes.";
}
identity half-bpsk {
base coding-modulation;
Ahlberg, et al. Expires June 1, 2019 [Page 34]
Internet-Draft Microwave YANG Model November 2018
description
"Half BPSK coding and modulation scheme.";
}
identity half-bpsk-strong {
base half-bpsk;
description
"Half BPSK strong coding and modulation scheme.";
}
identity half-bpsk-light {
base half-bpsk;
description
"Half BPSK light coding and modulation scheme.";
}
identity bpsk {
base coding-modulation;
description
"BPSK coding and modulation scheme.";
}
identity bpsk-strong {
base bpsk;
description
"BPSK strong coding and modulation scheme.";
}
identity bpsk-light {
base bpsk;
description
"BPSK light coding and modulation scheme.";
}
identity qpsk {
base coding-modulation;
description
"QPSK coding and modulation scheme.";
}
identity qam-4 {
base coding-modulation;
description
"4 QAM coding and modulation scheme.";
}
identity qam-4-strong {
base qam-4;
Ahlberg, et al. Expires June 1, 2019 [Page 35]
Internet-Draft Microwave YANG Model November 2018
description
"4 QAM strong coding and modulation scheme.";
}
identity qam-4-light {
base qam-4;
description
"4 QAM light coding and modulation scheme.";
}
identity qam-16 {
base coding-modulation;
description
"16 QAM coding and modulation scheme.";
}
identity qam-16-strong {
base qam-16;
description
"16 QAM strong coding and modulation scheme.";
}
identity qam-16-light {
base qam-16;
description
"16 QAM light coding and modulation scheme.";
}
identity qam-32 {
base coding-modulation;
description
"32 QAM coding and modulation scheme.";
}
identity qam-32-strong {
base qam-32;
description
"32 QAM strong coding and modulation scheme.";
}
identity qam-32-light {
base qam-32;
description
"32 QAM light coding and modulation scheme.";
}
identity qam-64 {
base coding-modulation;
Ahlberg, et al. Expires June 1, 2019 [Page 36]
Internet-Draft Microwave YANG Model November 2018
description
"64 QAM coding and modulation scheme.";
}
identity qam-64-strong {
base qam-64;
description
"64 QAM strong coding and modulation scheme.";
}
identity qam-64-light {
base qam-64;
description
"64 QAM light coding and modulation scheme.";
}
identity qam-128 {
base coding-modulation;
description
"128 QAM coding and modulation scheme.";
}
identity qam-128-strong {
base qam-128;
description
"128 QAM strong coding and modulation scheme.";
}
identity qam-128-light {
base qam-128;
description
"128 QAM light coding and modulation scheme.";
}
identity qam-256 {
base coding-modulation;
description
"256 QAM coding and modulation scheme.";
}
identity qam-256-strong {
base qam-256;
description
"256 QAM strong coding and modulation scheme.";
}
identity qam-256-light {
base qam-256;
Ahlberg, et al. Expires June 1, 2019 [Page 37]
Internet-Draft Microwave YANG Model November 2018
description
"256 QAM light coding and modulation scheme.";
}
identity qam-512 {
base coding-modulation;
description
"512 QAM coding and modulation scheme.";
}
identity qam-512-strong {
base qam-512;
description
"512 QAM strong coding and modulation scheme.";
}
identity qam-512-light {
base qam-512;
description
"512 QAM light coding and modulation scheme.";
}
identity qam-1024 {
base coding-modulation;
description
"1024 QAM coding and modulation scheme.";
}
identity qam-1024-strong {
base qam-1024;
description
"1024 QAM strong coding and modulation scheme.";
}
identity qam-1024-light {
base qam-1024;
description
"1024 QAM light coding and modulation scheme.";
}
identity qam-2048 {
base coding-modulation;
description
"2048 QAM coding and modulation scheme.";
}
identity qam-2048-strong {
base qam-2048;
Ahlberg, et al. Expires June 1, 2019 [Page 38]
Internet-Draft Microwave YANG Model November 2018
description
"2048 QAM strong coding and modulation scheme.";
}
identity qam-2048-light {
base qam-2048;
description
"2048 QAM light coding and modulation scheme.";
}
identity qam-4096 {
base coding-modulation;
description
"4096 QAM coding and modulation scheme.";
}
identity qam-4096-strong {
base qam-4096;
description
"4096 QAM strong coding and modulation scheme.";
}
identity qam-4096-light {
base qam-4096;
description
"4096 QAM light coding and modulation scheme.";
}
/*
* TDM-type identities
*/
identity tdm-type {
description
"A description of the type of TDM connection,
also indicating the supported capacity of the
connection.";
}
identity E1 {
base tdm-type;
description
"E1 connection, 2.048 Mbit/s.";
}
identity STM-1 {
base tdm-type;
description
Ahlberg, et al. Expires June 1, 2019 [Page 39]
Internet-Draft Microwave YANG Model November 2018
"STM-1 connection, 155.52 Mbit/s.";
}
}
<CODE ENDS>
7. Security Considerations
The YANG modules specified in this document define schemas for data
that is designed to be accessed via network management protocols such
as NETCONF [RFC6241] or RESTCONF [RFC8040]. The lowest NETCONF layer
is the secure transport layer, and the mandatory-to-implement secure
transport is Secure Shell (SSH) [RFC6242]. The lowest RESTCONF layer
is HTTPS, and the mandatory-to-implement secure transport is TLS
[RFC8446].
The NETCONF access control model [RFC8341] provides the means to
restrict access for particular NETCONF or RESTCONF users to a
preconfigured subset of all available NETCONF or RESTCONF protocol
operations and content.
There are a number of data nodes defined in these YANG modules that
are writable/creatable/deletable (i.e., config true, which is the
default). These data nodes may be considered sensitive or vulnerable
in some network environments. Write operations (e.g., edit-config)
to these data nodes without proper protection can have a negative
effect on network operations. These are the subtrees and data nodes
and their sensitivity/vulnerability:
Interfaces of type radio-link-terminal:
/if:interfaces/if:interface/mode,
/if:interfaces/if:interface/carrier-terminations,
/if:interfaces/if:interface/rlp-groups,
/if:interfaces/if:interface/xpic-pairs,
/if:interfaces/if:interface/mimo-groups, and
/if:interfaces/if:interface/tdm-connections:
These data nodes represent the configuration of the radio-link-
terminal and they need to match the configuration of the radio-link-
terminal on the other side of the radio link. Unauthorized access to
these data nodes could interrupt the ability to forward traffic.
Interfaces of type carrier-termination:
Ahlberg, et al. Expires June 1, 2019 [Page 40]
Internet-Draft Microwave YANG Model November 2018
/if:interfaces/if:interface/carrier-id,
/if:interfaces/if:interface/tx-enabled,
/if:interfaces/if:interface/tx-frequency,
/if:interfaces/if:interface/rx-frequency,
/if:interfaces/if:interface/duplex-distance,
/if:interfaces/if:interface/channel-separation,
/if:interfaces/if:interface/rtpc/maximum-nominal-power,
/if:interfaces/if:interface/atpc/maximum-nominal-power,
/if:interfaces/if:interface/atpc/atpc-lower-threshold,
/if:interfaces/if:interface/atpc/atpc-upper-threshold,
/if:interfaces/if:interface/single/selected-cm,
/if:interfaces/if:interface/adaptive/selected-min-acm,
/if:interfaces/if:interface/adaptive/selected-max-acm,
/if:interfaces/if:interface/if-loop, and
/if:interfaces/if:interface/rf-loop:
These data nodes represent the configuration of the carrier-
termination and they need to match the configuration of the carrier-
termination on the other side of the carrier. Unauthorized access to
these data nodes could interrupt the ability to forward traffic.
Radio link protection:
/radio-link-protection-groups/protection-group:
This data node represents the configuration of the protection of
carrier terminations. Unauthorized access to this data node could
interrupt the ability to forward traffic or remove the ability to
perform a necessary protection switch.
XPIC:
/xpic-pairs:
This data node represents the XPIC configuration of a pair carriers.
Unauthorized access to this data node could interrupt the ability to
forward traffic.
MIMO:
/mimo-groups:
Ahlberg, et al. Expires June 1, 2019 [Page 41]
Internet-Draft Microwave YANG Model November 2018
This data node represents the MIMO configuration of multiple
carriers. Unauthorized access to this data node could interrupt the
ability to forward traffic.
The security considerations of [RFC8343] also apply to this document.
8. IANA Considerations
It is proposed that IANA should assign new URIs from the "IETF XML
Registry" [RFC3688] as follows:
URI: urn:ietf:params:xml:ns:yang:ietf-microwave-radio-link
Registrant Contact: The IESG
XML: N/A; the requested URI is an XML namespace.
URI: urn:ietf:params:xml:ns:yang:ietf-interface-protection
Registrant Contact: The IESG
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
Module Names" registry [RFC6020] as follows:
Name: ietf-microwave-radio-link
Maintained by IANA?: N
Namespace: urn:ietf:params:xml:ns:yang:ietf-microwave-radio-link
Prefix: mrl
Reference: RFC XXXX
Name: ietf-interface-protection
Maintained by IANA?: N
Namespace: urn:ietf:params:xml:ns:yang:ietf-interface-protection
Prefix: ifprot
Reference: RFC XXXX
Name: ietf-microwave-types
Maintained by IANA?: N
Namespace: urn:ietf:params:xml:ns:yang:ietf-microwave-types
Prefix: mw-types
Reference: RFC XXXX
Ahlberg, et al. Expires June 1, 2019 [Page 42]
Internet-Draft Microwave YANG Model November 2018
It is proposed that IANA should register a new IANAifType TBD1 for
the interface type radio-link-terminal and a new IANAifType TBD2 for
the interface type carrier-termination at [IFTYPE-IANA-REGISTRY].
9. References
9.1. Normative References
[IFTYPE-IANA-REGISTRY]
"Internet Assigned Numbers Authority, "ifType
Definitions"",
<http://www.iana.org/assignments/smi-numbers>.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119,
DOI 10.17487/RFC2119, March 1997,
<https://www.rfc-editor.org/info/rfc2119>.
[RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688,
DOI 10.17487/RFC3688, January 2004,
<https://www.rfc-editor.org/info/rfc3688>.
[RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for
the Network Configuration Protocol (NETCONF)", RFC 6020,
DOI 10.17487/RFC6020, October 2010,
<https://www.rfc-editor.org/info/rfc6020>.
[RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed.,
and A. Bierman, Ed., "Network Configuration Protocol
(NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011,
<https://www.rfc-editor.org/info/rfc6241>.
[RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure
Shell (SSH)", RFC 6242, DOI 10.17487/RFC6242, June 2011,
<https://www.rfc-editor.org/info/rfc6242>.
[RFC6991] Schoenwaelder, J., Ed., "Common YANG Data Types",
RFC 6991, DOI 10.17487/RFC6991, July 2013,
<https://www.rfc-editor.org/info/rfc6991>.
[RFC7224] Bjorklund, M., "IANA Interface Type YANG Module",
RFC 7224, DOI 10.17487/RFC7224, May 2014,
<https://www.rfc-editor.org/info/rfc7224>.
[RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF
Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017,
<https://www.rfc-editor.org/info/rfc8040>.
Ahlberg, et al. Expires June 1, 2019 [Page 43]
Internet-Draft Microwave YANG Model November 2018
[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC
2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,
May 2017, <https://www.rfc-editor.org/info/rfc8174>.
[RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration
Access Control Model", STD 91, RFC 8341,
DOI 10.17487/RFC8341, March 2018,
<https://www.rfc-editor.org/info/rfc8341>.
[RFC8343] Bjorklund, M., "A YANG Data Model for Interface
Management", RFC 8343, DOI 10.17487/RFC8343, March 2018,
<https://www.rfc-editor.org/info/rfc8343>.
[RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol
Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018,
<https://www.rfc-editor.org/info/rfc8446>.
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.
Ahlberg, et al. Expires June 1, 2019 [Page 44]
Internet-Draft Microwave YANG Model November 2018
[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]
Ahlberg, J., Carlson, J., Lund, H., Olausson, T., Ye, M.,
and M. Vaupotic, "Microwave Radio Link YANG Data Models",
draft-ahlberg-ccamp-microwave-radio-link-01 (work in
progress), May 2016.
[ONF-model]
"Microwave Information Model", version 1.0 , December
2016,
<https://www.opennetworking.org/images/stories/downloads/
sdn-resources/technical-reports/
TR-532-Microwave-Information-Model-V1.pdf>.
[RFC8340] Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams",
BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018,
<https://www.rfc-editor.org/info/rfc8340>.
[RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K.,
and R. Wilton, "Network Management Datastore Architecture
(NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018,
<https://www.rfc-editor.org/info/rfc8342>.
[RFC8432] Ahlberg, J., Ed., Ye, M., Ed., Li, X., Contreras, LM., and
CJ. Bernardos, "A Framework for Management and Control of
Microwave and Millimeter Wave Interface Parameters",
RFC 8432, DOI 10.17487/RFC8432, October 2018,
<https://www.rfc-editor.org/info/rfc8432>.
[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
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
a complete module for 1+0 and 2+0 configuration.
Ahlberg, et al. Expires June 1, 2019 [Page 45]
Internet-Draft Microwave YANG Model November 2018
A.1. 1+0 instance
/--------- Radio Link ---------\
Near End Far End
+---------------+ +---------------+
| Radio Link | | Radio Link |
| Terminal A | | Terminal B |
| | | |
| | | |
| +-----------+ | | +-----------+ |
| | | | Carrier A | | | |
| | Carrier | |<--------->| | Carrier | |
| |Termination| | | |Termination| |
| | 1 | | | | 1 | |
| +-----------+ | | +-----------+ |
| | | |
| | | |
+---------------+ +---------------+
\--- Microwave Node ---/ \--- Microwave Node ---/
Figure A-1 1+0 example
Figure A-1 shows a 1+0 example. The following instance
shows the 1+0 configuration of Near End node.
"interface": [
{
"name": "RLT-A",
"description": "Radio Link Terminal A",
"type": "radio-link-terminal",
"id": "RLT-A",
"mode": "one-plus-zero",
"carrier-terminations": [
"RLT-A:CT-1"
],
"tdm-connections": [
"tdm-type": "E1",
"tdm-connections": "4"
]
},
{
"name": "RLT-A:CT-1",
"description": "Carrier Termination 1",
"type": "carrier-termination",
"carrier-id": "A",
Ahlberg, et al. Expires June 1, 2019 [Page 46]
Internet-Draft Microwave YANG Model November 2018
"tx-enabled": true,
"tx-frequency": 10728000,
"duplex-distance": 644000,
"channel-separation": 28,
"polarization": not-specified,
"rtpc": {
"maximum-nominal-power": 20
},
"single": {
"selected-cm": "qam-512"
}
}
]
A.2. 2+0 instance
Figure A-2 shows a 2+0 example.
/--------- Radio Link ---------\
Near End Far End
+---------------+ +---------------+
| Radio Link | | Radio Link |
| Terminal A | | Terminal B |
| | | |
| | | |
| +-----------+ | | +-----------+ |
| | | | Carrier A | | | |
| | Carrier | |<--------->| | Carrier | |
| |Termination| | | |Termination| |
| | 1 | | | | 1 | |
| +-----------+ | | +-----------+ |
| | | |
| +-----------+ | | +-----------+ |
| | | | Carrier B | | | |
| | Carrier | |<--------->| | Carrier | |
| |Termination| | | |Termination| |
| | 2 | | | | 2 | |
| +-----------+ | | +-----------+ |
| | | |
+---------------+ +---------------+
\--- Microwave Node ---/ \--- Microwave Node ---/
Figure A-2 2+0 example
Ahlberg, et al. Expires June 1, 2019 [Page 47]
Internet-Draft Microwave YANG Model November 2018
The following instance shows the 2+0 configuration of
Near End node.
"interface": [
{
"name": "RLT-A",
"description": "Radio Link Terminal A",
"type": "radio-link-terminal",
"id": "RLT-A",
"mode": "two-plus-zero",
"carrier-terminations": [
"RLT-A:CT-1",
"RLT-A:CT-2"
],
"tdm-connections": [
"tdm-type": "E1",
"tdm-connections": "4"
]
},
{
"name": "RLT-A:CT-1",
"description": "Carrier Termination 1",
"type": "carrier-termination",
"carrier-id": "A",
"tx-enabled": true,
"tx-frequency": 10728000,
"duplex-distance": 644000,
"channel-separation": 28,
"polarization": not-specified,
"rtpc": {
"maximum-nominal-power": 20
},
"single": {
"selected-cm": "qam-512"
}
},
{
"name": "RLT-A:CT-2",
"description": "Carrier Termination 2",
"type": "carrier-termination",
"carrier-id": "B",
"tx-enabled": true,
"tx-oper-status": on,
"tx-frequency": 10618000,
"duplex-distance": 644000,
"channel-separation": 28,
Ahlberg, et al. Expires June 1, 2019 [Page 48]
Internet-Draft Microwave YANG Model November 2018
"polarization": not-specified,
"rtpc": {
"maximum-nominal-power": 20
},
"single": {
"selected-cm": "qam-512"
}
}
]
A.3. 2+0 XPIC instance
The following instance shows the XPIC configuration of
Near End node.
"interface": [
{
"name": "RLT-A",
"description": "Radio Link Terminal A",
"type": "radio-link-terminal",
"id": "RLT-A",
"mode": "two-plus-zero",
"carrier-terminations": [
"RLT-A:CT-1",
"RLT-A:CT-2"
],
"xpic-pairs": [
"RLT-A:CT-1",
"RLT-A:CT-2"
],
"tdm-connections": [
"tdm-type": "E1",
"tdm-connections": "4"
]
},
{
"name": "RLT-A:CT-1",
"description": "Carrier Termination 1",
"type": "carrier-termination",
"carrier-id": "A",
"tx-enabled": true,
"tx-frequency": 10728000,
"duplex-distance": 644000,
"channel-separation": 28,
"polarization": not-specified,
"rtpc": {
Ahlberg, et al. Expires June 1, 2019 [Page 49]
Internet-Draft Microwave YANG Model November 2018
"maximum-nominal-power": 20
},
"single": {
"selected-cm": "qam-512"
}
},
{
"name": "RLT-A:CT-2",
"description": "Carrier Termination 2",
"type": "carrier-termination",
"carrier-id": "B",
"tx-enabled": true,
"tx-oper-status": on,
"tx-frequency": 10618000,
"duplex-distance": 644000,
"channel-separation": 28,
"polarization": not-specified,
"rtpc": {
"maximum-nominal-power": 20
},
"single": {
"selected-cm": "qam-512"
}
}
]
Appendix B. Contributors
Koji Kawada
NEC Corporation
1753, Shimonumabe Nakahara-ku
Kawasaki, Kanagawa 211-8666
Japan
Email: k-kawada@ah.jp.nec.com
Carlos J. Bernardos
Universidad Carlos III de Madrid
Av. Universidad, 30
Leganes, Madrid 28911
Spain
Email: cjbc@it.uc3m.es
Ahlberg, et al. Expires June 1, 2019 [Page 50]
Internet-Draft Microwave YANG Model November 2018
Authors' Addresses
Jonas Ahlberg
Ericsson AB
Lindholmspiren 11
Goteborg 417 56
Sweden
Email: jonas.ahlberg@ericsson.com
Ye Min
Huawei Technologies
No.1899, Xiyuan Avenue
Chengdu 611731
P.R.China
Email: amy.yemin@huawei.com
Xi Li
NEC Laboratories Europe
Kurfursten-Anlage 36
Heidelberg 69115
Germany
Email: Xi.Li@neclab.eu
Daniela Spreafico
Nokia - IT
Via Energy Park, 14
Vimercate (MI) 20871
Italy
Email: daniela.spreafico@nokia.com
Marko Vaupotic
Aviat Networks
Motnica 9
Trzin-Ljubljana 1236
Slovenia
Email: Marko.Vaupotic@Aviatnet.com
Ahlberg, et al. Expires June 1, 2019 [Page 51]
