Tech-invite3GPPspaceIETFspace
959493929190898887868584838281807978777675747372717069686766656463626160595857565554535251504948474645444342414039383736353433323130292827262524232221201918171615141312111009080706050403020100
in Index   Prev   Next

RFC 8561

A YANG Data Model for Microwave Radio Link

Pages: 53
Proposed Standard
Errata
Part 2 of 2 – Pages 27 to 53
First   Prev   None

Top   ToC   RFC8561 - Page 27   prevText

4. Interface Protection YANG Data Model

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 model in order to make it also available for other interface types. This module imports modules from [RFC8343], and it references [G.808.1]. <CODE BEGINS> file "ietf-interface-protection@2019-06-19.yang" module ietf-interface-protection { yang-version 1.1; namespace "urn:ietf:params:xml:ns:yang:ietf-interface-protection"; prefix ifprot; import ietf-interfaces { prefix if; reference "RFC 8343"; } organization "Internet Engineering Task Force (IETF) CCAMP WG"; contact "WG List: <mailto:ccamp@ietf.org> Editors: Jonas Ahlberg (jonas.ahlberg@ericsson.com) Min Ye (amy.yemin@huawei.com) Xi Li (Xi.Li@neclab.eu) Daniela Spreafico (daniela.spreafico@nokia.com) Marko Vaupotic (Marko.Vaupotic@aviatnet.com)"; description "This is a module for the entities in a generic interface protection mechanism. Copyright (c) 2019 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info).
Top   ToC   RFC8561 - Page 28
        This version of this YANG module is part of RFC 8561; see
        the RFC itself for full legal notices.";

     revision 2019-06-19 {
       description
         "Initial revision.";
       reference
         "RFC 8561: A YANG Data Model for Microwave Radio Link";
     }

     /*
      * Protection architecture type identities
      */

     identity protection-architecture-type {
       description
         "protection architecture type";
       reference
         "ITU-T G.808.1";
     }

     identity one-plus-one-type {
       base protection-architecture-type;
       description
         "1+1; one interface protects
          another one interface.";
       reference
         "ITU-T G.808.1";
     }

     identity one-to-n-type {
       base protection-architecture-type;
       description
         "1:N; one interface protects
          n other interfaces.";
       reference
         "ITU-T G.808.1";
     }

     /*
      * Protection states identities
      */

     identity protection-states {
       description
         "Identities describing the status of the protection
          in a group of interfaces configured in
          a protection mode.";
Top   ToC   RFC8561 - Page 29
     }

     identity unprotected {
       base protection-states;
       description
         "Not protected.";
     }

     identity protected {
       base protection-states;
       description
         "Protected.";
     }

     identity unable-to-protect {
       base protection-states;
       description
         "Unable to protect.";
     }

     /*
      * Protection Groups
      */

     grouping protection-groups {
       description
         "Configuration of protected groups 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 "ifprot:one-plus-one-type";
           description
             "The type of protection architecture used, e.g., one
              interface protecting one or several other interfaces.";
Top   ToC   RFC8561 - Page 30
           reference
             "ITU-T G.808.1";
         }
         leaf-list members {
           type if:interface-ref;
           min-elements 2;
           description
             "Association to a group of interfaces configured for
              protection and used by a higher-layer interface.";
         }
         leaf operation-type {
           type enumeration {
             enum non-revertive {
               description
                 "In non-revertive operation, the traffic does not
                  return to the working interface if the switch requests
                  are terminated.";
               reference
                 "ITU-T G.808.1";
             }
             enum revertive {
               description
                 "In revertive operation, the traffic always
                  returns to (or remains on) the working interface
                  if the switch requests are terminated.";
               reference
                 "ITU-T G.808.1";
             }
           }
           default "non-revertive";
           description
             "The type of protection operation, i.e., revertive
              or non-revertive operation.";
         }
         leaf-list working-entity {
           when "../operation-type = 'revertive'";
           type if:interface-ref;
           min-elements 1;
           description
             "The interfaces that the traffic normally should
              be transported over when there is no need to use the
              protecting interface.";
         }
         leaf revertive-wait-to-restore {
           when "../operation-type = 'revertive'";
           type uint16;
           units "seconds";
           default "0";
Top   ToC   RFC8561 - Page 31
           description
             "The time to wait before switching back to the working
              interface if operation-type is revertive.";
           reference
             "ITU-T G.808.1";
         }
         leaf hold-off-timer {
           type uint16;
           units "milliseconds";
           default "0";
           description
             "Time interval after the detection of a fault and its
              confirmation as a condition requiring the protection-
              switching procedure.";
           reference
             "ITU-T G.808.1";
         }
         leaf status {
           type identityref {
             base protection-states;
           }
           config false;
           description
             "Status of the protection in a group of interfaces
              configured in a protection mode.";
           reference
             "ITU-T G.808.1";
         }
         action manual-switch-working {
           description
             "A switch action initiated by an operator command.
              It switches a normal traffic signal to the working
              transport entity.";
           reference
             "ITU-T G.808.1";
         }
         action manual-switch-protection {
           description
             "A switch action initiated by an operator command.
              It switches a normal traffic signal to the protection
              transport entity.";
           reference
             "ITU-T G.808.1";
         }
         action forced-switch {
           description
             "A switch action initiated by an operator command.
              It switches a normal traffic signal to the protection
Top   ToC   RFC8561 - Page 32
              transport entity and forces it to remain on that
              entity even when criteria for switching back to
              the original entity are fulfilled.";
           reference
             "ITU-T G.808.1";
         }
         action lockout-of-protection {
           description
             "A switch action temporarily disables access to the
              protection transport entity for all signals.";
           reference
             "ITU-T G.808.1";
         }
         action freeze {
           description
             "A switch action temporarily prevents any switch action
              to be taken and, as such, freezes the current state.
              Until the freeze is cleared, additional near-end external
              commands are rejected, and fault condition changes and
              received Automatic Protection-Switching (APS) messages
              are ignored.";
           reference
             "ITU-T G.808.1";
         }
         action exercise {
           description
             "A switch action to test if the APS communication is
              operating correctly.  It is lower priority than any 'real'
              switch request.";
           reference
             "ITU-T G.808.1";
         }
         action clear {
           description
             "An action clears all switch commands.";
           reference
             "ITU-T G.808.1";
         }
       }
     }
   }

   <CODE ENDS>
