PCE Working Group
Internet Engineering Task Force (IETF) D. Dhody, Ed.
Internet-Draft
Request for Comments: 8733 Huawei Technologies
Intended status:
Category: Standards Track R. Gandhi, Ed.
Expires: April 3, 2020
ISSN: 2070-1721 Cisco Systems, Inc.
U. Palle
R. Singh
Individual Contributor
L. Fang
Expedia,
Expedia Group, Inc.
October 1, 2019
PCEP
February 2020
Path Computation Element Communication Protocol (PCEP) Extensions for
MPLS-TE LSP Automatic Bandwidth Label Switched Path (LSP) Auto-Bandwidth Adjustment with
Stateful PCE
draft-ietf-pce-stateful-pce-auto-bandwidth-12
Abstract
The Path Computation Element Communication Protocol (PCEP) provides
mechanisms for Path Computation Elements (PCEs) to perform path
computations in response to Path Computation Clients (PCCs) Client (PCC) requests.
The
Stateful PCE extensions allow stateful control of Multi-Protocol
Label Switching (MPLS) Traffic Engineering MPLS-TE Label
Switched Paths (TE
LSPs) (LSPs) using PCEP.
The automatic bandwidth auto-bandwidth feature allows automatic and dynamic adjustment of
the TE LSP bandwidth reservation based on the volume of traffic
flowing through the LSP. This document describes PCEP extensions for automatic bandwidth
auto-bandwidth adjustment when employing an
Active Stateful active stateful PCE for
both PCE-Initiated PCE-initiated and PCC-Initiated PCC-initiated LSPs.
Status of This Memo
This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents an Internet Standards Track document.
This document is a product of the Internet Engineering Task Force
(IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list It represents the consensus of current Internet-
Drafts is at https://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid the IETF community. It has
received public review and has been approved for a maximum publication by the
Internet Engineering Steering Group (IESG). Further information on
Internet Standards is available in Section 2 of six months RFC 7841.
Information about the current status of this document, any errata,
and how to provide feedback on it may be updated, replaced, or obsoleted by other documents obtained at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
This Internet-Draft will expire on April 3, 2020.
https://www.rfc-editor.org/info/rfc8733.
Copyright Notice
Copyright (c) 2019 2020 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents
(https://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must
include 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
2. Conventions Used in This Document . . . . . . . . . . . . . . 4
2.1. Requirements Language . . . . . . . . . . . . . . . . . . 4
2.2. Abbreviations . . . . . . . . . . . . . . . . . . . . . . 4
2.3. Terminology . . . . . . . . . . . . . . . . . . . . . . . 5
3. Requirements for PCEP Extensions . . . . . . . . . . . . . . 7
4. Architectural Overview . . . . . . . . . . . . . . . . . . . 8
4.1. Auto-Bandwidth Overview . . . . . . . . . . . . . . . . . 8
4.2. Auto-bandwidth Auto-Bandwidth Theory of Operation . . . . . . . . . . . 8
4.3. Scaling Considerations . . . . . . . . . . . . . . . . . 10
5. PCEP Extensions . . . . . . . . . . . . . . . . . . . . . . . 10
5.1. Capability Advertisement . . . . . . . . . . . . . . . . 10
5.1.1. AUTO-BANDWIDTH-CAPABILITY TLV . . . . . . . . . . . . 11
5.2. AUTO-BANDWIDTH-ATTRIBUTES TLV . . . . . . . . . . . . . . 11
5.2.1. Sample-Interval sub-TLV . . . . . . . . . . . . . . . 13 Sub-TLV
5.2.2. Adjustment Intervals . . . . . . . . . . . . . . . . 13 Adjustment-Intervals
5.2.2.1. Adjustment-Interval sub-TLV . . . . . . . . . . . 14 Sub-TLV
5.2.2.2. Down-Adjustment-Interval sub-TLV . . . . . . . . 14 Sub-TLV
5.2.3. Adjustment Thresholds . . . . . . . . . . . . . . . . 15 Adjustment-Thresholds
5.2.3.1. Adjustment-Threshold sub-TLV . . . . . . . . . . 15 Sub-TLV
5.2.3.2. Adjustment-Threshold-Percentage sub-TLV . . . . . 16 Sub-TLV
5.2.3.3. Down-Adjustment-Threshold sub-TLV . . . . . . . . 17 Sub-TLV
5.2.3.4. Down-Adjustment-Threshold-Percentage sub-TLV . . 17 Sub-TLV
5.2.4. Minimum and Maximum Bandwidth Maximum-Bandwidth Values . . . . . . . . 18
5.2.4.1. Minimum-Bandwidth sub-TLV . . . . . . . . . . . . 19 Sub-TLV
5.2.4.2. Maximum-Bandwidth sub-TLV . . . . . . . . . . . . 19 Sub-TLV
5.2.5. Overflow and Underflow Conditions . . . . . . . . . . 20
5.2.5.1. Overflow-Threshold sub-TLV . . . . . . . . . . . 20 Sub-TLV
5.2.5.2. Overflow-Threshold-Percentage sub-TLV . . . . . . 21 Sub-TLV
5.2.5.3. Underflow-Threshold sub-TLV . . . . . . . . . . . 22 Sub-TLV
5.2.5.4. Underflow-Threshold-Percentage sub-TLV . . . . . 22 Sub-TLV
5.3. BANDWIDTH Object . . . . . . . . . . . . . . . . . . . . 23
5.4. The PCInitiate Message . . . . . . . . . . . . . . . . . 24
5.5. The PCUpd Message . . . . . . . . . . . . . . . . . . . . 24
5.6. The PCRpt Message . . . . . . . . . . . . . . . . . . . . 24
5.7. The PCNtf Message . . . . . . . . . . . . . . . . . . . . 25
6. Manageability Considerations . . . . . . . . . . . . . . . . 26
6.1. Control of Function and Policy . . . . . . . . . . . . . 26
6.2. Information and Data Models . . . . . . . . . . . . . . . 26
6.3. Liveness Detection and Monitoring . . . . . . . . . . . . 26
6.4. Verify Verifying Correct Operations . . . . . . . . . . . . . . . . 26
6.5. Requirements On for Other Protocols . . . . . . . . . . . . . 27
6.6. Impact On on Network Operations . . . . . . . . . . . . . . 27
7. Security Considerations . . . . . . . . . . . . . . . . . . . 27
8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 28
8.1. PCEP TLV Type Indicators . . . . . . . . . . . . . . . . 28
8.2. AUTO-BANDWIDTH-CAPABILITY TLV Flag Field . . . . . . . . 28
8.3. AUTO-BANDWIDTH-ATTRIBUTES Sub-TLV . . . . . . . . . . . . 28
8.4. Error Object . . . . . . . . . . . . . . . . . . . . . . 29
8.5. Notification Object . . . . . . . . . . . . . . . . . . . 29
9. References . . . . . . . . . . . . . . . . . . . . . . . . . 30
9.1. Normative References . . . . . . . . . . . . . . . . . . 30
9.2. Informative References . . . . . . . . . . . . . . . . . 31
Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . 31
Contributors . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 32
1. Introduction
[RFC5440] describes the Path Computation Element Protocol (PCEP) as a
communication mechanism between a Path Computation Client (PCC) and a
Path Computation Element (PCE), or between a PCE and a PCE, that
enables computation of Multi-Protocol Label Switching (MPLS) Traffic
Engineering MPLS-TE Label Switched Paths (TE LSPs). (LSPs).
[RFC8231] specifies extensions to PCEP to enable stateful control of
MPLS TE
MPLS-TE LSPs. It describes two mode modes of operations - Passive operation: passive stateful
PCE and Active active stateful PCE. Further, [RFC8281] describes the setup,
maintenance
maintenance, and teardown of PCE-Initiated PCE-initiated LSPs for the stateful PCE
model. In this document, the focus is on Active the active stateful PCE PCE,
where the LSPs are controlled by the PCE.
Over time, based on the varying traffic pattern, an LSP established
with a certain bandwidth may require adjustment of the bandwidth
reserved in the network dynamically. The head-end Label Switch Switching
Router (LSR) monitors the actual bandwidth demand of the established
LSP and periodically computes new bandwidth. The head-end LSR
automatically adjusts the bandwidth reservation of the LSP based on
the computed
bandwidth automatically. bandwidth. This feature, when available in the head-
end Label Switching Router (LSR) head-end
LSR implementation, is common commonly referred to as Auto-Bandwidth. auto-bandwidth. The Auto-Bandwidth
auto-bandwidth feature is described in detail in Section 4 of this
document.
In the model considered in this document, the PCC (head-end of the
LSP) collects the traffic rate samples flowing through the LSP and
calculates the new adjusted bandwidth. Adjusted Bandwidth. The PCC reports the
calculated bandwidth to be adjusted to the PCE. This is similar to
the Passive passive stateful PCE model: while the Passive passive stateful PCE uses a
path request/reply mechanism, the Active active stateful PCE uses a report/
update mechanism. In case of PCE-Initiated With a PCE-initiated LSP, the PCC is requested
during the LSP initiation to monitor and calculate the new adjusted
bandwidth. Adjusted
Bandwidth. [RFC8051] describes the use-case use case for Auto-Bandwidth auto-bandwidth
adjustment for Passive passive and Active active stateful PCE. PCEs.
Another approach would be to send the measured values itself themselves to
the PCE, which is considered out of scope for this document.
This document defines the PCEP extensions needed to support an Auto-
Bandwidth auto-
bandwidth feature in an Active active stateful PCE model where the LSP
bandwidth to be adjusted is calculated on the PCC (head-end of the
LSP). The use of PCE to calculate the bandwidth to be adjusted is
out of scope of this document.
2. Conventions Used in This Document
2.1. Requirements Language
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
"OPTIONAL" in this document are to be interpreted as described in
BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all
capitals, as shown here.
2.2. Abbreviations
PCC: Path Computation Client. Client
PCE: Path Computation Element. Element
PCEP: Path Computation Element Communication Protocol.
TE LSP: Protocol
TE: Traffic Engineering
LSP: Label Switched Path. Path
2.3. Terminology
The reader is assumed to be familiar with the terminology defined in
[RFC5440], [RFC8231], and [RFC8281].
In this document, the PCC is considered to be the head end head-end LSR of the
LSP. Other types of PCC PCCs are not in scope.
The following auto-bandwidth terminology is defined in this document.
Maximum Average Bandwidth (MaxAvgBw): The maximum average
bandwidthrepresents bandwidth
represents the current 'measured' traffic bandwidth demand of the
LSP during a time interval. This is the maximum value of the
traffic bandwidth rate samples (Bandwidth-Samples) in a given time
interval.
Adjusted Bandwidth: This is the Auto-Bandwidth auto-bandwidth 'computed' bandwidth
that is used to adjust the bandwidth reservation of the LSP.
Sample-Interval: The periodic time interval at which the measured
traffic rate of the LSP is collected as a Bandwidth-Sample.
Bandwidth-Sample: The bandwidth sample Bandwidth-Sample of the measured traffic rate
of the LSP collected at every Sample-Interval.
Maximum-Bandwidth: The maximum bandwidth Maximum-Bandwidth that can be reserved for
the LSP.
Minimum-Bandwidth: The minimum bandwidth Minimum-Bandwidth that can be reserved for
the LSP.
Up-Adjustment-Interval: The periodic time interval at which the
bandwidth adjustment should be made using the MaxAvgBw, MaxAvgBw when
MaxAvgBw is greater than the current bandwidth reservation of the
LSP.
Down-Adjustment-Interval: The periodic time interval at which the
bandwidth adjustment should be made using the MaxAvgBw, MaxAvgBw when
MaxAvgBw is less than the current bandwidth reservation of the
LSP.
Up-Adjustment-Threshold: This parameter is used to decide when the
LSP bandwidth should be adjusted. If the percentage or absolute
difference between the current MaxAvgBw and the current bandwidth
reservation is greater than or equal to the threshold value, the
LSP bandwidth is adjusted (upsized) to the current bandwidth
demand (Adjusted Bandwidth) at the Up-Adjustment-Interval expiry.
Down-Adjustment-Threshold: This parameter is used to decide when the
LSP bandwidth should be adjusted. If the percentage or absolute
difference between the current bandwidth reservation and the
current MaxAvgBw is greater than or equal to the threshold value,
the LSP bandwidth is adjusted (downsized) to the current bandwidth
demand (Adjusted Bandwidth) at the Down-Adjustment-Interval
expiry.
Overflow-Count: This parameter is used to decide when the LSP
bandwidth should be adjusted when there is a sudden increase in
traffic demand. This value indicates how many times,
consecutively, that the percentage or absolute difference between
the current MaxAvgBw and the current bandwidth reservation of the
LSP needs to be greater than or equal to the Overflow-Threshold
value in order to meet the overflow condition.
Overflow-Threshold: This parameter is used to decide when the LSP
bandwidth should be adjusted when there is a sudden increase in
traffic demand. If the percentage or absolute difference between
the current MaxAvgBw and the current bandwidth reservation of the
LSP is greater than or equal to the threshold value, the overflow
condition is said to be met. The LSP bandwidth is adjusted to the
current bandwidth demand demand, bypassing the Up-Adjustment-Interval if
the overflow condition is met consecutively for the Overflow-
Count. The Overflow-Threshold needs to be greater than or equal
to the Up-Adjustment-Threshold.
Underflow-Count: This parameter is used to decide when the LSP
bandwidth should be adjusted when there is a sudden decrease in
traffic demand. This value indicates how many times times,
consecutively, that the percentage or absolute difference between
the current MaxAvgBw and the current bandwidth reservation of the
LSP needs to be greater than or equal to the Underflow-Threshold
value in order to meet the underflow condition.
Underflow-Threshold: This parameter is used to decide when the LSP
bandwidth should be adjusted when there is a sudden decrease in
traffic demand. If the percentage or absolute difference between
the current MaxAvgBw and the current bandwidth reservation of the
LSP is greater than or equal to the threshold value, the underflow
condition is said to be met. The LSP bandwidth is adjusted to the
current bandwidth demand demand, bypassing the Down-Adjustment-Interval
if the underflow condition is met consecutively for the Underflow-
Count. The Underflow-Threshold needs to be greater than or equal
to the Down-Adjustment-Threshold.
Minimum-Threshold: When percentage-based thresholds are in use, they
are accompanied by this minimum threshold, Minimum-Threshold, which is used to
enforce ensure
that the magnitude of deviation of the calculated LSP bandwidth to
be adjusted from the current bandwidth reservations exceeds a
specific non-percentage-based criterion (represented as an
absolute bandwidth value) before any adjustments are made. This
serves to suppress unnecessary auto-bandwidth adjustments and
re-signaling
resignaling of the LSP at low bandwidth values.
3. Requirements for PCEP Extensions
The PCEP extensions required for auto-bandwidth are summarized in the
following table as well as in Figure 1.
+-----------------------------+-----------------------------+
+-------------------------+--------------------------------------+
| PCC Initiated | PCE Initiated |
+-----------------------------+-----------------------------+
+=========================+======================================+
| PCC monitors the traffic | At the time of initiation, the PCE |
| traffic and reports the calculated | PCE request requests that the PCC to monitor the |
| calculated bandwidth to be adjusted | the traffic and report the calculated |
| be adjusted to the PCE. | calculated bandwidth to be |
| | adjusted to the PCE. |
+-------------------------+--------------------------------------+
| Extension is needed for PCC | Extension is needed for the PCE to |
| the PCC to pass on the adjustment | to pass on the adjustment parameters at |
| adjustment parameters at | the time of LSP initiation. |
| parameters at the time of LSP | | LSP Delegation.
| LSP Initiation. delegation. |
+-----------------------------+-----------------------------+ |
+-------------------------+--------------------------------------+
Table 1: Requirements for Auto-Bandwidth PCEP extensions Extensions
----------
| |
| PCE |
| |
----------
| ^
AUTO-BANDWIDTH CAPABILITY | | AUTO-BANDWIDTH CAPABILITY
| |
AUTO-BANDWIDTH ATTRIBUTES | | AUTO-BANDWIDTH ATTRIBUTES
| | (For Delegated LSPs)
| |
| | REQUESTED BANDWIDTH
v |
----------
| |
| PCC |
| |
----------
Figure 1: Overview of Auto-Bandwidth PCEP extensions Extensions
A PCEP speaker supporting this document must have a mechanism to
advertise the automatic bandwidth auto-bandwidth adjustment capability for both PCC-
Initiated
initiated and PCE-Initiated PCE-initiated LSPs.
Auto-bandwidth deployment considerations for PCEP extensions are
summarized below:
o
* It is necessary to identify and inform the PCC which LSPs have
enabled the Auto-Bandwidth auto-bandwidth feature. Not all LSPs in some
deployments would like their bandwidth to be dependent on the
real-time real-
time bandwidth usage; for some LSPs LSPs, leaving the bandwidth
constant as set by the operator is preferred.
o
* In addition, an operator should be able to specify the auto-
bandwidth adjustment parameters (i.e. (i.e., configuration knobs) to
control this feature (e.g. minimum/ maximum bandwidth (e.g., Minimum/Maximum-Bandwidth range). The
PCC should be informed about these adjustment parameters.
4. Architectural Overview
4.1. Auto-Bandwidth Overview
The Auto-Bandwidth auto-bandwidth feature allows automatic and dynamic adjustment of
the reserved bandwidth of an LSP over time (i.e., without network
operator intervention) to accommodate the varying traffic demand of
the LSP. If the traffic flowing through the LSP is lower than the
configured or current reserved bandwidth of the LSP, the extra
bandwidth is being reserved needlessly and is being wasted.
Conversely, if the actual traffic flowing through the LSP is higher
than the configured or current reserved bandwidth of the LSP, it can
potentially cause congestion or packet loss in the network. The
initial LSP bandwidth can be set to an arbitrary value (including
zero). In practice, it can be set to an expected value based on
design and planning. The head-end Label Switch Router (LSR) LSR monitors the actual traffic
flowing through the LSP and uses that information to adjust the
bandwidth reservation of the LSP in the network.
Bandwidth adjustment must not cause disruption to the traffic flow
carried by the LSP. One way to achieve this is to use the make-
before-break signaling method [RFC3209].
4.2. Auto-bandwidth Auto-Bandwidth Theory of Operation
This section describes the Auto-Bandwidth auto-bandwidth feature in a general way.
When the Auto-Bandwidth auto-bandwidth feature is enabled, the measured traffic rate
is periodically sampled at each Sample-Interval by the PCC, PCC when the
PCC is the head-end node of the LSP. The sample interval Sample-Interval can be
configured by an operator, with a default value of 5 minutes. A very
low Sample-Interval could have some undesirable interactions with
transport protocols (see Section 6.6).
The traffic rate samples are accumulated over the Adjustment-Interval
period (in the Up or Down direction). The period can be configured
by an operator, with a default value of 24 hours. The PCC in-charge in charge
of calculating the bandwidth to be adjusted can decide to adjust the
bandwidth of the LSP to the highest traffic rate sample (MaxAvgBw)
amongst the set of bandwidth samples Bandwidth-Samples collected over the Adjustment-
Interval period (in the Up or Down direction) depending on the
operator policy.
Note that the highest traffic rate sample could be higher or lower
than the current LSP bandwidth. Only The LSP is adjusted (upsized) to the
current bandwidth demand (MaxAvgBW) only if the difference between
the current bandwidth demand (MaxAvgBw) and the current bandwidth
reservation is greater than or equal to the Adjustment-Threshold the
LSP bandwidth is adjusted (upsized) to the current bandwidth demand
(MaxAvgBw). Adjustment-Threshold.
The Adjustment-Threshold could be an absolute value or a percentage.
The threshold can be configured by an operator, with a default value
of 5 percentage. percent. Similarly, if the difference between the current
bandwidth reservation and the current bandwidth demand (MaxAvgBw) is
greater than or equal to the Down-Adjustment-Threshold (percentage or
absolute value), the LSP bandwidth is adjusted (downsized) to the
current bandwidth demand (MaxAvgBw). Some LSPs are less eventful eventful,
while other LSPs may encounter a lot of changes in the traffic
pattern. The thresholds and intervals for bandwidth adjustment are
configured based on the traffic pattern of the LSP.
In order to avoid frequent re-signaling, resignaling, an operator may set a longer
adjustment-interval
Adjustment-Interval value (Up and/or Down). However, a longer
Adjustment-Interval can result in an the undesirable effect of masking
sudden changes in the traffic demands of an LSP. To avoid this, the
Auto-Bandwidth
auto-bandwidth feature may force the Adjustment-Interval to
prematurely expire the adjustment interval and adjust the LSP bandwidth to accommodate the
sudden bursts of increase in traffic demand as an overflow condition
or decrease in traffic demand as an underflow condition. An operator
needs to configure appropriate values for the Overflow-Threshold and/or and/
or Underflow-Threshold parameters parameters, and they do not have default
values defined in this document.
All thresholds in this document could be represented in both absolute
value and percentage, percentage and could be used together. This is provided to
accommodate the cases where the LSP bandwidth reservation may become very
large or very small over time. For example, an operator may use the
percentage threshold to handle small to large bandwidth values and
absolute values to handle very large bandwidth values. The auto-bandwidth auto-
bandwidth adjustment is made when either one of the two thresholds,
the absolute or percentage, is crossed.
When using the (adjustment/overflow/underflow) percentage thresholds,
if the LSP bandwidth changes rapidly at very low values, it may
trigger frequent auto-bandwidth adjustments due to the crossing of
the percentage thresholds. This can lead to unnecessary re-signaling resignaling
of the LSPs in the network. This is suppressed by setting the
minimum-threshold
Minimum-Threshold parameters along with the percentage thresholds.
The auto-bandwidth adjustment is only made if the LSP bandwidth
crosses both the percentage threshold and the minimum-threshold Minimum-Threshold
parameters.
4.3. Scaling Considerations
It should be noted that any bandwidth change requires re-signaling resignaling of
an LSP, which can further trigger preemption of lower priority lower-priority LSPs
in the network. When deployed under scale, this can lead to a
signaling churn in the network. The Auto-bandwidth auto-bandwidth application
algorithm is thus advised to take this into consideration before
adjusting the LSP bandwidth. Operators are advised to set the values
of various auto-bandwidth adjustment parameters appropriate for the
deployed LSP scale.
If a PCE gets overwhelmed, it can notify the PCC to temporarily
suspend the reporting of the new LSP bandwidth to be adjusted (see
Section 5.7 of this document). adjusted.
Similarly, if a PCC gets overwhelmed due to signaling churn, it can
notify the PCE to temporarily suspend new LSP setup requests (see requests. See
Section 5.7 of this document). document.
5. PCEP Extensions
5.1. Capability Advertisement
During the PCEP Initialization Phase, initialization phase, PCEP speakers (PCE or PCC)
advertise their support of Automatic Bandwidth the auto-bandwidth adjustment feature. A
PCEP speaker includes the AUTO-BANDWIDTH-CAPABILITY TLV, TLV in the OPEN
Object
object to advertise its support for PCEP Auto-Bandwidth auto-bandwidth extensions.
The presence of the AUTO-BANDWIDTH-CAPABILITY TLV in the OPEN Object object
indicates that the Automatic Bandwidth auto-bandwidth feature is supported as described
in this document.
o
* The PCEP protocol extensions for Auto-Bandwidth auto-bandwidth adjustments MUST
NOT be used if one or both PCEP speakers have not included the
AUTO-BANDWIDTH-CAPABILITY TLV in their respective OPEN message.
o
* A PCEP speaker that does not recognize the extensions defined in
this document would simply ignore the TLVs as per [RFC5440].
o
* If a PCEP speaker that supports the extensions defined in this document
but did not advertise this capability, then upon receipt of AUTO-BANDWIDTH-ATTRIBUTES AUTO-
BANDWIDTH-ATTRIBUTES TLV in the LSP Attributes (LSPA) object, it
SHOULD generate a PCErr with error-type Error-Type 19 (Invalid
Operation), error-value TBD4 Operation) and
Error-value 14 (Auto-Bandwidth capability was not advertised) and
ignore the AUTO-BANDWIDTH-ATTRIBUTES TLV.
5.1.1. AUTO-BANDWIDTH-CAPABILITY TLV
The AUTO-BANDWIDTH-CAPABILITY TLV is an optional TLV for use in the
OPEN Object for Automatic Bandwidth Adjustment auto-bandwidth adjustment via PCEP capability
advertisement. Its format is shown in the following figure:
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type=TBD2 Type=36 | Length=4 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Flags Flag |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 2: AUTO-BANDWIDTH-CAPABILITY TLV format Format
The Type of the TLV Type is (TBD2) 36, and it has a fixed Length of 4 octets.
The value comprises a single field - Flags field: Flag (32 bits). No flags are
defined for this TLV in this document.
Unassigned bits are considered reserved. They MUST be set to 0 on
transmission and MUST be ignored on receipt.
Advertisement of the AUTO-BANDWIDTH-CAPABILITY TLV implies support of
auto-bandwidth adjustment, as well as the objects, TLVs TLVs, and
procedures defined in this document.
5.2. AUTO-BANDWIDTH-ATTRIBUTES TLV
The AUTO-BANDWIDTH-ATTRIBUTES TLV provides the 'configurable knobs'
of the feature feature, and it can be included as an optional TLV in the LSPA
Object
object (as described in [RFC5440]).
For PCE-Initiated a PCE-initiated LSP [RFC8281], this TLV is included in the LSPA
Object
object with the PCInitiate message. For the PCC-Initiated PCC-initiated delegated
LSPs, this TLV is carried in the PCRpt Path Computation State Report
(PCRpt) message in the LSPA Object. object. This TLV is also carried in the
LSPA object with the PCUpd Path Computation Update Request (PCUpd) message
to direct the PCC (LSP head-end) to make updates to auto-bandwidth
attributes such as Adjustment-Interval.
The TLV is encoded in all PCEP messages for the LSP while the auto-
bandwidth adjustment feature is enabled, the enabled. The absence of the TLV
indicates the PCEP speaker wishes to disable the feature. This TLV
includes multiple AUTO-BANDWIDTH-ATTRIBUTES sub-TLVs. The AUTO-
BANDWIDTH-ATTRIBUTES sub-TLVs are included if there is a change since
the last information sent in the PCEP message. The default values
for missing sub-TLVs apply for the first PCEP message for the LSP.
The format of the AUTO-BANDWIDTH-ATTRIBUTES TLV is shown in the
following figure:
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type=TBD1 Type=37 | Length |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| |
// sub-TLVs //
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 3: AUTO-BANDWIDTH-ATTRIBUTES TLV format Format
Type: TBD1 37
Length: The Length field defines the length of the value portion in
octets
bytes as per [RFC5440].
Value: This comprises one or more sub-TLVs.
Following
The following sub-TLVs are defined in this document:
+------+-----+--------------------------------------+
| Type | Len | Name
------------------------------------------------------------------- |
+======+=====+======================================+
| 1 | 4 | Sample-Interval sub-TLV |
+------+-----+--------------------------------------+
| 2 | 4 | Adjustment-Interval sub-TLV |
+------+-----+--------------------------------------+
| 3 | 4 | Down-Adjustment-Interval sub-TLV |
+------+-----+--------------------------------------+
| 4 | 4 | Adjustment-Threshold sub-TLV |
+------+-----+--------------------------------------+
| 5 | 8 | Adjustment-Threshold-Percentage sub-TLV |
+------+-----+--------------------------------------+
| 6 | 4 | Down-Adjustment-Threshold sub-TLV |
+------+-----+--------------------------------------+
| 7 | 8 | Down-Adjustment-Threshold-Percentage sub-TLV |
+------+-----+--------------------------------------+
| 8 | 4 | Minimum-Bandwidth sub-TLV |
+------+-----+--------------------------------------+
| 9 | 4 | Maximum-Bandwidth sub-TLV |
+------+-----+--------------------------------------+
| 10 | 8 | Overflow-Threshold sub-TLV |
+------+-----+--------------------------------------+
| 11 | 8 | Overflow-Threshold-Percentage sub-TLV |
+------+-----+--------------------------------------+
| 12 | 8 | Underflow-Threshold sub-TLV |
+------+-----+--------------------------------------+
| 13 | 8 | Underflow-Threshold-Percentage sub-TLV |
+------+-----+--------------------------------------+
Table 2: Sub-TLV Types of the AUTO-BANDWIDTH-
ATTRIBUTES TLV
Future specifications can define additional sub-TLVs.
The sub-TLVs are encoded to inform the PCEP peer of the various
sampling and adjustment parameters. In the case of a missing sub-TLV, sub-
TLV, as per the local policy, either the default value (as specified
in this document) or some other operator configured operator-configured value is used.
All sub-TLVs are optional optional, and any unrecognized sub-TLV MUST be
ignored. If a sub-TLV of the same type appears more than once, only
the first occurrence is processed processed, and all others MUST be ignored.
The following sub-sections subsections describe the sub-TLVs which that are currently
defined to be as being carried within the AUTO-BANDWIDTH-ATTRIBUTES TLV.
5.2.1. Sample-Interval sub-TLV Sub-TLV
The Sample-Interval sub-TLV specifies a time interval in seconds at in
which traffic samples are collected at the PCC.
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type=1 | Length=4 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Sample-Interval |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 4: Sample-Interval sub-TLV format Sub-TLV Format
The Type is 1, the Length is 4 octets, and the value comprises of - the
following:
Sample-Interval: The 4-octet time interval for bandwidth sample the Bandwidth-Sample
collection. The valid range is from 1 to 604800 (7 days), in
seconds. The default value is 300 seconds. Due care needs to be
taken in a case of with a very low Sample-Interval, as it can have
some undesirable interactions with transport protocols (see
Section 6.6). The sample-interval Sample-Interval parameter MUST NOT be greater
than the (down) adjustment-interval. Adjustment-Interval. In the case of in which an
invalid value, value is present, the Sub-TLV sub-TLV MUST be ignored and the
previous value is will be maintained.
5.2.2. Adjustment Intervals Adjustment-Intervals
The sub-TLVs in this section are encoded to inform the PCEP peer of
the
adjustment interval Adjustment-Interval parameters. The Adjustment-Interval sub-TLV
specifies the time interval for both upward (Up-Adjustment-Interval)
and downward (Down-Adjustment-Interval) trends. An implementation
MAY require to set that a different adjustment interval values for Adjustment-Interval value be set when
the bandwidth usage trend is moving downwards from the one used when
it is moving upwards. In that case, the operator could use the Down-Adjustment-
Interval sub-TLV Down-
Adjustment-Interval sub-TLV, which overrides the Adjustment-Interval
value for Down-Adjustment-Interval.
5.2.2.1. Adjustment-Interval sub-TLV Sub-TLV
The Adjustment-Interval sub-TLV specifies a time interval in seconds
at
in which a bandwidth adjustment should be made in an upward or
downward direction. This sub-TLV specify specifies the value for Up-Adjustment-Interval Up-
Adjustment-Interval and Down-Adjustment-Interval when they are the
same and when the Down-
Adjustment-Interval Down-Adjustment-Interval sub-TLV is not included.
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type=2 | Length=4 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Adjustment-Interval |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 5: Adjustment-Interval sub-TLV format Sub-TLV Format
The Type is 2, the Length is 4 octets, and the value comprises of - the
following:
Adjustment-Interval: The 4-octet time interval for bandwidth
adjustments. The valid range is from 1 to 604800 (7 days), in
seconds. The default value is 86400 seconds (1 day). The
adjustment-interval
Adjustment-Interval parameter MUST NOT be less than the sample-
interval, otherwise Sample-
Interval; otherwise, the Sub-TLV sub-TLV MUST be ignored ignored, and the previous
value is will be maintained.
5.2.2.2. Down-Adjustment-Interval sub-TLV Sub-TLV
The Down-Adjustment-Interval sub-TLV specifies a time interval in
seconds at in which a bandwidth adjustment should be made when MaxAvgBw
is less than the current bandwidth reservation of the LSP. This
parameter overrides the Adjustment-Interval for the downward trend.
This sub-TLV is used only when there is a need for different
adjustment intervals
Adjustment-Intervals in the upward and downward directions.
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type=3 | Length=4 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Down-Adjustment-Interval |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 6: Down-Adjustment-Interval sub-TLV format Sub-TLV Format
The Type is 3, the Length is 4 octets, and the value comprises of - the
following:
Down-Adjustment-Interval: The 4-octet time interval for downward
bandwidth adjustments. The valid range is from 1 to 604800 (7
days), in seconds. The default value equals the adjustment-
interval. Adjustment-
Interval. The down-adjustment-interval Down-Adjustment-Interval parameter MUST NOT be less
than the sample-interval, otherwise Sample-Interval; otherwise, the Sub-TLV sub-TLV MUST be ignored
and the previous value is will be maintained.
5.2.3. Adjustment Thresholds Adjustment-Thresholds
The sub-TLVs in this section are encoded to inform the PCEP peer of
the adjustment threshold Adjustment-Threshold parameters. An implementation MAY include
both sub-TLVs for the absolute value and the percentage, in which
case the bandwidth is adjusted when either of the adjustment
threshold Adjustment-
Threshold conditions are met. The Adjustment-Threshold sub-TLV
specifies the threshold for both upward (Up-Adjustment-Threshold) and
downward (Down-Adjustment-Threshold) trend. trends. If the operator would
like to use a different adjustment threshold Adjustment-Threshold during the downward
trend, the Down-Adjustment-Threshold sub-TLV is included. Similarly,
the Adjustment-Threshold-Percentage sub-TLV specifies the threshold
percentage for both upward and downward trend. trends. If the operator
would like to use a different adjustment threshold Adjustment-Threshold percentage during
the downward trend, the Down-Adjustment-Threshold-Percentage sub-TLV
is included. It is worth noting that regardless of how the threshold
thresholds are set, the adjustment will not be made until at least
one sample-
interval Sample-Interval has passed simply because no sample will be made
on which to base a comparison with a threshold.
5.2.3.1. Adjustment-Threshold sub-TLV Sub-TLV
The Adjustment-Threshold sub-TLV is used to decide when the LSP
bandwidth should be adjusted in an upward or downward direction.
This sub-TLV specify specifies the absolute value for Up-Adjustment-Threshold
and Down-Adjustment-Threshold when they are the same and when the Down-
Adjustment-Threshold
Down-Adjustment-Threshold sub-TLV is not included.
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type=4 | Length=4 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Adjustment-Threshold |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 7: Adjustment-Threshold sub-TLV format Sub-TLV Format
The Type is 4, the Length is 4 octets, and the value comprises of - the
following:
Adjustment-Threshold: The absolute Adjustment-Threshold bandwidth
difference value, encoded in IEEE floating point format (see
[[IEEE.754.1985]]),
[IEEE.754.1985]) and expressed in bytes per second. The default
adjustment-threshold
Adjustment-Threshold value is not set. Refer to Section 3.1.2 of
[RFC3471] for a table of commonly used values.
If the modulus of difference between the current MaxAvgBw and the
current bandwidth reservation is greater than or equal to the
threshold value, the LSP bandwidth is adjusted to the current
bandwidth demand (MaxAvgBw).
In the case of in which an invalid value, value is present, the Sub-TLV sub-TLV MUST be
ignored and the previous value is will be maintained.
5.2.3.2. Adjustment-Threshold-Percentage sub-TLV Sub-TLV
The Adjustment-Threshold-Percentage sub-TLV is used to decide when
the LSP bandwidth should be adjusted in an upward or downward
direction. This sub-TLV specify specifies the percentage value for Up-Adjustment-Threshold Up-
Adjustment-Threshold and Down-Adjustment-Threshold when they are the
same and when the Down-
Adjustment-Threshold-Percentage Down-Adjustment-Threshold-Percentage sub-TLV is not
included.
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type=5 | Length=8 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Reserved | Percentage |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Minimum-Threshold |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 8: Adjustment-Threshold-Percentage sub-TLV format Sub-TLV Format
The Type is 5, the Length is 8 octets, and the value comprises of - the
following:
Reserved: MUST be set to zero on transmission and MUST be ignored on
receipt.
Percentage: The Adjustment-Threshold value (7 bits), encoded in a
percentage (an integer from 1 to 100). The value 0 is considered
to be invalid. The default value is 5 percent.
Minimum-Threshold: The absolute Minimum-Threshold bandwidth value,
encoded in IEEE floating point format (see [[IEEE.754.1985]]), [IEEE.754.1985]) and
expressed in bytes per second. The increase or decrease of the
LSP bandwidth MUST be at least or above the minimum-threshold Minimum-Threshold before the
bandwidth adjustment is made. The default value is 0.
If the percentage absolute difference between the current MaxAvgBw
and the current bandwidth reservation is greater than or equal to the
threshold percentage, percentage and the difference in the bandwidth is at least or
above the Minimum-Threshold, the LSP bandwidth is adjusted to the
current bandwidth demand (MaxAvgBw).
In the case of in which an invalid value, value is present, the Sub-TLV sub-TLV MUST be
ignored and the previous value is will be maintained.
5.2.3.3. Down-Adjustment-Threshold sub-TLV Sub-TLV
The Down-Adjustment-Threshold sub-TLV is used to decide when the LSP
bandwidth should be adjusted when MaxAvgBw is lesser less than the current
bandwidth reservation. This parameter overrides the Adjustment-
Threshold for the downward trend. This sub-TLV is used only when
there is a need for a different threshold in the upward and downward
directions.
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type=6 | Length=4 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Down-Adjustment-Threshold |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 9: Down-Adjustment-Threshold sub-TLV format Sub-TLV Format
The Type is 6, the Length is 4 octets, and the value comprises of - the
following:
Down-Adjustment-Threshold: The absolute Down-Adjustment-Threshold
bandwidth value, encoded in IEEE floating point format (see
[[IEEE.754.1985]]),
[IEEE.754.1985]) and expressed in bytes per second. The default
value equals the adjustment-threshold. Adjustment-Threshold. Refer to Section 3.1.2 of
[RFC3471] for a table of commonly used values.
If the difference between the current bandwidth reservation and the
current MaxAvgBw is greater than or equal to the threshold value, the
LSP bandwidth is adjusted to the current bandwidth demand (MaxAvgBw).
In the case of in which an invalid value, value is present, the Sub-TLV sub-TLV MUST be
ignored and the previous value is will be maintained.
5.2.3.4. Down-Adjustment-Threshold-Percentage sub-TLV Sub-TLV
The Down-Adjustment-Threshold-Percentage sub-TLV is used to decide
when the LSP bandwidth should be adjusted when MaxAvgBw is lesser less than
the current bandwidth reservation. This parameter overrides the
Adjustment-Threshold-Percentage for the downward trend. This sub-TLV
is used only when there is a need for a different threshold
percentage in the upward and downward directions.
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type=7 | Length=8 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Reserved | Percentage |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Minimum-Threshold |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 10: Down-Adjustment-Threshold-Percentage sub-TLV format Sub-TLV Format
The Type is 7, the Length is 8 octets, and the value comprises of - the
following:
Reserved: MUST be set to zero on transmission and MUST be ignored on
receipt.
Percentage: The Down-Adjustment-Threshold value (7 bits), encoded in
a percentage (an integer from 1 to 100). The value 0 is
considered to be invalid. The default value equals the adjustment-threshold-
percentage.
Adjustment-Threshold-Percentage.
Minimum-Threshold: The absolute Minimum-Threshold bandwidth value,
encoded in IEEE floating point format (see [[IEEE.754.1985]]), [IEEE.754.1985]) and
expressed in bytes per second. The decrease of the LSP bandwidth
MUST be at least or above the minimum-threshold Minimum-Threshold before the bandwidth
adjustment is made. The default value equals the
minimum-threshold Minimum-
Threshold for the adjustment-threshold-percentage. Adjustment-Threshold-Percentage.
If the percentage difference between the current bandwidth
reservation and the current MaxAvgBw is greater than or equal to the
threshold percentage, percentage and the difference in the bandwidth is at least or
above the Minimum-Threshold, the LSP bandwidth is adjusted to the
current bandwidth demand (MaxAvgBw).
In the case of in which an invalid value, value is present, the Sub-TLV sub-TLV MUST be
ignored and the previous value is will be maintained.
5.2.4. Minimum and Maximum Bandwidth Maximum-Bandwidth Values
5.2.4.1. Minimum-Bandwidth sub-TLV Sub-TLV
The Minimum-Bandwidth sub-TLV specify specifies the minimum bandwidth Minimum-Bandwidth allowed
for the LSP, LSP and is expressed in bytes per second. The LSP bandwidth
cannot be adjusted below the minimum bandwidth Minimum-Bandwidth value.
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type=8 | Length=4 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Minimum-Bandwidth |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 11: Minimum-Bandwidth sub-TLV format Sub-TLV Format
The Type is 8, the Length is 4 octets, and the value comprises of - the
following:
Minimum-Bandwidth: The 4-octet bandwidth value encoded in IEEE
floating point format (see [[IEEE.754.1985]]), [IEEE.754.1985]) and expressed in bytes
per second. The default minimum-bandwidth Minimum-Bandwidth value is set to 0.
Refer to Section 3.1.2 of [RFC3471] for a table of commonly used
values.
In the case of in which an invalid value, value is present, the Sub-TLV sub-TLV MUST be
ignored and the previous value is will be maintained.
5.2.4.2. Maximum-Bandwidth sub-TLV Sub-TLV
The Maximum-Bandwidth sub-TLV specify specifies the maximum bandwidth Maximum-Bandwidth allowed
for the LSP, LSP and is expressed in bytes per second. The LSP bandwidth
cannot be adjusted above the maximum bandwidth Maximum-Bandwidth value.
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type=9 | Length=4 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Maximum-Bandwidth |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 12: Maximum-Bandwidth sub-TLV format Sub-TLV Format
The Type is 9, the Length is 4 octets, and the value comprises of - the
following:
Maximum-Bandwidth: The 4-octet bandwidth value encoded in IEEE
floating point format (see [[IEEE.754.1985]]), [IEEE.754.1985]) and expressed in bytes
per second. The default maximum-bandwidth Maximum-Bandwidth value is not set.
Refer to Section 3.1.2 of [RFC3471] for a table of commonly used
values.
In the case of in which an invalid value, value is present, the Sub-TLV sub-TLV MUST be
ignored and the previous value is will be maintained.
5.2.5. Overflow and Underflow Conditions
The sub-TLVs in this section are encoded to inform the PCEP peer of
the overflow and underflow threshold parameters. An implementation
MAY include sub-TLVs for an absolute value and/or a percentage for
the threshold, in which case the bandwidth is immediately adjusted
when either of the threshold conditions is met consecutively for the
given count (as long as the difference in the bandwidth is at least or
above the Minimum-Threshold). By default, the threshold values for
overflow and underflow conditions are not set.
5.2.5.1. Overflow-Threshold sub-TLV Sub-TLV
The Overflow-Threshold sub-TLV is used to decide if the LSP bandwidth
should be adjusted immediately.
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type=10 | Length=8 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Reserved | Count |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Overflow-Threshold |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 13: Overflow-Threshold sub-TLV format Sub-TLV Format
The Type is 10, the Length is 8 octets, and the value comprises of - the
following:
Reserved: MUST be set to zero on transmission and MUST be ignored on
receipt.
Count: The Overflow-Count value (5 bits), encoded in an integer.
The value 0 is considered to be invalid. The number of
consecutive samples for which the overflow condition MUST be met
for the LSP bandwidth is to be immediately adjusted to the current
bandwidth demand, bypassing the (up) adjustment-interval. Adjustment-Interval.
Overflow-Threshold: The absolute Overflow-Threshold bandwidth value,
encoded in IEEE floating point format (see [[IEEE.754.1985]]), [IEEE.754.1985]) and
expressed in bytes per second. Refer to Section 3.1.2 of
[RFC3471] for a table of commonly used values. If the difference
of
between the current MaxAvgBw from and the current bandwidth reservation
is greater than or equal to the threshold value, the overflow
condition is met.
In the case of in which an invalid value, value is present, the Sub-TLV sub-TLV MUST be
ignored and the previous value is will be maintained.
5.2.5.2. Overflow-Threshold-Percentage sub-TLV Sub-TLV
The Overflow-Threshold-Percentage sub-TLV is used to decide if the
LSP bandwidth should be adjusted immediately.
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type=11 | Length=8 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Percentage | Reserved | Count |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Minimum-Threshold |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 14: Overflow-Threshold-Percentage sub-TLV format Sub-TLV Format
The Type is 11, the Length is 8 octets, and the value comprises of - the
following:
Percentage: The Overflow-Threshold value (7 bits), encoded in a
percentage (an integer from 1 to 100). The value 0 is considered
to be invalid. If the percentage increase of the current MaxAvgBw
from the current bandwidth reservation is greater than or equal to
the threshold percentage, the overflow condition is met.
Reserved: MUST be set to zero on transmission and MUST be ignored on
receipt.
Count: The Overflow-Count value (5 bits), encoded in an integer.
The value 0 is considered to be invalid. The number of
consecutive samples for which the overflow condition MUST be met
for the LSP bandwidth is to be immediately adjusted to the current
bandwidth demand, bypassing the (up) adjustment-interval. Adjustment-Interval.
Minimum-Threshold: The absolute Minimum-Threshold bandwidth value,
encoded in IEEE floating point format (see [[IEEE.754.1985]]), [IEEE.754.1985]) and
expressed in bytes per second. The increase of the LSP bandwidth
MUST be at least or above the minimum-threshold Minimum-Threshold before the bandwidth
adjustment is made.
In the case of in which an invalid value, value is present, the Sub-TLV sub-TLV MUST be
ignored and the previous value is will be maintained.
5.2.5.3. Underflow-Threshold sub-TLV Sub-TLV
The Underflow-Threshold sub-TLV is used to decide if the LSP
bandwidth should be adjusted immediately.
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type=12 | Length=8 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Reserved | Count |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Underflow-Threshold |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 15: Underflow-Threshold sub-TLV format Sub-TLV Format
The Type is 12, the Length is 8 octets, and the value comprises of - the
following:
Reserved: MUST be set to zero on transmission and MUST be ignored on
receipt.
Count: The Underflow-Count value (5 bits), encoded in an integer.
The value 0 is considered to be invalid. The number of
consecutive samples for which the underflow condition MUST be met
for the LSP bandwidth is to be immediately adjusted to the current
bandwidth demand, bypassing the down-adjustment-interval. Down-Adjustment-Interval.
Underflow-Threshold: The absolute Underflow-Threshold bandwidth
value, encoded in IEEE floating point format (see
[[IEEE.754.1985]]), [IEEE.754.1985])
and expressed in bytes per second. Refer to Section 3.1.2 of
[RFC3471] for a table of commonly used values. If the difference of
between the current MaxAvgBw from and the current bandwidth reservation
is greater than or equal to the threshold value, the underflow
condition is met.
In the case of in which an invalid value, value is present, the Sub-TLV sub-TLV MUST be
ignored and the previous value is will be maintained.
5.2.5.4. Underflow-Threshold-Percentage sub-TLV Sub-TLV
The Underflow-Threshold-Percentage sub-TLV is used to decide if the
LSP bandwidth should be adjusted immediately.
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type=13 | Length=8 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Percentage | Reserved | Count |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Minimum-Threshold |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 16: Underflow-Threshold-Percentage sub-TLV format Sub-TLV Format
The Type is 13, the Length is 8 octets, and the value comprises of - the
following:
Percentage: The Underflow-Threshold value (7 bits), encoded in
percentage (an integer from 1 to 100). The value 0 is considered
to be invalid. If the percentage decrease of the current MaxAvgBw
from the current bandwidth reservation is greater than or equal to
the threshold percentage, the underflow condition is met.
Reserved: MUST be set to zero on transmission and MUST be ignored on
receipt.
Count: The Underflow-Count value (5 bits), encoded in an integer.
The value 0 is considered to be invalid. The number of
consecutive samples for which the underflow condition MUST be met
for the LSP bandwidth is to be immediately adjusted to the current
bandwidth demand, bypassing the down-adjustment-interval. Down-Adjustment-Interval.
Minimum-Threshold: The absolute Minimum-Threshold bandwidth value,
encoded in IEEE floating point format (see [[IEEE.754.1985]]), [IEEE.754.1985]) and
expressed in bytes per second. The decrease of the LSP bandwidth
MUST be at least or above the minimum-threshold Minimum-Threshold before the bandwidth
adjustment is made.
In the case of in which an invalid value, value is present, the Sub-TLV sub-TLV MUST be
ignored and the previous value is will be maintained.
5.3. BANDWIDTH Object
As per [RFC5440], the BANDWIDTH object (Object-Class value 5) is
defined with two Object-Type values as following: follows:
Requested Bandwidth: The BANDWIDTH Object-Type value is 1.
Re-optimization
Reoptimization Bandwidth: Bandwidth The bandwidth of an existing TE LSP for
which a re-optimization reoptimization is requested. The BANDWIDTH Object-Type
value is 2.
The PCC reports the calculated bandwidth to be adjusted (MaxAvgBw) to
the Stateful stateful PCE using the existing 'Requested Bandwidth' with the
BANDWIDTH Object-Type as 1. The reporting of the 're-optimization 'reoptimization
bandwidth' with BANDWIDTH Object-Type as 2 is not required as the
Stateful
stateful PCE is aware of the existing LSP bandwidth.
5.4. The PCInitiate Message
A PCInitiate message is a PCEP message sent by a PCE to a PCC to
trigger LSP instantiation or deletion [RFC8281].
For the PCE-Initiated PCE-initiated LSP with Auto-Bandwidth the auto-bandwidth feature enabled, AUTO-
BANDWIDTH-ATTRIBUTES
AUTO-BANDWIDTH-ATTRIBUTES TLV MUST be included in the LSPA object
with the PCInitiate message.
The Routing Backus-Naur Format Form (RBNF) definition of the PCInitiate
message [RFC8281] is unchanged by this document.
5.5. The PCUpd Message
A PCUpd message is a PCEP message sent by a PCE to a PCC to update
the LSP parameters [RFC8231].
For PCE-Initiated PCE-initiated LSPs with Auto-Bandwidth the auto-bandwidth feature enabled, AUTO-
BANDWIDTH-ATTRIBUTES the
AUTO-BANDWIDTH-ATTRIBUTES TLV MUST be included in the LSPA object
with the PCUpd message. The PCE can send this TLV to direct the PCC
to change the auto-bandwidth parameters.
The RBNF definition of the PCUpd message [RFC8231] is unchanged by
this document.
5.6. The PCRpt Message
The PCRpt message [RFC8231] is a PCEP message sent by a PCC to a PCE
to report the status of one or more LSPs.
For PCE-Initiated PCE-initiated LSPs [RFC8281], the PCC creates the LSP using the
attributes communicated by the PCE, PCE and using the local values for the
unspecified parameters. After the successful instantiation of the
LSP, the PCC automatically delegates the LSP to the PCE and generates
a PCRpt message to provide the status report for the LSP.
For both PCE-Initiated PCE-initiated and PCC-Initiated PCC-initiated LSPs, when the LSP is
delegated to a PCE for the very first time as well as after the
successful delegation, the BANDWIDTH object of type 1 is used to
specify the requested bandwidth in the PCRpt message.
The RBNF definition of the PCRpt message [RFC8231] is unchanged by
this document.
5.7. The PCNtf Message
As per [RFC5440], the PCEP Notification message (PCNtf) can be sent
by a PCEP speaker to notify its peer of a specific event.
A PCEP speaker (PCE or PCC) SHOULD notify its PCEP peer (PCC or PCE)
when it is in an overwhelmed state due to the auto-bandwidth feature.
An implementation needs to make an attempt to send this notification
(when overwhelmed by auto-bandwidth adjustments) unless sending this
notification would only serve to increase the load further. Note
that when the notification is not received received, the PCEP speaker would
continue to request bandwidth adjustments even when they could not cannot be
handled in a timely fashion.
Upon receipt of an auto-bandwidth overwhelm notification, the peer
SHOULD NOT send any PCEP messages related to auto-bandwidth
adjustment. If a PCEP message related to auto-bandwidth adjustment
is received during while in an overwhelmed state, it MUST be ignored.
o
* When a PCEP speaker is overwhelmed, it SHOULD notify its peer by
sending a PCNtf message with Notification-Type Notification-type = TBD3 (Auto-
bandwidth 5 (Auto-Bandwidth
Overwhelm State) and Notification-Value Notification-value = 1 (Entering
auto-bandwidth overwhelm state). Auto-
Bandwidth Overwhelm State). Optionally, an OVERLOADED-DURATION
TLV [RFC5440] MAY be included that specifies to specify the time period during
which no further PCEP messages related to auto-bandwidth
adjustment should be sent.
o
* When the PCEP speaker is no longer in the overwhelm state and is
available to process the auto-bandwidth adjustments, it SHOULD
notify its peers by sending a PCNtf message with Notification Type Notification-type
= TBD3 (Auto-bandwidth 5 (Auto-Bandwidth Overwhelm State) and Notification Value Notification-value = 2
(Clearing auto-bandwidth overwhelm state). Auto-Bandwidth Overwhelm State). A PCEP speaker SHOULD
send such notification to all peers to with if a Notification message
(Notification-Type=TBD3, Notification-Value=1)
(Notification-type = 5, Notification-value = 1) was sent earlier
unless earlier.
This message is not sent if an OVERLOADED-DURATION TLV was
included and the PCEP speakers wishes for the peer to wait for the
expiration of that period of time before receiving further PCEP
messages related to auto-bandwidth adjustment.
When Auto-Bandwidth the auto-bandwidth feature is deployed, a PCE can send this
notification to PCC when a PCC is reporting when it reports frequent auto-bandwidth
adjustments. If a PCC is overwhelmed with re-signaling, resignaling, it can also
notify the PCE to not adjust the LSP bandwidth while in the overwhelm
state.
Some dampening notification procedure (as per [RFC5440]) to avoid
oscillations of the overwhelm state is RECOMMENDED. On receipt of an
auto-bandwidth overwhelm notification from the PCE, a PCC should
consider the impact on the entire network. Moving the delegations of
auto-bandwidth enabled LSP
auto-bandwidth-enabled LSPs to another PCE could cause further
overloading.
6. Manageability Considerations
6.1. Control of Function and Policy
The Auto-Bandwidth auto-bandwidth feature SHOULD be controlled per LSP on a per-LSP basis
(at the PCC (head-end of the LSP) or PCE) PCE), and the values for auto-bandwidth
parameters e.g. sample-interval, adjustment-interval auto-
bandwidth parameters, e.g., Sample-Interval, Adjustment-Interval (up/
down), Minimum-Bandwidth, Maximum-Bandwidth, and Adjustment-Threshold
(up/down),
minimum-bandwidth, maximum-bandwidth, adjustment-threshold (up/down) SHOULD be configurable by an operator.
The Maximum-Bandwidth (and Minimum-Bandwidth) should be set to an
acceptable limit to avoid having an impact on the rest of the MPLS-TE
domain.
The operator should make sure that the Overflow-Threshold is greater
than or at least equal to the Up-Adjustment-Threshold. And
similarly, make sure it is important to ensure that the Underflow-Threshold is
greater than or at least equal to the Down-Adjustment-Threshold.
6.2. Information and Data Models
A MIB module for gathering operational information about the PCEP is
defined in [RFC7420]. Additionally, the YANG module defined in
[I-D.ietf-pce-pcep-yang]
[PCE-PCEP-YANG] provides for both configuration of PCEP as well as
operational management. These could be enhanced to provide controls
and indicators for support of the auto-bandwidth feature. Support
for various configuration knobs as well as counters of messages sent/received sent/
received containing the TLVs defined in this document could be added.
6.3. Liveness Detection and Monitoring
The mechanisms defined in this document do not imply any new liveness
detection and monitoring requirements in addition to those already
listed in [RFC5440].
6.4. Verify Verifying Correct Operations
The mechanisms defined in this document do not imply any new
operation verification requirements in addition to those already
listed in [RFC5440].
In the case of in which an invalid value, value is present, the Sub-TLV sub-TLV would
get ignored and the previous value would will be maintained. In such case a
case, the implementation SHOULD log the event.
6.5. Requirements On for Other Protocols
The mechanisms defined in this document do not add any new
requirements on for other protocols.
6.6. Impact On on Network Operations
In order to avoid any unacceptable impact on network operations, an
implementation SHOULD allow a limit to be placed on the number of
LSPs that can be enabled with the auto-bandwidth feature. For each
LSP enabled with the auto-bandwidth feature feature, there is an extra load
on the PCC, as it needs to monitor the traffic and report the
calculated bandwidth to be adjusted to the PCE. The PCE further re-compute
recomputes paths based on the requested bandwidth and update updates the
path to the PCC, which which, in
turns turn, triggers the re-signaling resignaling of the
path. All these steps adds add extra load and churn in the network and thus network; thus,
the operator needs to take due care while enabling this these features on
a number of LSPs.
An implementation MAY allow a limit to be placed on the rate of auto-
bandwidth related
bandwidth-related messages sent by a PCEP speaker and received by a
peer. An implementation SHOULD also allow sending a notification notifications to be sent
when a PCEP speaker is overwhelmed or when the rate of messages reach
reaches a threshold.
Due care is required by the operator if a Sample-Interval value
significantly smaller than the default (5 minute) minutes) is used, as a small
Sample-Interval values, e.g., 1 minute or less, could cause
undesirable interactions with transport protocols. These undesirable
interactions result from providing insufficient time for transport
protocol reactions to a prior bandwidth adjustment to settle out down
before bandwidth samples Bandwidth-Samples are taken for the next bandwidth adjustment.
7. Security Considerations
This document defines AUTO-BANDWIDTH-CAPABILITY TLV and AUTO-
BANDWIDTH-ATTRIBUTES sub-TLVs sub-TLVs, which do not add any substantial new
security concerns beyond those already discussed in [RFC8231] and
[RFC8281] for stateful PCE operations. As per [RFC8231], it is
RECOMMENDED that these PCEP extensions only be activated on
authenticated and encrypted sessions across PCEs and PCCs belonging
to the same administrative authority, using Transport Layer Security
(TLS) [RFC8253], as per the recommendations and best current
practices in BCP 195 [RFC7525] (unless explicitly set aside in
[RFC8253]).
Incorrect auto-bandwidth parameters in the AUTO-BANDWIDTH-ATTRIBUTES
sub-TLVs could have an adverse effect on the LSP as well as on the
network.
8. IANA Considerations
8.1. PCEP TLV Type Indicators
This document defines the following new PCEP TLVs; IANA is requested
to make has made the
following allocations from the "PCEP TLV Type Indicators"
sub-registry subregistry
of the PCEP Numbers registry, "Path Computation Element Protocol (PCEP) Numbers" registry as
follows:
+-------+---------------------------+-----------+
| Value Name | Description | Reference
-----------------------------------------------------------------
TBD2 |
+=======+===========================+===========+
| 36 | AUTO-BANDWIDTH-CAPABILITY [This document]
TBD1 | [RFC8733] |
+-------+---------------------------+-----------+
| 37 | AUTO-BANDWIDTH-ATTRIBUTES [This document] | [RFC8733] |
+-------+---------------------------+-----------+
Table 3: PCEP TLV Type Indicators
8.2. AUTO-BANDWIDTH-CAPABILITY TLV Flag Field
IANA is requested to create has created a sub-registry subregistry to manage the Flag field of the AUTO-BANDWIDTH-CAPABILITY AUTO-
BANDWIDTH-CAPABILITY TLV within the "Path Computation Element
Protocol (PCEP) Numbers" registry.
New bit numbers are to be assigned by Standards Action [RFC8126].
Each bit should be tracked with the following qualities:
o
* Bit number (counting from bit 0 as the most significant bit)
o
* Capability description
o
* Defining RFC
The initial contents of the sub-registry subregistry are empty, with all bits
marked unassigned unassigned.
8.3. AUTO-BANDWIDTH-ATTRIBUTES Sub-TLV
This document specifies the AUTO-BANDWIDTH-ATTRIBUTES Sub-TLVs. sub-TLVs. IANA
is requested to create
has created an "AUTO-BANDWIDTH-ATTRIBUTES Sub-TLV Types"
sub-registry subregistry
within the "Path Computation Element Protocol (PCEP) Numbers"
registry to manage the type indicator space for sub-TLVs of the AUTO-BANDWIDTH-ATTRIBUTES AUTO-
BANDWIDTH-ATTRIBUTES TLV. The valid range of values in the registry
is 0-65535. IANA is requested to initialize has initialized the registry with the following
values. All other values in the registry should be marked as
"Unassigned".
IANA is requested to has set the registration procedure Registration Procedure for this registry to read as
follows:
+-------------+------------------------+
| Range | Registration Procedure |
+=============+========================+
| 0-65503 | IETF Review |
+-------------+------------------------+
| 65504-65535 | Experimental Use |
+-------------+------------------------+
Table 4: Registration Procedure for
the "AUTO-BANDWIDTH-ATTRIBUTES Sub-
TLV" Registry
This document defines the following types:
+----------+--------------------------------------+-----------+
| Type | Name | Reference
----------------------------------------------------------------- |
+==========+======================================+===========+
| 0 | Reserved [This document] | [RFC8733] |
+----------+--------------------------------------+-----------+
| 1 | Sample-Interval sub-TLV [This document] | [RFC8733] |
+----------+--------------------------------------+-----------+
| 2 | Adjustment-Interval sub-TLV [This document] | [RFC8733] |
+----------+--------------------------------------+-----------+
| 3 | Down-Adjustment-Interval sub-TLV [This document] | [RFC8733] |
+----------+--------------------------------------+-----------+
| 4 | Adjustment-Threshold sub-TLV [This document] | [RFC8733] |
+----------+--------------------------------------+-----------+
| 5 | Adjustment-Threshold-Percentage sub-TLV [This document] | [RFC8733] |
+----------+--------------------------------------+-----------+
| 6 | Down-Adjustment-Threshold sub-TLV [This document] | [RFC8733] |
+----------+--------------------------------------+-----------+
| 7 | Down-Adjustment-Threshold-Percentage sub-TLV [This document] | [RFC8733] |
+----------+--------------------------------------+-----------+
| 8 | Minimum-Bandwidth sub-TLV [This document] | [RFC8733] |
+----------+--------------------------------------+-----------+
| 9 | Maximum-Bandwidth sub-TLV [This document] | [RFC8733] |
+----------+--------------------------------------+-----------+
| 10 | Overflow-Threshold sub-TLV [This document] | [RFC8733] |
+----------+--------------------------------------+-----------+
| 11 | Overflow-Threshold-Percentage sub-TLV [This document] | [RFC8733] |
+----------+--------------------------------------+-----------+
| 12 | Underflow-Threshold sub-TLV [This document] | [RFC8733] |
+----------+--------------------------------------+-----------+
| 13 | Underflow-Threshold-Percentage sub-TLV [This document]
14- | [RFC8733] |
+----------+--------------------------------------+-----------+
| 14-65503 | Unassigned [This document]
65503 | [RFC8733] |
+----------+--------------------------------------+-----------+
Table 5: Initial Contents of the "AUTO-BANDWIDTH-ATTRIBUTES
Sub-TLV" Registry
8.4. Error Object
This document defines a new Error-Value Error-value for PCErr message of Error-
Type 19 (Invalid Operation) [RFC8231]. IANA is requested to allocate has allocated a new error-value
Error-value within the "PCEP-ERROR Object Error Types and Values"
subregistry of the PCEP Numbers registry, "Path Computation Element Protocol (PCEP) Numbers"
registry as follows:
+------------+-----------+--------------------+-----------+
| Error-Type | Meaning & error values | Error-value | Reference
----------------------------------------------------------------- |
+============+===========+====================+===========+
| 19 | Invalid Operations
Error-Value = TBD4: [This document] | 14: Auto-Bandwidth Capability | [RFC8733] |
| | Operation | capability was not Advertised | |
| | | advertised | |
+------------+-----------+--------------------+-----------+
Table 6: Addition to the "PCEP-ERROR Object Error Types
and Values" Registry
8.5. Notification Object
IANA is requested to allocate has allocated a new Notification Type Notification-type and Notification
Values Notification-values
within the "Notification Object" sub-registry subregistry of the PCEP
Numbers registry, "Path Computation
Element Protocol (PCEP) Numbers" registry as follows:
Type Meaning Reference
-----------------------------------------------------------------
TBD3
+-------------------+----------------+--------------------+---------+
| Notification-type | Name | Notification-value |Reference|
+===================+================+====================+=========+
| 5 | Auto-Bandwidth Overwhelm | 0: Unassigned |[RFC8733]|
| |Overwhelm State [This document]
Notification-value=1: | | |
+-------------------+----------------+--------------------+---------+
| | | 1: Entering Auto-Bandwidth
overwhelm state
Notification-value=2: Auto- |[RFC8733]|
| | |Bandwidth Overwhelm | |
| | | State | |
+-------------------+----------------+--------------------+---------+
| | | 2: Clearing Auto-Bandwidth
overwhelm state Auto- |[RFC8733]|
| | |Bandwidth Overwhelm | |
| | | State | |
+-------------------+----------------+--------------------+---------+
Table 7: Additions to the "Notification Object" Registry
9. References
9.1. Normative References
[IEEE.754.1985]
Institute of Electrical and Electronics Engineers,
IEEE, "Standard for Binary Floating-Point Arithmetic",
DOI 10.1109/IEEESTD.1985.82928, IEEE Standard 754, August 1985. October
1985, <https://doi.org/10.1109/IEEESTD.1985.82928>.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119,
DOI 10.17487/RFC2119, March 1997,
<https://www.rfc-editor.org/info/rfc2119>.
[RFC5440] Vasseur, JP., Ed. and JL. Le Roux, Ed., "Path Computation
Element (PCE) Communication Protocol (PCEP)", RFC 5440,
DOI 10.17487/RFC5440, March 2009,
<https://www.rfc-editor.org/info/rfc5440>.
[RFC7525] Sheffer, Y., Holz, R., and P. Saint-Andre,
"Recommendations for Secure Use of Transport Layer
Security (TLS) and Datagram Transport Layer Security
(DTLS)", BCP 195, RFC 7525, DOI 10.17487/RFC7525, May
2015, <https://www.rfc-editor.org/info/rfc7525>.
[RFC8126] Cotton, M., Leiba, B., and T. Narten, "Guidelines for
Writing an IANA Considerations Section in RFCs", BCP 26,
RFC 8126, DOI 10.17487/RFC8126, June 2017,
<https://www.rfc-editor.org/info/rfc8126>.
[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC
2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,
May 2017, <https://www.rfc-editor.org/info/rfc8174>.
[RFC8231] Crabbe, E., Minei, I., Medved, J., and R. Varga, "Path
Computation Element Communication Protocol (PCEP)
Extensions for Stateful PCE", RFC 8231,
DOI 10.17487/RFC8231, September 2017,
<https://www.rfc-editor.org/info/rfc8231>.
[RFC8253] Lopez, D., Gonzalez de Dios, O., Wu, Q., and D. Dhody,
"PCEPS: Usage of TLS to Provide a Secure Transport for the
Path Computation Element Communication Protocol (PCEP)",
RFC 8253, DOI 10.17487/RFC8253, October 2017,
<https://www.rfc-editor.org/info/rfc8253>.
[RFC8281] Crabbe, E., Minei, I., Sivabalan, S., and R. Varga, "Path
Computation Element Communication Protocol (PCEP)
Extensions for PCE-Initiated LSP Setup in a Stateful PCE
Model", RFC 8281, DOI 10.17487/RFC8281, December 2017,
<https://www.rfc-editor.org/info/rfc8281>.
9.2. Informative References
[I-D.ietf-pce-pcep-yang]
[PCE-PCEP-YANG]
Dhody, D., Hardwick, J., Beeram, V., and J. Tantsura, "A
YANG Data Model for Path Computation Element
Communications Protocol (PCEP)", draft-ietf-pce-pcep-
yang-12 (work in progress), July 2019. Work in Progress,
Internet-Draft, draft-ietf-pce-pcep-yang-13, 31 October
2019,
<https://tools.ietf.org/html/draft-ietf-pce-pcep-yang-13>.
[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,
<https://www.rfc-editor.org/info/rfc3209>.
[RFC3471] Berger, L., Ed., "Generalized Multi-Protocol Label
Switching (GMPLS) Signaling Functional Description",
RFC 3471, DOI 10.17487/RFC3471, January 2003,
<https://www.rfc-editor.org/info/rfc3471>.
[RFC7420] Koushik, A., Stephan, E., Zhao, Q., King, D., and J.
Hardwick, "Path Computation Element Communication Protocol
(PCEP) Management Information Base (MIB) Module",
RFC 7420, DOI 10.17487/RFC7420, December 2014,
<https://www.rfc-editor.org/info/rfc7420>.
[RFC8051] Zhang, X., Ed. and I. Minei, Ed., "Applicability of a
Stateful Path Computation Element (PCE)", RFC 8051,
DOI 10.17487/RFC8051, January 2017,
<https://www.rfc-editor.org/info/rfc8051>.
Acknowledgments
Authors
The authors would like to thank Robert Varga, Venugopal Reddy, Reeja
Paul, Sandeep Boina, Avantika, JP Vasseur, Himanshu Shah, Jonathan
Hardwick
Hardwick, and Adrian Farrel for their useful comments and
suggestions.
Thanks to Daniel Franke, Joe Clarke, David Black, and Erik Kline for
the directorate reviews.
Thanks to Mirja Kuhlewind, Kühlewind, Barry Leiba, Benjamin Kaduk, and Roman
Danyliw for the IESG review.
Contributors
He Zekun
Tencent Holdings Ltd, Ltd.
Shenzhen P.R.China
China
Email: kinghe@tencent.com
Xian Zhang
Huawei Technologies
Research Area F3-1B, F3-1B
Huawei Industrial Base,
Shenzhen,
Shenzhen
518129
China
Phone: +86-755-28972645
Email: zhang.xian@huawei.com
Young Lee
SKKU
Samsung
Email: younglee.tx@gmail.com
Authors' Addresses
Dhruv Dhody (editor)
Huawei Technologies
Divyashree Techno Park, Whitefield
Bangalore, Karnataka
Bangalore 560066
Karnataka
India
Email: dhruv.ietf@gmail.com
Rakesh Gandhi (editor)
Cisco Systems, Inc.
Canada
Email: rgandhi@cisco.com
Udayasree Palle
Individual Contributor
Email: udayasreereddy@gmail.com
Ravi Singh
Individual Contributor
Email: ravi.singh.ietf@gmail.com
Luyuan Fang
Expedia,
Expedia Group, Inc.
USA
United States of America
Email: luyuanf@gmail.com