From 4bfd864f10b68b71482b35c818559068ef8d5797 Mon Sep 17 00:00:00 2001 From: Thomas Voss Date: Wed, 27 Nov 2024 20:54:24 +0100 Subject: doc: Add RFC documents --- doc/rfc/rfc7759.txt | 1627 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 1627 insertions(+) create mode 100644 doc/rfc/rfc7759.txt (limited to 'doc/rfc/rfc7759.txt') diff --git a/doc/rfc/rfc7759.txt b/doc/rfc/rfc7759.txt new file mode 100644 index 0000000..10f2dd0 --- /dev/null +++ b/doc/rfc/rfc7759.txt @@ -0,0 +1,1627 @@ + + + + + + +Internet Engineering Task Force (IETF) E. Bellagamba +Request for Comments: 7759 +Category: Standards Track G. Mirsky +ISSN: 2070-1721 Ericsson + L. Andersson + Huawei Technologies + P. Skoldstrom + Acreo AB + D. Ward + Cisco + J. Drake + Juniper + February 2016 + + + Configuration of Proactive Operations, + Administration, and Maintenance (OAM) Functions for MPLS-Based + Transport Networks Using Label Switched Path (LSP) Ping + +Abstract + + This specification describes the configuration of proactive MPLS-TP + Operations, Administration, and Maintenance (OAM) functions for a + given Label Switched Path (LSP) using a set of TLVs that are carried + by the LSP Ping protocol. + +Status of This Memo + + This is an Internet Standards Track document. + + This document is a product of the Internet Engineering Task Force + (IETF). It represents the consensus of the IETF community. It has + received public review and has been approved for publication by the + Internet Engineering Steering Group (IESG). Further information on + Internet Standards is available in Section 2 of RFC 5741. + + Information about the current status of this document, any errata, + and how to provide feedback on it may be obtained at + http://www.rfc-editor.org/info/rfc7759. + + + + + + + + + + + + +Bellagamba, et al. Standards Track [Page 1] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + +Copyright Notice + + Copyright (c) 2016 IETF Trust and the persons identified as the + document authors. All rights reserved. + + This document is subject to BCP 78 and the IETF Trust's Legal + Provisions Relating to IETF Documents + (http://trustee.ietf.org/license-info) in effect on the date of + publication of this document. Please review these documents + carefully, as they describe your rights and restrictions with respect + to this document. Code Components extracted from this document must + include Simplified BSD License text as described in Section 4.e of + the Trust Legal Provisions and are provided without warranty as + described in the Simplified BSD License. + +Table of Contents + + 1. Introduction ....................................................3 + 1.1. Conventions Used in This Document ..........................4 + 1.1.1. Terminology .........................................4 + 1.1.2. Requirements Language ...............................5 + 2. Theory of Operations ............................................5 + 2.1. MPLS OAM Configuration Operation Overview ..................5 + 2.1.1. Configuration of BFD Sessions .......................5 + 2.1.2. Configuration of Performance Monitoring .............6 + 2.1.3. Configuration of Fault Management Signals ...........6 + 2.2. MPLS OAM Functions TLV .....................................7 + 2.2.1. BFD Configuration Sub-TLV ...........................9 + 2.2.2. BFD Local Discriminator Sub-TLV ....................11 + 2.2.3. BFD Negotiation Timer Parameters Sub-TLV ...........11 + 2.2.4. BFD Authentication Sub-TLV .........................13 + 2.2.5. Traffic Class Sub-TLV ..............................14 + 2.2.6. Performance Monitoring Sub-TLV .....................14 + 2.2.7. PM Loss Measurement Sub-TLV ........................17 + 2.2.8. PM Delay Measurement Sub-TLV .......................18 + 2.2.9. Fault Management Signal Sub-TLV ....................20 + 2.2.10. Source MEP-ID Sub-TLV .............................21 + 3. Summary of MPLS OAM Configuration Errors .......................22 + 4. IANA Considerations ............................................23 + 4.1. TLV and Sub-TLV Allocation ................................23 + 4.2. MPLS OAM Function Flags Allocation ........................24 + 4.3. OAM Configuration Errors ..................................25 + 5. Security Considerations ........................................26 + 6. References .....................................................26 + 6.1. Normative References ......................................26 + 6.2. Informative References ....................................27 + Acknowledgements .................................................28 + Authors' Addresses ................................................29 + + + +Bellagamba, et al. Standards Track [Page 2] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + +1. Introduction + + The MPLS Transport Profile (MPLS-TP) describes a profile of MPLS that + enables operational models typical in transport networks while + providing additional Operations, Administration, and Maintenance + (OAM), survivability, and other maintenance functions not currently + supported by MPLS. [RFC5860] defines the requirements for the OAM + functionality of MPLS-TP. + + This document describes the configuration of proactive MPLS-TP OAM + functions for a given Label Switched Path (LSP) using TLVs carried in + LSP Ping [RFC4379]. In particular, it specifies the mechanisms + necessary to establish MPLS-TP OAM entities at the maintenance points + for monitoring and performing measurements on an LSP, as well as + defining information elements and procedures to configure proactive + MPLS-TP OAM functions running between Label Edge Routers (LERs). + Initialization and control of on-demand MPLS-TP OAM functions are + expected to be carried out by directly accessing network nodes via a + management interface; hence, configuration and control of on-demand + OAM functions are out of scope for this document. + + The Transport Profile of MPLS must, by definition [RFC5654], be + capable of operating without a control plane. Therefore, there are a + few options for configuring MPLS-TP OAM: without a control plane + using a Network Management System (NMS), implementing LSP Ping + instead or with a control plane implementing extensions to signaling + protocols RSVP Traffic Engineering (RSVP-TE) [RFC3209] and/or + Targeted LDP [RFC5036]. + + Proactive MPLS-TP OAM is performed by a set of protocols: + Bidirectional Forwarding Detection (BFD) [RFC6428] for Continuity + Check/Connectivity Verification, the Delay Measurement (DM) protocol + [RFC6374], [RFC6375] for delay and delay variation (jitter) + measurements, and the Loss Measurement (LM) protocol [RFC6374], + [RFC6375] for packet loss and throughput measurements. Additionally, + there are a number of Fault Management Signals that can be configured + [RFC6427]. + + BFD is a protocol that provides low-overhead, fast detection of + failures in the path between two forwarding engines, including the + interfaces, data link(s), and to the extent possible, the forwarding + engines themselves. BFD can be used to detect the continuity and + mis-connection defects of MPLS-TP point-to-point and might also be + extended to support point-to-multipoint LSPs. + + The delay and loss measurements protocols [RFC6374] and [RFC6375] use + a simple query/response model for performing both unidirectional and + bidirectional measurements that allow the originating node to measure + + + +Bellagamba, et al. Standards Track [Page 3] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + packet loss and delay in forward, or forward and reverse directions. + By timestamping and/or writing current packet counters to the + measurement packets (four times, Transmit and Receive in both + directions), current delays and packet losses can be calculated. By + performing successive delay measurements, the delay and/or inter- + packet delay variation (jitter) can be calculated. Current + throughput can be calculated from the packet loss measurements by + dividing the number of packets sent/received with the time it took to + perform the measurement, given by the timestamp in the LM header. + Combined with a packet generator, the throughput measurement can be + used to measure the maximum capacity of a particular LSP. It should + be noted that this document does not specify how to configure + on-demand throughput estimates based on saturating the connection as + defined in [RFC6371]; rather, it only specifies how to enable the + estimation of the current throughput based on loss measurements. + +1.1. Conventions Used in This Document + +1.1.1. Terminology + + BFD - Bidirectional Forwarding Detection + + DM - Delay Measurement + + FMS - Fault Management Signal + + G-ACh - Generic Associated Channel + + LSP - Label Switched Path + + LM - Loss Measurement + + MEP - Maintenance Entity Group End Point + + MPLS - Multi-Protocol Label Switching + + MPLS-TP - MPLS Transport Profile + + NMS - Network Management System + + PM - Performance Monitoring + + RSVP-TE - RSVP Traffic Engineering + + TC - Traffic Class + + + + + + +Bellagamba, et al. Standards Track [Page 4] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + +1.1.2. Requirements Language + + The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", + "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this + document are to be interpreted as described in RFC 2119 [RFC2119]. + +2. Theory of Operations + +2.1. MPLS OAM Configuration Operation Overview + + The MPLS-TP OAM tool set is described in [RFC6669]. + + LSP Ping, or alternatively RSVP-TE [RFC7487], can be used to easily + enable the different OAM functions by setting the corresponding flags + in the MPLS OAM Functions TLV (refer to Section 2.2). For a more + detailed configuration, one may include sub-TLVs for the different + OAM functions in order to specify various parameters in detail. + + Typically, intermediate nodes simply forward OAM configuration TLVs + to the end node without any processing or modification. At least one + exception to this is if the FMS sub-TLV (refer to Section 2.2.9 ) is + present. This sub-TLV MUST be examined even by intermediate nodes + that support this extension. The sub-TLV MAY be present if a flag is + set in the MPLS OAM Functions TLV. + +2.1.1. Configuration of BFD Sessions + + For this specification, BFD MUST run in either one of the two modes: + + o Asynchronous mode, where both sides are in active mode + + o Unidirectional mode + + In the simplest scenario, LSP Ping [RFC5884], or alternatively RSVP- + TE [RFC7487], is used only to bootstrap a BFD session for an LSP, + without any timer negotiation. + + Timer negotiation can be performed either in subsequent BFD control + messages (in this case the operation is similar to bootstrapping + based on LSP Ping described in [RFC5884]), or directly in the LSP + Ping configuration messages. + + When BFD Control packets are transported in the Associated Channel + Header (ACH) encapsulation, they are not protected by any end-to-end + checksum; only lower layers provide error detection/correction. A + single bit error, e.g., a flipped bit in the BFD State field, could + cause the receiving end to wrongly conclude that the link is down and + in turn trigger protection switching. To prevent this from + + + +Bellagamba, et al. Standards Track [Page 5] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + happening, the BFD Configuration sub-TLV (refer to Section 2.2.1) has + an Integrity flag that, when set, enables BFD Authentication using + Keyed SHA1 with an empty key (all 0s) [RFC5880]. This would make + every BFD Control packet carry a SHA1 hash of itself that can be used + to detect errors. + + If BFD Authentication using a pre-shared key/password is desired + (i.e., authentication and not only error detection), the BFD + Authentication sub-TLV (refer to Section 2.2.4) MUST be included in + the BFD Configuration sub-TLV. The BFD Authentication sub-TLV is + used to specify which authentication method that should be used and + which pre-shared key/password that should be used for this particular + session. How the key exchange is performed is out of scope of this + document. + +2.1.2. Configuration of Performance Monitoring + + It is possible to configure Performance Monitoring functionalities + such as Loss, Delay, Delay/Interpacket Delay variation (jitter), and + throughput as described in [RFC6374]. + + When configuring Performance Monitoring functionalities, it is + possible to choose either the default configuration, by only setting + the respective flags in the MPLS OAM functions TLV, or a customized + configuration. To customize the configuration, one would set the + respective flags in the MPLS OAM functions TLV and include the + respective Loss and/or Delay sub-TLVs. + + By setting the PM Loss flag in the MPLS OAM Functions TLV and + including the PM Loss sub-TLV (refer to Section 2.2.7), one can + configure the measurement interval and loss threshold values for + triggering protection. + + Delay measurements are configured by setting the PM Delay flag in the + MPLS OAM Functions TLV and by including the PM Delay sub-TLV (refer + to Section 2.2.8), one can configure the measurement interval and the + delay threshold values for triggering protection. + +2.1.3. Configuration of Fault Management Signals + + To configure Fault Management Signals (FMSs) and their refresh time, + the FMS Flag in the MPLS OAM Functions TLV MUST be set and the FMS + sub-TLV MUST be included. When configuring an FMS, an implementation + can enable the default configuration by setting the FMS Flag in the + OAM Function Flags sub-TLV. In order to modify the default + configuration, the MPLS OAM FMS sub-TLV MUST be included. + + + + + +Bellagamba, et al. Standards Track [Page 6] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + If an intermediate point is meant to originate FMS messages, this + means that such an intermediate point is associated with a Server MEP + through a co-located MPLS-TP client/server adaptation function, and + the Fault Management subscription flag in the MPLS OAM FMS sub-TLV + has been set as an indication of the request to create the + association at each intermediate node of the client LSP. The + corresponding Server MEP needs to be configured by its own LSP Ping + session or, alternatively, via a Network Management System (NMS) or + RSVP-TE. + +2.2. MPLS OAM Functions TLV + + The MPLS OAM Functions TLV presented in Figure 1 is carried as a TLV + of the MPLS Echo Request/Reply messages [RFC4379]. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | MPLS OAM Func. Type (27) | Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | MPLS OAM Function Flags | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | | + ~ sub-TLVs ~ + | | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 1: MPLS OAM Functions TLV Format + + The MPLS OAM Functions TLV contains the MPLS OAM Function Flags + field. The MPLS OAM Function Flags indicate which OAM functions + should be activated as well as OAM function-specific sub-TLVs with + configuration parameters for the particular function. + + Type: Indicates the MPLS OAM Functions TLV (Section 4). + + Length: The length of the MPLS OAM Function Flags field including the + total length of the sub-TLVs in octets. + + MPLS OAM Function Flags: A bitmap numbered from left to right as + shown in Figure 2. These flags are managed by IANA (refer to + Section 4.2). Flags defined in this document are presented in + Table 2. Undefined flags MUST be set to zero and unknown flags MUST + be ignored. The flags indicate what OAM is being configured and + direct the presence of optional sub-TLVs as set out below. + + + + + + +Bellagamba, et al. Standards Track [Page 7] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |C|V|F|L|D|T|Unassigned MUST be zero (MBZ) |R| + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 2: MPLS OAM Function Flags Format + + Sub-TLVs corresponding to the different flags are as follows. No + meaning should be attached to the order of sub-TLVs. + + o If a flag in the MPLS OAM Function Flags is set and the + corresponding sub-TLVs listed below are absent, then this MPLS OAM + function MUST be initialized according to its default settings. + Default settings of MPLS OAM functions are outside the scope of + this document. + + o If any sub-TLV is present without the corresponding flag being + set, the sub-TLV SHOULD be ignored. + + o BFD Configuration sub-TLV, which MUST be included if either the + CC, the CV, or both MPLS OAM Function flags are being set in the + MPLS OAM Functions TLV. + + o Performance Monitoring sub-TLV MUST be used to carry PM Loss sub- + TLV and/or PM Delay sub-TLV. If neither one of these sub-TLVs is + present, then Performance Monitoring sub-TLV SHOULD NOT be + included. Empty, i.e., no enclosed sub-TLVs, Performance + Monitoring sub-TLV SHOULD be ignored. + + o PM Loss sub-TLV MAY be included if the PM/Loss OAM Function flag + is set. If the "PM Loss sub-TLV" is not included, default + configuration values are used. Such sub-TLV MAY also be included + in case the Throughput function flag is set and there is the need + to specify a measurement interval different from the default ones. + In fact, the throughput measurement makes use of the same tool as + the loss measurement; hence, the same TLV is used. + + o PM Delay sub-TLV MAY be included if the PM/Delay OAM Function flag + is set. If the "PM Delay sub-TLV" is not included, default + configuration values are used. + + o FMS sub-TLV, that MAY be included if the FMS OAM Function flag is + set. If the "FMS sub-TLV" is not included, default configuration + values are used. + + + + + + +Bellagamba, et al. Standards Track [Page 8] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + If all flags in the MPLS OAM Function Flags field have the same value + of zero, that MUST be interpreted as meaning that the MPLS OAM + Functions TLV is not present in the MPLS Echo Request. If more than + one MPLS OAM Functions TLV is present in the MPLS Echo request + packet, then the first TLV SHOULD be processed and the rest ignored. + Any parsing error within nested sub-TLVs that is not specified in + Section 3 SHOULD be treated as described in [RFC4379]. + +2.2.1. BFD Configuration Sub-TLV + + The BFD Configuration sub-TLV, depicted in Figure 3, is defined for + BFD OAM-specific configuration parameters. The "BFD Configuration + sub-TLV" is carried as a sub-TLV of the "OAM Functions TLV". + + This TLV accommodates generic BFD OAM information and carries sub- + TLVs. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | BFD Conf. Sub-type (100) | Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |Vers.|N|S|I|G|U|B| Reserved (set to all 0s) | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | | + ~ sub-TLVs ~ + | | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 3: BFD Configuration Sub-TLV Format + + Sub-type: Indicates a new sub-type, the BFD Configuration sub-TLV + (value 100). + + Length: Indicates the length of the Value field in octets. + + Version: Identifies the BFD protocol version. If a node does not + support a specific BFD version, an error must be generated: "OAM + Problem/Unsupported BFD Version". + + BFD Negotiation (N): If set, timer negotiation/renegotiation via BFD + Control Messages is enabled. When cleared, it is disabled and timer + configuration is achieved using the BFD Negotiation Timer Parameters + sub-TLV as described in Section 2.2.3. + + Symmetric session (S): If set, the BFD session MUST use symmetric + timing values. If cleared, the BFD session MAY use any timing values + either negotiated or explicitly configured. + + + +Bellagamba, et al. Standards Track [Page 9] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + Integrity (I): If set, BFD Authentication MUST be enabled. If the + BFD Configuration sub-TLV does not include a BFD Authentication sub- + TLV, the authentication MUST use Keyed SHA1 with an empty pre-shared + key (all 0s). If the egress LSR does not support BFD Authentication, + an error MUST be generated: "OAM Problem/BFD Authentication + unsupported". If the Integrity flag is clear, then Authentication + MUST NOT be used. + + Encapsulation Capability (G): If set, it shows the capability of + encapsulating BFD messages into the G-ACh channel. If both the G bit + and U bit are set, configuration gives precedence to the G bit. + + Encapsulation Capability (U): If set, it shows the capability of + encapsulating BFD messages into IP/UDP packets. If both the G bit + and U bit are set, configuration gives precedence to the G bit. + + If the egress LSR does not support any of the ingress LSR + Encapsulation Capabilities, an error MUST be generated: "OAM Problem/ + Unsupported BFD Encapsulation format". + + Bidirectional (B): If set, it configures BFD in the Bidirectional + mode. If it is not set, it configures BFD in the unidirectional + mode. In the second case, the source node does not expect any + Discriminator values back from the destination node. + + Reserved: Reserved for future specification; set to 0 on transmission + and ignored when received. + + The BFD Configuration sub-TLV MUST include the following sub-TLVs in + the MPLS Echo Request message: + + o BFD Local Discriminator sub-TLV, if the B flag is set in the MPLS + Echo Request; + + o BFD Negotiation Timer Parameters sub-TLV, if the N flag is + cleared. + + The BFD Configuration sub-TLV MUST include the following sub-TLVs in + the MPLS Echo Reply message: + + o BFD Local Discriminator sub-TLV; + + o BFD Negotiation Timer Parameters sub-TLV if: + + * The N and S flags are cleared, or if: + + * The N flag is cleared and the S flag is set, and the BFD + Negotiation Timer Parameters sub-TLV received by the egress + + + +Bellagamba, et al. Standards Track [Page 10] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + contains unsupported values. In this case, an updated BFD + Negotiation Timer Parameters sub-TLV, containing values + supported by the egress node [RFC7419], is returned to the + ingress. + +2.2.2. BFD Local Discriminator Sub-TLV + + The BFD Local Discriminator sub-TLV is carried as a sub-TLV of the + "BFD Configuration sub-TLV" and is depicted in Figure 4. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Locl. Discr. Sub-type (101) | Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Local Discriminator | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 4: BFD Local Discriminator Sub-TLV Format + + Sub-type: Indicates a new sub-type, the "BFD Local Discriminator sub- + TLV" (value 101). + + Length: Indicates the length of the Value field in octets (4). + + Local Discriminator: A nonzero discriminator value that is unique in + the context of the transmitting system that generates it. It is used + to demultiplex multiple BFD sessions between the same pair of + systems. + +2.2.3. BFD Negotiation Timer Parameters Sub-TLV + + The BFD Negotiation Timer Parameters sub-TLV is carried as a sub-TLV + of the BFD Configuration sub-TLV and is depicted in Figure 5. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Nego. Timer Sub-type (102) | Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Acceptable Min. Asynchronous TX interval | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Acceptable Min. Asynchronous RX interval | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Required Echo TX Interval | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 5: BFD Negotiation Timer Parameters Sub-TLV Format + + + +Bellagamba, et al. Standards Track [Page 11] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + Sub-type: Indicates a new sub-type, the BFD Negotiation Timer + Parameters sub-TLV (value 102). + + Length: Indicates the length of the Value field in octets (12). + Acceptable Min. Asynchronous TX interval: If the S (symmetric) flag + is set in the BFD Configuration sub-TLV, defined in Section 2.2.1, it + expresses the desired time interval (in microseconds) at which the + ingress LER intends to both transmit and receive BFD periodic control + packets. If the receiving edge LSR cannot support such a value, it + SHOULD reply with an interval greater than the one proposed. + + If the S (symmetric) flag is cleared in the BFD Configuration sub- + TLV, this field expresses the desired time interval (in microseconds) + at which an edge LSR intends to transmit BFD periodic control packets + in its transmitting direction. + + Acceptable Min. Asynchronous RX interval: If the S (symmetric) flag + is set in the BFD Configuration sub-TLV, Figure 3, this field MUST be + equal to Acceptable Min. Asynchronous TX interval and has no + additional meaning respect to the one described for "Acceptable Min. + Asynchronous TX interval". + + If the S (symmetric) flag is cleared in the BFD Configuration sub- + TLV, it expresses the minimum time interval (in microseconds) at + which edge LSRs can receive BFD periodic control packets. If this + value is greater than the value of Acceptable Min. Asynchronous TX + interval received from the other edge LSR, such an edge LSR MUST + adopt the interval expressed in this Acceptable Min. Asynchronous RX + interval. + + Required Echo TX Interval: The minimum interval (in microseconds) + between received BFD Echo packets that this system is capable of + supporting, less any jitter applied by the sender as described in + Section 6.8.9 of [RFC5880]. This value is also an indication for the + receiving system of the minimum interval between transmitted BFD Echo + packets. If this value is zero, the transmitting system does not + support the receipt of BFD Echo packets. If the receiving system + cannot support this value, the "Unsupported BFD TX Echo rate + interval" error MUST be generated. By default, the value is set to + 0. + + + + + + + + + + + +Bellagamba, et al. Standards Track [Page 12] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + +2.2.4. BFD Authentication Sub-TLV + + The "BFD Authentication sub-TLV" is carried as a sub-TLV of the "BFD + Configuration sub-TLV" and is depicted in Figure 6. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | BFD Auth. Sub-type (103) | Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Auth Type | Auth Key ID | Reserved (0s) | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 6: BFD Authentication Sub-TLV Format + + Sub-type: Indicates a new sub-type, the BFD Authentication sub-TLV + (value 103). + + Length: Indicates the length of the Value field in octets (4). + + Auth Type: Indicates which type of authentication to use. The same + values as are defined in Section 4.1 of [RFC5880] are used. Simple + Password SHOULD NOT be used if other authentication types are + available. + + Auth Key ID: Indicates which authentication key or password + (depending on Auth Type) should be used. How the key exchange is + performed is out of scope of this document. If the egress LSR does + not support this Auth Key ID, an "OAM Problem/Mismatch of BFD + Authentication Key ID" error MUST be generated. + + Reserved: Reserved for future specification; set to 0 on transmission + and ignored when received. + + An implementation MAY change the mode of authentication if an + operator re-evaluates the security situation in and around the + administrative domain. If the BFD Authentication sub-TLV is used for + a BFD session in Up state, then the Sender of the MPLS LSP Echo + Request SHOULD ensure that old and new modes of authentication, i.e., + a combination of Auth.Type and Auth. Key ID, are used to send and + receive BFD control packets, until the Sender can confirm that its + peer has switched to the new authentication. + + + + + + + + + +Bellagamba, et al. Standards Track [Page 13] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + +2.2.5. Traffic Class Sub-TLV + + The Traffic Class sub-TLV is carried as a sub-TLV of the "BFD + Configuration sub-TLV" and "Fault Management Signal Sub-TLV" + (Section 2.2.9) and is depicted in Figure 7. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Traffic Class Sub-type (104) | Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | TC | Reserved (set to all 0s) | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 7: Traffic Class Sub-TLV Format + + Sub-type: Indicates a new sub-type, the "Traffic Class sub-TLV" + (value 104). + + Length: Indicates the length of the Value field in octets (4). + + TC: Identifies the Traffic Class (TC) [RFC5462] for periodic + continuity monitoring messages or packets with fault management + information. + + If the TC sub-TLV is present, then the sender of any periodic + continuity monitoring messages or packets with fault management + information on the LSP, with a Forwarding Equivalence Class (FEC) + that corresponds to the FEC for which fault detection is being + performed, MUST use the value contained in the TC field of the sub- + TLV as the value of the TC field in the top label stack entry of the + MPLS label stack. If the TC sub-TLV is absent from either "BFD + Configuration sub-TLV" or "Fault Management Signal sub-TLV", then + selection of the TC value is a local decision. + +2.2.6. Performance Monitoring Sub-TLV + + If the MPLS OAM Functions TLV has any of the L (Loss), D (Delay), and + T (Throughput) flags set, the Performance Monitoring sub-TLV MUST be + present. Failure to include the correct sub-TLVs MUST result in an + "OAM Problem/PM Configuration Error" being generated. + + The Performance Monitoring sub-TLV provides the configuration + information mentioned in Section 7 of [RFC6374]. It includes support + for the configuration of quality thresholds and, as described in + [RFC6374]: + + + + + +Bellagamba, et al. Standards Track [Page 14] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + ...the crossing of which will trigger warnings or alarms, and + result in reporting and exception notification will be integrated + into the system-wide network management and reporting framework. + + In case the values need to be different than the default ones, the + Performance Monitoring sub-TLV MAY include the following sub-TLVs: + + o PM Loss sub-TLV, if the L flag is set in the MPLS OAM Functions + TLV; + + o PM Delay sub-TLV, if the D flag is set in the MPLS OAM Functions + TLV. + + The Performance Monitoring sub-TLV depicted in Figure 8 is carried as + a sub-TLV of the MPLS OAM Functions TLV. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |Perf. Monitoring Sub-type (200)| Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | PM Configuration Flags | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | | + ~ sub-TLVs ~ + | | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 8: Performance Monitoring Sub-TLV Format + + Sub-type: Indicates a new sub-type, the Performance Monitoring sub- + TLV (value 200). + + Length: Indicates the length of the Value field in octets, including + PM Configuration Flags and optional sub-TLVs. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |D|L|J|Y|K|C| Reserved (set to all 0s) | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 9: PM Configuration Flags Format + + + + + + + + +Bellagamba, et al. Standards Track [Page 15] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + The PM Configuration Flags format is presented in Figure 9. For the + specific function description, please refer to [RFC6374]: + + D: Delay inferred/direct (0=INFERRED, 1=DIRECT). If the egress + LSR does not support the specified mode, an "OAM Problem/ + Unsupported Delay Mode" error MUST be generated. + + L: Loss inferred/direct (0=INFERRED, 1=DIRECT). If the egress LSR + does not support the specified mode, an "OAM Problem/ + Unsupported Loss Mode" error MUST be generated. + + J: Delay variation/jitter (1=ACTIVE, 0=NOT ACTIVE). If the egress + LSR does not support Delay variation measurements and the J + flag is set, an "OAM Problem/Delay variation unsupported" error + MUST be generated. + + Y: Dyadic (1=ACTIVE, 0=NOT ACTIVE). If the egress LSR does not + support Dyadic mode and the Y flag is set, an "OAM Problem/ + Dyadic mode unsupported" error MUST be generated. + + K: Loopback (1=ACTIVE, 0=NOT ACTIVE). If the egress LSR does not + support Loopback mode and the K flag is set, an "OAM Problem/ + Loopback mode unsupported" error MUST be generated. + + C: Combined (1=ACTIVE, 0=NOT ACTIVE). If the egress LSR does not + support Combined mode and the C flag is set, an "OAM Problem/ + Combined mode unsupported" error MUST be generated. + + Reserved: Reserved for future specification; set to 0 on + transmission and ignored when received. + + + + + + + + + + + + + + + + + + + + + +Bellagamba, et al. Standards Track [Page 16] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + +2.2.7. PM Loss Measurement Sub-TLV + + The PM Loss Measurement sub-TLV depicted in Figure 10 is carried as a + sub-TLV of the Performance Monitoring sub-TLV. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | PM Loss Sub-type (201) | Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | OTF |T|B| Reserved (set to all 0s) | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Measurement Interval | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Test Interval | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Loss Threshold | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 10: PM Loss Measurement Sub-TLV Format + + Sub-type: Indicates a new sub-type, the PM Loss Measurement sub-TLV + (value 201). + + Length: Indicates the length of the Value field in octets (16). + + OTF: Origin Timestamp Format of the Origin Timestamp field described + in [RFC6374]. By default, it is set to IEEE 1588 version 1. If the + egress LSR cannot support this value, an "OAM Problem/Unsupported + Timestamp Format" error MUST be generated. + + Configuration Flags, please refer to [RFC6374] for further details: + + T: Traffic-class-specific measurement indicator. Set to 1 when + the measurement operation is scoped to packets of a particular + traffic class (Differentiated Services Code Point value), and 0 + otherwise. When set to 1, the Differentiated Services (DS) + field of the message indicates the measured traffic class. By + default, it is set to 1. + + B: Octet (byte) count. When set to 1, indicates that the Counter + 1-4 fields represent octet counts. When set to 0, indicates + that the Counter 1-4 fields represent packet counts. By + default, it is set to 0. + + Reserved: Reserved for future specification; set to 0 on transmission + and ignored when received. + + + + +Bellagamba, et al. Standards Track [Page 17] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + Measurement Interval: The time interval (in milliseconds) at which + Loss Measurement query messages MUST be sent on both directions. If + the edge LSR receiving the Path message cannot support such a value, + it SHOULD reply with a higher interval. By default, it is set to + (100) as per [RFC6375]. + + Test Interval: Test messages interval in milliseconds as described in + [RFC6374]. By default, it is set to (10) as per [RFC6375]. + + Loss Threshold: The threshold value of measured lost packets per + measurement over which action(s) SHOULD be triggered. + +2.2.8. PM Delay Measurement Sub-TLV + + The "PM Delay Measurement sub-TLV" depicted in Figure 11 is carried + as a sub-TLV of the Performance Monitoring sub-TLV. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | PM Delay Sub-type (202) | Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | OTF |T|B| Reserved (set to all 0s) | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Measurement Interval | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Test Interval | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Delay Threshold | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 11: PM Delay Measurement Sub-TLV Format + + Sub-type: Indicates a new sub-type, the "PM Delay Measurement sub- + TLV" (value 202). + + Length: Indicates the length of the Value field in octets (16). + + OTF: Origin Timestamp Format of the Origin Timestamp field described + in [RFC6374]. By default, it is set to IEEE 1588 version 1. If the + egress LSR cannot support this value, an "OAM Problem/Unsupported + Timestamp Format" error MUST be generated. + + + + + + + + + +Bellagamba, et al. Standards Track [Page 18] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + Configuration Flags, please refer to [RFC6374] for further details: + + T: Traffic-class-specific measurement indicator. Set to 1 when + the measurement operation is scoped to packets of a particular + traffic class (Differentiated Services Code Point value), and 0 + otherwise. When set to 1, the DS field of the message + indicates the measured traffic class. By default, it is set to + 1. + + B: Octet (byte) count. When set to 1, indicates that the Counter + 1-4 fields represent octet counts. When set to 0, indicates + that the Counter 1-4 fields represent packet counts. By + default, it is set to 0. + + Reserved: Reserved for future specification; set to 0 on transmission + and ignored when received. + + Measurement Interval: The time interval (in milliseconds) at which + Delay Measurement query messages MUST be sent on both directions. If + the edge LSR receiving the Path message cannot support such a value, + it can reply with a higher interval. By default, it is set to (1000) + as per [RFC6375]. + + Test Interval: Test messages interval (in milliseconds) as described + in [RFC6374]. By default, it is set to (10) as per [RFC6375]. + + Delay Threshold: The threshold value of measured two-way delay (in + milliseconds) over which action(s) SHOULD be triggered. + + + + + + + + + + + + + + + + + + + + + + + +Bellagamba, et al. Standards Track [Page 19] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + +2.2.9. Fault Management Signal Sub-TLV + + The FMS sub-TLV depicted in Figure 12 is carried as a sub-TLV of the + MPLS OAM Configuration sub-TLV. When both working and protection + paths are configured, both LSPs SHOULD be configured with identical + settings of the E flag, T flag, and the refresh timer. An + implementation MAY configure the working and protection LSPs with + different settings of these fields in case of 1:N protection. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | FMS Sub-type (300) | Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |E|S|T| Reserved | Refresh Timer | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | | + ~ sub-TLVs ~ + | | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 12: Fault Management Signal Sub-TLV Format + + Sub-type: Indicates a new sub-type, the FMS sub-TLV (value 300). + + Length: Indicates the length of the Value field in octets. + + FMS Flags are used to enable the FMS Flags at end point MEPs and the + Server MEPs of the links over which the LSP is forwarded. In this + document, only the S flag pertains to Server MEPs. + + The following flags are defined: + + E: Enable Alarm Indication Signal (AIS) and Lock Report (LKR) + signaling as described in [RFC6427]. Default value is 1 + (enabled). If the egress MEP does not support FMS Flag + generation, an "OAM Problem/Fault management signaling + unsupported" error MUST be generated. + + S: Indicate to a Server MEP that it should transmit AIS and LKR + signals on the client LSP. Default value is 0 (disabled). If + a Server MEP that is capable of generating FMS messages is, for + some reason, unable to do so for the LSP being signaled, an + "OAM Problem/Unable to create fault management association" + error MUST be generated. + + T: Set timer value, enabled the configuration of a specific timer + value. Default value is 0 (disabled). + + + +Bellagamba, et al. Standards Track [Page 20] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + Reserved: Bits 4-16 that follow the FMS Flags are reserved for future + allocation. These bits MUST be set to 0 on transmit and ignored on + receipt if not allocated. + + Refresh Timer: Indicates the refresh timer of fault indication + messages, in seconds. The value MUST be between 1 to 20 seconds as + specified for the Refresh Timer field in [RFC6427]. If the edge LSR + receiving the Path message cannot support the value, it SHOULD reply + with a higher timer value. + + FMS sub-TLV MAY include Traffic Class sub-TLV (Section 2.2.5). If + the TC sub-TLV is present, the value of the TC field MUST be used as + the value of the TC field of an MPLS label stack entry for FMS + messages. If the TC sub-TLV is absent, then selection of the TC + value is a local decision. + +2.2.10. Source MEP-ID Sub-TLV + + The Source MEP-ID sub-TLV depicted in Figure 13 is carried as a sub- + TLV of the MPLS OAM Functions TLV. + + Note that support of ITU IDs is out of scope. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Source MEP-ID Sub-type (400) | Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Source Node ID | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Tunnel ID | LSP ID | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 13: Source MEP-ID Sub-TLV Format + + Sub-type: Indicates a new sub-type, the Source MEP-ID sub-TLV (value + 400). + + Length: Indicates the length of the Value field in octets (8). + + Source Node ID: 32-bit node identifier as defined in [RFC6370]. + + Tunnel ID: A 16-bit unsigned integer unique to the node as defined in + [RFC6370]. + + LSP ID: A 16-bit unsigned integer unique within the Tunnel_ID as + defined in [RFC6370]. + + + + +Bellagamba, et al. Standards Track [Page 21] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + +3. Summary of MPLS OAM Configuration Errors + + This is the summary of Return Codes [RFC4379] defined in this + document: + + o If an egress LSR does not support the specified BFD version, an + error MUST be generated: "OAM Problem/Unsupported BFD Version". + + o If an egress LSR does not support the specified BFD Encapsulation + format, an error MUST be generated: "OAM Problem/Unsupported BFD + Encapsulation format". + + o If an egress LSR does not support BFD Authentication, and it is + requested, an error MUST be generated: "OAM Problem/BFD + Authentication unsupported". + + o If an egress LSR does not support the specified BFD Authentication + Type, an error MUST be generated: "OAM Problem/Unsupported BFD + Authentication Type". + + o If an egress LSR is not able to use the specified Authentication + Key ID, an error MUST be generated: "OAM Problem/Mismatch of BFD + Authentication Key ID". + + o If PM flags in MPLS OAM Functions TLV don't have corresponding PM + sub-TLVs present, an error MUST be generated: "OAM Problem/PM + Configuration Error". + + o If an egress LSR does not support the specified Timestamp Format, + an error MUST be generated: "OAM Problem/Unsupported Timestamp + Format". + + o If an egress LSR does not support specified Delay mode, an "OAM + Problem/Unsupported Delay Mode" error MUST be generated. + + o If an egress LSR does not support specified Loss mode, an "OAM + Problem/Unsupported Loss Mode" error MUST be generated. + + o If an egress LSR does not support Delay variation measurements, + and it is requested, an "OAM Problem/Delay variation unsupported" + error MUST be generated. + + o If an egress LSR does not support Dyadic mode, and it is + requested, an "OAM Problem/Dyadic mode unsupported" error MUST be + generated. + + + + + + +Bellagamba, et al. Standards Track [Page 22] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + o If an egress LSR does not support Loopback mode, and it is + requested, an "OAM Problem/Loopback mode unsupported" error MUST + be generated. + + o If an egress LSR does not support Combined mode, and it is + requested, an "OAM Problem/Combined mode unsupported" error MUST + be generated. + + o If an egress LSR does not support Fault Monitoring Signals, and it + is requested, an "OAM Problem/Fault management signaling + unsupported" error MUST be generated. + + o If an intermediate Server MEP supports Fault Monitoring Signals, + but is unable to create an association, when requested to do so, + an "OAM Problem/Unable to create fault management association" + error MUST be generated. + + Ingress LSR MAY combine multiple MPLS OAM configuration TLVs and sub- + TLVs into single MPLS echo request. In case an egress LSR doesn't + support any of the requested modes, it MUST set the return code to + report the first unsupported mode in the list of TLVs and sub-TLVs. + And if any of the requested OAM configuration is not supported, the + egress LSR SHOULD NOT process OAM Configuration TLVs and sub-TLVs + listed in the MPLS echo request. + +4. IANA Considerations + +4.1. TLV and Sub-TLV Allocation + + IANA maintains the "Multi-Protocol Label Switching (MPLS) Label + Switched Paths (LSPs) Ping Parameters" registry and, within that + registry, a subregistry for TLVs and sub-TLVs. + + IANA has allocated a new MPLS OAM Functions TLV from the Standards + Action [RFC5226] range (0-16383) and sub-TLVs as follows from + subregistry presented in Table 1, called "Sub-TLVs for TLV Type 27". + + Registration procedures for Sub-TLVs from ranges 0-16383 and + 32768-49161 are by Standards Action. Ranges 16384-31743 and + 49162-64511 are through Specification Required (Experimental RFC + Needed). + + + + + + + + + + +Bellagamba, et al. Standards Track [Page 23] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + +------+----------+---------------------------------+---------------+ + | Type | Sub-type | Value Field | Reference | + +------+----------+---------------------------------+---------------+ + | 27 | | MPLS OAM Functions | This document | + | | 100 | BFD Configuration | This document | + | | 101 | BFD Local Discriminator | This document | + | | 102 | BFD Negotiation Timer | This document | + | | | Parameters | | + | | 103 | BFD Authentication | This document | + | | 104 | Traffic Class | This document | + | | 200 | Performance Monitoring | This document | + | | 201 | PM Loss Measurement | This document | + | | 202 | PM Delay Measurement | This document | + | | 300 | Fault Management Signal | This document | + | | 400 | Source MEP-ID | This document | + +------+----------+---------------------------------+---------------+ + + Table 1: IANA TLV Type Allocation + +4.2. MPLS OAM Function Flags Allocation + + IANA has created a new registry called the "MPLS OAM Function Flags" + registry. Assignments of bit positions 0 through 31 are via + Standards Action. The new registry is to be populated as follows. + + +------------+--------------------+---------------------------------+ + | Bit | MPLS OAM Function | Description | + | Position | Flag | | + +------------+--------------------+---------------------------------+ + | 0 | C | Continuity Check (CC) | + | 1 | V | Connectivity Verification (CV) | + | 2 | F | Fault Management Signal (FMS) | + | 3 | L | Performance Monitoring/Loss | + | | | (PM/Loss) | + | 4 | D | Performance Monitoring/Delay | + | | | (PM/Delay) | + | 5 | T | Throughput Measurement | + | 6-30 | | Unassigned (Must be zero) | + | 31 | | Reserved | + +------------+--------------------+---------------------------------+ + + Table 2: MPLS OAM Function Flags + + + + + + + + + +Bellagamba, et al. Standards Track [Page 24] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + +4.3. OAM Configuration Errors + + IANA maintains a registry "Multi-Protocol Label Switching (MPLS) + Label Switched Paths (LSPs) Ping Parameters", and within that + registry a subregistry "Return Codes". + + IANA has assigned new Return Codes from the Standards Action range + (0-191) as follows: + + +----------------+--------------------------------------+-----------+ + | Error Value | Description | Reference | + | Sub-codes | | | + +----------------+--------------------------------------+-----------+ + | 21 | OAM Problem/Unsupported BFD Version | This | + | | | document | + | 22 | OAM Problem/Unsupported BFD | This | + | | Encapsulation format | document | + | 23 | OAM Problem/Unsupported BFD | This | + | | Authentication Type | document | + | 24 | OAM Problem/Mismatch of BFD | This | + | | Authentication Key ID | document | + | 25 | OAM Problem/Unsupported Timestamp | This | + | | Format | document | + | 26 | OAM Problem/Unsupported Delay Mode | This | + | | | document | + | 27 | OAM Problem/Unsupported Loss Mode | This | + | | | document | + | 28 | OAM Problem/Delay variation | This | + | | unsupported | document | + | 29 | OAM Problem/Dyadic mode unsupported | This | + | | | document | + | 30 | OAM Problem/Loopback mode | This | + | | unsupported | document | + | 31 | OAM Problem/Combined mode | This | + | | unsupported | document | + | 32 | OAM Problem/Fault management | This | + | | signaling unsupported | document | + | 33 | OAM Problem/Unable to create fault | This | + | | management association | document | + | 34 | OAM Problem/PM Configuration Error | This | + | | | document | + +----------------+--------------------------------------+-----------+ + + Table 3: IANA Return Codes Allocation + + + + + + + +Bellagamba, et al. Standards Track [Page 25] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + +5. Security Considerations + + The signaling of OAM-related parameters and the automatic + establishment of OAM entities introduces additional security + considerations to those discussed in [RFC4379]. In particular, a + network element could be overloaded if an attacker were to request + high-frequency liveliness monitoring of a large number of LSPs, + targeting a single network element. Implementations must be made + cognizant of available OAM resources and MAY refuse new OAM + configurations that would overload a node. Additionally, policies to + manage OAM resources may be used to provide some fairness in OAM + resource distribution among monitored LSPs. + + Security of OAM protocols configured with extensions to LSP Ping + described in this document are discussed in [RFC5880], [RFC5884], + [RFC6374], [RFC6427], and [RFC6428]. + + In order that the configuration of OAM functionality can be achieved + securely through the techniques described in this document, security + mechanisms must already be in place and operational for LSP Ping. + Thus, the exchange of security parameters (such as keys) for use in + securing OAM is outside the scope of this document and is assumed to + use an off-line mechanism or an established secure key exchange + protocol. + + Additional discussion of security for MPLS protocols can be found in + [RFC5920]. + +6. References + +6.1. Normative References + + [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate + Requirement Levels", BCP 14, RFC 2119, + DOI 10.17487/RFC2119, March 1997, + . + + [RFC4379] Kompella, K. and G. Swallow, "Detecting Multi-Protocol + Label Switched (MPLS) Data Plane Failures", RFC 4379, + DOI 10.17487/RFC4379, February 2006, + . + + [RFC5654] Niven-Jenkins, B., Ed., Brungard, D., Ed., Betts, M., Ed., + Sprecher, N., and S. Ueno, "Requirements of an MPLS + Transport Profile", RFC 5654, DOI 10.17487/RFC5654, + September 2009, . + + + + + +Bellagamba, et al. Standards Track [Page 26] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + [RFC5880] Katz, D. and D. Ward, "Bidirectional Forwarding Detection + (BFD)", RFC 5880, DOI 10.17487/RFC5880, June 2010, + . + + [RFC5884] Aggarwal, R., Kompella, K., Nadeau, T., and G. Swallow, + "Bidirectional Forwarding Detection (BFD) for MPLS Label + Switched Paths (LSPs)", RFC 5884, DOI 10.17487/RFC5884, + June 2010, . + + [RFC6370] Bocci, M., Swallow, G., and E. Gray, "MPLS Transport + Profile (MPLS-TP) Identifiers", RFC 6370, + DOI 10.17487/RFC6370, September 2011, + . + + [RFC6374] Frost, D. and S. Bryant, "Packet Loss and Delay + Measurement for MPLS Networks", RFC 6374, + DOI 10.17487/RFC6374, September 2011, + . + + [RFC6427] Swallow, G., Ed., Fulignoli, A., Ed., Vigoureux, M., Ed., + Boutros, S., and D. Ward, "MPLS Fault Management + Operations, Administration, and Maintenance (OAM)", + RFC 6427, DOI 10.17487/RFC6427, November 2011, + . + + [RFC6428] Allan, D., Ed., Swallow Ed., G., and J. Drake Ed., + "Proactive Connectivity Verification, Continuity Check, + and Remote Defect Indication for the MPLS Transport + Profile", RFC 6428, DOI 10.17487/RFC6428, November 2011, + . + +6.2. Informative References + + [RFC3209] Awduche, D., Berger, L., Gan, D., Li, T., Srinivasan, V., + and G. Swallow, "RSVP-TE: Extensions to RSVP for LSP + Tunnels", RFC 3209, DOI 10.17487/RFC3209, December 2001, + . + + [RFC5036] Andersson, L., Ed., Minei, I., Ed., and B. Thomas, Ed., + "LDP Specification", RFC 5036, DOI 10.17487/RFC5036, + October 2007, . + + [RFC5226] Narten, T. and H. Alvestrand, "Guidelines for Writing an + IANA Considerations Section in RFCs", BCP 26, RFC 5226, + DOI 10.17487/RFC5226, May 2008, + . + + + + + +Bellagamba, et al. Standards Track [Page 27] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + + [RFC5462] Andersson, L. and R. Asati, "Multiprotocol Label Switching + (MPLS) Label Stack Entry: "EXP" Field Renamed to "Traffic + Class" Field", RFC 5462, DOI 10.17487/RFC5462, February + 2009, . + + [RFC5860] Vigoureux, M., Ed., Ward, D., Ed., and M. Betts, Ed., + "Requirements for Operations, Administration, and + Maintenance (OAM) in MPLS Transport Networks", RFC 5860, + DOI 10.17487/RFC5860, May 2010, + . + + [RFC5920] Fang, L., Ed., "Security Framework for MPLS and GMPLS + Networks", RFC 5920, DOI 10.17487/RFC5920, July 2010, + . + + [RFC6371] Busi, I., Ed. and D. Allan, Ed., "Operations, + Administration, and Maintenance Framework for MPLS-Based + Transport Networks", RFC 6371, DOI 10.17487/RFC6371, + September 2011, . + + [RFC6375] Frost, D., Ed. and S. Bryant, Ed., "A Packet Loss and + Delay Measurement Profile for MPLS-Based Transport + Networks", RFC 6375, DOI 10.17487/RFC6375, September 2011, + . + + [RFC6669] Sprecher, N. and L. Fang, "An Overview of the Operations, + Administration, and Maintenance (OAM) Toolset for MPLS- + Based Transport Networks", RFC 6669, DOI 10.17487/RFC6669, + July 2012, . + + [RFC7419] Akiya, N., Binderberger, M., and G. Mirsky, "Common + Interval Support in Bidirectional Forwarding Detection", + RFC 7419, DOI 10.17487/RFC7419, December 2014, + . + + [RFC7487] Bellagamba, E., Takacs, A., Mirsky, G., Andersson, L., + Skoldstrom, P., and D. Ward, "Configuration of Proactive + Operations, Administration, and Maintenance (OAM) + Functions for MPLS-Based Transport Networks Using RSVP- + TE", RFC 7487, DOI 10.17487/RFC7487, March 2015, + . + +Acknowledgements + + The authors would like to thank Nobo Akiya, David Allan, and Adrian + Farrel for their thorough reviews and insightful comments. + + + + + +Bellagamba, et al. Standards Track [Page 28] + +RFC 7759 Extensions for MPLS-TP OAM Config. February 2016 + + +Authors' Addresses + + Elisa Bellagamba + + Email: elisa.bellagamba@gmail.com + + + Gregory Mirsky + Ericsson + + Email: Gregory.Mirsky@ericsson.com + + + Loa Andersson + Huawei Technologies + + Email: loa@mail01.huawei.com + + + Pontus Skoldstrom + Acreo AB + Electrum 236 + Kista 164 40 + Sweden + + Phone: +46 8 6327731 + Email: pontus.skoldstrom@acreo.se + + + Dave Ward + Cisco + + Email: dward@cisco.com + + + John Drake + Juniper + + Email: jdrake@juniper.net + + + + + + + + + + + + +Bellagamba, et al. Standards Track [Page 29] + -- cgit v1.2.3