Top   ToC   RFC8561 - Page 33

5. Microwave Types YANG Data Model

This module defines a collection of common data types using the YANG data modeling language. These common types are designed to be imported by other modules defined in the microwave area. <CODE BEGINS> file "ietf-microwave-types@2019-06-19.yang" module ietf-microwave-types { yang-version 1.1; namespace "urn:ietf:params:xml:ns:yang:ietf-microwave-types"; prefix mw-types; organization "Internet Engineering Task Force (IETF) CCAMP WG"; contact "WG List: <mailto:ccamp@ietf.org> Editors: Jonas Ahlberg (jonas.ahlberg@ericsson.com) Min Ye (amy.yemin@huawei.com) Xi Li (Xi.Li@neclab.eu) Daniela Spreafico (daniela.spreafico@nokia.com) Marko Vaupotic (Marko.Vaupotic@aviatnet.com)"; description "This module contains a collection of YANG data types considered generally useful for microwave interfaces. Copyright (c) 2019 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info). This version of this YANG module is part of RFC 8561; see the RFC itself for full legal notices."; revision 2019-06-19 { description "Initial revision."; reference "RFC 8561: A YANG Data Model for Microwave Radio Link"; }
Top   ToC   RFC8561 - Page 34
     /*
      * Radio-link-terminal mode identities
      */

     identity rlt-mode {
       description
         "A description of the mode in which the radio link
          terminal is configured.  The format is X plus Y.
          X represents the number of bonded carrier terminations.
          Y represents the number of protecting carrier
          terminations.";
     }

     identity one-plus-zero {
       base rlt-mode;
       description
         "1 carrier termination only.";
     }

     identity one-plus-one {
       base rlt-mode;
       description
         "1 carrier termination
          and 1 protecting carrier termination.";
     }

     identity two-plus-zero {
       base rlt-mode;
       description
         "2 bonded carrier terminations.";
     }

     /*
      * Coding and modulation identities
      */

     identity coding-modulation {
       description
         "The coding and modulation schemes.";
     }

     identity half-bpsk {
       base coding-modulation;
       description
         "Half BPSK coding and modulation scheme.";
     }
Top   ToC   RFC8561 - Page 35
     identity half-bpsk-strong {
       base half-bpsk;
       description
         "Half BPSK strong coding and modulation scheme.";
     }

     identity half-bpsk-light {
       base half-bpsk;
       description
         "Half BPSK light coding and modulation scheme.";
     }

     identity bpsk {
       base coding-modulation;
       description
         "BPSK coding and modulation scheme.";
     }

     identity bpsk-strong {
       base bpsk;
       description
         "BPSK strong coding and modulation scheme.";
     }

     identity bpsk-light {
       base bpsk;
       description
         "BPSK light coding and modulation scheme.";
     }

     identity qpsk {
       base coding-modulation;
       description
         "QPSK coding and modulation scheme.";
     }

     identity qam-4 {
       base coding-modulation;
       description
         "4 QAM coding and modulation scheme.";
     }

     identity qam-4-strong {
       base qam-4;
       description
         "4 QAM strong coding and modulation scheme.";
     }
Top   ToC   RFC8561 - Page 36
     identity qam-4-light {
       base qam-4;
       description
         "4 QAM light coding and modulation scheme.";
     }

     identity qam-16 {
       base coding-modulation;
       description
         "16 QAM coding and modulation scheme.";
     }

     identity qam-16-strong {
       base qam-16;
       description
         "16 QAM strong coding and modulation scheme.";
     }

     identity qam-16-light {
       base qam-16;
       description
         "16 QAM light coding and modulation scheme.";
     }

     identity qam-32 {
       base coding-modulation;
       description
         "32 QAM coding and modulation scheme.";
     }

     identity qam-32-strong {
       base qam-32;
       description
         "32 QAM strong coding and modulation scheme.";
     }

     identity qam-32-light {
       base qam-32;
       description
         "32 QAM light coding and modulation scheme.";
     }

     identity qam-64 {
       base coding-modulation;
       description
         "64 QAM coding and modulation scheme.";
     }
Top   ToC   RFC8561 - Page 37
     identity qam-64-strong {
       base qam-64;
       description
         "64 QAM strong coding and modulation scheme.";
     }

     identity qam-64-light {
       base qam-64;
       description
         "64 QAM light coding and modulation scheme.";
     }

     identity qam-128 {
       base coding-modulation;
       description
         "128 QAM coding and modulation scheme.";
     }

     identity qam-128-strong {
       base qam-128;
       description
         "128 QAM strong coding and modulation scheme.";
     }

     identity qam-128-light {
       base qam-128;
       description
         "128 QAM light coding and modulation scheme.";
     }

     identity qam-256 {
       base coding-modulation;
       description
         "256 QAM coding and modulation scheme.";
     }

     identity qam-256-strong {
       base qam-256;
       description
         "256 QAM strong coding and modulation scheme.";
     }

     identity qam-256-light {
       base qam-256;
       description
         "256 QAM light coding and modulation scheme.";
     }
Top   ToC   RFC8561 - Page 38
     identity qam-512 {
       base coding-modulation;
       description
         "512 QAM coding and modulation scheme.";
     }

     identity qam-512-strong {
       base qam-512;
       description
         "512 QAM strong coding and modulation scheme.";
     }

     identity qam-512-light {
       base qam-512;
       description
         "512 QAM light coding and modulation scheme.";
     }

     identity qam-1024 {
       base coding-modulation;
       description
         "1024 QAM coding and modulation scheme.";
     }

     identity qam-1024-strong {
       base qam-1024;
       description
         "1024 QAM strong coding and modulation scheme.";
     }

     identity qam-1024-light {
       base qam-1024;
       description
         "1024 QAM light coding and modulation scheme.";
     }

     identity qam-2048 {
       base coding-modulation;
       description
         "2048 QAM coding and modulation scheme.";
     }

     identity qam-2048-strong {
       base qam-2048;
       description
         "2048 QAM strong coding and modulation scheme.";
     }
Top   ToC   RFC8561 - Page 39
     identity qam-2048-light {
       base qam-2048;
       description
         "2048 QAM light coding and modulation scheme.";
     }

     identity qam-4096 {
       base coding-modulation;
       description
         "4096 QAM coding and modulation scheme.";
     }

     identity qam-4096-strong {
       base qam-4096;
       description
         "4096 QAM strong coding and modulation scheme.";
     }

     identity qam-4096-light {
       base qam-4096;
       description
         "4096 QAM light coding and modulation scheme.";
     }

     /*
      * TDM-type identities
      */

     identity tdm-type {
       description
         "A description of the type of TDM connection,
          also indicating the supported capacity of the
          connection.";
     }

     identity E1 {
       base tdm-type;
       description
         "E1 connection, 2.048 Mbit/s.";
     }

     identity STM-1 {
       base tdm-type;
       description
         "STM-1 connection, 155.52 Mbit/s.";
     }
   }
