YANG definitions of common service types. Copyright of the Members of the Open ROADM MSA Agreement dated (c) 2016, All other ...
Version: 2023-09-29
module org-openroadm-common-service-types { yang-version 1; namespace "http://org/openroadm/common/service/types"; prefix org-openroadm-common-service-types; import ietf-yang-types { prefix yang; revision-date "2013-07-15"; } import ietf-inet-types { prefix inet; revision-date "2013-07-15"; } import org-openroadm-routing-constraints { prefix org-openroadm-routing-constraints; revision-date "2022-12-09"; } import org-openroadm-topology { prefix org-openroadm-topology; revision-date "2023-05-26"; } import org-openroadm-common-equipment-types { prefix org-openroadm-common-equipment-types; revision-date "2019-11-29"; } import org-openroadm-common-state-types { prefix org-openroadm-common-state-types; revision-date "2019-11-29"; } import org-openroadm-common-node-types { prefix org-openroadm-common-node-types; revision-date "2021-05-28"; } import org-openroadm-resource-types { prefix org-openroadm-resource-types; revision-date "2022-03-25"; } import org-openroadm-otn-common-types { prefix org-openroadm-otn-common-types; revision-date "2021-09-24"; } import org-openroadm-common-types { prefix org-openroadm-common-types; revision-date "2023-09-29"; } import org-openroadm-equipment-states-types { prefix org-openroadm-equipment-states-types; revision-date "2019-11-29"; } import org-openroadm-service-format { prefix org-openroadm-service-format; revision-date "2019-11-29"; } import org-openroadm-common-attributes { prefix org-openroadm-common-attributes; revision-date "2021-09-24"; } import org-openroadm-common-phy-codes { prefix org-openroadm-common-phy-codes; revision-date "2023-09-29"; } import org-openroadm-common-optical-channel-types { prefix org-openroadm-common-optical-channel-types; revision-date "2023-05-26"; } import org-openroadm-common-link-types { prefix org-openroadm-common-link-types; revision-date "2019-11-29"; } import org-openroadm-resource { prefix org-openroadm-resource; revision-date "2023-05-26"; } organization "Open ROADM MSA"; contact "OpenROADM.org"; description "YANG definitions of common service types. Copyright of the Members of the Open ROADM MSA Agreement dated (c) 2016, All other rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the Members of the Open ROADM MSA Agreement nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE MEMBERS OF THE OPEN ROADM MSA AGREEMENT ''AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT THE MEMBERS OF THE OPEN ROADM MSA AGREEMENT BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE"; revision "2023-09-29" { description "Version 14.0"; } revision "2023-05-26" { description "Version 13.1"; } revision "2023-03-31" { description "Version 13.0"; } revision "2022-12-09" { description "Version 12.1"; } revision "2022-09-30" { description "Version 12.0"; } revision "2022-05-27" { description "Version 11.1"; } revision "2022-03-25" { description "Version 11.0"; } revision "2021-12-10" { description "Version 10.1"; } revision "2021-09-24" { description "Version 10.0"; } revision "2021-05-28" { description "Version 9.1"; } revision "2021-03-26" { description "Version 9.0"; } revision "2020-12-11" { description "Version 8.1"; } revision "2020-09-25" { description "Version 8.0"; } revision "2020-05-29" { description "Version 7.1.0"; } revision "2020-03-27" { description "Version 7.0.0"; } revision "2019-11-29" { description "Version 6.1.0"; } revision "2019-09-27" { description "Version 6.0.0"; } revision "2019-05-31" { description "Version 5.1.0"; } revision "2019-03-29" { description "Version 5.0.0"; } revision "2018-11-30" { description "Version 4.1.0"; } revision "2018-09-28" { description "Version 4.0.0"; } revision "2018-05-30" { description "Version 3.1.0"; } revision "2018-03-30" { description "Version 3.0.0"; } revision "2017-12-15" { description "Version 2.2"; } revision "2017-09-29" { description "Version 2.1"; } revision "2017-07-28" { description "Version 2.0.1 - added revision-date to imports"; } revision "2017-06-26" { description "Version 2.0"; } revision "2016-10-14" { description "Version 1.2"; } identity service-resiliency-type-identity { description "A unique resiliency type identification of the service."; } identity unprotected { base service-resiliency-type-identity; description "the service is not protected in the OpenROADM layer"; } identity unprotected-diversely-routed { base service-resiliency-type-identity; description "the service is not protected in the OpenROADM layer, but may be protected in a higher layer a coupled service that may be routed partially or fully disjointly is defined"; } identity protected { base service-resiliency-type-identity; description "the service is protected in the OpenROADM layer : the protection is handled autonomously in this layer"; } identity restorable { base service-resiliency-type-identity; description "the service can be restored autonomously in the OpenROADM layer"; } identity external-trigger-restorable { base service-resiliency-type-identity; description "the service can be restored in the OpenROADM layer, but the restoration is triggered at a higher layer through service models' rpc"; } typedef rpc-actions { type enumeration { enum "service-create" { value 1; } enum "service-feasibility-check" { value 2; } enum "service-delete" { value 3; } enum "equipment-notification" { value 4; } enum "temp-service-create" { value 5; } enum "temp-service-delete" { value 6; } enum "service-roll" { value 7; } enum "service-reconfigure" { value 8; } enum "service-restoration" { value 9; } enum "service-reversion" { value 10; } enum "service-reroute" { value 11; } enum "service-reroute-confirm" { value 12; } enum "network-re-optimization" { value 13; } enum "service-feasibility-check-bulk" { value 14; } enum "ber-test" { value 15; } enum "controller-parameters-setting" { value 16; } enum "optical-tunnel-create" { value 17; } enum "optical-tunnel-request-cancel" { value 18; } enum "fill-catalog-with-or-operational-modes" { value 19; } enum "fill-catalog-with-specific-operational-modes" { value 20; } enum "end-terminal-performance-info-request" { value 21; } enum "end-terminal-activation-request" { value 22; } enum "end-terminal-deactivation-request" { value 23; } enum "end-terminal-power-control" { value 24; } } description "rpc-actions include all the rpc methods"; } typedef ethernet-encoding-type { type enumeration { enum "10GBASE-W" { value 1; } enum "10GBASE-R" { value 2; } } } typedef mapping-mode-type { type enumeration { enum "GFP-F" { value 1; reference "GFP-F - ITU-T G.7041 SubClause 7.1, Payload Only"; } enum "GFP-E" { value 2; reference "GFP-E - ITU-T G.7041 SubClause 7.9, Payload + Preamble + Ordered Sets"; } enum "PCS-Transparent" { value 3; reference "PCS-Transparent - ITU-T G.709 Subclause 17.2 , CBR10G3 mapping to ODU2e"; } } } typedef service-layer-type { type enumeration { enum "wdm" { value 1; } enum "otn" { value 2; } } } typedef service-notification-types { type enumeration { enum "service-create-result" { value 1; } enum "service-reconfigure-result" { value 2; } enum "service-delete-result" { value 3; } enum "service-roll-result" { value 4; } enum "service-revert-result" { value 5; } enum "service-reroute-result" { value 6; } enum "service-restoration-result" { value 7; } enum "successful-path-computation-resource-reserved" { value 8; } enum "path-computation-failed" { value 9; } enum "end-terminal-activation-status" { value 10; } } } typedef end-terminal-activation-status-type { type enumeration { enum "activated" { value 1; } enum "deactivated" { value 2; } } } typedef connection-type { type enumeration { enum "service" { value 1; } enum "infrastructure" { value 2; } enum "roadm-line" { value 3; } enum "optical-tunnel" { value 4; } } } typedef resource-status-type { type enumeration { enum "deployed" { value 1; description "find the best route using deployed network resources, regardless of network failures; lifecycle-state must be deployed and operational-state is ignored."; } enum "in-service" { value 2; description "find the best route using deployed network resources, but route around failed resources; lifecycle-state must be deployed and operational-state must be inService."; } enum "planned" { value 3; description "find the best route using both deployed and planned network resources; lifecycle-state must be planned or deployed (deploying, deployed-updating, deployed- augmented, and deploy-failed may be considered planned states) and operational-state is ignored. if planned is selected, due-date must be specified in the service request."; } } default "deployed"; description "identifies the state of network resources required to complete a service request. default is deployed"; } typedef service-condition { type enumeration { enum "restored-temporarily" { value 1; } enum "re-routed-temporarily" { value 2; } enum "activated-for-service" { value 3; } enum "activated-for-further-check" { value 4; } enum "activated-for-troubleshooting-failure" { value 5; } } } grouping service-and-supporting-services { description "Service identifiers and supporting services details"; uses service-identifiers-container; uses supporting-services-identifiers-and-ends; } // grouping service-and-supporting-services grouping supporting-services-identifiers-and-ends { container supporting-services { list supporting-service-details { key "index"; leaf index { type uint16; description "Service number of the supporting service"; } uses service-identifiers-container; uses service-ends-container; } // list supporting-service-details } // container supporting-services } // grouping supporting-services-identifiers-and-ends grouping trail-trace { description "Trail trace grouping"; uses org-openroadm-common-attributes:trail-trace-tx; uses org-openroadm-common-attributes:trail-trace-other; } // grouping trail-trace grouping tcm-attributes { description "Tandem Connection Monitoring (TCM) attributes"; leaf layer { type uint8 { range "1..6"; } description "TCM layer"; } leaf monitoring-mode { type enumeration { enum "not-terminated" { value 0; description "Not Terminated: no detection or generation. Overhead is passed through the interface transparently in receive direction unless extension is set for erase"; } enum "terminated" { value 1; description "Terminated: detection and generation enabled. Overhead is erased (replaced with all zeros) in receive direction, unless extension is set to passthrough"; } enum "monitored" { value 2; description "Monitored: detection enabled. Overhead is passed through the interface transparently in receive direction unless extension is set for erase"; } } description "Monitoring mode of the TCM layer"; } leaf ltc-act-enabled { type boolean; description "enable/disable alarm transfer on detection of Loss of Tandem Connection (LTC)"; } leaf proactive-delay-measurement-enabled { type boolean; description "enable/disable proactive Delay Measurement for TCM"; } leaf tcm-direction { type org-openroadm-otn-common-types:tcm-direction-enum; description "Direction of TCM."; } uses trail-trace; uses org-openroadm-common-attributes:deg-threshold; } // grouping tcm-attributes grouping otn-attributes-grp { container otn-attributes { when "(../service-format='OTU' or ../service-format='ODU')" { description "For any OTN services (OTU and OTN)"; } uses org-openroadm-common-attributes:parent-odu-allocation; uses org-openroadm-common-types:fec-grouping { description "OTN FEC / Forward Error Correction"; } uses org-openroadm-common-attributes:trail-trace-tx; uses org-openroadm-common-attributes:trail-trace-other; uses org-openroadm-common-attributes:deg-threshold; leaf-list reserved-tcm-layer { type uint8; } list tcm { key "layer tcm-direction"; max-elements 12; description "Tandem Connection Management"; uses tcm-attributes; } // list tcm } // container otn-attributes } // grouping otn-attributes-grp grouping ethernet-subrate-attributes-grp { container ethernet-attributes { when "(../service-format='Ethernet')" { description "For any Ethernet services"; } uses org-openroadm-common-types:fec-grouping { description "ETH FEC / Forward Error Correction"; } uses org-openroadm-common-service-types:subrate-eth-sla; } // container ethernet-attributes } // grouping ethernet-subrate-attributes-grp grouping service-ends-container { container service-a-end { uses service-endpoint-summary; } // container service-a-end container service-z-end { uses service-endpoint-summary; } // container service-z-end } // grouping service-ends-container grouping alien-service-ends-setting-container { container service-a-end { uses service-endpoint-summary; leaf min-output-power { type org-openroadm-common-link-types:power-dBm; description "the minimum power that can be set on end-terminal network port"; } leaf max-output-power { type org-openroadm-common-link-types:power-dBm; description "the maximum power that can be set on end-terminal network port"; } } // container service-a-end container service-z-end { uses service-endpoint-summary; leaf min-output-power { type org-openroadm-common-link-types:power-dBm; description "the minimum power that can be set on end-terminal network port"; } leaf max-output-power { type org-openroadm-common-link-types:power-dBm; description "the maximum power that can be set on end-terminal network port"; } } // container service-z-end } // grouping alien-service-ends-setting-container grouping service-endpoint-summary { description "Brief form of service-endpoint"; container service-endpoint-details { leaf clli { type string; mandatory true; description "CLLI. Note this CLLI must match the site associated with the device-id of this endpoint"; } uses org-openroadm-resource-types:device-id; container tx-direction { uses service-port; } // container tx-direction container rx-direction { uses service-port; } // container rx-direction } // container service-endpoint-details } // grouping service-endpoint-summary grouping intermediate-site-container { description "Intermediate site used in the service feasibility check output. This is different from the service-endpoint structure"; list intermediate-site { key "clli"; description "List of intermediate sites in the service feasiblity check output response"; leaf clli { type string; } list node { key "node-id"; leaf node-id { type org-openroadm-common-node-types:node-id-type; description "List of nodes within a CLLI"; } list equipment-required { key "equipment-identifier"; description "List of required equipment, including equipment type, state and quantity"; uses equipment-info; } // list equipment-required } // list node } // list intermediate-site } // grouping intermediate-site-container grouping service-identifiers-container { container service-identifiers { leaf service-name { type string; } leaf common-id { type string; } leaf version-number { type uint64; } } // container service-identifiers } // grouping service-identifiers-container grouping configuration-response-common { container configuration-response-common { leaf request-id { type string; mandatory true; } leaf response-code { type string; mandatory true; } leaf response-message { type string; } leaf ack-final-indicator { type string; mandatory true; } } // container configuration-response-common } // grouping configuration-response-common grouping response-parameters { container response-parameters { description "Violated soft constraints"; uses org-openroadm-routing-constraints:routing-constraints; } // container response-parameters } // grouping response-parameters grouping subrate-eth-sla { container subrate-eth-sla { presence "Explicit assignment of subrate ethernet allocation"; description "SLA (Service Level Agreement) for subrate Ethernet"; uses org-openroadm-common-types:eth-rate-and-burst-size; } // container subrate-eth-sla } // grouping subrate-eth-sla grouping external-interface-characteristics { list supported-operational-modes { key "preference"; description "list of supported operational modes associated to a preference for their selection by the Path Computation Engine (1 is the highest priority) only one operational mode shall be associated to a preference. 2 leaves present since this mode could be either specific or an openROADM operational-mode"; leaf preference { type int16; description "preference/priority associated to the operational mode"; } leaf operational-mode-id { type string; description "the supported operational mode : either openROADM or specific "; } } // list supported-operational-modes leaf min-frequency { type org-openroadm-common-optical-channel-types:frequency-THz; description "Minimum acceptable Frequency in THz."; } leaf max-frequency { type org-openroadm-common-optical-channel-types:frequency-THz; description "Minimum acceptable Frequency in THz."; } leaf min-granularity { type org-openroadm-common-optical-channel-types:frequency-GHz; description "Minimum grid granularity in GHz."; } } // grouping external-interface-characteristics grouping service-endpoint { leaf service-format { type org-openroadm-service-format:service-format; mandatory true; description "Format of the requested service: Ethernet, OTU, etc."; } leaf service-rate { when "../service-format != 'OMS' and ../service-format != 'ODU'" { description "service rate not applicable when service format is roadmline or ODU; valid for OTU since service-rate has already been supported for wdm layer OTU services (100 for OTU4)"; } type uint32; description "Rate of the requested service in GBps"; } leaf is-split-lambda { type boolean; default "false"; description "This flag allows to specify whether to use split-lambda. It can be user controlled (or specified) or controller initiated. This is only applicable for line-service or network ports"; } leaf split-lambda-service-rate { when "../is-split-lambda = 'true' and ../service-format != 'OMS' and ../service-format != 'ODU'"; type uint32; description "This service rate is only applicable when the split-lambda is enabled. It will help to identify how many wavelengths to use. Only applicable to the WDM layer and OTUCn services."; } leaf other-service-format-and-rate { type string; description "Used when service-format is set to other in the bookend xponder use case. The use of other-service-format-and-rate is not standardized in the Open ROADM MSA and intended to allow the controller to support non-Open ROADM service formats. This value encodes both the service format and the rate supported. This field should not be specified when service format != other."; } leaf otu-service-rate { when "../service-format = 'OTU'" { description "only applicable for OTU services"; } type identityref { base org-openroadm-otn-common-types:otu-rate-identity; } description "OTU Rate of the requested service"; } leaf odu-service-rate { when "../service-format = 'ODU'" { description "only applicable for ODU services"; } type identityref { base org-openroadm-otn-common-types:odu-rate-identity; } description "ODU Rate of the requested service"; } leaf ethernet-encoding { when "(../service-format='Ethernet') and (../service-rate=10)" { description "Applicable only to Ethernet 10G services"; } type ethernet-encoding-type; description "Ethernet encoding type"; } leaf mapping-mode { when "(../service-format='Ethernet') and (../service-rate=10)" { description "Mapping Mode, currently only defined for Ethernet 10G services"; } type mapping-mode-type; description "Mapping mode."; } leaf client-phy-code { type identityref { base org-openroadm-common-phy-codes:client-phy-code-identity; } description "Client PHY Code for the service end point."; } uses otn-attributes-grp; leaf clli { type string; mandatory true; description "CLLI. Note this CLLI must match the site associated with the device-id of this endpoint"; } uses org-openroadm-resource-types:device-id; list tx-direction { key "index"; leaf index { type uint8; description "Used to list tx-direction attributes for each split-lambda wavelength/service"; } uses service-port; uses service-lgx; uses service-tail; } // list tx-direction list rx-direction { key "index"; leaf index { type uint8; description "used to list rx-direction attributes for each split-lambda wavelength/service"; } uses service-port; uses service-lgx; uses service-tail; } // list rx-direction leaf optic-type { type org-openroadm-common-equipment-types:optic-types; } container router { description "Needed for communication with DWDM pluggable"; leaf node-id { type org-openroadm-common-node-types:node-id-type; description "Node id. This is reported against the service, but may not get reflected in the service in the network."; } leaf ip-address { type inet:ip-address; description "Router IP Address. This is reported against the service, but may not get reflected in the service in the network."; } leaf url { type string; description "URL needed for communication with DWDM pluggable. This is reported against the service, but may not get reflected in the service in the network."; } } // container router leaf user-label { type string; description "Label for service endpoint, defined by the user"; } uses ethernet-subrate-attributes-grp; leaf project-id { type string; description "Project identifier for the service end point"; } leaf project-note { type string; description "Additional details associated with the service end point project"; } } // grouping service-endpoint typedef existing-resource-reuse-type { type enumeration { enum "regenerator" { value 1; description "Indicates reuse regenerator"; } enum "wavelength" { value 2; description "Indicates reuse of wavelength"; } enum "spectrum-portion" { value 3; description "Indicates reuse of frequency slot(s). Reuse the exact or partial portion of the spectrum of the original service specturm"; } enum "xponder" { value 4; description "This could be a transponder/muxponder/switchponder"; } enum "all" { value 99; description "Reuse all possible options"; } } description "Used to indicate the type of resource that the existing service can reuse wherever possible (best-effort)"; } grouping existing-service-grouping { container existing-service-attributes { description "This consists of all the attributes related to the existing service"; leaf is-existing { type boolean; description "This is set true if feasibility check is on an existing service with or without new constraints. Feasibility is done as if current service and its resources are released"; } leaf existing-service-name { when "../is-existing = 'true'"; type string; description "Name of the existing service"; } leaf reuse-existing-resources { type boolean; description "If true reuse the existing equipment wherever possible"; } leaf-list reusable-existing-resources { when "../reuse-existing-resources = 'true'"; type existing-resource-reuse-type; description "List of existing resources that can be reused; This list is enabled only when the reuse-existing-equipment is set true"; } } // container existing-service-attributes } // grouping existing-service-grouping grouping sdnc-request-header { container sdnc-request-header { leaf request-id { type string; } leaf rpc-action { type rpc-actions; } leaf notification-url { type string; } leaf request-system-id { type string; } } // container sdnc-request-header } // grouping sdnc-request-header grouping service-port { container port { description "From the device model perspective the port-device-name plus the port-circuit-pack-name plus the port-name uniquely identifies the port. From the network model perspective the openroadm-topology-ref plus port-device-name plus port-name uniquely identify the termination point in the network model."; leaf port-device-name { type string; } leaf port-circuit-pack-name { type string; } leaf port-circuit-pack-type { type string; } leaf port-type { type string; } leaf port-name { type string; } leaf port-rack { type string; } leaf port-shelf { type string; } leaf port-slot { type string; } leaf port-sub-slot { type string; } } // container port } // grouping service-port grouping service-lgx { container lgx { leaf lgx-device-name { type string; } leaf lgx-port-name { type string; } leaf lgx-port-rack { type string; } leaf lgx-port-shelf { type string; } } // container lgx } // grouping service-lgx grouping service-tail { container tail { container tail-roadm { description "ROADM on which the transponder is connected to (TID, IP Address, or FQDN)"; uses org-openroadm-resource-types:device-id; } // container tail-roadm container xponder-port { description "Muxponder port used in tail, that will get used as a service endpoint."; leaf circuit-pack-name { type string; } leaf port-name { type string; } } // container xponder-port leaf tail-roadm-port-aid { type string; description "This will provide the transponder port needed to inter-city ROADM connection"; } leaf tail-roadm-port-rack-location { type string; description "Transponder's location"; } } // container tail } // grouping service-tail grouping service-information { leaf due-date { type yang:date-and-time; description "Date and time service to be turn up. If time is not specified for a given date, default to midnight. Service turned up immediately if no due date is specified"; } leaf end-date { type yang:date-and-time; description "Date and time service to be removed"; } uses eventHorizon; leaf nc-code { type string; description "NC code applied to wavelength service only. This is reported against the service, but may not get reflected in the service in the network."; } leaf nci-code { type string; description "NCI code applied to wavelength service only. This is reported against the service, but may not get reflected in the service in the network."; } leaf secondary-nci-code { type string; description "NC code applied to wavelength service only. This is reported against the service, but may not get reflected in the service in the network."; } leaf customer { type string; description "To be included in ticket information. This is reported against the service, but may not get reflected in the service in the network."; } leaf customer-contact { type string; description "Customer contact information to be included in ticket information. This is reported against the service, but may not get reflected in the service in the network."; } leaf operator-contact { type string; description "Operator contact information to be included in ticket information. This is reported against the service, but may not get reflected in the service in the network."; } leaf service-layer { type service-layer-type; default "wdm"; description "Layer associated with service (e.g. wdm or otn)"; } leaf clli-network-ref { type string; description "Assumption: a service would not span multiple clli-network layers. Reference to the network-id of the clli-network layer."; } leaf openroadm-network-ref { type string; description "Assumption: a service would not span multiple openroadm-network layers. Reference to the network-id of the openroadm-network layer."; } leaf openroadm-topology-ref { type string; description "Assumption: a service would not span multiple topology layers. Reference to the network-id of either the openroadm-topology or the otn-topology layer depending upon service-layer (wdm or otn)."; } leaf sla-id { type string; description "Service Level Agreement"; } leaf bandwidth-calendaring { type boolean; description "True if service is active only during a specific time period"; } container bw-calendaring-parameters { when "../bandwidth-calendaring = 'true'" { description "Includes all attributes associated with bandwidth calendaring option. Used to set service profile : each service corresponds to one specific time-period. Services defined on complementary time periods can be linked together through the coupled-service attribute "; } list bw-calendaring-coupled-services { key "service-index"; leaf service-index { type uint16; description "service-number of the service that may be associated to the considered service"; } leaf service-name { type string; description "service-name of the service that may be associated to the considered service in service-list"; } leaf common-id { type string; description "common-id of the service that may be associated to the considered service in temp-service-list"; } leaf version-number { type uint64; description "common-id of the service that may be associated to the considered service in versioned-service-list"; } } // list bw-calendaring-coupled-services list recurrence-pattern { key "recurrence-id"; leaf recurrence-id { type uint32; description "id of the pattern defining the time during which the service is active "; } leaf-list day-of-the-week { type enumeration { enum "Monday" { value 1; } enum "Tuesday" { value 2; } enum "Wednesday" { value 3; } enum "Thursday" { value 4; } enum "Friday" { value 5; } enum "Saturday" { value 6; } enum "Sunday" { value 7; } } description "Each day for which the service is active from stat-time to end-time"; } leaf start-time { type string { pattern '\d{2}:\d{2}:\d{2}'; } description "start time expressed as hour:min:seconds"; } leaf end-time { type string { pattern '\d{2}:\d{2}:\d{2}'; } description "end time expressed as hour:min:seconds"; } } // list recurrence-pattern } // container bw-calendaring-parameters } // grouping service-information grouping routing-metric { container routing-metric { description "Describes the metrics used to route a service. All parameters of integer type, to set the priority of the routing criterion '0' means the criterion is not used, '1'coresponds to the highest priority, '255'coresponds to the lowest priority. Priority might be handled in several way : 1) To select one from several paths with the same metrics, using lower priority metrics until metrics calculated allow the selection; 2) Using priority as a weight for composite metric calculation"; leaf wdm-hop-count { type uint8 { range "0..255"; } default "1"; description "Metric corresponding to the number of hop in the wdm layer"; } leaf otn-hop-count { type uint8 { range "0..255"; } default "0"; description "Metric corresponding to the number of hop in the otn layer"; } leaf wdm-load { type uint8 { range "0..255"; } default "0"; description "Metric corresponding to the load of the wdm layer Can be used to avoid using heavy loaded links "; } leaf otn-load { type uint8 { range "0..255"; } default "0"; description "Metric corresponding to the load of the otn layer. Can be used to avoid using heavy loaded links/switchs "; } leaf latency { type uint8 { range "0..255"; } default "0"; description "Metric corresponding to the latency. Total path latency can be calculated from SRLG length of the OMS and the latency introduced by the equipment"; } leaf distance { type uint8 { range "0..255"; } default "0"; description "Metric associated with the distance. Total path distance can be calculated from SRLG length of the OMS"; } leaf wdm-TE-metric { type uint8 { range "0..255"; } default "0"; description "Used when routing shall be performed according to specific pre-defined TE-Metric. Total path metric can be calculated from OMS TE-metric attribute defined in org-openroadm-link module"; } leaf adaptation-number { type uint8 { range "0..255"; } default "0"; description "Metric associated with the adaptation between layers. Total path metric can can be calculated from the total number of transition between layers"; } leaf otn-TE-metric { type uint8 { range "0..255"; } default "0"; description "Used when routing shall be performed according to specific pre-defined metric associated with OTN (OTU/ODU level)"; } } // container routing-metric } // grouping routing-metric grouping service-resiliency { container service-resiliency { leaf resiliency { type identityref { base service-resiliency-type-identity; } description "describes the type of resiliency and the associated layer "; } leaf revertive { when "../resiliency != 'unprotected' and ../resiliency != 'unprotected-diversely-routed'" { description "revertive not applicable when service is neither protected nor restorable"; } type boolean; description "defines if the service shall revert to the initial working path after protection or restoration has been triggered and fault condition has disappeared"; } leaf wait-to-restore { when "../revertive = 'true'" { description "wait-to-restore applies for service defined as revertive "; } type uint64; units "ms"; description "time delay to revert to initial path after conditions for reversion are satisfied"; } leaf holdoff-time { when "../resiliency != 'unprotected' and ../resiliency != 'unprotected-diversely-routed'" { description "holdoff-time applies when services are either protected or restorable"; } type uint64; units "ms"; description "time delay to initiate a protection or restoration event"; } leaf pre-calculated-backup-path-number { when "../resiliency = 'restorable' or ../resiliency = 'external-trigger-restorable'" { description "when service is restorable, defines the number of paths that shall be or have been pre-calculated"; } type uint8; description "Associated to service-create / reconfigure / feasibility-check rpcs --> defines the target number of backup-paths to be calculated by PCE. This is an optional parameter : operator can provide it to conform with specific engineering rules. If not provided, PCE will evaluate the number of backup path to be provided automously. Associated with service --> gives the effective number of backup-paths returned/calculated by PCE that can be find in topology container"; } container coupled-service { when "../resiliency = 'unprotected-diversely-routed'" { description "for unprotected-diversely-routed services only one path is defined. Allows providing a link between services that are coupled through a routing disjonction criterion"; } list coupled-services { key "service-index"; leaf service-index { type uint16; description "service-number of the service that may be routed disjointly to the considered service"; } leaf service-name { type string; description "service-name of the service that may be routed disjointly to the considered service in service-list"; } leaf common-id { type string; description "common-id of the service that may be routed disjointly to the considered service in temp-service-list"; } leaf version-number { type uint64; description "common-id of the service that may be routed disjointly to the considered service in versioned-service-list"; } } // list coupled-services } // container coupled-service } // container service-resiliency } // grouping service-resiliency grouping service-order { description "Service Order information for service"; leaf order-id { type string; description "Order identifier for this service"; } leaf order-note { type string; description "Additional details associated with the service order"; } } // grouping service-order grouping resource-status { description "Grouping used to consisistenty apply resource-status naming to appropriate RPC."; leaf resource-status { type resource-status-type; description "identifies the state of network resources required to complete a service request."; } } // grouping resource-status grouping service { leaf service-name { type string; description "Identifier for the service to be created in the ROADM network, e.g., CLFI, CLCI, etc."; } leaf common-id { type string; description "To be used by the ROADM controller to identify the routing constraints received from planning application (PED)."; } uses service-order; uses sdnc-request-header; uses service-resiliency; uses routing-metric; leaf connection-type { type connection-type; mandatory true; description "Connection type"; } leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; description "Lifecycle State of service. Whether it is planned, deployed, in maintenance, etc."; } uses resource-status; leaf administrative-state { type org-openroadm-equipment-states-types:admin-states; description "Administrative State: Intended state of service"; } leaf operational-state { type org-openroadm-common-state-types:state; config false; description "Operational State: Actual state of service"; } leaf condition { type service-condition; description "Service Condition: Additional information about the state of the service. Only sent when applicable."; } leaf frequency { when "../connection-type = 'optical-tunnel'" { description "Describes the frequency used by the external optical transceiver handled by a 3rd party controller for an optical-tunnel service"; } type org-openroadm-common-optical-channel-types:frequency-THz; description "Center Frequency in THz."; } leaf width { when "../connection-type = 'optical-tunnel'" { description "Describes the och/otsi width used by the external optical transceiver handled by a 3rd party controller for an optical-tunnel service"; } type org-openroadm-common-optical-channel-types:frequency-GHz; description "Frequency width in GHz."; } container service-a-end { uses service-endpoint; container optical-attributes { when "../../connection-type = 'optical-tunnel' or ../../connection-type = 'infrastructure'" { description "Describes settings and expected performances that might differ from one to the other end and which apply to Xponders for an infrastructure service, and to external optical transceivers handled by a 3rd party controller for an optical-tunnel service"; } leaf operational-mode { type string; description "the supported operational mode : either openROADM or specific "; } uses org-openroadm-resource:path-computation-outputs; } // container optical-attributes } // container service-a-end container service-z-end { uses service-endpoint; container optical-attributes { when "../../connection-type = 'optical-tunnel' or ../../connection-type = 'infrastructure'" { description "Describes settings and expected performances that might differ from one to the other end and which apply to Xponders for an infrastructure service, and to external optical transceivers handled by a 3rd party controller for an optical-tunnel service"; } leaf operational-mode { type string; description "the supported operational mode : either openROADM or specific "; } uses org-openroadm-resource:path-computation-outputs; } // container optical-attributes } // container service-z-end uses org-openroadm-routing-constraints:routing-constraints; uses service-information; leaf latency { type decimal64 { fraction-digits 3; } units "milliseconds"; description "One-way latency (in milliseconds) on service"; } leaf-list fiber-span-srlgs { type string; description "Shared risk link group identifiers"; } list equipment-srgs { key "srg-number"; uses org-openroadm-resource-types:srg-number; } // list equipment-srgs leaf-list supporting-service-name { type string; description "The service name that this runs over top. If connection-type is service, then this is the related connection-type = infrastructure service, for example."; } leaf current-active-path-id { type uint8; description "defines the current active path : '0' if active path is the working path id of the active backup path if protection or restoration has been triggered"; } container topology { description "topology corresponds to working-path which is the default path. It defines the initial path to which services defined as revertive may revert to when the failure condition disappear"; uses org-openroadm-topology:topology; } // container topology container backup-topology { list backup-path { key "backup-path-id"; leaf backup-path-id { type uint8 { range "1..255"; } description "Several backup paths may be used when backup-paths are pre-calculated. Backup-path-id avoids 0 which is associated with working path in current-active-path"; } leaf failure-case-id { type string; description "A failure case Id can be used to associate a backup-path to a specific failure (srlg, OMS,...)"; } uses org-openroadm-topology:topology; } // list backup-path } // container backup-topology container network-topology { uses org-openroadm-topology:network-topology; } // container network-topology container network-backup-topology { list backup-path { key "backup-path-id"; leaf backup-path-id { type uint8 { range "1..255"; } description "Several backup paths may be used when backup-paths are pre-calculated. Backup-path-id avoids 0 which is associated with working path in current-active-path"; } leaf failure-case-id { type string; description "A failure case Id can be used to associate a backup-path to a specific failure (srlg, OMS,...)"; } uses org-openroadm-topology:network-topology; } // list backup-path } // container network-backup-topology leaf is-bandwidth-locked { type boolean; default "false"; description "Bandwidth lock (true, false) indicates whether the service is administratively prohibited from taking on more capacity - ie whether it can be used as a supporting service in any new service creations. Unlike administrative status, this does not impact any previous planned or deployed services."; } } // grouping service grouping service-notification-result { leaf service-name { type string; description "Identifier for the service e.g., CLFI, CLCI, etc."; } leaf version-number { type uint64; description "Identifier for the versioned service"; } leaf common-id { type string; description "Identifier for the temp service"; } leaf actual-date { type yang:date-and-time; description "Actual date and time (if successful)"; } } // grouping service-notification-result grouping service-port-list { list port { key "circuit-pack-name port-name"; description "List allows to output more than one piece of equipment per CLLI; Port-name is unique in the context of circuit-pack"; leaf circuit-pack-name { type string; } leaf port-name { type string; } leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; } } // list port } // grouping service-port-list grouping equipment-info { leaf equipment-type { type string; description "The set of valid value is derived from the equipment-type grouping used in the device model."; } leaf equipment-identifier { type string; } leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; } leaf equipment-rack { type string; } leaf equipment-shelf { type string; } leaf equipment-slot { type string; } leaf equipment-sub-slot { type string; } leaf is-reused { type boolean; description "This is set true if the equipment-required is being reused for service roll"; } uses service-port-list; } // grouping equipment-info grouping eventHorizon { leaf eventHorizonStart { type yang:date-and-time; description "Start time to ensure that the service is routable and viable. Required resources shall be considered reserved from this time. If not provided, defaults to due-date."; } leaf eventHorizonEnd { type yang:date-and-time; description "End time to ensure that the service is routable and viable. Required resources shall be considered reserved until this time. If not provided, defaults to end-date."; } } // grouping eventHorizon grouping service-hierarchy { leaf service-identifier { type string; description "Based on the level in the service hierarchy, this indentifier can be for the proposed or existing service"; } leaf service-layer { type service-layer-type; default "wdm"; description "Layer associated with service (e.g. wdm or otn)"; } container service-a-end { leaf clli { type string; description "Based on the level in the service hierarchy, A-end CLLI of the proposed or existing service."; } } // container service-a-end container service-z-end { leaf clli { type string; description "Based on the level in the service hierarchy, Z-end CLLI of the proposed or existing service."; } } // container service-z-end list supporting-service { key "id"; uses supporting-service; } // list supporting-service container transport-assignment { container mc-ttp { description "Media Channel Trail Termination Point (MC-TTP)"; uses org-openroadm-resource:mc-ttp-attributes; } // container mc-ttp list nmc-ctp { key "id"; description "List of Network Media Channel Connection Termination Point (NMC-CTP)"; leaf id { type string; description "This used to indentify the NMC in the MC. For example split-lambda would have two NMCs"; } uses org-openroadm-resource:nmc-ctp-attributes; } // list nmc-ctp container odu-allocation { description "parent odu allocation"; leaf trib-port-number { type uint16 { range "1 .. 80"; } description "Assigned tributary port number in parent OPU"; } choice trib-slots-choice { description "trib slot selection"; case opu { leaf min-trib-slot { type uint16; description "Minimum assigned trib slots occupied in parent OPU MSI"; } leaf max-trib-slot { type uint16; description "Maximum assigned trib slots occupied in parent OPU MSI"; } } // case opu case opucn { leaf opucn-min-trib-slot { type org-openroadm-otn-common-types:opucn-trib-slot-def; description "Minimum OPUCn 5G trib slots in the form of TS #A.B (G.709)"; } leaf opucn-max-trib-slot { type org-openroadm-otn-common-types:opucn-trib-slot-def; description "Maximum OPUCn 5G trib slots in the form of TS #A.B (G.709)"; } } // case opucn } // choice trib-slots-choice } // container odu-allocation leaf is-reused { type boolean; description "This flag is true if the spectral assignment overlaps--in part or in full--with that of the active instance of the service. A determination whether the overlap is full or partial requires a detailed comparison of spectral assignments; it is not indicated here."; } } // container transport-assignment } // grouping service-hierarchy grouping supporting-service { leaf service-identifier { type string; } leaf id { type string; } container service-a-end { uses supporting-service-detail; } // container service-a-end container service-z-end { uses supporting-service-detail; } // container service-z-end } // grouping supporting-service grouping supporting-service-detail { leaf service-format { type org-openroadm-service-format:service-format; mandatory true; description "Format of the requested service: Ethernet, OTU, etc."; } leaf service-rate { when "../service-format != 'OMS' and ../service-format != 'ODU'" { description "service rate not applicable when service format is roadmline or ODU; valid for OTU since service-rate has already been supported for wdm layer OTU services (100 for OTU4)"; } type uint32; description "Rate of the requested service in GBps"; } leaf other-service-format-and-rate { type string; description "Used when service-format is set to other in the bookend xponder use case. The use of other-service-format-and-rate is not standardized in the Open ROADM MSA and intended to allow the controller to support non-Open ROADM service formats. This value encodes both the service format and the rate supported. This field should not be specified when service format != other."; } leaf otu-service-rate { when "../service-format = 'OTU'" { description "only applicable for OTU services"; } type identityref { base org-openroadm-otn-common-types:otu-rate-identity; } description "OTU Rate of the requested service"; } leaf odu-service-rate { when "../service-format = 'ODU'" { description "only applicable for ODU services"; } type identityref { base org-openroadm-otn-common-types:odu-rate-identity; } description "ODU Rate of the requested service"; } leaf clli { type string; description "CLLI of the supporting service"; } leaf node-id { type org-openroadm-common-node-types:node-id-type; description "Node id. This is reported against the service, but may not get reflected in the service in the network."; } } // grouping supporting-service-detail grouping max-regeneration-options { leaf max-regeneration-options { type uint8; default "1"; description "Max regeneration options, is maximum number of regeneration-option-list elements requested in service-feasibility output. RNC can return less number of regeneration-options based on it's calculation but should not return more than max-regeneration-options. The goal of this field is to avoid RNC from having performance issues."; } } // grouping max-regeneration-options grouping regeneration-option-list { list regeneration-option-list { key "regeneration-option-rank"; leaf regeneration-option-rank { type uint8; description "Regen option rank is derived rank based on optical performance or based on other metrics."; } list regeneration-clli-list { key "sequence-id"; leaf sequence-id { type uint8; description "Sequence id will define order of regeneration location for output path in A to Z direction."; } leaf regeneration-clli { type string; description "CLLI for the site where regeneraton is located or bring proposed."; } leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; description "Lifecycle State for regeneration CLLI indicating whether regen is already deployed or being proposed for at this site."; } } // list regeneration-clli-list } // list regeneration-option-list } // grouping regeneration-option-list } // module org-openroadm-common-service-types
© 2023 YumaWorks, Inc. All rights reserved.