draft-ietf-ccamp-mw-yang-01.txt   draft-ietf-ccamp-mw-yang-02.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 4, 2018 Huawei Technologies Expires: April 26, 2018 Huawei Technologies
X. Li X. Li
NEC Laboratories Europe NEC Laboratories Europe
K. Kawada K. Kawada
NEC Corporation NEC Corporation
CJ. Bernardos CJ. Bernardos
Universidad Carlos III de Madrid Universidad Carlos III de Madrid
D. Spreafico D. Spreafico
Nokia - IT Nokia - IT
M. Vaupotic M. Vaupotic
Aviat Networks Aviat Networks
July 3, 2017 October 23, 2017
A YANG Data Model for Microwave Radio Link A YANG Data Model for Microwave Radio Link
draft-ietf-ccamp-mw-yang-01 draft-ietf-ccamp-mw-yang-02
Abstract Abstract
This document defines a YANG data model in order to control and This document defines a YANG data model for control and management
manage the radio link interfaces, and the connectivity to packet of 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
functionality is broken out into a separate and generic YANG data
model in order to make it available also for other interface types.
Requirements Language Requirements Language
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in [RFC2119]. document are to be interpreted as described in [RFC2119].
Status of This Memo Status of This Memo
This Internet-Draft is submitted in full conformance with the This Internet-Draft is submitted in full conformance with the
skipping to change at page 1, line 49 skipping to change at page 1, line 52
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 http://datatracker.ietf.org/drafts/current/. Drafts is at http://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 4, 2018. This Internet-Draft will expire on April 26, 2018.
Copyright Notice Copyright Notice
Copyright (c) 2017 IETF Trust and the persons identified as the Copyright (c) 2017 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
(http://trustee.ietf.org/license-info) in effect on the date of (http://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
carefully, as they describe your rights and restrictions with respect carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License. described in the Simplified BSD License.
Table of Contents Table of Contents
1. Terminology and Definitions . . . . . . . . . . . . . . . . . 2 1. Terminology and Definitions . . . . . . . . . . . . . . . . . 2
2. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3
3. YANG Data Model (Tree Structure) . . . . . . . . . . . . . . 4 3. Microwave Radio Link YANG Data Model. . . . . . . . . . . . . 4
3.1. the YANG Tree . . . . . . . . . . . . . . . . . . . . . . 4 3.1. YANG Tree . . . . . . . . . . . . . . . . . . . . . . . . 4
3.2. Explanation of the Microwave Data Model . . . . . . . . . 5 3.2. Explanation of the Microwave Data Model . . . . . . . . . 5
4. YANG Module . . . . . . . . . . . . . . . . . . . . . . . . . 6 4. Microwave Radio Link YANG Module . . . . . . . . . . . . . . 6
5. Security Considerations . . . . . . . . . . . . . . . . . . . 33 5. Interface Protection YANG Module . . . . . . . . . . . . . . 30
6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 34 6. Security Considerations . . . . . . . . . . . . . . . . . . . 36
7. References . . . . . . . . . . . . . . . . . . . . . . . . . 34 7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 36
7.1. Normative References . . . . . . . . . . . . . . . . . . 34 8. References . . . . . . . . . . . . . . . . . . . . . . . . . 37
7.2. Informative References . . . . . . . . . . . . . . . . . 34 8.1. Normative References . . . . . . . . . . . . . . . . . . 37
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 35 8.2. Informative References . . . . . . . . . . . . . . . . . 37
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 38
1. Terminology and Definitions 1. Terminology and Definitions
The following terms are used in this document: The following terms are used in this document:
Carrier Termination (CT) is an interface for the capacity provided Carrier Termination (CT) is an interface for the capacity provided
over the air by a single carrier. It is typically defined by its over the air by a single carrier. It is typically defined by its
transmitting and receiving frequencies. transmitting and receiving frequencies.
Radio Link Terminal (RLT) is an interface providing packet capacity Radio Link Terminal (RLT) is an interface providing packet capacity
and/or TDM capacity to the associated Ethernet and/or TDM interfaces 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 in a node and used for setting up a transport service over a
microwave/millimeter wave link. microwave/millimeter wave link.
The following acronyms are used in this document: The following acronyms are used in this document:
ACM Adaptive Coding Modulation ACM Adaptive Coding Modulation
ATPC Automatic Transmit Power Control ATPC Automatic Transmit Power Control
CM Coding Modulation
CM Coding Modulation
CT Carrier Termination CT Carrier Termination
RLT Radio Link Terminal RLT Radio Link Terminal
RTPC Remote Transmit Power Control RTPC Remote Transmit Power Control
XPIC Cross Polarization Interference Cancellation XPIC Cross Polarization Interference Cancellation
MIMO Multiple-Input Multiple-Output MIMO Multiple-Input Multiple-Output
2. Introduction 2. 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 [EN 302 217-2] specifies the essential parameters for EN 302 217-2 [EN 302 217-2] specifies the essential parameters for
the systems operating from 1.4GHz to 86GHz. The data model includes the systems operating from 1.4GHz to 86GHz. The data model includes
configuration and state data. configuration and state data according to the new Network Management
Datastore Architecture [NMDA].
The design of the data model follows the framework for management and The design of the data model follows the framework for management and
control of microwave and millimeter wave interface parameters defined control of microwave and millimeter wave interface parameters defined
in [I-D.ietf-ccamp-microwave-framework]. This framework identifies in [I-D.ietf-ccamp-microwave-framework]. This framework identifies
the need and the scope of the YANG data model, the use cases and the need and the scope of the YANG data model, the use cases and
requirements that the model needs to support. Moreover, it provides requirements that the model needs to support. Moreover, it provides
a detailed gap analysis to identify the missing parameters and a detailed gap analysis to identify the missing parameters and
functionalities of the existing and established models to support the functionalities of the existing and established models to support the
specified use cases and requirements, and based on that recommends specified use cases and requirements, and based on that recommends
how the gaps should be filled with the development of the new model. 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 According to the conclusion of the gap analysis, the structure of the
data model is based on the structure defined in data model is based on the structure defined in
[I-D.ahlberg-ccamp-microwave-radio-link] and it augments RFC 7223 to [I-D.ahlberg-ccamp-microwave-radio-link] and it augments [RFC7223bis]
align with the same structure for management of the packet to align with the same structure for management of the packet
interfaces. More specifically, the model will include interface interfaces. More specifically, the model will include interface
layering to manage the capacity provided by a radio link terminal for layering to manage the capacity provided by a radio link terminal for
the associated Ethernet and TDM interfaces, using the principles for the associated Ethernet and TDM interfaces, using the principles for
interface layering described in RFC 7223 as a basis. interface layering described in RFC 7223 bis 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 The designed YANG data model uses established microwave equipment
and radio standards, such as ETSI EN 302 217-2, and the IETF: Radio 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: Link Model[I-D.ahlberg-ccamp-microwave-radio-link] and the ONF:
Microwave Modeling[ONF-model] as the basis for the definition of the Microwave Modeling[ONF-model] as the basis for the definition of the
detailed leafs/parameters, and proposes new ones to cover identified detailed leafs/parameters, and proposes new ones to cover identified
gaps which are analysed in[I-D.ietf-ccamp-microwave-framework]. gaps which are analysed in[I-D.ietf-ccamp-microwave-framework].
3. YANG Data Model (Tree Structure) 3. Microwave Radio Link YANG Data Model
3.1. the YANG Tree 3.1. YANG Tree
module: ietf-microwave-radio-link module: ietf-microwave-radio-link
+--rw radio-link-protection-groups +--rw radio-link-protection-groups
| +--rw radio-link-protection-group* [name] | +--rw protection-group* [name]
| +--rw name string | +--rw name string
| +--rw protection-architecture-type? identityref | +--rw protection-architecture-type? identityref
| +--rw protection-operation-type? enumeration | +--rw protection-members* if:interface-ref
| +--rw working-entity* if:interface-ref | +--rw protection-operation-type? enumeration
| +--rw revertive-wait-to-restore? uint16 | +--rw working-entity* if:interface-ref
| +--rw radio-link-protection-members* if:interface-ref | +--rw revertive-wait-to-restore? uint16
| +---x protection-external-commands | +--rw hold-off-timer? uint16
| +---w input | +--rw protection-status? identityref
| +---w protection-external-command? identityref | +---x protection-external-commands
+--ro radio-link-protection-groups-state | +---w input
| +--ro radio-link-protection-group* [name] | +---w protection-external-command? identityref
| +--ro name string +--rw xpic-pairs {xpic}?
| +--ro protection-status? identityref | +--rw xpic-pair* [name]
+--rw xpic-pairs {xpic}? | +--rw name string
| +--rw xpic-pair* [name] | +--rw enabled? boolean
| +--rw name string | +--rw xpic-members* if:interface-ref
| +--rw enabled? boolean +--rw mimo-groups {mimo}?
| +--rw xpic-members* if:interface-ref +--rw mimo-group* [name]
+--rw mimo-groups {mimo}? +--rw name string
+--rw mimo-group* [name] +--rw enabled? boolean
+--rw name string +--rw mimo-members* if:interface-ref
+--rw enabled? boolean augment /if:interfaces/if:interface:
+--rw mimo-members* if:interface-ref +--rw id? string
augment /if:interfaces/if:interface: +--rw mode identityref
+--rw id? string +--rw carrier-terminations* if:interface-ref
+--rw mode identityref +--rw rlp-groups*
+--rw carrier-terminations* if:interface-ref | -> /radio-link-protection-groups/protection-group/name
+--rw rlp-groups* leafref +--rw xpic-pairs* -> /xpic-pairs/xpic-pair/name
+--rw xpic-pairs* | {xpic}?
-> /xpic-pairs/xpic-pair/name {xpic}? +--rw mimo-groups* -> /mimo-groups/mimo-group/name
+--rw mimo-group? | {mimo}?
-> /mimo-groups/mimo-group/name {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
+--rw tx-frequency uint32 +--rw tx-frequency uint32
+--rw rx-frequency? uint32 +--rw rx-frequency? uint32
+--rw duplex-distance? uint32 +--rw duplex-distance? uint32
+--rw channel-separation uint32 +--rw channel-separation uint32
+--rw polarization? enumeration +--rw polarization? enumeration
+--rw power-mode enumeration +--rw power-mode enumeration
+--rw selected-output-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
+--rw coding-modulation-mode enumeration +--ro actual-transmitted-level? power
+--rw selected-cm identityref +--ro actual-received-level? power
+--rw selected-min-acm identityref +--rw coding-modulation-mode enumeration
+--rw selected-max-acm identityref +--rw selected-cm identityref
+--rw if-loop? enumeration +--rw selected-min-acm identityref
+--rw rf-loop? enumeration +--rw selected-max-acm identityref
+--rw ct-performance-thresholds +--ro actual-tx-cm? identityref
+--rw received-level-alarm-threshold? power +--ro actual-snir? decimal64
+--rw transmitted-level-alarm-threshold? power +--ro actual-xpi? decimal64 {xpic}?
+--rw ber-alarm-threshold? enumeration +--rw ct-performance-thresholds
augment /if:interfaces-state/if:interface: | +--rw received-level-alarm-threshold? power
+--ro tx-oper-status? enumeration | +--rw transmitted-level-alarm-threshold? power
+--ro actual-transmitted-level? power | +--rw ber-alarm-threshold? enumeration
+--ro actual-received-level? power +--rw if-loop? enumeration
+--ro actual-tx-cm? identityref +--rw rf-loop? enumeration
+--ro actual-snir? decimal64 +--ro capabilities
+--ro actual-xpi? decimal64 {xpic}? | +--ro min-tx-frequency? uint32
+--ro capabilities | +--ro max-tx-frequency? uint32
+--ro min-tx-frequency? uint32 | +--ro min-rx-frequency? uint32
+--ro max-tx-frequency? uint32 | +--ro max-rx-frequency? uint32
+--ro min-rx-frequency? uint32 | +--ro minimum-power? power
+--ro max-rx-frequency? uint32 | +--ro maximum-available-power? power
+--ro available-min-output-power? power | +--ro available-min-acm? identityref
+--ro available-max-output-power? power | +--ro available-max-acm? identityref
+--ro available-min-acm? identityref +--ro error-performance-statistics
+--ro available-max-acm? identityref | +--ro bbe? yang:counter32
augment /if:interfaces-state/if:interface/if:statistics: | +--ro es? yang:counter32
+--ro bbe? yang:counter32 | +--ro ses? yang:counter32
+--ro es? yang:counter32 | +--ro uas? yang:counter32
+--ro ses? yang:counter32 +--ro radio-performance-statistics
+--ro uas? yang:counter32 +--ro min-rltm? power
+--ro min-rltm? power +--ro max-rltm? power
+--ro max-rltm? power +--ro min-tltm? power
+--ro min-tltm? power +--ro max-tltm? power
+--ro max-tltm? power
3.2. Explanation of the Microwave Data Model 3.2. Explanation of the Microwave Data Model
The leaves in the Interface Management Module augmented by Radio Link The leafs in the Interface Management Module augmented by Radio Link
Terminal (RLT) and Carrier Termination (CT) are not always relevant. Terminal (RLT) and Carrier Termination (CT) are not always
applicable.
"/interfaces/interface/enabled" is not relevant for RLT. Enable and "/interfaces/interface/enabled" is not applicable for RLT. Enable and
disable of an interface is done in the constituent CTs. disable of an interface is done in the constituent CTs.
The packet related measurements "in-octets", "in-unicast-pkts", "in- The packet related measurements "in-octets", "in-unicast-pkts", "in-
broadcast-pkts", "in-multicast-pkts", "in-discards", "in-errors", broadcast-pkts", "in-multicast-pkts", "in-discards", "in-errors",
"in-unknown-protos", "out-octets", "out-unicast-pkts", "out- "in-unknown-protos", "out-octets", "out-unicast-pkts", "out-
broadcast-pkts", "out-multicast-pkts", "out-discards", "out-errors" broadcast-pkts", "out-multicast-pkts", "out-discards", "out-errors"
are not within the scope of the microwave radio link domain and are not within the scope of the microwave radio link domain and
therefore not relevant for RLT and CT. therefore not applicable for RLT and CT.
4. YANG Module 4. Microwave Radio Link YANG Module
<CODE BEGINS> file "ietf-microwave-radio-link.yang" <CODE BEGINS> file "ietf-microwave-radio-link.yang"
module ietf-microwave-radio-link { module ietf-microwave-radio-link {
yang-version 1.1; yang-version 1.1;
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";
import ietf-yang-types { import ietf-yang-types {
prefix yang; prefix yang;
} }
import ietf-interfaces { import ietf-interfaces {
prefix if; prefix if;
} }
import ietf-interface-protection {
prefix ifprot;
}
import iana-if-type { import iana-if-type {
prefix ianaift; prefix ianaift;
} }
organization organization
"Internet Engineering Task Force (IETF) CCAMP WG"; "Internet Engineering Task Force (IETF) CCAMP WG";
contact contact
" "WG List: <mailto:ccamp@ietf.org>
WG List: <mailto:ccamp@ietf.org>
ID-draft authors: ID-draft authors:
Jonas Ahlberg (jonas.ahlberg@ericsson.com); Jonas Ahlberg (jonas.ahlberg@ericsson.com);
Min Ye (amy.yemin@huawei.com); Min Ye (amy.yemin@huawei.com);
Xi Li (Xi.Li@neclab.eu); Xi Li (Xi.Li@neclab.eu);
Koji Kawada (k-kawada@ah.jp.nec.com) Koji Kawada (k-kawada@ah.jp.nec.com)
Carlos J. Bernardos (cjbc@it.uc3m.es) Carlos J. Bernardos (cjbc@it.uc3m.es)
Daniela Spreafico (daniela.spreafico@nokia.com) Daniela Spreafico (daniela.spreafico@nokia.com)
Marko Vaupotic (Marko.Vaupotic@aviatnet.com) Marko Vaupotic (Marko.Vaupotic@aviatnet.com)";
";
description description
"This is a module for the entities in a generic microwave system."; "This is a module for the entities in
a generic microwave system.";
revision 2017-10-23 {
description
"Break out protection functionality to a generic module
and update to follow the new NMDA style.";
reference "";
}
revision 2017-06-21 { revision 2017-06-21 {
description description
"Updated draft revision with updates of some descriptions to "Updated draft revision with updates of some descriptions to
increase clarity and some minor adjustments of the model."; increase clarity and some minor adjustments of the model.";
reference ""; reference "";
} }
revision 2016-12-22 { revision 2016-12-22 {
description description
"Draft revision covering a complete scope for configuration "Draft revision covering a complete scope for configuration
and state data for radio link interfaces."; and state data for radio link interfaces.";
skipping to change at page 7, line 33 skipping to change at page 7, line 29
reference ""; reference "";
} }
/* /*
* Features * Features
*/ */
feature xpic { feature xpic {
description description
"Indicates that the device supports XPIC."; "Indicates that the device supports XPIC.";
reference "ETSI TR 102 311";
} }
feature mimo { feature mimo {
description description
"Indicates that the device supports MIMO."; "Indicates that the device supports MIMO.";
reference "ETSI TR 102 311";
} }
feature tdm { feature tdm {
description description
"Indicates that the device supports TDM."; "Indicates that the device supports TDM.";
} }
/* /*
* Interface identities * Interface identities
*/ */
skipping to change at page 13, line 35 skipping to change at page 13, line 29
"4096 QAM coding and modulation scheme."; "4096 QAM coding and modulation scheme.";
} }
identity qam-4096-light { identity qam-4096-light {
base coding-modulation; base coding-modulation;
description description
"4096 QAM light coding and modulation scheme."; "4096 QAM light coding and modulation scheme.";
} }
/* /*
* Protection architecture type identities
*/
identity protection-architecture-type {
description
"protection architecture type";
}
identity one-plus-one-type {
base protection-architecture-type;
description
"One carrier termination and
one protecting carrier termination.";
}
identity one-to-n-type {
base protection-architecture-type;
description
"One carrier termination protecting
n other carrier terminations.";
}
/*
* Protection states identities
*/
identity protection-states {
description
"Identities describing the status of the protection,
in a group of carrier terminations configured in
a radio link 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-external-commands identities
*/
identity protection-external-commands{
description
"Protection external commands for trouble shooting purpose.";
}
identity manual-switch{
base protection-external-commands;
description
"A switch action initiated by an operator command. It switches
normal traffic signal to the protection transport entity.";
}
identity forced-switch{
base protection-external-commands;
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 orignal entity are fulfilled.";
}
/*
* TDM-type identities * TDM-type identities
*/ */
identity tdm-type { identity tdm-type {
description description
"A description of the type of TDM connection, "A description of the type of TDM connection,
also indicating the supported capacity of the also indicating the supported capacity of the
connection."; connection.";
} }
skipping to change at page 15, line 47 skipping to change at page 14, line 17
typedef power { typedef power {
type decimal64 { type decimal64 {
fraction-digits 1; fraction-digits 1;
} }
description description
"Type used for power values, selected and measured."; "Type used for power values, selected and measured.";
} }
/* /*
* Radio Link Terminal (RLT) - Configuration data nodes * Radio Link Terminal (RLT)
*/ */
augment "/if:interfaces/if:interface" { augment "/if:interfaces/if:interface" {
when "if:type = 'mrl:radio-link-terminal'"; when "if:type = 'mrl:radio-link-terminal'";
description description
"Addition of data nodes for radio link terminal to "Addition of data nodes for radio link terminal to
the standard Interface data model, for interfaces of the standard Interface data model, for interfaces of
the type 'radio-link-terminal'."; the type 'radio-link-terminal'.";
leaf id { leaf id {
skipping to change at page 16, line 47 skipping to change at page 15, line 21
} }
min-elements 1; min-elements 1;
description description
"A list of references to carrier terminations "A list of references to carrier terminations
included in the radio link terminal."; included in the radio link terminal.";
} }
leaf-list rlp-groups { leaf-list rlp-groups {
type leafref { type leafref {
path "/mrl:radio-link-protection-groups/" path "/mrl:radio-link-protection-groups/"
+ "mrl:radio-link-protection-group/mrl:name"; + "mrl:protection-group/mrl:name";
} }
description description
"A list of references to the carrier termination "A list of references to the carrier termination
groups configured for radio link protection in this groups configured for radio link protection in this
radio link terminal."; radio link terminal.";
} }
leaf-list xpic-pairs { leaf-list xpic-pairs {
if-feature xpic; if-feature xpic;
type leafref { type leafref {
path "/mrl:xpic-pairs/mrl:xpic-pair/mrl:name"; path "/mrl:xpic-pairs/mrl:xpic-pair/mrl:name";
} }
description description
"A list of references to the XPIC pairs used in this "A list of references to the XPIC pairs used in this
radio link terminal. One pair can be used by two radio link terminal. One pair can be used by two
terminals."; terminals.";
reference "ETSI TR 102 311";
} }
leaf mimo-group { leaf-list mimo-groups {
if-feature mimo; if-feature mimo;
type leafref { type leafref {
path "/mrl:mimo-groups/mrl:mimo-group/mrl:name"; path "/mrl:mimo-groups/mrl:mimo-group/mrl:name";
} }
description description
"A reference to the MIMO group used in this "A reference to the MIMO group used in this
radio link terminal. One group can be used by more radio link terminal. One group can be used by more
than one terminal."; than one terminal.";
reference "ETSI TR 102 311";
} }
list tdm-connections { list tdm-connections {
if-feature tdm; if-feature tdm;
key "tdm-type"; key "tdm-type";
description description
"A list stating the number of active TDM connections of "A list stating the number of active TDM connections
a specified tdm-type that is configured to be supported of a specified tdm-type that is configured to be
by the RLT."; supported by the RLT.";
leaf tdm-type { leaf tdm-type {
type identityref { type identityref {
base tdm-type; base tdm-type;
} }
description description
"The type of TDM connection, which also indicates "The type of TDM connection, which also indicates
the supported capacity."; the supported capacity.";
} }
leaf tdm-connections { leaf tdm-connections {
type uint16; type uint16;
mandatory true; mandatory true;
description "Number of connections of the specified type."; description
"Number of connections of the specified type.";
} }
} }
} }
/* /*
* Carrier Termination - Configuration data nodes * Carrier Termination
*/ */
augment "/if:interfaces/if:interface" { augment "/if:interfaces/if:interface" {
when "if:type = 'mrl:carrier-termination'"; when "if:type = 'mrl:carrier-termination'";
description description
"Addition of data nodes for carrier termination to the "Addition of data nodes for carrier termination to
standard Interface data model, for interfaces of the type the standard Interface data model, for interfaces
'carrier-termination'."; of the type 'carrier-termination'.";
leaf carrier-id { leaf carrier-id {
type string; type string;
default "A"; default "A";
description description
"ID of the carrier. (e.g. A, B, C or D) "ID of the carrier. (e.g. A, B, C or D)
Used in XPIC & MIMO configurations to check that the Used in XPIC & MIMO configurations to check that
carrier termination is connected to the correct far-end the carrier termination is connected to the correct
carrier termination. Should be the same carrier ID on far-end carrier termination. Should be the same
both sides of the hop. carrier ID on both sides of the hop.
Defaulted when not MIMO or XPIC."; Defaulted when not MIMO or XPIC.";
} }
leaf tx-enabled { leaf tx-enabled {
type boolean; type boolean;
default "false"; default "false";
description description
"Disables (false) or enables (true) the transmitter. "Disables (false) or enables (true) the transmitter.
Only applicable when the interface is enabled Only applicable when the interface is enabled
(interface:enabled = true) otherwise it's always (interface:enabled = true) otherwise it's always
disabled."; disabled.";
} }
skipping to change at page 18, line 37 skipping to change at page 17, line 14
leaf tx-enabled { leaf tx-enabled {
type boolean; type boolean;
default "false"; default "false";
description description
"Disables (false) or enables (true) the transmitter. "Disables (false) or enables (true) the transmitter.
Only applicable when the interface is enabled Only applicable when the interface is enabled
(interface:enabled = true) otherwise it's always (interface:enabled = true) otherwise it's always
disabled."; disabled.";
} }
leaf tx-oper-status {
type enumeration {
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 { leaf tx-frequency {
type uint32; type uint32;
units "kHz"; units "kHz";
mandatory true; mandatory true;
description description
"Selected transmitter frequency."; "Selected transmitter frequency.";
} }
leaf rx-frequency { leaf rx-frequency {
type uint32; type uint32;
skipping to change at page 19, line 28 skipping to change at page 18, line 23
rx-frequency is configured. rx-frequency is configured.
Must match rx-frequency if both leaves are configured Must match rx-frequency if both leaves are configured
in a single operation."; in a single operation.";
} }
leaf channel-separation { leaf channel-separation {
type uint32; type uint32;
units "kHz"; units "kHz";
mandatory true; mandatory true;
description description
"The amount of bandwidth allocated to a carrier."; "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 { leaf polarization {
type enumeration { type enumeration {
enum "horizontal" { enum "horizontal" {
description "Horizontal polarization."; description "Horizontal polarization.";
} }
enum "vertical" { enum "vertical" {
description "Vertical polarization."; description "Vertical polarization.";
} }
skipping to change at page 19, line 51 skipping to change at page 18, line 49
} }
} }
default "not-specified"; default "not-specified";
description description
"Polarization - A textual description for info only."; "Polarization - A textual description for info only.";
} }
leaf power-mode { leaf power-mode {
type enumeration { type enumeration {
enum rtpc { enum rtpc {
description "Remote Transmit Power Control (RTPC)."; description
"Remote Transmit Power Control (RTPC).";
reference "ETSI EN 302 217-1";
} }
enum atpc { enum atpc {
description "Automatic Transmit Power Control (ATPC)."; description
"Automatic Transmit Power Control (ATPC).";
reference "ETSI EN 302 217-1";
} }
} }
mandatory true; mandatory true;
description description
"A choice of Remote Transmit Power Control (RTPC) "A choice of Remote Transmit Power Control (RTPC)
or Automatic Transmit Power Control (ATPC)."; or Automatic Transmit Power Control (ATPC).";
} }
leaf selected-output-power { leaf maximum-nominal-power {
type power { type power {
range "-99..40"; range "-99..40";
} }
units "dBm"; units "dBm";
mandatory true; mandatory true;
description description
"Selected output power in RTPC mode and selected maximum "Selected output power in RTPC mode and selected
output power in ATPC mode. Minimum ouput power in ATPC mode maximum output power in ATPC mode. Minimum ouput
is the same as the system capability, power in ATPC mode is the same as the system
available-min-output-power."; capability, available-min-output-power.";
reference "ETSI EN 302 217-1";
} }
leaf atpc-lower-threshold { leaf atpc-lower-threshold {
when "../power-mode = 'atpc'"; when "../power-mode = 'atpc'";
type power { type power {
range "-99..-30"; range "-99..-30";
} }
units "dBm"; units "dBm";
mandatory true; mandatory true;
description description
"The lower threshold for the input power at far-end used in "The lower threshold for the input power at far-end
the ATPC mode."; used in the ATPC mode.";
reference "ETSI EN 302 217-1";
} }
leaf atpc-upper-threshold { leaf atpc-upper-threshold {
when "../power-mode = 'atpc'"; when "../power-mode = 'atpc'";
type power { type power {
range "-99..-30"; range "-99..-30";
} }
units "dBm"; units "dBm";
mandatory true; mandatory true;
description description
"The upper threshold for the input power at far-end used in "The upper threshold for the input power at far-end
the ATPC mode."; used in the ATPC mode.";
reference "ETSI EN 302 217-1";
} }
leaf actual-transmitted-level {
type power {
range "-99..40";
}
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";
}
leaf coding-modulation-mode { leaf coding-modulation-mode {
type enumeration { type enumeration {
enum fixed { enum single {
description "Fixed coding/modulation."; description "a single modulation order only.";
reference "ETSI EN 302 217-1";
} }
enum adaptive { enum adaptive {
description "Adaptive coding/modulation."; description "Adaptive coding/modulation.";
reference "ETSI EN 302 217-1";
} }
} }
mandatory true; mandatory true;
description description
"A selection of fixed or "A selection of single or
adaptive coding/modulation mode."; adaptive coding/modulation mode.";
} }
leaf selected-cm { leaf selected-cm {
when "../coding-modulation-mode = 'fixed'"; when "../coding-modulation-mode = 'single'";
type identityref { type identityref {
base coding-modulation; base coding-modulation;
} }
mandatory true; mandatory true;
description description
"Selected fixed coding/modulation."; "Selected the single coding/modulation.";
} }
leaf selected-min-acm { leaf selected-min-acm {
when "../coding-modulation-mode = 'adaptive'"; when "../coding-modulation-mode = 'adaptive'";
type identityref { type identityref {
base coding-modulation; base coding-modulation;
} }
mandatory true; mandatory true;
description description
"Selected minimum coding/modulation. "Selected minimum coding/modulation.
Adaptive coding/modulation shall not go Adaptive coding/modulation shall not go
below this value."; below this value.";
skipping to change at page 22, line 4 skipping to change at page 21, line 27
when "../coding-modulation-mode = 'adaptive'"; when "../coding-modulation-mode = 'adaptive'";
type identityref { type identityref {
base coding-modulation; base coding-modulation;
} }
mandatory true; mandatory true;
description description
"Selected maximum coding/modulation. "Selected maximum coding/modulation.
Adaptive coding/modulation shall not go Adaptive coding/modulation shall not go
above this value."; above this value.";
} }
leaf if-loop {
type enumeration { leaf actual-tx-cm {
enum disabled { type identityref {
description "Disables the IF Loop."; base coding-modulation;
}
enum client {
description "Loops the signal back to the client side.";
}
enum radio {
description "Loops the signal back to the radio side.";
}
} }
default "disabled"; config false;
description description
"Enable (client/radio) or disable (disabled) the IF loop, "Actual coding/modulation in transmitting direction.";
which loops the signal back to the client side or
the radio side.";
} }
leaf rf-loop { leaf actual-snir {
type enumeration { type decimal64 {
enum disabled { fraction-digits 1;
description "Disables the RF Loop."; range "0..99";
}
enum client {
description "Loops the signal back to the client side.";
}
enum radio {
description "Loops the signal back to the radio side.";
}
} }
default "disabled"; units "dB";
config false;
description description
"Enable (client/radio) or disable (disabled) the RF loop, "Actual signal to noise plus interference ratio.
which loops the signal back to the client side or (0.1 dB resolution).";
the radio side."; }
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 { container ct-performance-thresholds {
description description
"Specification of thresholds for when alarms should "Specification of thresholds for when alarms should
be sent and cleared for various performance counters."; be sent and cleared for various performance counters.";
leaf received-level-alarm-threshold { leaf received-level-alarm-threshold {
type power { type power {
range "-99..-30"; range "-99..-30";
} }
units "dBm"; units "dBm";
default "-99"; default "-99";
description description
"An alarm is sent when the received power level is "An alarm is sent when the received power level is
below the specified threshold."; below the specified threshold.";
reference "ETSI EN 301 129";
} }
leaf transmitted-level-alarm-threshold { leaf transmitted-level-alarm-threshold {
type power { type power {
range "-99..40"; range "-99..40";
} }
units "dBm"; units "dBm";
default "-99"; default "-99";
description description
"An alarm is sent when the transmitted power level is "An alarm is sent when the transmitted power level
below the specified threshold."; is below the specified threshold.";
reference "ETSI EN 301 129";
} }
leaf ber-alarm-threshold { leaf ber-alarm-threshold {
type enumeration { type enumeration {
enum "10e-9" { enum "10e-9" {
description "Threshold at 10e-9."; description "Threshold at 10e-9.";
} }
enum "10e-8" { enum "10e-8" {
description "Threshold at 10e-8."; description "Threshold at 10e-8.";
} }
skipping to change at page 24, line 7 skipping to change at page 23, line 24
description "Threshold at 10e-2."; description "Threshold at 10e-2.";
} }
enum "10e-1" { enum "10e-1" {
description "Threshold at 10e-1."; description "Threshold at 10e-1.";
} }
} }
default "10e-6"; default "10e-6";
description description
"Specification of at which BER an alarm should "Specification of at which BER an alarm should
be raised."; be raised.";
reference "ETSI EN 302 217-1";
} }
} }
}
/*
* Radio Link Terminal - Operational state data nodes
* Currently nothing in addition to the general
* interface-state model.
*/
/*
* Carrier Termination - Operational state data nodes
*/
augment "/if:interfaces-state/if:interface" {
when "if:type = 'mrl:carrier-termination'";
description
"Addition of state data nodes for carrier termination to
the standard Interface state data model, for interfaces of
the type 'carrier-termination'.";
leaf tx-oper-status { leaf if-loop {
type enumeration { type enumeration {
enum "off" { enum disabled {
description "Transmitter is off."; description "Disables the IF Loop.";
} }
enum "on" { enum client {
description "Transmitter is on."; description
"Loops the signal back to the client side.";
} }
enum "standby" { enum radio {
description "Transmitter is in standby."; description
"Loops the signal back to the radio side.";
} }
} }
default "disabled";
description description
"Shows the operative status of the transmitter."; "Enable (client/radio) or disable (disabled)
} the IF loop, which loops the signal back to
the client side or the radio side.";
leaf actual-transmitted-level {
type power {
range "-99..40";
}
units "dBm";
description
"Actual transmitted power level (0.1 dBm resolution).";
}
leaf actual-received-level {
type power {
range "-99..-20";
}
units "dBm";
description
"Actual received power level (0.1 dBm resolution).";
}
leaf actual-tx-cm {
type identityref {
base coding-modulation;
}
description
"Actual coding/modulation in transmitting direction.";
}
leaf actual-snir {
type decimal64 {
fraction-digits 1;
range "0..99";
}
units "dB";
description
"Actual signal to noise plus interference ratio.
(0.1 dB resolution).";
} }
leaf actual-xpi { leaf rf-loop {
if-feature xpic; type enumeration {
type decimal64 { enum disabled {
fraction-digits 1; description "Disables the RF Loop.";
range "0..99"; }
enum client {
description
"Loops the signal back to the client side.";
}
enum radio {
description
"Loops the signal back to the radio side.";
}
} }
units "dB"; default "disabled";
description description
"The actual carrier to cross-polar interference. "Enable (client/radio) or disable (disabled)
Only valid if XPIC is enabled. (0.1 dB resolution)."; the RF loop, which loops the signal back to
the client side or the radio side.";
} }
container capabilities { container capabilities {
config false;
description description
"Capabilities of the the installed equipment and "Capabilities of the the installed equipment and
some selected configurations."; some selected configurations.";
leaf min-tx-frequency { leaf min-tx-frequency {
type uint32; type uint32;
units "kHz"; units "kHz";
description description
"Minimum Tx frequency possible to use."; "Minimum Tx frequency possible to use.";
} }
skipping to change at page 26, line 28 skipping to change at page 25, line 4
description description
"Minimum Rx frequency possible to use."; "Minimum Rx frequency possible to use.";
} }
leaf max-rx-frequency { leaf max-rx-frequency {
type uint32; type uint32;
units "kHz"; units "kHz";
description description
"Maximum Tx frequency possible to use."; "Maximum Tx frequency possible to use.";
} }
leaf minimum-power {
leaf available-min-output-power {
type power; type power;
units "dBm"; units "dBm";
description description
"The minimum output power supported."; "The minimum output power supported.";
reference "ETSI EN 302 217-1";
} }
leaf available-max-output-power { leaf maximum-available-power {
type power; type power;
units "dBm"; units "dBm";
description description
"The maximum output power supported."; "The maximum output power supported.";
reference "ETSI EN 302 217-1";
} }
leaf available-min-acm { leaf available-min-acm {
type identityref { type identityref {
base coding-modulation; base coding-modulation;
} }
description description
"Minimum coding-modulation possible to use."; "Minimum coding-modulation possible to use.";
} }
leaf available-max-acm { leaf available-max-acm {
type identityref { type identityref {
base coding-modulation; base coding-modulation;
} }
description description
"Maximum coding-modulation possible to use."; "Maximum coding-modulation possible to use.";
} }
} }
}
augment "/if:interfaces-state/if:interface/if:statistics" {
when "../if:type = 'mrl:carrier-termination'";
description
"Addition of state data nodes in the container statistics
for carrier terminations to the standard Interface data
model, for interfaces of the type 'carrier-termination'.";
leaf bbe {
type yang:counter32;
units "number of block errors";
description
"Number of Background Block Errors (BBE) during the
interval. A BBE is an errored block not occurring as
part of an SES.";
}
leaf es {
type yang:counter32;
units "seconds";
description
"Number of Errored Seconds (ES) since last reset.
An ES is a one-second period with one or more errored
blocks or at least one defect.";
}
leaf ses {
type yang:counter32;
units "seconds";
description
"Number of Severely Errored Seconds (SES) during the
interval. 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.";
}
leaf uas { container error-performance-statistics {
type yang:counter32; config false;
units "seconds";
description description
"Number of Unavailable Seconds (UAS), that is, the "ITU-T G.826 error performance statistics relevant for
total time that the node has been unavailable during a microwave/millimeter wave carrier.";
a fixed measurement interval.";
}
leaf min-rltm { leaf bbe {
type power { type yang:counter32;
range "-99..-20"; units "number of block errors";
description
"Number of Background Block Errors (BBE) during the
interval. A BBE is an errored block not occurring as
part of an SES.";
reference "ITU-T G.826";
} }
units "dBm"; leaf es {
description type yang:counter32;
"Minimum received power level since last reset."; units "seconds";
} description
"Number of Errored Seconds (ES) since last reset.
leaf max-rltm { An ES is a one-second period with one or more errored
type power { blocks or at least one defect.";
range "-99..-20"; reference "ITU-T G.826";
} }
units "dBm";
description
"Maximum received power level since last reset.";
}
leaf min-tltm { leaf ses {
type power { type yang:counter32;
range "-99..40"; units "seconds";
description
"Number of Severely Errored Seconds (SES) during the
interval. 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.";
reference "ITU-T G.826";
} }
units "dBm";
description
"Minimum transmitted power level since last reset.";
}
leaf max-tltm { leaf uas {
type power { type yang:counter32;
range "-99..40"; units "seconds";
description
"Number of Unavailable Seconds (UAS), that is, the
total time that the node has been unavailable during
a fixed measurement interval.";
reference "ITU-T G.826";
} }
units "dBm";
description
"Maximum transmitted power level since last reset.";
} }
}
/*
* Radio Link Protection Groups - Configuration data nodes
*/
container radio-link-protection-groups { container radio-performance-statistics {
description config false;
"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.";
list radio-link-protection-group {
key "name";
description description
"List of protected groups of carrier terminations "ETSI EN 301 129 radio physical interface statistics relevant
in a radio link."; for a carrier termination.";
leaf name {
type string;
description
"Name used for identification of the radio
link protection group";
}
leaf protection-architecture-type { leaf min-rltm {
type identityref{ type power {
base protection-architecture-type; range "-99..-20";
} }
default "one-plus-one-type"; units "dBm";
description description
"The type of protection architecture used, "Minimum received power level since last reset.";
e.g. one carrier termination protecting one or reference "ETSI EN 301 129";
several other carrier terminations.";
} }
leaf max-rltm {
leaf protection-operation-type { type power {
type enumeration { range "-99..-20";
enum "non-revertive" {
description
"In non revertive operation, the traffic
does not return to the working carrier termination
if the switch requests are terminated. ";
}
enum "revertive" {
description
"In revertive operation, the traffic always
returns to (or remains on) the working
carrier termination if the switch requests are
terminated. ";
}
} }
default "non-revertive"; units "dBm";
description description
"The type of protection operation, i.e. revertive "Maximum received power level since last reset.";
or non-revertive operation."; reference "ETSI EN 301 129";
} }
leaf-list working-entity { leaf min-tltm {
when "../protection-operation-type = 'revertive'"; type power {
type if:interface-ref; range "-99..40";
must "/if:interfaces/if:interface[if:name = current()]"
+ "/if:type = 'mrl:carrier-termination'" {
description
"The type of a working-entity must be
'carrier-termination'.";
} }
min-elements 1; units "dBm";
description
"The carrier terminations over which the traffic
normally should be transported over when there
is no need to use the protecting carrier termination.";
}
leaf revertive-wait-to-restore {
when "../protection-operation-type = 'revertive'";
type uint16;
units "seconds";
default "0";
description description
"The time to wait before switching back to the "Minimum transmitted power level since last reset.";
working carrier termination if protection-operation-type reference "ETSI EN 301 129";
is revertive.";
} }
leaf-list radio-link-protection-members { leaf max-tltm {
type if:interface-ref; type power {
must "/if:interfaces/if:interface[if:name = current()]" range "-99..40";
+ "/if:type = 'mrl:carrier-termination'" {
description
"The type of a protection member must be
'carrier-termination'.";
} }
min-elements 2; units "dBm";
description description
"Association to a group of carrier terminations "Maximum transmitted power level since last reset.";
configured for radio link protection and used in reference "ETSI EN 301 129";
the radio link terminal.";
}
action protection-external-commands {
input {
leaf protection-external-command {
type identityref {
base protection-external-commands;
}
description
"Execution of protection external commands for
trouble shooting purpose.";
}
}
} }
} }
} }
/* /*
* Radio Link Protection Groups - Operational state data nodes * Radio Link Protection Groups
*/ */
container radio-link-protection-groups-state { container radio-link-protection-groups {
config false;
description description
"State data for radio link protected groups of "Configuration of radio link protected groups (1+1) of
carrier terminations in a radio link."; carrier terminations in a radio link. More than one
protected group per radio-link-terminal is allowed.";
list radio-link-protection-group { uses ifprot:protection-groups {
key "name";
description
"List of protected groups of carrier terminations
in a radio link.";
leaf name { refine protection-group/protection-members {
type string; must "/if:interfaces/if:interface[if:name = current()]"
description + "/if:type = 'mrl:carrier-termination'" {
"Name used for identification of the radio description
link protection group."; "The type of a protection member must be
'carrier-termination'.";
}
} }
refine protection-group/working-entity {
leaf protection-status { must "/if:interfaces/if:interface[if:name = current()]"
type identityref { + "/if:type = 'mrl:carrier-termination'" {
base protection-states; description
"The type of a working-entity must be
'carrier-termination'.";
} }
description
"Status of the protection, in a group of carrier
terminations configured in a radio link protection
mode.";
} }
} }
} }
/* /*
* XPIC & MIMO groups - Configuration data nodes * XPIC & MIMO groups - Configuration data nodes
*/ */
container xpic-pairs { container xpic-pairs {
if-feature xpic; if-feature xpic;
description description
"Configuration of carrier termination pairs "Configuration of carrier termination pairs
for operation in XPIC mode."; for operation in XPIC mode.";
reference "ETSI TR 102 311";
list xpic-pair { list xpic-pair {
key "name"; key "name";
description description
"List of carrier termination pairs in XPIC mode."; "List of carrier termination pairs in XPIC mode.";
leaf name { leaf name {
type string; type string;
description description
"Name used for identification of the XPIC pair."; "Name used for identification of the XPIC pair.";
skipping to change at page 33, line 4 skipping to change at page 29, line 16
terminal."; terminal.";
} }
} }
} }
container mimo-groups { container mimo-groups {
if-feature mimo; if-feature mimo;
description description
"Configuration of carrier terminations "Configuration of carrier terminations
for operation in MIMO mode."; for operation in MIMO mode.";
reference "ETSI TR 102 311";
list mimo-group { list mimo-group {
key "name"; key "name";
description description
"List of carrier terminations in MIMO mode."; "List of carrier terminations in MIMO mode.";
leaf name { leaf name {
type string; type string;
description description
"Name used for identification of the MIMO group."; "Name used for identification of the MIMO group.";
skipping to change at page 33, line 37 skipping to change at page 29, line 50
description description
"The type of a mimo-member must be "The type of a mimo-member must be
'carrier-termination'."; 'carrier-termination'.";
} }
min-elements 2; min-elements 2;
description description
"Association to a MIMO group if used in the radio "Association to a MIMO group if used in the radio
link terminal."; 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.
<CODE BEGINS> file "ietf-interface-protection.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;
}
organization
"Internet Engineering Task Force (IETF) CCAMP WG";
contact
"WG List: <mailto:ccamp@ietf.org>
ID-draft authors:
Jonas Ahlberg (jonas.ahlberg@ericsson.com);
Min Ye (amy.yemin@huawei.com);
Xi Li (Xi.Li@neclab.eu);
Koji Kawada (k-kawada@ah.jp.nec.com)
Carlos J. Bernardos (cjbc@it.uc3m.es)
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.";
revision 2017-10-19 {
description
"Draft revision.";
reference "";
}
/*
* Protection architecture type identities
*/
identity protection-architecture-type {
description
"protection architecture type";
reference "ITU-T Rec. G.808.1";
}
identity one-plus-one-type {
base protection-architecture-type;
description
"1+1, One interface protects
another one interface.";
reference "ITU-T Rec. G.808.1";
}
identity one-to-n-type {
base protection-architecture-type;
description
"1:N, One interface protects
n other interfaces.";
reference "ITU-T Rec. G.808.1";
}
/*
* 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-external-commands identities
*/
identity protection-external-commands{
description
"Protection external commands for trouble shooting
purpose.";
reference "ITU-T Rec. G.808.1";
}
identity manual-switch-working{
base protection-external-commands;
description
"A switch action initiated by an operator command.
It switches normal traffic signal to the working
transport entity.";
reference "ITU-T Rec. G.808.1";
}
identity manual-switch-protection{
base protection-external-commands;
description
"A switch action initiated by an operator command.
It switches normal traffic signal to the protection
transport entity.";
reference "ITU-T Rec. G.808.1";
}
identity forced-switch{
base protection-external-commands;
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 orignal entity are fulfilled.";
reference "ITU-T Rec. G.808.1";
}
identity lockout-of-protection{
base protection-external-commands;
description
"A switch action temporarily disables access to the
protection transport entity for all signals.";
reference "ITU-T Rec. G.808.1";
}
identity freeze{
base protection-external-commands;
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 Rec. G.808.1";
}
identity exercise{
base protection-external-commands;
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 Rec. G.808.1";
}
identity clear{
base protection-external-commands;
description
"A action clears all switch commands.";
reference "ITU-T Rec. G.808.1";
}
/*
* 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 {
type identityref{
base protection-architecture-type;
}
default "one-plus-one-type";
description
"The type of protection architecture used, e.g. one
interface protecting one or several other interfaces.";
reference "ITU-T Rec. G.808.1";
}
leaf-list protection-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 protection-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 Rec. 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 Rec. G.808.1";
}
}
default "non-revertive";
description
"The type of protection operation, i.e. revertive
or non-revertive operation.";
}
leaf-list working-entity {
when "../protection-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
protecting interface.";
}
leaf revertive-wait-to-restore {
when "../protection-operation-type = 'revertive'";
type uint16;
units "seconds";
default "0";
description
"The time to wait before switching back to the working
interface if protection-operation-type is revertive.";
reference "ITU-T Rec. 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 Rec. G.808.1";
}
leaf protection-status {
type identityref {
base protection-states;
}
description
"Status of the protection, in a group of interfaces
configured in a protection mode.";
reference "ITU-T Rec. G.808.1";
}
action protection-external-commands {
input {
leaf protection-external-command {
type identityref {
base protection-external-commands;
}
description
"Execution of protection external commands for
trouble shooting purpose.";
}
}
}
}
}
} }
<CODE ENDS> <CODE ENDS>
5. Security Considerations 6. Security Considerations
The YANG module defined in this memo is designed to be accessed via The YANG module defined in this memo is designed to be accessed via
the NETCONF protocol [RFC6241]. The lowest NETCONF layer is the the NETCONF protocol [RFC6241]. The lowest NETCONF layer is the
secure transport layer and the mandatory-to-implement secure secure transport layer and the mandatory-to-implement secure
transport is SSH [RFC6242]. The NETCONF access control model transport is SSH [RFC6242]. The NETCONF access control model
[RFC6536] provides the means to restrict access for particular [RFC6536] provides the means to restrict access for particular
NETCONF users to a pre-configured subset of all available NETCONF NETCONF users to a pre-configured subset of all available NETCONF
protocol operations and content. protocol operations and content.
There are a number of data nodes defined in the YANG module which are There are a number of data nodes defined in the YANG module which are
writable/creatable/deletable (i.e., config true, which is the writable/creatable/deletable (i.e., config true, which is the
default). These data nodes may be considered sensitive or vulnerable default). These data nodes may be considered sensitive or vulnerable
in some network environments. Write operations (e.g., <editconfig>) in some network environments. Write operations (e.g., <editconfig>)
to these data nodes without proper protection can have a negative to these data nodes without proper protection can have a negative
effect on network operations. effect on network operations.
The security considerations of [RFC7223] also apply to this document. The security considerations of [RFC7223bis] also apply to this
document.
6. IANA Considerations 7. IANA Considerations
TBD. TBD.
7. References 8. References
7.1. Normative References 8.1. Normative References
[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,
<http://www.rfc-editor.org/info/rfc2119>. <http://www.rfc-editor.org/info/rfc2119>.
[RFC7223] Bjorklund, M., "A YANG Data Model for Interface [RFC7223bis]
Management", RFC 7223, DOI 10.17487/RFC7223, May 2014, Bjorklund, M., "A YANG Data Model for Interface
<http://www.rfc-editor.org/info/rfc7223>. Management", draft-bjorklund-netmod-rfc7223bis-00
(work in progress), September 2017.
[EN 302 217-2] [EN 302 217-2]
ETSI, "Fixed Radio Systems; Characteristics and ETSI, "Fixed Radio Systems; Characteristics and
requirements for point to-point equipment and antennas; requirements for point to-point equipment and antennas;
Part 2: Digital systems operating in frequency bands from Part 2: Digital systems operating in frequency bands from
1 GHz to 86 GHz; Harmonised Standard covering the 1 GHz to 86 GHz; Harmonised Standard covering the
essential requirements of article 3.2 of Directive essential requirements of article 3.2 of Directive
2014/53/EU", EN 302 217-2 V3.1.1, May 2017. 2014/53/EU", EN 302 217-2 V3.1.1, May 2017.
7.2. Informative References 8.2. Informative References
[NMDA] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K.,
Wilton, R. "Network Management Datastore Architecture",
draft-ietf-netmod-revised-datastores-05 (work in
progress), October 2017.
[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., Contreras, L., Ye, M., Vaupotic, M., Ahlberg, J., Contreras, L., Ye, M., Vaupotic, M.,
Tantsura, J., Kawada, K., Li, X., Akiyoshi, I., and C. Tantsura, J., Kawada, K., Li, X., Akiyoshi, I., C.
Bernardos, "A framework for Management and Control of Bernardos, and D. Spreafico, "A framework for Management
microwave and millimeter wave interface parameters", and Control of microwave and millimeter wave interface
draft-ietf-ccamp-microwave-framework-01 (work in parameters", draft-ietf-ccamp-microwave-framework-02
progress), June 2017. (work in progress), October 2017.
[ONF-model] "Microwave Modeling - ONF Wireless Transport Group", [ONF-model] "Microwave Modeling - ONF Wireless Transport Group",
May 2016. May 2016.
[RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed., [RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed.,
and A. Bierman, Ed., "Network Configuration Protocol and A. Bierman, Ed., "Network Configuration Protocol
(NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011, (NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011,
<http://www.rfc-editor.org/info/rfc6241>. <http://www.rfc-editor.org/info/rfc6241>.
[RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure [RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure
 End of changes. 128 change blocks. 
551 lines changed or deleted 701 lines changed or added

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