Top   ToC   RFC8561 - Page 40
   <CODE ENDS>

6. Security Considerations

The YANG data models specified in this document define schemas for data that is designed to be accessed via network management protocols such as NETCONF [RFC6241] or RESTCONF [RFC8040]. The lowest NETCONF layer is the secure transport layer, and the mandatory-to-implement secure transport is Secure Shell (SSH) [RFC6242]. The lowest RESTCONF layer is HTTPS, and the mandatory-to-implement secure transport is TLS [RFC8446]. The Network Configuration Access Control Model (NACM) [RFC8341] provides the means to restrict access for particular NETCONF or RESTCONF users to a preconfigured subset of all available NETCONF or RESTCONF protocol operations and content. There are a number of data nodes defined in these YANG data models that are writable/creatable/deletable (i.e., config true, which is the default). These data nodes may be considered sensitive or vulnerable in some network environments. Write operations (e.g., edit-config) to these data nodes without proper protection can have a negative effect on network operations. These are the subtrees and data nodes and their sensitivity/vulnerability: Interfaces of type microwaveRadioLinkTerminal: /if:interfaces/if:interface/mode, /if:interfaces/if:interface/carrier-terminations, /if:interfaces/if:interface/rlp-groups, /if:interfaces/if:interface/xpic-pairs, /if:interfaces/if:interface/mimo-groups, and /if:interfaces/if:interface/tdm-connections: These data nodes represent the configuration of the radio link terminal, and they need to match the configuration of the radio link terminal on the other side of the radio link. Unauthorized access to these data nodes could interrupt the ability to forward traffic. Interfaces of type microwaveCarrierTermination: /if:interfaces/if:interface/carrier-id, /if:interfaces/if:interface/tx-enabled, /if:interfaces/if:interface/tx-frequency, /if:interfaces/if:interface/rx-frequency, /if:interfaces/if:interface/duplex-distance, /if:interfaces/if:interface/channel-separation, /if:interfaces/if:interface/rtpc/maximum-nominal-power,
Top   ToC   RFC8561 - Page 41
      /if:interfaces/if:interface/atpc/maximum-nominal-power,
      /if:interfaces/if:interface/atpc/atpc-lower-threshold,
      /if:interfaces/if:interface/atpc/atpc-upper-threshold,
      /if:interfaces/if:interface/single/selected-cm,
      /if:interfaces/if:interface/adaptive/selected-min-acm,
      /if:interfaces/if:interface/adaptive/selected-max-acm,
      /if:interfaces/if:interface/if-loop, and
      /if:interfaces/if:interface/rf-loop:

   These data nodes represent the configuration of the carrier
   termination, and they need to match the configuration of the carrier
   termination on the other side of the carrier.  Unauthorized access to
   these data nodes could interrupt the ability to forward traffic.

   Radio link protection:

      /radio-link-protection-groups/protection-group:

   This data node represents the configuration of the protection of
   carrier terminations.  Unauthorized access to this data node could
   interrupt the ability to forward traffic or remove the ability to
   perform a necessary protection switch.

   XPIC:

      /xpic-pairs:

   This data node represents the XPIC configuration of a pair of
   carriers.  Unauthorized access to this data node could interrupt the
   ability to forward traffic.

   MIMO:

      /mimo-groups:

   This data node represents the MIMO configuration of multiple
   carriers.  Unauthorized access to this data node could interrupt the
   ability to forward traffic.

   Some of the RPC operations in this YANG data model may be considered
   sensitive or vulnerable in some network environments.  It is thus
   important to control access to these operations.  These are the
   operations and their sensitivity/vulnerability:
