summaryrefslogtreecommitdiff
path: root/doc/rfc/rfc9656.txt
diff options
context:
space:
mode:
authorThomas Voss <mail@thomasvoss.com> 2024-11-27 20:54:24 +0100
committerThomas Voss <mail@thomasvoss.com> 2024-11-27 20:54:24 +0100
commit4bfd864f10b68b71482b35c818559068ef8d5797 (patch)
treee3989f47a7994642eb325063d46e8f08ffa681dc /doc/rfc/rfc9656.txt
parentea76e11061bda059ae9f9ad130a9895cc85607db (diff)
doc: Add RFC documents
Diffstat (limited to 'doc/rfc/rfc9656.txt')
-rw-r--r--doc/rfc/rfc9656.txt2114
1 files changed, 2114 insertions, 0 deletions
diff --git a/doc/rfc/rfc9656.txt b/doc/rfc/rfc9656.txt
new file mode 100644
index 0000000..7ce27aa
--- /dev/null
+++ b/doc/rfc/rfc9656.txt
@@ -0,0 +1,2114 @@
+
+
+
+
+Internet Engineering Task Force (IETF) S. Mansfield, Ed.
+Request for Comments: 9656 Ericsson Inc
+Category: Standards Track J. Ahlberg
+ISSN: 2070-1721 Ericsson AB
+ M. Ye
+ Huawei Technologies
+ X. Li
+ NEC Laboratories Europe
+ D. Spreafico
+ Nokia - IT
+ September 2024
+
+
+ A YANG Data Model for Microwave Topology
+
+Abstract
+
+ This document defines a YANG data model to describe microwave and
+ millimeter-wave radio links in a network topology.
+
+Status of This Memo
+
+ This is an Internet Standards Track document.
+
+ This document is a product of the Internet Engineering Task Force
+ (IETF). It represents the consensus of the IETF community. It has
+ received public review and has been approved for publication by the
+ Internet Engineering Steering Group (IESG). Further information on
+ Internet Standards is available in Section 2 of RFC 7841.
+
+ Information about the current status of this document, any errata,
+ and how to provide feedback on it may be obtained at
+ https://www.rfc-editor.org/info/rfc9656.
+
+Copyright Notice
+
+ Copyright (c) 2024 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 Revised BSD License text as described in Section 4.e of the
+ Trust Legal Provisions and are provided without warranty as described
+ in the Revised BSD License.
+
+Table of Contents
+
+ 1. Introduction
+ 1.1. Abbreviations
+ 1.2. Tree Structure
+ 1.3. Prefixes in Data Node Names
+ 2. Microwave Topology YANG Data Model
+ 2.1. YANG Tree
+ 2.2. Relationship between Radio Links and Carriers
+ 2.3. Relationship with Client Topology Model
+ 2.4. Applicability of the Data Model for Traffic Engineering
+ (TE) Topologies
+ 2.5. Microwave Topology YANG Module
+ 3. Security Considerations
+ 4. IANA Considerations
+ 5. References
+ 5.1. Normative References
+ 5.2. Informative References
+ Appendix A. Microwave Topology Model with Base Topology Models
+ A.1. Instance Data for 2+0 Mode for a Bonded Configuration
+ A.2. Instance Data for 1+1 Mode for a Protected Configuration
+ Appendix B. Microwave Topology Model with Example Extensions
+ B.1. Instance Data for 2+0 Mode
+ B.2. Instance Data for Geolocation Information
+ Acknowledgments
+ Contributors
+ Authors' Addresses
+
+1. Introduction
+
+ This document defines a YANG data model to describe microwave and
+ millimeter-wave radio links in a network topology (hereafter,
+ "microwave" is used to simplify the text). The YANG data model
+ describes radio links, supporting carrier(s), and the associated
+ carrier termination points [RFC8561]. A carrier is a single link
+ providing transport capacity over the air. It is typically defined
+ by its transmitting and receiving frequencies. A radio link provides
+ the transport capacity of the supporting carriers in aggregated and/
+ or protected configurations, which can be used to carry traffic on
+ higher topology layers such as Ethernet and Time-Division
+ Multiplexing (TDM). The model augments the YANG Data Model for
+ Traffic Engineering (TE) Topologies defined in [RFC8795], which is
+ based on A YANG Data Model for Network Topologies defined in
+ [RFC8345].
+
+ The microwave point-to-point radio technology provides connectivity
+ on Layer 0 or Layer 1 (L0/L1) over a radio link between two
+ termination points using one or several supporting carriers in
+ aggregated or protected configurations. That application of
+ microwave technology cannot be used to perform cross-connection or
+ switching of the traffic to create network connectivity across
+ multiple microwave radio links. Instead, a payload of traffic on
+ higher topology layers, normally Layer 2 (L2) Ethernet, is carried
+ over the microwave radio link. When the microwave radio link is
+ terminated at the endpoints, cross-connection and switching can be
+ performed on that higher layer creating connectivity across multiple
+ supporting microwave radio links.
+
+ The microwave topology model is expected to be used between a
+ Provisioning Network Controller (PNC) and a Multi-Domain Service
+ Coordinator (MDSC) [RFC8453]. Examples of use cases that can be
+ supported are:
+
+ 1. Correlation between microwave radio links and the supported links
+ on higher topology layers (e.g., an L2 Ethernet topology). This
+ information can be used to understand how changes in the
+ performance/status of a microwave radio link affect traffic on
+ higher layers.
+
+ 2. Propagation of relevant characteristics of a microwave radio
+ link, such as bandwidth, to higher topology layers, where it
+ could be used as a criterion when configuring and optimizing a
+ path for a connection or service through the network end to end.
+
+ 3. Optimization of the microwave radio link configurations on a
+ network level, with the purpose to minimize overall interference
+ and/or maximize the overall capacity provided by the links.
+
+1.1. Abbreviations
+
+ The following abbreviations are used in this document:
+
+ CTP: Carrier Termination Point
+
+ RLT: Radio Link Terminal
+
+ RLTP: Radio Link Termination Point
+
+1.2. Tree Structure
+
+ A simplified graphical representation of the data model is used in
+ Section 2 of this document. The meaning of the symbols in these
+ diagrams is defined in [RFC8340].
+
+1.3. Prefixes in Data Node Names
+
+ In this document, names of data nodes and other data model objects
+ are prefixed using the standard prefix associated with the
+ corresponding YANG imported modules, as shown in Table 1.
+
+ +==========+=======================+===========+
+ | Prefix | YANG Module | Reference |
+ +==========+=======================+===========+
+ | nw | ietf-network | [RFC8345] |
+ +----------+-----------------------+-----------+
+ | nt | ietf-network-topology | [RFC8345] |
+ +----------+-----------------------+-----------+
+ | mw-types | ietf-microwave-types | [RFC8561] |
+ +----------+-----------------------+-----------+
+ | tet | ietf-te-topology | [RFC8795] |
+ +----------+-----------------------+-----------+
+
+ Table 1: Prefixes for Imported YANG Modules
+
+2. Microwave Topology YANG Data Model
+
+2.1. YANG Tree
+
+ module: ietf-microwave-topology
+
+ augment /nw:networks/nw:network/nw:network-types/tet:te-topology:
+ +--rw mw-topology!
+ augment /nw:networks/nw:network/nw:node/tet:te
+ /tet:te-node-attributes:
+ +--rw mw-node!
+ augment /nw:networks/nw:network/nw:node/nt:termination-point
+ /tet:te:
+ +--rw mw-tp!
+ +--rw (mw-tp-option)?
+ +--:(microwave-rltp)
+ | +--rw microwave-rltp!
+ +--:(microwave-ctp)
+ +--rw microwave-ctp!
+ augment /nw:networks/nw:network/nt:link/tet:te
+ /tet:te-link-attributes:
+ +--rw mw-link!
+ +--rw (mw-link-option)
+ +--:(microwave-radio-link)
+ | +--rw microwave-radio-link!
+ | +--rw rlt-mode
+ | +--rw num-bonded-carriers uint32
+ | +--rw num-protecting-carriers uint32
+ +--:(microwave-carrier)
+ +--rw microwave-carrier!
+ +--rw tx-frequency? uint32
+ +--ro actual-rx-frequency? uint32
+ +--rw channel-separation? uint32
+ +--ro actual-tx-cm? identityref
+ +--ro actual-snir? decimal64
+ +--ro actual-transmitted-level? decimal64
+ augment /nw:networks/nw:network/nt:link/tet:te
+ /tet:te-link-attributes/tet:max-link-bandwidth
+ /tet:te-bandwidth:
+ +--ro mw-bandwidth? uint64
+
+ Figure 1: Microwave Topology Tree
+
+2.2. Relationship between Radio Links and Carriers
+
+ A microwave radio link is always an aggregate of one or multiple
+ carriers in various configurations or modes. The supporting carriers
+ are identified by their termination points and are listed in the
+ container-bundled links as part of the te-link-config in the YANG
+ Data Model for Traffic Engineering (TE) Topologies [RFC8795] for a
+ radio-link. The exact configuration of the included carriers is
+ further specified in the rlt-mode container (1+0, 2+0, 1+1, etc.) for
+ the radio-link. Appendix A includes JSON examples of how such a
+ relationship can be modeled.
+
+2.3. Relationship with Client Topology Model
+
+ A microwave radio link carries a payload of traffic on higher
+ topology layers, normally L2 Ethernet. The leafs supporting-network,
+ supporting-node, supporting-link, and supporting-termination-point in
+ the generic YANG module for Network Topologies [RFC8345] are expected
+ to be used to model a relationship or dependency from higher topology
+ layers to a supporting microwave radio link topology layer.
+ Appendix A includes JSON examples of an L2 Ethernet link transported
+ over one supporting microwave link.
+
+2.4. Applicability of the Data Model for Traffic Engineering (TE)
+ Topologies
+
+ Since microwave is a point-to-point radio technology, a majority of
+ the leafs in the Data Model for Traffic Engineering (TE) Topologies
+ [RFC8795] augmented by the microwave topology model are not
+ applicable. Examples of which leafs are considered applicable can be
+ found in Appendices A and B in this document.
+
+ In the more specific context of the microwave-specific augmentations
+ of te-topology, the admin-status, and oper-status leafs (from te-
+ topology) are only applicable to microwave carriers (in the mw-link
+ tree); they are not applicable to microwave radio links. Radio links
+ are instead enabled or disabled in the constituent carriers.
+ Furthermore, the status leafs related to mw-tp can be used with
+ inter-domain links and when the status of only one side of the link
+ is known. However, since microwave is a point-to-point technology
+ where both ends normally belong to the same domain, it is not
+ expected to be applicable in normal cases.
+
+2.5. Microwave Topology YANG Module
+
+ This module imports typedefs and modules from [RFC8345], [RFC8561],
+ and [RFC8795]. It references [EN301129] and [EN302217-1].
+
+ <CODE BEGINS> file "ietf-microwave-topology@2024-09-30.yang"
+ module ietf-microwave-topology {
+ yang-version 1.1;
+ namespace "urn:ietf:params:xml:ns:yang:ietf-microwave-topology";
+ prefix mwt;
+
+ import ietf-network {
+ prefix nw;
+ reference
+ "RFC 8345: A YANG Data Model for Network Topologies";
+ }
+ import ietf-network-topology {
+ prefix nt;
+ reference
+ "RFC 8345: A YANG Data Model for Network Topologies";
+ }
+ import ietf-te-topology {
+ prefix tet;
+ reference
+ "RFC 8795: YANG Data Model for Traffic Engineering
+ (TE) Topologies";
+ }
+ import ietf-microwave-types {
+ prefix mw-types;
+ reference
+ "RFC 8561: A YANG Data Model for Microwave Radio Link";
+ }
+
+ organization
+ "Internet Engineering Task Force (IETF) CCAMP WG";
+ contact
+ "WG Web: <https://datatracker.ietf.org/wg/ccamp/>
+ WG List: <ccamp@ietf.org>
+
+ Editor: Jonas Ahlberg
+ <jonas.ahlberg@ericsson.com>
+ Editor: Scott Mansfield
+ <scott.mansfield@ericsson.com>
+ Editor: Min Ye
+ <amy.yemin@huawei.com>
+ Editor: Italo Busi
+ <Italo.Busi@huawei.com>
+ Editor: Xi Li
+ <Xi.Li@neclab.eu>
+ Editor: Daniela Spreafico
+ <daniela.spreafico@nokia.com>
+ ";
+ description
+ "This is a module for microwave topology.
+
+ Copyright (c) 2024 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 Revised BSD License
+ set forth in Section 4.c of the IETF Trust's Legal Provisions
+ Relating to IETF Documents
+ (https://trustee.ietf.org/license-info).
+
+ This version of this YANG module is part of RFC 9656; see
+ the RFC itself for full legal notices.";
+
+ revision 2024-09-30 {
+ description
+ "Initial revision.";
+ reference
+ "RFC 9656: A YANG Data Model for Microwave Topology";
+ }
+
+ grouping rlt-mode {
+ description
+ "This grouping provides a flexible definition of the number
+ of bonded carriers and protecting carriers of a radio
+ link.";
+ leaf num-bonded-carriers {
+ type uint32;
+ mandatory true;
+ description
+ "Number of bonded carriers.";
+ }
+ leaf num-protecting-carriers {
+ type uint32;
+ mandatory true;
+ description
+ "Number of protecting carriers.";
+ }
+ }
+
+ grouping microwave-radio-link-attributes {
+ description
+ "Grouping used for attributes describing a microwave
+ radio link.";
+ container rlt-mode {
+ description
+ "This grouping provides a flexible definition of the number
+ of bonded carriers and protecting carriers of a radio
+ link.";
+ uses rlt-mode;
+ }
+ }
+
+ grouping microwave-carrier-attributes {
+ description
+ "Grouping used for attributes describing a microwave
+ carrier.";
+ leaf tx-frequency {
+ type uint32;
+ units "kHz";
+ description
+ "Selected transmitter frequency.
+ Related to the data node tx-frequency in RFC 8561.";
+ reference
+ "RFC 8561: A YANG Data Model for Microwave Radio Link";
+ }
+ leaf actual-rx-frequency {
+ type uint32;
+ units "kHz";
+ config false;
+ description
+ "Computed receiver frequency.
+ Related to the data node actual-rx-frequency in RFC 8561.";
+ reference
+ "RFC 8561: A YANG Data Model for Microwave Radio Link";
+ }
+ leaf channel-separation {
+ type uint32;
+ units "kHz";
+ description
+ "The amount of bandwidth allocated to a carrier. The
+ distance between adjacent channels in a radio
+ frequency channel arrangement.
+ Related to the data node channel-separation in RFC 8561.";
+ reference
+ "ETSI EN 302 217-1 and
+ RFC 8561: A YANG Data Model for Microwave Radio Link";
+ }
+ leaf actual-tx-cm {
+ type identityref {
+ base mw-types:coding-modulation;
+ }
+ config false;
+ description
+ "Actual coding/modulation in transmitting direction.
+ Related to the data node actual-tx-cm in RFC 8561.";
+ reference
+ "RFC 8561: A YANG Data Model for Microwave Radio Link";
+ }
+ leaf actual-snir {
+ type decimal64 {
+ fraction-digits 1;
+ }
+ units "dB";
+ config false;
+ description
+ "Actual signal-to-noise plus the interference ratio
+ (0.1 dB resolution).
+ Related to the data node actual-snir in RFC 8561.";
+ reference
+ "RFC 8561: A YANG Data Model for Microwave Radio Link";
+ }
+ leaf actual-transmitted-level {
+ type decimal64 {
+ fraction-digits 1;
+ }
+ units "dBm";
+ config false;
+ description
+ "Actual transmitted power level (0.1 dBm resolution).
+ Related to the data node actual-transmitted-level
+ in RFC 8561.";
+ reference
+ "ETSI EN 301 129 and
+ RFC 8561: A YANG Data Model for Microwave Radio Link";
+ }
+ }
+
+ grouping microwave-bandwidth {
+ description
+ "Grouping used for microwave bandwidth.";
+ leaf mw-bandwidth {
+ type uint64;
+ units "bits/seconds";
+ config false;
+ description
+ "Nominal microwave radio link and carrier bandwidth.";
+ }
+ }
+
+ augment "/nw:networks/nw:network/nw:network-types/"
+ + "tet:te-topology" {
+ description
+ "Augment network types to define a microwave network
+ topology type.";
+ container mw-topology {
+ presence "Indicates a topology type of microwave.";
+ description
+ "Microwave topology type";
+ }
+ }
+
+ augment "/nw:networks/nw:network/nw:node/tet:te"
+ + "/tet:te-node-attributes" {
+ when '../../../nw:network-types'
+ + '/tet:te-topology/mwt:mw-topology' {
+ description
+ "Augmentation parameters apply only to networks with a
+ microwave network topology type.";
+ }
+ description
+ "Augment network node to indicate a microwave node.";
+ container mw-node {
+ presence "Indicates a microwave node.";
+ description
+ "Microwave node";
+ }
+ }
+
+ augment "/nw:networks/nw:network/nw:node/nt:termination-point/"
+ + "tet:te" {
+ when '../../../nw:network-types/tet:te-topology/'
+ + 'mwt:mw-topology' {
+ description
+ "Augmentation parameters apply only for networks with a
+ microwave network topology type.";
+ }
+ description
+ "Augmentation to add microwave-technology-specific
+ characteristics to a termination point.";
+ container mw-tp {
+ presence "Denotes a microwave termination point.";
+ description
+ "Specification of type of termination point.";
+ choice mw-tp-option {
+ description
+ "Selection of type of termination point.";
+ case microwave-rltp {
+ container microwave-rltp {
+ presence
+ "Denotes a microwave radio link termination point.
+ It corresponds to a microwave RLT interface as
+ defined in RFC 8561.";
+ description
+ "Denotes and describes a microwave radio link
+ termination point.";
+ reference
+ "RFC 8561: A YANG Data Model for Microwave Radio Link";
+ }
+ }
+ case microwave-ctp {
+ container microwave-ctp {
+ presence "Denotes a microwave carrier termination point.
+ It corresponds to a microwave CT interface as
+ defined in RFC 8561.";
+ description
+ "Denotes and describes a microwave carrier
+ termination point.";
+ reference
+ "RFC 8561: A YANG Data Model for Microwave Radio Link";
+ }
+ }
+ }
+ }
+ }
+
+ augment "/nw:networks/nw:network/nt:link/tet:te/"
+ + "tet:te-link-attributes" {
+ when '../../../nw:network-types/tet:te-topology/'
+ + 'mwt:mw-topology' {
+ description
+ "Augmentation parameters apply only for networks with a
+ microwave network topology type.";
+ }
+ description
+ "Augmentation to add microwave-technology-specific
+ characteristics to a link.";
+ container mw-link {
+ presence "This indicates a microwave link";
+ description
+ "Specification of type of link.";
+ choice mw-link-option {
+ mandatory true;
+ description
+ "Selection of type of link.";
+ case microwave-radio-link {
+ container microwave-radio-link {
+ presence "Denotes a microwave radio link";
+ description
+ "Denotes and describes a microwave radio link.";
+ uses microwave-radio-link-attributes;
+ }
+ }
+ case microwave-carrier {
+ container microwave-carrier {
+ presence "Denotes a microwave carrier";
+ description
+ "Denotes and describes a microwave carrier.";
+ uses microwave-carrier-attributes;
+ }
+ }
+ }
+ }
+ }
+
+ augment "/nw:networks/nw:network/nt:link/tet:te/"
+ + "tet:te-link-attributes/"
+ + "tet:max-link-bandwidth/"
+ + "tet:te-bandwidth" {
+ when '../../../../../nw:network-types/tet:te-topology/'
+ + 'mwt:mw-topology' {
+ description
+ "Augmentation parameters apply only for networks with a
+ microwave network topology type.";
+ }
+ description
+ "Augmentation for TE bandwidth.";
+ uses microwave-bandwidth;
+ }
+ }
+ <CODE ENDS>
+
+3. Security Considerations
+
+ The YANG module specified in this document defines 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.
+
+ The YANG module specified in this document imports and augments the
+ ietf-network and ietf-network-topology models defined in [RFC8345].
+ The security considerations from [RFC8345] are applicable to the
+ module in this document.
+
+ There are a number of data nodes defined in this YANG module that are
+ writable/creatable/deletable (i.e., config true, which is the
+ default). These data nodes can 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:
+
+ * rlt-mode: A malicious client could attempt to modify the mode in
+ which the radio link is configured and, thereby, change the
+ intended behavior of the link.
+
+ * tx-frequency and channel-separation: A malicious client could
+ attempt to modify the frequency configuration of a carrier, which
+ could modify the intended behavior or make the configuration
+ invalid and, thereby, stop the operation of it.
+
+4. IANA Considerations
+
+ IANA has assigned a new URI from the "IETF XML Registry" [RFC3688] as
+ follows:
+
+ URI: urn:ietf:params:xml:ns:yang:ietf-microwave-topology
+ Registrant Contact: The IESG
+ XML: N/A; the requested URI is an XML namespace.
+
+ IANA has recorded the YANG module names in the "YANG Module Names"
+ registry [RFC6020] as follows:
+
+ Name: ietf-microwave-topology
+ Maintained by IANA?: N
+ Namespace: urn:ietf:params:xml:ns:yang:ietf-microwave-topology
+ Prefix: mwt
+ Reference: RFC 9656
+
+5. References
+
+5.1. Normative References
+
+ [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>.
+
+ [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>.
+
+ [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>.
+
+ [RFC8345] Clemm, A., Medved, J., Varga, R., Bahadur, N.,
+ Ananthakrishnan, H., and X. Liu, "A YANG Data Model for
+ Network Topologies", RFC 8345, DOI 10.17487/RFC8345, March
+ 2018, <https://www.rfc-editor.org/info/rfc8345>.
+
+ [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>.
+
+ [RFC8561] Ahlberg, J., Ye, M., Li, X., Spreafico, D., and M.
+ Vaupotic, "A YANG Data Model for Microwave Radio Link",
+ RFC 8561, DOI 10.17487/RFC8561, June 2019,
+ <https://www.rfc-editor.org/info/rfc8561>.
+
+ [RFC8795] Liu, X., Bryskin, I., Beeram, V., Saad, T., Shah, H., and
+ O. Gonzalez de Dios, "YANG Data Model for Traffic
+ Engineering (TE) Topologies", RFC 8795,
+ DOI 10.17487/RFC8795, August 2020,
+ <https://www.rfc-editor.org/info/rfc8795>.
+
+5.2. Informative References
+
+ [EN301129] ETSI, "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 1999, <https://www.etsi.org/deliver/
+ etsi_en/301100_301199/301129/01.01.02_60/
+ en_301129v010102p.pdf>.
+
+ [EN302217-1]
+ ETSI, "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.1.1, May 2017,
+ <https://www.etsi.org/deliver/
+ etsi_en/302200_302299/30221701/03.01.01_60/
+ en_30221701v030101p.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>.
+
+ [RFC8453] Ceccarelli, D., Ed. and Y. Lee, Ed., "Framework for
+ Abstraction and Control of TE Networks (ACTN)", RFC 8453,
+ DOI 10.17487/RFC8453, August 2018,
+ <https://www.rfc-editor.org/info/rfc8453>.
+
+ [RFC8792] Watsen, K., Auerswald, E., Farrel, A., and Q. Wu,
+ "Handling Long Lines in Content of Internet-Drafts and
+ RFCs", RFC 8792, DOI 10.17487/RFC8792, June 2020,
+ <https://www.rfc-editor.org/info/rfc8792>.
+
+ [RFC8944] Dong, J., Wei, X., Wu, Q., Boucadair, M., and A. Liu, "A
+ YANG Data Model for Layer 2 Network Topologies", RFC 8944,
+ DOI 10.17487/RFC8944, November 2020,
+ <https://www.rfc-editor.org/info/rfc8944>.
+
+ [YANG-BWA-TOPO]
+ Ahlberg, J., Mansfield, S., Ye, M., Busi, I., Li, X., and
+ D. Spreafico, "A YANG Data Model for Bandwidth
+ Availability Topology", Work in Progress, Internet-Draft,
+ draft-ietf-ccamp-bwa-topo-yang-01, 18 October 2023,
+ <https://datatracker.ietf.org/doc/html/draft-ietf-ccamp-
+ bwa-topo-yang-01>.
+
+ [YANG-IF-REF-TOPO]
+ Ahlberg, J., Mansfield, S., Ye, M., Busi, I., Li, X., and
+ D. Spreafico, "A YANG Data Model for Interface Reference
+ Topology", Work in Progress, Internet-Draft, draft-ietf-
+ ccamp-if-ref-topo-yang-01, 18 October 2023,
+ <https://datatracker.ietf.org/doc/html/draft-ietf-ccamp-
+ if-ref-topo-yang-01>.
+
+Appendix A. Microwave Topology Model with Base Topology Models
+
+ The tree below shows an example of the relevant leafs for a complete
+ Microwave Topology Model including the augmented Network Topology
+ Model defined in [RFC8345] and the Traffic Engineering (TE)
+ Topologies model defined in [RFC8795]. There are also JSON-based
+ instantiations of the Microwave Topology Model for a couple of small
+ network examples.
+
+ module: ietf-network
+ +--rw networks
+ +--rw network* [network-id]
+ | +--rw network-id network-id
+ | +--rw network-types
+ | | +--rw tet:te-topology!
+ | | +--rw mwt:mw-topology!
+ | +--rw supporting-network* [network-ref]
+ | | +--rw network-ref -> /networks/network/network-id
+ | +--rw node* [node-id]
+ | | +--rw node-id node-id
+ | | +--rw supporting-node* [network-ref node-ref]
+ | | | +--rw network-ref
+ | | | | -> ../../../supporting-network/network-ref
+ | | | +--rw node-ref -> /networks/network/node/node-id
+ | | +--rw nt:termination-point* [tp-id]
+ | | | +--rw nt:tp-id tp-id
+ | | | +--rw nt:supporting-termination-point*
+ | | | | [network-ref node-ref tp-ref]
+ | | | | +--rw nt:network-ref
+ | | | | | -> ../../../nw:supporting-node/network-ref
+ | | | | +--rw nt:node-ref
+ | | | | | -> ../../../nw:supporting-node/node-ref
+ | | | | +--rw nt:tp-ref leafref
+ | | | +--rw tet:te-tp-id?
+ | | | | te-types:te-tp-id
+ | | | +--rw tet:te!
+ | | | +--rw tet:name? string
+ | | | +--ro tet:geolocation
+ | | | | +--ro tet:altitude? int64
+ | | | | +--ro tet:latitude?
+ | | | | | geographic-coordinate-degree
+ | | | | +--ro tet:longitude?
+ | | | | geographic-coordinate-degree
+ | | | +--rw mwt:mw-tp!
+ | | | +--rw (mwt:mw-tp-option)?
+ | | | +--:(mwt:microwave-rltp)
+ | | | | +--rw mwt:microwave-rltp!
+ | | | +--:(mwt:microwave-ctp)
+ | | | +--rw mwt:microwave-ctp!
+ | | +--rw tet:te-node-id? te-types:te-node-id
+ | +--rw nt:link* [link-id]
+ | | +--rw nt:link-id link-id
+ | | +--rw nt:source
+ | | | +--rw nt:source-node? -> ../../../nw:node/node-id
+ | | | +--rw nt:source-tp? leafref
+ | | +--rw nt:destination
+ | | | +--rw nt:dest-node? -> ../../../nw:node/node-id
+ | | | +--rw nt:dest-tp? leafref
+ | | +--rw nt:supporting-link* [network-ref link-ref]
+ | | | +--rw nt:network-ref
+ | | | | -> ../../../nw:supporting-network/network-ref
+ | | | +--rw nt:link-ref leafref
+ | | +--rw tet:te!
+ | | +--rw (tet:bundle-stack-level)?
+ | | | +--:(tet:bundle)
+ | | | | +--rw tet:bundled-links
+ | | | | +--rw tet:bundled-link* [sequence]
+ | | | | +--rw tet:sequence uint32
+ | | | | +--rw tet:src-tp-ref? leafref
+ | | | | +--rw tet:des-tp-ref? leafref
+ | | +--rw tet:te-link-attributes
+ | | | +--rw tet:name? string
+ | | | +--rw tet:max-link-bandwidth
+ | | | | +--rw tet:te-bandwidth
+ | | | | +--ro mwt:mw-bandwidth? uint64
+ | | | +--rw mwt:mw-link!
+ | | | +--rw (mwt:mw-link-option)
+ | | | +--:(mwt:microwave-radio-link)
+ | | | | +--rw mwt:microwave-radio-link!
+ | | | | +--rw mwt:rlt-mode
+ | | | | +--rw mwt:num-bonded-carriers
+ | | | | | uint32
+ | | | | +--rw mwt:num-protecting-carriers
+ | | | | uint32
+ | | | +--:(mwt:microwave-carrier)
+ | | | +--rw mwt:microwave-carrier!
+ | | | +--rw mwt:tx-frequency?
+ | | | | uint32
+ | | | +--ro mwt:actual-rx-frequency?
+ | | | | uint32
+ | | | +--rw mwt:channel-separation?
+ | | | | uint32
+ | | | +--ro mwt:actual-tx-cm?
+ | | | | identityref
+ | | | +--ro mwt:actual-snir?
+ | | | | decimal64
+ | | | +--ro mwt:actual-transmitted-level?
+ | | | decimal64
+
+ Figure 2: Microwave Topology with Augmentations Tree
+
+ The Microwave Topology Model augments the TE Topology Model.
+
+ Node N1 Node N2
+ +--------------+ +--------------+
+ | +----------+ | | +----------+ | L2-network
+ | |L2-N1-TP1 | | L2-N1-N2 | |L2-N2-TP2 | | -L2 topology
+ | | o<--------------------->o | |
+ | +----------+ | ' | +----------+ | Supporting
+ | : | ' | : | ' mw link
+ | : | ' | : | : TPs
+ | +----------+ | ' | +----------+ |
+ | |mw-N1- | | mwrl-N1-N2 | | mw-N2- | | MW-network
+ | |RLTP1 o<----------*---------->o RLTP2 | | -MW topology
+ | +----------+ | / \ | +----------+ |
+ | : : | / \ | : : |
+ | :: | / \ | :: | Supporting
+ | +-------:--+ | / \ | +--:-------+ | : TPs
+ | |mw-N1- : *---+--' '--+---* : mw-N2-| | * carriers
+ | |CTP1 : o<--|---------------|-->o : CTP2 | | as bundled
+ | +-------:--+ | | mwc-N1-N2-A | | +--:-------+ | links
+ | : | | | | : |
+ | +----------+ | | | | +----------+ |
+ | |mw-N1-CTP3*---' '---*mw-N2-CTP4| |
+ | | o<--------------------->o | |
+ | +----------+ | mwc-N1-N2-B | +----------+ |
+ +--------------+ +--------------+
+
+ Figure 3: Example for L2 over Microwave
+
+A.1. Instance Data for 2+0 Mode for a Bonded Configuration
+
+ An L2 network with a supporting microwave network, showing a 2+0
+ microwave configuration is provided below. The num-bonded-carriers =
+ 2, and the num-protecting-carriers = 0. This means both carriers are
+ active, so there is no redundancy and there is more capacity. The
+ JSON encoding of the 2+0 example data follows:
+
+ {
+ "ietf-network:networks": {
+ "network": [
+ {
+ "network-id": "L2-network",
+ "network-types": {
+ "ietf-te-topology:te-topology": {}
+ },
+ "supporting-network": [
+ {
+ "network-ref": "mw-network"
+ }
+ ],
+ "node": [
+ {
+ "node-id": "L2-N1",
+ "supporting-node": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N1"
+ }
+ ],
+ "ietf-network-topology:termination-point": [
+ {
+ "tp-id": "L2-N1-TP1",
+ "supporting-termination-point": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N1",
+ "tp-ref": "mw-N1-RLTP1"
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "node-id": "L2-N2",
+ "supporting-node": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N2"
+ }
+ ],
+ "ietf-network-topology:termination-point": [
+ {
+ "tp-id": "L2-N2-TP2",
+ "supporting-termination-point": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N2",
+ "tp-ref": "mw-N2-RLTP2"
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "ietf-network-topology:link": [
+ {
+ "link-id": "L2-N1-N2",
+ "source": {
+ "source-node": "L2-N1",
+ "source-tp": "L2-N1-TP1"
+ },
+ "destination": {
+ "dest-node": "L2-N2",
+ "dest-tp": "L2-N2-TP2"
+ },
+ "supporting-link": [
+ {
+ "network-ref": "mw-network",
+ "link-ref": "mwrl-N1-N2"
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "network-id": "mw-network",
+ "network-types": {
+ "ietf-te-topology:te-topology": {
+ "ietf-microwave-topology:mw-topology": {}
+ }
+ },
+ "supporting-network": [
+ {
+ "network-ref": "mw-network"
+ }
+ ],
+ "node": [
+ {
+ "node-id": "mw-N1",
+ "supporting-node": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N1"
+ }
+ ],
+ "ietf-network-topology:termination-point": [
+ {
+ "tp-id": "mw-N1-RLTP1",
+ "supporting-termination-point": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N1",
+ "tp-ref": "mw-N1-CTP1"
+ },
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N1",
+ "tp-ref": "mw-N1-CTP3"
+ }
+ ],
+ "ietf-te-topology:te-tp-id": "192.0.2.3",
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-rltp": {}
+ }
+ }
+ },
+ {
+ "tp-id": "mw-N1-CTP1",
+ "ietf-te-topology:te-tp-id": 1,
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-ctp": {}
+ }
+ }
+ },
+ {
+ "tp-id": "mw-N1-CTP3",
+ "ietf-te-topology:te-tp-id": 2,
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-ctp": {}
+ }
+ }
+ }
+ ]
+ },
+ {
+ "node-id": "mw-N2",
+ "supporting-node": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N2"
+ }
+ ],
+ "ietf-network-topology:termination-point": [
+ {
+ "tp-id": "mw-N2-RLTP2",
+ "supporting-termination-point": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N2",
+ "tp-ref": "mw-N2-CTP2"
+ },
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N2",
+ "tp-ref": "mw-N2-CTP4"
+ }
+ ],
+ "ietf-te-topology:te-tp-id": "192.0.2.4",
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-rltp": {}
+ }
+ }
+ },
+ {
+ "tp-id": "mw-N2-CTP2",
+ "ietf-te-topology:te-tp-id": 1,
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-ctp": {}
+ }
+ }
+ },
+ {
+ "tp-id": "mw-N2-CTP4",
+ "ietf-te-topology:te-tp-id": 2,
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-ctp": {}
+ }
+ }
+ }
+ ]
+ }
+ ],
+ "ietf-network-topology:link": [
+ {
+ "link-id": "mwrl-N1-N2",
+ "source": {
+ "source-node": "mw-N1",
+ "source-tp": "mw-N1-RLTP1"
+ },
+ "destination": {
+ "dest-node": "mw-N2",
+ "dest-tp": "mw-N2-RLTP2"
+ },
+ "ietf-te-topology:te": {
+ "bundled-links": {
+ "bundled-link": [
+ {
+ "sequence": 1,
+ "src-tp-ref": "mw-N1-CTP1",
+ "des-tp-ref": "mw-N2-CTP2"
+ },
+ {
+ "sequence": 2,
+ "src-tp-ref": "mw-N1-CTP3",
+ "des-tp-ref": "mw-N2-CTP4"
+ }
+ ]
+ },
+ "te-link-attributes": {
+ "ietf-microwave-topology:mw-link": {
+ "microwave-radio-link": {
+ "rlt-mode": {
+ "num-bonded-carriers": 2,
+ "num-protecting-carriers": 0
+ }
+ }
+ }
+ }
+ }
+ },
+ {
+ "link-id": "mwc-N1-N2-A",
+ "source": {
+ "source-node": "mw-N1",
+ "source-tp": "mw-N1-CTP1"
+ },
+ "destination": {
+ "dest-node": "mw-N2",
+ "dest-tp": "mw-N2-CTP2"
+ },
+ "ietf-te-topology:te": {
+ "te-link-attributes": {
+ "ietf-microwave-topology:mw-link": {
+ "microwave-carrier": {
+ "tx-frequency": 10728000,
+ "channel-separation": 28000
+ }
+ }
+ }
+ }
+ },
+ {
+ "link-id": "mwc-N1-N2-B",
+ "source": {
+ "source-node": "mw-N1",
+ "source-tp": "mw-N1-CTP3"
+ },
+ "destination": {
+ "dest-node": "mw-N2",
+ "dest-tp": "mw-N2-CTP4"
+ },
+ "ietf-te-topology:te": {
+ "te-link-attributes": {
+ "ietf-microwave-topology:mw-link": {
+ "microwave-carrier": {
+ "tx-frequency": 10528000,
+ "channel-separation": 28000
+ }
+ }
+ }
+ }
+ }
+ ]
+ }
+ ]
+ }
+ }
+
+A.2. Instance Data for 1+1 Mode for a Protected Configuration
+
+ An L2 network with a supporting microwave network, showing a 1+1
+ microwave configuration is provided below. The num-bonded-carriers =
+ 1, and the num-protecting-carriers = 1. This means there is a
+ standby carrier protecting the active carrier. The JSON encoding of
+ the 1+1 example data follows:
+
+ {
+ "ietf-network:networks": {
+ "network": [
+ {
+ "network-id": "L2-network",
+ "network-types": {
+ "ietf-te-topology:te-topology": {}
+ },
+ "supporting-network": [
+ {
+ "network-ref": "mw-network"
+ }
+ ],
+ "node": [
+ {
+ "node-id": "L2-N1",
+ "supporting-node": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N1"
+ }
+ ],
+ "ietf-network-topology:termination-point": [
+ {
+ "tp-id": "L2-N1-TP1",
+ "supporting-termination-point": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N1",
+ "tp-ref": "mw-N1-RLTP1"
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "node-id": "L2-N2",
+ "supporting-node": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N2"
+ }
+ ],
+ "ietf-network-topology:termination-point": [
+ {
+ "tp-id": "L2-N2-TP2",
+ "supporting-termination-point": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N2",
+ "tp-ref": "mw-N2-RLTP2"
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "ietf-network-topology:link": [
+ {
+ "link-id": "L2-N1-N2",
+ "source": {
+ "source-node": "L2-N1",
+ "source-tp": "L2-N1-TP1"
+ },
+ "destination": {
+ "dest-node": "L2-N2",
+ "dest-tp": "L2-N2-TP2"
+ },
+ "supporting-link": [
+ {
+ "network-ref": "mw-network",
+ "link-ref": "mwrl-N1-N2"
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "network-id": "mw-network",
+ "network-types": {
+ "ietf-te-topology:te-topology": {
+ "ietf-microwave-topology:mw-topology": {}
+ }
+ },
+ "supporting-network": [
+ {
+ "network-ref": "mw-network"
+ }
+ ],
+ "node": [
+ {
+ "node-id": "mw-N1",
+ "supporting-node": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N1"
+ }
+ ],
+ "ietf-network-topology:termination-point": [
+ {
+ "tp-id": "mw-N1-RLTP1",
+ "supporting-termination-point": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N1",
+ "tp-ref": "mw-N1-CTP1"
+ },
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N1",
+ "tp-ref": "mw-N1-CTP3"
+ }
+ ],
+ "ietf-te-topology:te-tp-id": "192.0.2.3",
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-rltp": {}
+ }
+ }
+ },
+ {
+ "tp-id": "mw-N1-CTP1",
+ "ietf-te-topology:te-tp-id": 1,
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-ctp": {}
+ }
+ }
+ },
+ {
+ "tp-id": "mw-N1-CTP3",
+ "ietf-te-topology:te-tp-id": 2,
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-ctp": {}
+ }
+ }
+ }
+ ]
+ },
+ {
+ "node-id": "mw-N2",
+ "supporting-node": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N2"
+ }
+ ],
+ "ietf-network-topology:termination-point": [
+ {
+ "tp-id": "mw-N2-RLTP2",
+ "supporting-termination-point": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N2",
+ "tp-ref": "mw-N2-CTP2"
+ },
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N2",
+ "tp-ref": "mw-N2-CTP4"
+ }
+ ],
+ "ietf-te-topology:te-tp-id": "192.0.2.4",
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-rltp": {}
+ }
+ }
+ },
+ {
+ "tp-id": "mw-N2-CTP2",
+ "ietf-te-topology:te-tp-id": 1,
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-ctp": {}
+ }
+ }
+ },
+ {
+ "tp-id": "mw-N2-CTP4",
+ "ietf-te-topology:te-tp-id": 2,
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-ctp": {}
+ }
+ }
+ }
+ ]
+ }
+ ],
+ "ietf-network-topology:link": [
+ {
+ "link-id": "mwrl-N1-N2",
+ "source": {
+ "source-node": "mw-N1",
+ "source-tp": "mw-N1-RLTP1"
+ },
+ "destination": {
+ "dest-node": "mw-N2",
+ "dest-tp": "mw-N2-RLTP2"
+ },
+ "ietf-te-topology:te": {
+ "bundled-links": {
+ "bundled-link": [
+ {
+ "sequence": 1,
+ "src-tp-ref": "mw-N1-CTP1",
+ "des-tp-ref": "mw-N2-CTP2"
+ },
+ {
+ "sequence": 2,
+ "src-tp-ref": "mw-N1-CTP3",
+ "des-tp-ref": "mw-N2-CTP4"
+ }
+ ]
+ },
+ "te-link-attributes": {
+ "ietf-microwave-topology:mw-link": {
+ "microwave-radio-link": {
+ "rlt-mode": {
+ "num-bonded-carriers": 1,
+ "num-protecting-carriers": 1
+ }
+ }
+ }
+ }
+ }
+ },
+ {
+ "link-id": "mwc-N1-N2-A",
+ "source": {
+ "source-node": "mw-N1",
+ "source-tp": "mw-N1-CTP1"
+ },
+ "destination": {
+ "dest-node": "mw-N2",
+ "dest-tp": "mw-N2-CTP2"
+ },
+ "ietf-te-topology:te": {
+ "te-link-attributes": {
+ "ietf-microwave-topology:mw-link": {
+ "microwave-carrier": {
+ "tx-frequency": 10728000,
+ "channel-separation": 28000
+ }
+ }
+ }
+ }
+ },
+ {
+ "link-id": "mwc-N1-N2-B",
+ "source": {
+ "source-node": "mw-N1",
+ "source-tp": "mw-N1-CTP3"
+ },
+ "destination": {
+ "dest-node": "mw-N2",
+ "dest-tp": "mw-N2-CTP4"
+ },
+ "ietf-te-topology:te": {
+ "te-link-attributes": {
+ "ietf-microwave-topology:mw-link": {
+ "microwave-carrier": {
+ "tx-frequency": 10728000,
+ "channel-separation": 28000
+ }
+ }
+ }
+ }
+ }
+ ]
+ }
+ ]
+ }
+ }
+
+Appendix B. Microwave Topology Model with Example Extensions
+
+ This non-normative appendix provides examples of how the Microwave
+ Topology Model can be used with the interface reference topology
+ (ifref) [YANG-IF-REF-TOPO] and the bandwidth-availability-topology
+ (bwa) [YANG-BWA-TOPO] models. There is also a snippet of JSON to
+ show geolocation information instance data. When the JSON files have
+ long lines, the long lines are wrapped as described in [RFC8792].
+
+ The tree below shows an example of the relevant leafs for a complete
+ Microwave Topology Model including interface reference topology
+ (ifref) [YANG-IF-REF-TOPO] and bandwidth-availability-topology (bwa)
+ [YANG-BWA-TOPO] models.
+
+ module: ietf-network
+ +--rw networks
+ +--rw network* [network-id]
+ | +--rw network-id network-id
+ | +--rw network-types
+ | | +--rw tet:te-topology!
+ | | +--rw mwt:mw-topology!
+ | +--rw supporting-network* [network-ref]
+ | | +--rw network-ref -> /networks/network/network-id
+ | +--rw node* [node-id]
+ | | +--rw node-id node-id
+ | | +--rw supporting-node* [network-ref node-ref]
+ | | | +--rw network-ref
+ | | | | -> ../../../supporting-network/network-ref
+ | | | +--rw node-ref -> /networks/network/node/node-id
+ | | +--rw nt:termination-point* [tp-id]
+ | | | +--rw nt:tp-id tp-id
+ | | | +--rw nt:supporting-termination-point*
+ | | | | [network-ref node-ref tp-ref]
+ | | | | +--rw nt:network-ref
+ | | | | | -> ../../../nw:supporting-node/network-ref
+ | | | | +--rw nt:node-ref
+ | | | | | -> ../../../nw:supporting-node/node-ref
+ | | | | +--rw nt:tp-ref leafref
+ | | | +--rw tet:te-tp-id?
+ | | | | te-types:te-tp-id
+ | | | +--rw tet:te!
+ | | | +--rw tet:name? string
+ | | | +--ro tet:geolocation
+ | | | | +--ro tet:altitude? int64
+ | | | | +--ro tet:latitude?
+ | | | | | geographic-coordinate-degree
+ | | | | +--ro tet:longitude?
+ | | | | geographic-coordinate-degree
+ | | | +--rw mwt:mw-tp!
+ | | | | +--rw (mwt:mw-tp-option)?
+ | | | | +--:(mwt:microwave-rltp)
+ | | | | | +--rw mwt:microwave-rltp!
+ | | | | +--:(mwt:microwave-ctp)
+ | | | | +--rw mwt:microwave-ctp!
+ | | | +--rw ifref:tp-to-interface-path?
+ | | | -> /if:interfaces/interface/name
+ | | +--rw tet:te-node-id? te-types:te-node-id
+ | +--rw nt:link* [link-id]
+ | | +--rw nt:link-id link-id
+ | | +--rw nt:source
+ | | | +--rw nt:source-node? -> ../../../nw:node/node-id
+ | | | +--rw nt:source-tp? leafref
+ | | +--rw nt:destination
+ | | | +--rw nt:dest-node? -> ../../../nw:node/node-id
+ | | | +--rw nt:dest-tp? leafref
+ | | +--rw nt:supporting-link* [network-ref link-ref]
+ | | | +--rw nt:network-ref
+ | | | | -> ../../../nw:supporting-network/network-ref
+ | | | +--rw nt:link-ref leafref
+ | | +--rw tet:te!
+ | | +--rw (tet:bundle-stack-level)?
+ | | | +--:(tet:bundle)
+ | | | | +--rw tet:bundled-links
+ | | | | +--rw tet:bundled-link* [sequence]
+ | | | | +--rw tet:sequence uint32
+ | | | | +--rw tet:src-tp-ref? leafref
+ | | | | +--rw tet:des-tp-ref? leafref
+ | | +--rw tet:te-link-attributes
+ | | | +--rw tet:name? string
+ | | | +--rw tet:max-link-bandwidth
+ | | | | +--rw tet:te-bandwidth
+ | | | | +--ro mwt:mw-bandwidth? uint64
+ | | | +--rw mwt:mw-link!
+ | | | | +--rw (mwt:mw-link-option)
+ | | | | +--:(mwt:microwave-radio-link)
+ | | | | | +--rw mwt:microwave-radio-link!
+ | | | | | +--rw mwt:rlt-mode
+ | | | | | +--rw mwt:num-bonded-carriers
+ | | | | | | uint32
+ | | | | | +--rw mwt:num-protecting-carriers
+ | | | | | uint32
+ | | | | +--:(mwt:microwave-carrier)
+ | | | | +--rw mwt:microwave-carrier!
+ | | | | +--rw mwt:tx-frequency?
+ | | | | | uint32
+ | | | | +--ro mwt:actual-rx-frequency?
+ | | | | | uint32
+ | | | | +--rw mwt:channel-separation?
+ | | | | | uint32
+ | | | | +--ro mwt:actual-tx-cm?
+ | | | | | identityref
+ | | | | +--ro mwt:actual-snir?
+ | | | | | decimal64
+ | | | | +--ro mwt:actual-transmitted-level?
+ | | | | decimal64
+ | | | +--rw bwatopo:link-availability* [availability]
+ | | | | +--rw bwatopo:availability decimal64
+ | | | | +--rw bwatopo:link-bandwidth? uint64
+ | | | +--ro bwatopo:actual-bandwidth?
+ | | | yang:gauge64
+
+ Figure 4: Microwave Topology with Extensions Tree
+
+ Microwave is a transport technology that can be used to transport
+ client services, such as L2 Ethernet links. When an L2 link is
+ transported over a single supporting microwave radio link, the
+ topologies could be as shown below. Note that the figure just shows
+ an example: there might be other possibilities to demonstrate such a
+ topology. The example of the instantiation encoded in JSON is using
+ only a selected subset of the leafs from the L2 topology model
+ [RFC8944]. The example below uses Figure 3 and adds the interface-
+ related information.
+
+ Node N1 Interfaces
+ +---------------+ +----------------+
+ | +-----------+ |tp-to-interface-path| +------------+ |
+ | | L2-N1-TP1 |<---------------------->|L2Interface1| |
+ | +-----------+ | | +------------+ |
+ | | | |
+ | +-----------+ |tp-to-interface-path| +------------+ |
+ | |mw-N1-RLTP1|<---------------------->| RLT-1 | |
+ | +-----------+ | | +------------+ |
+ | | | |
+ | +-----------+ |tp-to-interface-path| +------------+ |
+ | |mw-N1-CTP1 |<---------------------->| CT-1 | |
+ | +-----------+ | | +------------+ |
+ | | | |
+ | +-----------+ |tp-to-interface-path| +------------+ |
+ | |mw-N1-CTP3 |<---------------------->| CT-3 | |
+ | +-----------+ | | +------------+ |
+ +---------------+ +----------------+
+
+ -------------------------------------------------------
+
+ Node N2 Interfaces
+ +---------------+ +----------------+
+ | +-----------+ |tp-to-interface-path| +------------+ |
+ | | L2-N2-TP2 |<---------------------->|L2Interface2| |
+ | +-----------+ | | +------------+ |
+ | | | |
+ | +-----------+ |tp-to-interface-path| +------------+ |
+ | |mw-N2-RLTP2|<---------------------->| RLT-2 | |
+ | +-----------+ | | +------------+ |
+ | | | |
+ | +-----------+ |tp-to-interface-path| +------------+ |
+ | |mw-N2-CTP2 |<---------------------->| CT-2 | |
+ | +-----------+ | | +------------+ |
+ | | | |
+ | +-----------+ |tp-to-interface-path| +------------+ |
+ | |mw-N2-CTP4 |<---------------------->| CT-4 | |
+ | +-----------+ | | +------------+ |
+ +---------------+ +----------------+
+
+ Figure 5: Interface Extension Example for L2 over Microwave
+
+B.1. Instance Data for 2+0 Mode
+
+ An L2 network with a supporting microwave network, including
+ microwave-topology (mw) and bandwidth-availability-topology (bwa)
+ models as well as the reference to the associated interface
+ management information, is encoded in JSON as follows:
+
+ {
+ "ietf-interfaces:interfaces": {
+ "interface": [
+ {
+ "name": "L2Interface1",
+ "description": "'Ethernet Interface 1'",
+ "type": "iana-if-type:ethernetCsmacd"
+ },
+ {
+ "name": "L2Interface2",
+ "description": "'Ethernet Interface 2'",
+ "type": "iana-if-type:ethernetCsmacd"
+ },
+ {
+ "name": "RLT-1",
+ "description": "'Radio Link Terminal 1'",
+ "type": "iana-if-type:microwaveRadioLinkTerminal",
+ "ietf-microwave-radio-link:mode":
+ "ietf-microwave-types:two-plus-zero",
+ "ietf-microwave-radio-link:carrier-terminations": [
+ "CT-1",
+ "CT-3"
+ ]
+ },
+ {
+ "name": "RLT-2",
+ "description": "'Radio Link Terminal 2'",
+ "type": "iana-if-type:microwaveRadioLinkTerminal",
+ "ietf-microwave-radio-link:mode":
+ "ietf-microwave-types:two-plus-zero",
+ "ietf-microwave-radio-link:carrier-terminations": [
+ "CT-2",
+ "CT-4"
+ ]
+ },
+ {
+ "name": "CT-1",
+ "description": "'Carrier Termination 1'",
+ "type": "iana-if-type:microwaveCarrierTermination",
+ "ietf-microwave-radio-link:tx-frequency": 10728000,
+ "ietf-microwave-radio-link:duplex-distance": 113000,
+ "ietf-microwave-radio-link:channel-separation": 28000,
+ "ietf-microwave-radio-link:rtpc": {
+ "maximum-nominal-power": "20.0"
+ },
+ "ietf-microwave-radio-link:single": {
+ "selected-cm": "ietf-microwave-types:qam-512"
+ }
+ },
+ {
+ "name": "CT-3",
+ "description": "'Carrier Termination 3'",
+ "type": "iana-if-type:microwaveCarrierTermination",
+ "ietf-microwave-radio-link:tx-frequency": 10528000,
+ "ietf-microwave-radio-link:duplex-distance": 113000,
+ "ietf-microwave-radio-link:channel-separation": 28000,
+ "ietf-microwave-radio-link:rtpc": {
+ "maximum-nominal-power": "20.0"
+ },
+ "ietf-microwave-radio-link:single": {
+ "selected-cm": "ietf-microwave-types:qam-512"
+ }
+ },
+ {
+ "name": "CT-2",
+ "description": "'Carrier Termination 2'",
+ "type": "iana-if-type:microwaveCarrierTermination",
+ "ietf-microwave-radio-link:tx-frequency": 10615000,
+ "ietf-microwave-radio-link:duplex-distance": 113000,
+ "ietf-microwave-radio-link:channel-separation": 28000,
+ "ietf-microwave-radio-link:rtpc": {
+ "maximum-nominal-power": "20.0"
+ },
+ "ietf-microwave-radio-link:single": {
+ "selected-cm": "ietf-microwave-types:qam-512"
+ }
+ },
+ {
+ "name": "CT-4",
+ "description": "'Carrier Termination 4'",
+ "type": "iana-if-type:microwaveCarrierTermination",
+ "ietf-microwave-radio-link:tx-frequency": 10415000,
+ "ietf-microwave-radio-link:duplex-distance": 113000,
+ "ietf-microwave-radio-link:channel-separation": 28000,
+ "ietf-microwave-radio-link:rtpc": {
+ "maximum-nominal-power": "20.0"
+ },
+ "ietf-microwave-radio-link:single": {
+ "selected-cm": "ietf-microwave-types:qam-512"
+ }
+ }
+ ]
+ },
+ "ietf-network:networks": {
+ "network": [
+ {
+ "network-id": "L2-network",
+ "network-types": {
+ "ietf-te-topology:te-topology": {
+ "ietf-eth-te-topology:eth-tran-topology": {}
+ }
+ },
+ "supporting-network": [
+ {
+ "network-ref": "mw-network"
+ }
+ ],
+ "node": [
+ {
+ "node-id": "L2-N1",
+ "supporting-node": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N1"
+ }
+ ],
+ "ietf-network-topology:termination-point": [
+ {
+ "tp-id": "L2-N1-TP1",
+ "supporting-termination-point": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N1",
+ "tp-ref": "mw-N1-RLTP1"
+ }
+ ]
+ }
+ ],
+ "ietf-te-topology:te-node-id": "192.0.2.1",
+ "ietf-te-topology:te": {
+ "te-node-attributes": {
+ "ietf-eth-te-topology:eth-node": {}
+ }
+ }
+ },
+ {
+ "node-id": "L2-N2",
+ "supporting-node": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N2"
+ }
+ ],
+ "ietf-network-topology:termination-point": [
+ {
+ "tp-id": "L2-N2-TP2",
+ "supporting-termination-point": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N2",
+ "tp-ref": "mw-N2-RLTP2"
+ }
+ ]
+ }
+ ],
+ "ietf-te-topology:te-node-id": "192.0.2.2",
+ "ietf-te-topology:te": {
+ "te-node-attributes": {
+ "ietf-eth-te-topology:eth-node": {}
+ }
+ }
+ }
+ ],
+ "ietf-network-topology:link": [
+ {
+ "link-id": "L2-N1-N2",
+ "source": {
+ "source-node": "L2-N1",
+ "source-tp": "L2-N1-TP1"
+ },
+ "destination": {
+ "dest-node": "L2-N2",
+ "dest-tp": "L2-N2-TP2"
+ },
+ "supporting-link": [
+ {
+ "network-ref": "mw-network",
+ "link-ref": "mwrl-N1-N2"
+ }
+ ],
+ "ietf-te-topology:te": {
+ "te-link-attributes": {
+ "interface-switching-capability": [
+ {
+ "switching-capability": "ietf-te-types:switching-l2sc",
+ "encoding": "ietf-te-types:lsp-encoding-ethernet"
+ }
+ ]
+ }
+ }
+ }
+ ]
+ },
+ {
+ "network-id": "mw-network",
+ "network-types": {
+ "ietf-te-topology:te-topology": {
+ "ietf-microwave-topology:mw-topology": {}
+ }
+ },
+ "supporting-network": [
+ {
+ "network-ref": "mw-network"
+ }
+ ],
+ "node": [
+ {
+ "node-id": "mw-N1",
+ "supporting-node": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N1"
+ }
+ ],
+ "ietf-network-topology:termination-point": [
+ {
+ "tp-id": "mw-N1-RLTP1",
+ "supporting-termination-point": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N1",
+ "tp-ref": "mw-N1-CTP1"
+ },
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N1",
+ "tp-ref": "mw-N1-CTP3"
+ }
+ ],
+ "ietf-te-topology:te-tp-id": "192.0.2.3",
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-rltp": {}
+ },
+ "ietf-tp-interface-reference-topology:tp-to-interface-path":
+ "RLT-1"
+ }
+ },
+ {
+ "tp-id": "mw-N1-CTP1",
+ "ietf-te-topology:te-tp-id": 1,
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-ctp": {}
+ },
+ "ietf-tp-interface-reference-topology:tp-to-interface-path":
+ "CT-1"
+ }
+ },
+ {
+ "tp-id": "mw-N1-CTP3",
+ "ietf-te-topology:te-tp-id": 2,
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-ctp": {}
+ },
+ "ietf-tp-interface-reference-topology:tp-to-interface-path":
+ "CT-3"
+ }
+ }
+ ],
+ "ietf-te-topology:te-node-id": "192.0.2.1",
+ "ietf-te-topology:te": {
+ "te-node-attributes": {
+ "ietf-microwave-topology:mw-node": {}
+ }
+ }
+ },
+ {
+ "node-id": "mw-N2",
+ "supporting-node": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N2"
+ }
+ ],
+ "ietf-network-topology:termination-point": [
+ {
+ "tp-id": "mw-N2-RLTP2",
+ "supporting-termination-point": [
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N2",
+ "tp-ref": "mw-N2-CTP2"
+ },
+ {
+ "network-ref": "mw-network",
+ "node-ref": "mw-N2",
+ "tp-ref": "mw-N2-CTP4"
+ }
+ ],
+ "ietf-te-topology:te-tp-id": "192.0.2.4",
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-rltp": {}
+ },
+ "ietf-tp-interface-reference-topology:tp-to-interface-path":
+ "RLT-2"
+ }
+ },
+ {
+ "tp-id": "mw-N2-CTP2",
+ "ietf-te-topology:te-tp-id": 1,
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-ctp": {}
+ },
+ "ietf-tp-interface-reference-topology:tp-to-interface-path":
+ "CT-2"
+ }
+ },
+ {
+ "tp-id": "mw-N2-CTP4",
+ "ietf-te-topology:te-tp-id": 2,
+ "ietf-te-topology:te": {
+ "ietf-microwave-topology:mw-tp": {
+ "microwave-ctp": {}
+ },
+ "ietf-tp-interface-reference-topology:tp-to-interface-path":
+ "CT-4"
+ }
+ }
+ ],
+ "ietf-te-topology:te-node-id": "192.0.2.1",
+ "ietf-te-topology:te": {
+ "te-node-attributes": {
+ "ietf-microwave-topology:mw-node": {}
+ }
+ }
+ }
+ ],
+ "ietf-network-topology:link": [
+ {
+ "link-id": "mwrl-N1-N2",
+ "source": {
+ "source-node": "mw-N1",
+ "source-tp": "mw-N1-RLTP1"
+ },
+ "destination": {
+ "dest-node": "mw-N2",
+ "dest-tp": "mw-N2-RLTP2"
+ },
+ "ietf-te-topology:te": {
+ "bundled-links": {
+ "bundled-link": [
+ {
+ "sequence": 1,
+ "src-tp-ref": "mw-N1-CTP1",
+ "des-tp-ref": "mw-N2-CTP2"
+ },
+ {
+ "sequence": 2,
+ "src-tp-ref": "mw-N1-CTP3",
+ "des-tp-ref": "mw-N2-CTP4"
+ }
+ ]
+ },
+ "te-link-attributes": {
+ "ietf-microwave-topology:mw-link": {
+ "microwave-radio-link": {
+ "rlt-mode": {
+ "num-bonded-carriers": 2,
+ "num-protecting-carriers": 0
+ }
+ }
+ }
+ }
+ }
+ },
+ {
+ "link-id": "mwc-N1-N2-A",
+ "source": {
+ "source-node": "mw-N1",
+ "source-tp": "mw-N1-CTP1"
+ },
+ "destination": {
+ "dest-node": "mw-N2",
+ "dest-tp": "mw-N2-CTP2"
+ },
+ "ietf-te-topology:te": {
+ "te-link-attributes": {
+ "ietf-bandwidth-availability-topology:link-availability": [
+ {
+ "availability": "0.99",
+ "link-bandwidth": "998423"
+ },
+ {
+ "availability": "0.95",
+ "link-bandwidth": "1048576"
+ }
+ ],
+ "ietf-microwave-topology:mw-link": {
+ "microwave-carrier": {
+ "tx-frequency": 10728000,
+ "channel-separation": 28000
+ }
+ }
+ }
+ }
+ },
+ {
+ "link-id": "mwc-N1-N2-B",
+ "source": {
+ "source-node": "mw-N1",
+ "source-tp": "mw-N1-CTP3"
+ },
+ "destination": {
+ "dest-node": "mw-N2",
+ "dest-tp": "mw-N2-CTP4"
+ },
+ "ietf-te-topology:te": {
+ "te-link-attributes": {
+ "ietf-microwave-topology:mw-link": {
+ "microwave-carrier": {
+ "tx-frequency": 10528000,
+ "channel-separation": 28000
+ }
+ }
+ }
+ }
+ }
+ ]
+ }
+ ]
+ }
+ }
+
+B.2. Instance Data for Geolocation Information
+
+ This example provides a JSON snippet that shows geolocation
+ information.
+
+ "node": [
+ {
+ "node-id": "mw-N1",
+
+ ...
+
+ "ietf-te-topology:te" : {
+ "ietf-te-topology:geolocation": {
+ "altitude": "200000",
+ "latitude": "45",
+ "longitude": "90"
+ }
+ },
+ "ietf-network-topology:termination-point": [
+
+ ...
+
+Acknowledgments
+
+ This document was initially prepared using the kramdown RFC tool
+ written and maintained by Carsten Bormann. Thanks to Martin Thomson
+ for the GitHub integration of the kramdown RFC tool and for the aasvg
+ tool, which is used for the ascii-to-SVG conversion.
+
+ The authors would like to thank Tom Petch, Éric Vyncke, and Rob
+ Wilton for their reviews.
+
+Contributors
+
+ Italo Busi
+ Huawei Technologies
+ Email: italo.busi@huawei.com
+
+
+Authors' Addresses
+
+ Scott Mansfield (editor)
+ Ericsson Inc
+ Email: scott.mansfield@ericsson.com
+
+
+ Jonas Ahlberg
+ Ericsson AB
+ Lindholmspiren 11
+ SE-417 56 Goteborg
+ Sweden
+ Email: jonas.ahlberg@ericsson.com
+
+
+ Min Ye
+ Huawei Technologies
+ No.1899, Xiyuan Avenue
+ Chengdu
+ 611731
+ China
+ Email: amy.yemin@huawei.com
+
+
+ Xi Li
+ NEC Laboratories Europe
+ Kurfursten-Anlage 36
+ 69115 Heidelberg
+ Germany
+ Email: Xi.Li@neclab.eu
+
+
+ Daniela Spreafico
+ Nokia - IT
+ Via Energy Park, 14
+ 20871 Vimercate (MI)
+ Italy
+ Email: daniela.spreafico@nokia.com