netconfcentral logo

ietf-interface-protection

HTML

ietf-interface-protection@2019-06-19



  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).

     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";

    }


    identity protection-architecture-type {
      base 
      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";

    }

    identity protection-states {
      base 
      description
        "Identities describing the status of the protection
       in a group of interfaces configured in
       a protection mode.";
    }

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

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

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

    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.";
          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" {
              value 0;
              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" {
              value 1;
              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";
          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";

        }  // rpc manual-switch-working

        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";

        }  // rpc manual-switch-protection

        action forced-switch {
          description
            "A switch action initiated by an operator command.
           It switches a normal traffic signal to the protection
           transport entity and forces it to remain on that
           entity even when criteria for switching back to
           the original entity are fulfilled.";
          reference
            "ITU-T G.808.1";

        }  // rpc forced-switch

        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";

        }  // rpc lockout-of-protection

        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";

        }  // rpc freeze

        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";

        }  // rpc exercise

        action clear {
          description
            "An action clears all switch commands.";
          reference
            "ITU-T G.808.1";

        }  // rpc clear
      }  // list protection-group
    }  // grouping protection-groups
  }  // module ietf-interface-protection

Summary

  
  
Organization Internet Engineering Task Force (IETF) CCAMP WG
  
Module ietf-interface-protection
Version 2019-06-19
File ietf-interface-protection@2019-06-19.yang
  
Prefix ifprot
Namespace urn:ietf:params:xml:ns:yang:ietf-interface-protection
  
Cooked /cookedmodules/ietf-interface-protection/2019-06-19
YANG /src/ietf-interface-protection@2019-06-19.yang
XSD /xsd/ietf-interface-protection@2019-06-19.xsd
  
Abstract This is a module for the entities in a generic interface protection mechanism. Copyright (c) 2019 IETF Trust and the persons id...
  
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).

This version of this YANG module is part of RFC 8561; see
the RFC itself for full legal notices.

Groupings

Grouping Objects Abstract
protection-groups protection-group Configuration of protected groups of interfaces providing protection for each other. More than one protected group per higher-layer interface is allowed.