Top   ToC   RFC8561 - Page 42
   Radio link protection:

   /radio-link-protection-groups/protection-group/manual-switch-working,
   /radio-link-protection-groups/protection-group/
                                               manual-switch-protection,
   /radio-link-protection-groups/protection-group/forced-switch,
   /radio-link-protection-groups/protection-group/lockout-of-protection,
   /radio-link-protection-groups/protection-group/freeze,
   /radio-link-protection-groups/protection-group/exercise, and
   /radio-link-protection-groups/protection-group/clear

   These data nodes represent actions that might have an impact on the
   configuration of the protection of carrier terminations.
   Unauthorized access to these data nodes could interrupt the ability
   to forward traffic or remove the ability to perform a necessary
   protection switch.

   The security considerations of [RFC8343] also apply to this document.

7. IANA Considerations

IANA has assigned new URIs from the "IETF XML Registry" [RFC3688] as follows: URI: urn:ietf:params:xml:ns:yang:ietf-microwave-radio-link Registrant Contact: The IESG XML: N/A; the requested URI is an XML namespace. URI: urn:ietf:params:xml:ns:yang:ietf-interface-protection Registrant Contact: The IESG XML: N/A; the requested URI is an XML namespace. URI: urn:ietf:params:xml:ns:yang:ietf-microwave-types Registrant Contact: The IESG XML: N/A; the requested URI is an XML namespace.
Top   ToC   RFC8561 - Page 43
   IANA has recorded YANG module names in the "YANG Module Names"
   registry [RFC6020] as follows:

      Name: ietf-microwave-radio-link
      Maintained by IANA?: N
      Namespace: urn:ietf:params:xml:ns:yang:ietf-microwave-radio-link
      Prefix: mrl
      Reference: RFC 8561

      Name: ietf-interface-protection
      Maintained by IANA?: N
      Namespace: urn:ietf:params:xml:ns:yang:ietf-interface-protection
      Prefix: ifprot
      Reference: RFC 8561

      Name: ietf-microwave-types
      Maintained by IANA?: N
      Namespace: urn:ietf:params:xml:ns:yang:ietf-microwave-types
      Prefix: mw-types
      Reference: RFC 8561

   IANA has registered the following ifTypes in "ifType definitions"
   under [IANA-SMI]:

   Decimal  Name                         Description
   -------  ------------                 -------------------------------
   295      microwaveCarrierTermination  air interface of a single
                                         microwave carrier

   296      microwaveRadioLinkTerminal   radio link interface for one
                                         or several aggregated microwave
                                         carriers

8. References

8.1. Normative References

[IANA-SMI] IANA, "Structure of Management Information (SMI) Numbers (MIB Module Registrations)", <https://www.iana.org/assignments/smi-numbers>. [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, DOI 10.17487/RFC3688, January 2004, <https://www.rfc-editor.org/info/rfc3688>.
Top   ToC   RFC8561 - Page 44
   [RFC6020]  Bjorklund, M., Ed., "YANG - A Data Modeling Language for
              the Network Configuration Protocol (NETCONF)", RFC 6020,
              DOI 10.17487/RFC6020, October 2010,
              <https://www.rfc-editor.org/info/rfc6020>.

   [RFC6241]  Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed.,
              and A. Bierman, Ed., "Network Configuration Protocol
              (NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011,
              <https://www.rfc-editor.org/info/rfc6241>.

   [RFC6242]  Wasserman, M., "Using the NETCONF Protocol over Secure
              Shell (SSH)", RFC 6242, DOI 10.17487/RFC6242, June 2011,
              <https://www.rfc-editor.org/info/rfc6242>.

   [RFC6991]  Schoenwaelder, J., Ed., "Common YANG Data Types",
              RFC 6991, DOI 10.17487/RFC6991, July 2013,
              <https://www.rfc-editor.org/info/rfc6991>.

   [RFC7224]  Bjorklund, M., "IANA Interface Type YANG Module",
              RFC 7224, DOI 10.17487/RFC7224, May 2014,
              <https://www.rfc-editor.org/info/rfc7224>.

   [RFC8040]  Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF
              Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017,
              <https://www.rfc-editor.org/info/rfc8040>.

   [RFC8341]  Bierman, A. and M. Bjorklund, "Network Configuration
              Access Control Model", STD 91, RFC 8341,
              DOI 10.17487/RFC8341, March 2018,
              <https://www.rfc-editor.org/info/rfc8341>.

   [RFC8343]  Bjorklund, M., "A YANG Data Model for Interface
              Management", RFC 8343, DOI 10.17487/RFC8343, March 2018,
              <https://www.rfc-editor.org/info/rfc8343>.

   [RFC8446]  Rescorla, E., "The Transport Layer Security (TLS) Protocol
              Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018,
              <https://www.rfc-editor.org/info/rfc8446>.

8.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.
Top   ToC   RFC8561 - Page 45
   [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.0, May 2017.

   [EN302217-2]
              ETSI, "Fixed Radio Systems; Characteristics and
              requirements for point to-point equipment and antennas;
              Part 2: Digital systems operating in frequency bands from
              1 GHz to 86 GHz; Harmonised Standard covering the
              essential requirements of article 3.2 of Directive
              2014/53/EU", EN 302 217-2 V3.1.1, May 2017.

   [G.808.1]  ITU-T, "SERIES G: TRANSMISSION SYSTEMS AND MEDIA, DIGITAL
              SYSTEMS AND NETWORKS; Digital networks ; General aspects
              Generic protection switching ; Linear trail and subnetwork
              protection", ITU-T Recommendation G.808.1, May 2014.

   [G.826]    ITU-T, "SERIES G: TRANSMISSION SYSTEMS AND MEDIA, DIGITAL
              SYSTEMS AND NETWORKS; Digital networks - Quality and
              availability targets; End-to-end error performance
              parameters and objectives for international, constant bit-
              rate digital paths and connections", ITU-T
              Recommendation G.826, December 2002.

   [MICROWAVE-RADIO-LINK]
              Ahlberg, J., Carlson, J., Lund, H., Olausson, T., Ye, M.,
              and M. Vaupotic, "Microwave Radio Link YANG Data Models",
              Work in Progress, draft-ahlberg-ccamp-microwave-radio-
              link-01, May 2016.

   [ONF-model]
              ONF, "Microwave Information Model", TR-532, version 1.0,
              December 2016,
              <https://www.opennetworking.org/images/stories/downloads/
              sdn-resources/technical-reports/
              TR-532-Microwave-Information-Model-V1.pdf>.

   [RFC8340]  Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams",
              BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018,
              <https://www.rfc-editor.org/info/rfc8340>.

   [RFC8342]  Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K.,
              and R. Wilton, "Network Management Datastore Architecture
              (NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018,
              <https://www.rfc-editor.org/info/rfc8342>.
Top   ToC   RFC8561 - Page 46
   [RFC8432]  Ahlberg, J., Ed., Ye, M., Ed., Li, X., Contreras, LM., and
              CJ. Bernardos, "A Framework for Management and Control of
              Microwave and Millimeter Wave Interface Parameters",
              RFC 8432, DOI 10.17487/RFC8432, October 2018,
              <https://www.rfc-editor.org/info/rfc8432>.

   [TR102311] ETSI, "Fixed Radio Systems; Point-to-point equipment;
              Specific aspects of the spatial frequency reuse method",
              ETSI TR 102 311 V1.2.1, November 2015.
Top   ToC   RFC8561 - Page 47

Appendix A. Example: 1+0 and 2+0 Configuration Instances

This section gives simple examples of 1+0 and 2+0 instances using the YANG data model defined in this document. The examples are not intended as a complete module for 1+0 and 2+0 configuration.

A.1. 1+0 Instance

/--------- Radio Link ---------\ Near End Far End +---------------+ +---------------+ | Radio Link | | Radio Link | | Terminal A | | Terminal B | | | | | | | | | | +-----------+ | | +-----------+ | | | | | Carrier A | | | | | | Carrier | |<--------->| | Carrier | | | |Termination| | | |Termination| | | | 1 | | | | 1 | | | +-----------+ | | +-----------+ | | | | | | | | | +---------------+ +---------------+ \--- Microwave Node ---/ \--- Microwave Node ---/ Figure 1: 1+0 Example Figure 1 shows a 1+0 example. The following instance shows the 1+0 configuration of the Near End node.
Top   ToC   RFC8561 - Page 48
      "interface": [
         {
           "name": "RLT-A",
           "description": "Radio Link Terminal A",
           "type": "microwaveRadioLinkTerminal",
           "id": "RLT-A",
           "mode": "one-plus-zero",
           "carrier-terminations": [
             "RLT-A:CT-1"
           ],
           "tdm-connections": [
             "tdm-type": "E1",
             "tdm-connections": "4"
           ]
         },

         {
           "name": "RLT-A:CT-1",
           "description": "Carrier Termination 1",
           "type": "microwaveCarrierTermination",
           "carrier-id": "A",
           "tx-enabled": true,
           "tx-frequency": 10728000,
           "duplex-distance": 644000,
           "channel-separation": 28000,
           "polarization": not-specified,
           "rtpc": {
             "maximum-nominal-power": 20
           },
           "single": {
             "selected-cm": "qam-512"
           }
         }
      ]
Top   ToC   RFC8561 - Page 49

A.2. 2+0 Instance

Figure 2 shows a 2+0 example. /--------- Radio Link ---------\ Near End Far End +---------------+ +---------------+ | Radio Link | | Radio Link | | Terminal A | | Terminal B | | | | | | | | | | +-----------+ | | +-----------+ | | | | | Carrier A | | | | | | Carrier | |<--------->| | Carrier | | | |Termination| | | |Termination| | | | 1 | | | | 1 | | | +-----------+ | | +-----------+ | | | | | | +-----------+ | | +-----------+ | | | | | Carrier B | | | | | | Carrier | |<--------->| | Carrier | | | |Termination| | | |Termination| | | | 2 | | | | 2 | | | +-----------+ | | +-----------+ | | | | | +---------------+ +---------------+ \--- Microwave Node ---/ \--- Microwave Node ---/ Figure 2: 2+0 Example The following instance shows the 2+0 configuration of the Near End node. "interface": [ { "name": "RLT-A", "description": "Radio Link Terminal A", "type": "microwaveRadioLinkTerminal", "id": "RLT-A", "mode": "two-plus-zero", "carrier-terminations": [ "RLT-A:CT-1", "RLT-A:CT-2" ],
Top   ToC   RFC8561 - Page 50
           "tdm-connections": [
             "tdm-type": "E1",
             "tdm-connections": "4"
           ]
         },

         {
           "name": "RLT-A:CT-1",
           "description": "Carrier Termination 1",
           "type": "microwaveCarrierTermination",
           "carrier-id": "A",
           "tx-enabled": true,
           "tx-frequency": 10728000,
           "duplex-distance": 644000,
           "channel-separation": 28000,
           "polarization": not-specified,
           "rtpc": {
             "maximum-nominal-power": 20
           },
           "single": {
             "selected-cm": "qam-512"
           }
         },

         {
           "name": "RLT-A:CT-2",
           "description": "Carrier Termination 2",
           "type": "microwaveCarrierTermination",
           "carrier-id": "B",
           "tx-enabled": true,
           "tx-oper-status": on,
           "tx-frequency": 10618000,
           "duplex-distance": 644000,
           "channel-separation": 28000,
           "polarization": not-specified,
           "rtpc": {
             "maximum-nominal-power": 20
           },
           "single": {
             "selected-cm": "qam-512"
           }
         }
      ]
Top   ToC   RFC8561 - Page 51

A.3. 2+0 XPIC Instance

The following instance shows the XPIC configuration of the Near End node. "interface": [ { "name": "RLT-A", "description": "Radio Link Terminal A", "type": "microwaveRadioLinkTerminal", "id": "RLT-A", "mode": "two-plus-zero", "carrier-terminations": [ "RLT-A:CT-1", "RLT-A:CT-2" ], "xpic-pairs": [ "RLT-A:CT-1", "RLT-A:CT-2" ], "tdm-connections": [ "tdm-type": "E1", "tdm-connections": "4" ] }, { "name": "RLT-A:CT-1", "description": "Carrier Termination 1", "type": "microwaveCarrierTermination", "carrier-id": "A", "tx-enabled": true, "tx-frequency": 10728000, "duplex-distance": 644000, "channel-separation": 28000, "polarization": not-specified, "rtpc": { "maximum-nominal-power": 20 }, "single": { "selected-cm": "qam-512" } },
Top   ToC   RFC8561 - Page 52
         {
           "name": "RLT-A:CT-2",
           "description": "Carrier Termination 2",
           "type": "microwaveCarrierTermination",
           "carrier-id": "B",
           "tx-enabled": true,
           "tx-oper-status": on,
           "tx-frequency": 10618000,
           "duplex-distance": 644000,
           "channel-separation": 28000,
           "polarization": not-specified,
           "rtpc": {
             "maximum-nominal-power": 20
           },
           "single": {
             "selected-cm": "qam-512"
           }
         }
      ]

Contributors

Koji Kawada NEC Corporation 1753, Shimonumabe Nakahara-ku Kawasaki, Kanagawa 211-8666 Japan Email: k-kawada@ah.jp.nec.com Carlos J. Bernardos Universidad Carlos III de Madrid Av. Universidad, 30 Leganes, Madrid 28911 Spain Email: cjbc@it.uc3m.es
Top   ToC   RFC8561 - Page 53

Authors' Addresses

Jonas Ahlberg Ericsson AB Lindholmspiren 11 Goteborg 417 56 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 Heidelberg 69115 Germany Email: Xi.Li@neclab.eu Daniela Spreafico Nokia - IT Via Energy Park, 14 Vimercate (MI) 20871 Italy Email: daniela.spreafico@nokia.com Marko Vaupotic Aviat Networks Motnica 9 Trzin-Ljubljana 1236 Slovenia Email: Marko.Vaupotic@Aviatnet.com