Network Working Group P. Amsden Request for Comments: 2124 J. Amweg Category: Informational P. Calato S. Bensley G. Lyons Cabletron Systems Inc. March 1997 Cabletron's Light-weight Flow Admission Protocol Specification Version 1.0 Status of this Memo This memo provides information for the Internet community. This memo does not specify an Internet standard of any kind. Distribution of this memo is unlimited. Abstract Light-weight Flow Admission Protocol, LFAP, allows an external Flow Admission Service (FAS) to manage flow admission at the switch, allowing flexible Flow Admission Services to be deployed by a vendor or customer without changes to, or undue burden on, the switch. Specifically, this document specifies the protocol between the switch Connection Control Entity (CCE) and the external FAS. Using LFAP, a Flow Admission Service can: allow or disallow flows, define the parameters under which a given flow is to operate (operating policy) or, redirect the flow to an alternate destination. The FAS may also maintain details of current or historical flows for billing, capacity planning and other purposes. Table of Contents 1. Introduction .................................................. 2 2. Message Flows ................................................. 3 3. Message Contents and Format ................................... 4 3.1. IE Formats ............................................. 5 3.2. Flow Admission Request (FAR) Message ................... 14 3.3. Flow Admission Acknowledge (FAA) Message ............... 15 3.4. Flow Admission Update (FAU) Message .................... 15 3.5 Flow Update Notification (FUN) Message .................. 16 3.6. Flow Update Acknowledge (FUA) Message .................. 16 3.7. Flow Change Request (FCR) Message ...................... 17 3.8. Flow Change Acknowledge (FCA) Message .................. 17 3.9. Administrative Request (AR) Message .................... 18 3.10. Administrative Request Acknowledge (ARA) Message ...... 18 4. Error Handling ................................................ 18 Amsden, et. al. Informational [Page 1] RFC 2124 LFAP March 1997 4.1. FAA Related Error Handling ............................. 19 4.2. FUA Related Error Handling ............................. 19 4.3. FCA Related Error Handling ............................. 19 4.4. ARA Related Error Handling ............................. 20 5. Security Considerations ....................................... 20 6. Author's Addresses ............................................ 20 7. References .................................................... 21 1. Introduction Light-weight Flow Admission Protocol, LFAP, allows an external Flow Admission Service (FAS) to manage flow admission at the switch, allowing flexible Flow Admission Services to be deployed by a vendor or customer without changes to, or undue burden on, the switch. It provides a means for network managers, or management systems, to establish connection admission parameters for multiple switches in a single management domain by configuring policy information and other data via a single centralized connection admission control point. Specifically, this document specifies the protocol between the switch Connection Control Entity (CCE) and the external FAS. Using LFAP, a Flow Admission Service can: allow or disallow flows, define the parameters under which a given flow is to operate (operating policy) or, redirect the flow to an alternate destination. The FAS may also maintain details of current or historical flows for billing, capacity planning and other purposes. A significant advantage of this protocol is that it relieves switch vendors from the complexity of policy enforcement under any number of policy representation schemes. Similarly, switch configuration managers do not need to translate organization-determined policy or usage procedures, limitations and guidelines into an arbitrarily large set of vendor-specific representations. Finally, use of such a scheme makes possible plug-and-play connection management at the present time - in the absence of a standardized representation for connection policies. This document describes the message flow between switch CCE and FAS, the messages used and error handling that applies. This constitutes the LFAP interface definition. Amsden, et. al. Informational [Page 2] RFC 2124 LFAP March 1997 2. Message Flows Initiating message flows between CCE and FAS entities always originate at the switch. Therefore, the switch is the point at which connectivity is originated. The CCE must have IP reachability using some approach described elsewhere (e.g. [1577] or [LANE]) and an IP address for the FAS must be preconfigured at the switch CCE. The CCE establishes TCP connectivity using the registered port number - ###. As shown below, Flow Admission Request (FAR) messages are sent by a switch's Call Control Entity (CCE) to the Flow Admission Service (FAS). These messages are sent when a flow is about to be set up by the switch and contain specific information relating to the flow - such as flow identifier, source/destination and qualifying information about the flow - that may be required to determine the admissibility of the flow and any operating policies that apply to the flow if it is admitted. The FAS responds with a Flow Admission Acknowledge (FAA) message (to the CCE) with a status indicating connection admissibility and any operating policy information that applies to the flow. If a FAA message contains mandatory operating policies that the switch CCE does not understand, the switch would abort the flow using the Flow Admission Update (FAU) message. ,--------------------. ,--------------------. | FAS | | Switch | | | | CCE | `--+----+----+-------' `------+-----+----+--' ^ | ^ ^ | ^ | ^ ^ ^ ^ ^ | ^ | | ^ | | | | | | | | | | AR | | | | | | | | | | | | | | | | | '--------------' | | | | | | | | | | | | | | | | ARA | | | | | | | | | | | | | | | '------------------' | | | | | | | | | | | | | | FUA | | | | | | | | | | | | | `------------------------' | | | | | | | | | | | | FUN | | | | | | | | | | | `----------------------------' | | | | | | | | | | FCR | | | | | | | | | `----------------------------------' | | | | | | | | FCA | | | | | | | `--------------------------------------' | | | | | | FAU | | | | | '--------------------------------------------' | | | | FAA | | | `------------------------------------------------' | | FAR | `----------------------------------------------------' Amsden, et. al. Informational [Page 3] RFC 2124 LFAP March 1997 When a connection is established, periodically during the course of maintaining the connection and when a change in connection state occurs, the switch CCE sends a Flow Update Notification (FUN) message to the FAS. The FAS, in turn, responds with a Flow Update Acknowledge (FUA) message with a Flow failure code if a an error condition has been detected. An example of error conditions would be receipt of a FUN message indicating octets received and sent for a connection never admitted. The FAS may send a Flow Change Request (FCR) to the CCE either to effect a change in the state of a specific connection or to set any new/changed policy information that applies to the flow. The CCE replies with a Flow Change Acknowledge (FCA) message and may respond with a flow failure code indicating the offending flow or policy change. Either the CCE or the FAS may initiate a Administrative Request (AR). The CCE uses it to get a Flow Identifier Prefix. The FAS uses it to request FUN messages be returned on some set of flows. The requested entity (FAS or CCE) replies with a Administrative Request Acknowledge. The FAS uses the ARA to return the requested Flow Prefix. The CCE uses the ARA to return any Flow Identifiers that were in error on the AR. 3. Message Contents and Format LFAP defines nine messages: "Flow Admission Request", "Flow Admission Acknowledge", "Flow Admission Update", "Flow Update Notification", "Flow Update Acknowledge", "Flow Change Request", "Flow Change Acknowledge", "Administrative Request" and "Administrative Request Acknowledge" (FAR, FAA, FAU, FUN, FUA, FCR, FCA, AR, ARA respectively). FAR messages are sent by a switch call control entity (CCE) to the Flow Admission Service (FAS). FAA messages are responses from the FAS to the CCE. FUA messages are responses from the CCE only under error conditions. FUN messages originate at switches and are acknowledged by FUA messages from the FAS. FCR messages are sent by the FAS to the CCE and are acknowledged by FCA messages. AR messages are sent by either the Entity (FAS or CCE) and are acknowledged by the ARA messages. Amsden, et. al. Informational [Page 4] RFC 2124 LFAP March 1997 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Version | Op Code | Reserved | Status | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Message ID | Message Length | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | ~ Information Element (IE) Fields ~ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ The general message format for all LFAP messages is as shown above. Version is 1 and Op Codes are as follows: FAR - 1 FAA - 2 FAU - 3 FUN - 4 FUA - 5 FCR - 6 FCA - 7 AR - 8 ARA - 9 The Status field serves as a Status on the overall message. The values that Status may assume are: STATUS: SUCCESS = 0 CORRUPTED = 1 VERSION = 2 Message ID is used to associate each original message with its corresponding response and must be unique for the combination of sender and responder while an original message is pending. The Message Length excludes the 8 octets of the message header. 3.1. IE Formats IE fields consist of 2-octet TYPE, 2-octet LENGTH and a variable length VALUE sub-fields. All IEs are even multiples of 4 octets in length, left-aligned and zero filled if necessary. Length is computed excluding the 4 octet TYPE and LENGTH fields. Individual IEs are formated as described in following sections. Amsden, et. al. Informational [Page 5] RFC 2124 LFAP March 1997 Byte Count IE Contains the count of octets sent and received associated with the identified connection. IE format is: 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 or 2 | LENGTH = 16 | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | +-+-+-+-+- Bytes Received -+-+-+-+-+ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | +-+-+-+-+- Bytes Sent -+-+-+-+-+ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Type 1 Means that the byte count is a running counter and is the count from the beginning of the flow establishment. Type 2 Means that the byte count is a delta counter and is the count since the last FUN message. Packet Count IE Contains the count of packets cells or frames sent and received associated with the identified connection. IE format is: 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 or 4 | LENGTH = 16 | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | +-+-+-+-+- Packets/Cells/Frames Received -+-+-+-+-+ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | +-+-+-+-+- Packets/Cells/Frames Sent -+-+-+-+-+ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Type 3 Means that the packet/cell/frame count is a running counter and is the count from the beginning of the flow establishment. Type 4 Means that the packet/cell/frame count is a delta counter and is the count since the last FUN message. Amsden, et. al. Informational [Page 6] RFC 2124 LFAP March 1997 Client Data IE For use in determination of admission policy relative to a specific connection request based on arbitrary client data (OCTET STRING [8824]). IE format is: 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 | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | ~ Client Data ~ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Destination Address IE Destination address associated with a message. IE format is: 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 | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Address Family Number | Address Length | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | ~ Address ~ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ The Address Length field contains the length of the address excluding any pad of zeros used to align the address field. Address Family Numbers include: 1 - 14 (decimal) as specified in [1700] 15 E.164 with NSAP format subaddress Flow ID IE In order to accumulate the flow accounting statistics across multiple FAS's in case of a FAS failure a globally unique flow identifier needs to be formed. To accomplish this the FAS assigns a prefix if requested by the CCE. The CCE then assigns a CCE flow identifier that it guaranties to be unique for the use of the FAS flow identifier prefix for each flow admitted. If the CCE needs to reuse Amsden, et. al. Informational [Page 7] RFC 2124 LFAP March 1997 a CCE flow ID it must acquire a new FAS prefix. If a CCE cannot support the FAS flow identifier then it does not request a FAS prefix and uses a FAS length of 0 in all updates to the flow. If the CCE does not support the FAS identifier prefix then when a CCE fails over all calls will need to be readmitted and will be seen as two separate calls at the accumulation point. Flow ID IE is copied exactly in all messages that refer to this flow. IE format is: 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 |FAS Length = 8 |CCE Length = 4 | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | |+-+-+-+-+- FAS assigned Flow Identifier Prefix -+-+-+-+-+ | | +-+-+-+-+-+-+-+-+ +-+-+-+--+-+-+-+-+ | CCE assigned Flow Identifier | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Flow State IE Flow state is the intended end state for the Flow associated with the message containing this IE. IE format is: 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 | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Flow State | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Flow state has one of the following values and meanings: 0 - INACTIVE - Flow is inactive 1 - ACTIVE - Flow is active Policy IE's There are two basic types of Policy IE's Optional and Mandatory. In the case of optional operating policy if the combination of policy and value given cannot be interpreted by a switch CCE it may be safely ignored. In the case of mandatory operating policy if the combination of policy and value given cannot be interpreted by a switch CCE it must abort the flow state. Examples of optional operating policies are Checkpoint Timer and Connection Priority. Amsden, et. al. Informational [Page 8] RFC 2124 LFAP March 1997 There are also two forms of the policy ID. The first is where the policy ID is a number and the second is where the policy ID is an Object Identifier. The policy ID's with number values are identified in this document and its proposed changes over time. The Object Identifier IDs can be used by individual implementers to apply proprietary or experimental additions to this document and still be compliant with the general form of this document. Operating Policy IEs are comprised of Policy ID, a length and a value. In the case of the policies defined in this document a length is required and specified here. In the case of policies using the OID format the length may be implied by the OID or be part of the policy value as determined by individual implementation. Policy IE format for Policy ID's defined in this document 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 + 10 | LENGTH | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Policy ID | Policy Value length | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | | ~ Policy Value ~ | | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | ~ Additional Policy Pairs ~ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Type 9 is an Optional Policy and type 10 is a Mandatory Policy. The following policy ID's and policy values are presently defined or under consideration. Policy ID Value Meaning Usage 01xx The purpose of this set of policies is for usage constraints. This set of policies in the future may include Connection Count, Maximum Bandwidth and Connect Time. Amsden, et. al. Informational [Page 9] RFC 2124 LFAP March 1997 Routing 02xx The purpose of these polices is to allow for various routing policies to be enforced in the a switching environment. This set of policies may include Optimization, Designated Transit List, Restricted Transit List and Path Cost. Administrative 03xx Keep Statistics 0301 = 0 Keep statistics on this flow Not= 0 Do Not keep statistics on flow Connection 0302 1 - 255 Priority of this connection Priority Less is higher Checkpoint 0303 1 - 2^31 Seconds between FUN on a flow Timer Checkpoint Threshold 0304 1 - 2^63 # of bytes to collect before sending a FUN on a flow Connectionless 04xx The purpose of these policies is to control connection unaware calls. This set will include Inactivity Timer and Bandwidth allocation. Policy IE format when Policy ID is a Object Identifier 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 + 12 | LENGTH | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | ~ Policy OID ~ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | ~ Policy ~ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | ~ Additional Policy Pairs ~ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Type 11 is an optional policy and type 12 is a mandatory policy. Amsden, et. al. Informational [Page 10] RFC 2124 LFAP March 1997 Service Identifier IE Used in determination of admission policy relative to a specific connection request based on service type. Service Identifier is specified as an OCTET STRING [8824]. 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 | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | ~ Service Identifier ~ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Source Address IE Source address associated with a message. TYPE is 14, format is as shown for Destination Address IE. Source Switch Address IE Source Switch address associated with a message. TYPE is 15, format is as shown for Destination Address IE. Destination Switch Address IE Destination Switch address associated with a message. TYPE is 16, format is as shown for Destination Address IE. Time IE The time (as a SNMPv2 TimeStamp [1443]) associated with the status/statistics observed. TYPE is 17 and format is: 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 = 17 | LENGTH = 4 | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Time | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Amsden, et. al. Informational [Page 11] RFC 2124 LFAP March 1997 Multiple Record IE The Multiple Record IE is composed of 4 parts. The record descriptor, fixed information, record format IEs and individual records. The record descriptor consist of two fields the first field is the length of the fixed information field. The second is the length of the Record format section. The fixed information is the IE's that apply to all the records that follow. The Record Format is the list of IE's that make up each record. The individual record section contains the individual records that are being reported in the format given by the Record Format section. 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 = 18 | LENGTH | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Length of fixed Information | Length of Record Format | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | ~ Fixed Information ~ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | ~ Record Format ~ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | | Individual Record (1) | | Individual Record (2) | | Individual Record (3) | | . | ~ . ~ | . | | Individual Record (n) | | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Amsden, et. al. Informational [Page 12] RFC 2124 LFAP March 1997 Flow Failure Code IE Flow failure code is the reason why a operation an a given flow failed. IE format is: 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 = 19 | LENGTH = 4 | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Flow Failure Code | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Flow failure code has one of the following values and meanings: 0 - POLICY_REJECT - A policy reject has occurred 1 - NO_SUCH_FLOW - The specified was flow was not found 2 - AMBIGUOUS - Duplicate FAR caused this error 3 - DESTINATION_UNKNOWN - The redirect destination was unknown Command Code IE Command Code is a administrative request command to perform a particular function. IE format is: 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 = 20 | LENGTH = 4 | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Command Code | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Command code has one of the following values and meanings: 0 - RETURN_INDICATED_FLOWS - Return FUNs indicated 1 - RETURN_ALL_CHANGED_FLOWS - Return FUNs indicated 2 - RETURN_ALL_FLOWS - Return FUNs indicated 3 - RETURN_FLOW_PREFIX - Return a new flow prefix Amsden, et. al. Informational [Page 13] RFC 2124 LFAP March 1997 Flow Identifier Prefix IE The flow Identifier prefix IE gives the prefix that the FAS has created to maintain a globally unique ID. IE format is: 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 = 21 | Length = 8 | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | |+-+-+-+-+- FAS assigned Flow Identifier Prefix -+-+-+-+-+ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ 3.2. Flow Admission Request (FAR) Message Status is set to SUCCESS in FAR messages. In addition, FAR messages may contain the following IEs: Source Switch Address IE - address of switch making request Dest Switch Address IE - address of switch to which the request is made Source Address IE - flow "from" address Destination Address IE - flow "to" address Service Identifier IE - identifier for service requested Flow ID IE - locally unique identifier for flow (unique to update reporting entity) Client Data IE - client data as applied to this request Time IE - switch time of admission request Mandatory IE's Source Address Destination Address Flow ID Time Optional IE's Source Switch Address Destination Switch Address Client Data Amsden, et. al. Informational [Page 14] RFC 2124 LFAP March 1997 FAR messages are sent by a switch CCE when it seeks verification of validity of a flow that is about to be established. FAR messages refer to a single flow only and do not multi IE functionality. Source and destination addresses are those determined by the switch CCE as the points of origin and termination of a flow. Service ID is the service type/category associated with the desired flow. The client data is arbitrary information about the client associated with the desired flow. 3.3. Flow Admission Acknowledge (FAA) Message Status reflects the result of the corresponding FAR message (see Error Handling for details). Message ID is copied from the FAR message. In addition, FAA messages may have the following IEs: Optional Operating Policy IE - policy(s) that may apply to this flow. Mandatory Operating Policy IE - policy(s) that must apply to this flow. Destination Address IE - may be included if the flow should be redirected. Flow Failure Code IE - indicates the cause of flow failure FAA messages are sent by a FAS in response to FAR messages received from a switch CCE. Operating policy information is that determined by the FAS as either desirable or required for the flow specified in the corresponding FAR message. 3.4. Flow Admission Update (FAU) Message Status reflects the result of the corresponding FAA message (see Error Handling for details). Message ID is copied from the FAR or FAA message. In addition, FAU messages may have the following IEs: Flow ID IE - identifier for the flow Flow Failure Code IE - indicates the cause of flow failure FUA messages are sent by a switch CCE in response to FAA messages received from a FAS. The FAU message is returned by the switch CCE only if an a error was detected as a result of the FAA message. Amsden, et. al. Informational [Page 15] RFC 2124 LFAP March 1997 3.5. Flow Update Notification (FUN) Message Status is set to SUCCESS in FUN messages. In addition, FUN messages may contain the following IEs: Time IE - switch time of notification Flow ID IE - identifier for the flow Flow State IE - state of the flow at time of notification Byte Count IE - octets sent and received for this flow Packet Count IE - packets sent and received for this flow Mandatory IE's Time - If multiple IE, only needs to be given once in fixed information section. If given in record format must be in each individual record. Optional IE's at least one must be present Flow State Byte Count Packet Count FUN messages are sent periodically (possibly as specified in an operating policy associated with the flow) by an CCE to the FAS. The Time IE may be given first and only once. If it is only a single flow being reported on then just the IE's and their values are returned. If multiple flows are to be reported on then the multiple record IE should be used. This results in reduced overhead on transmissions. FUN messages may are also be sent as a result of a AR message or a FCR message. The FCR message would be one that request that the flow state be set to inactive. The flow ID identifies the flow to which this update applies. Flow state is the state of the flow at the time this message is sent. Counts are as specified in the IE definitions. The FAS's are coordinated and will resolve the reception of FUN information from a CCE who has lost connection with its FAS and has gone to a alternative FAS. 3.6. Flow Update Acknowledge (FUA) Message Status is set to SUCCESS in FUA messages unless an error is detected (see "Error Handling"). Message ID is copied from the FUN message. Amsden, et. al. Informational [Page 16] RFC 2124 LFAP March 1997 FUA messages are sent by the FAS to acknowledge a FUN message from the switch CCE. If a FUN message contained a multiple record IE and any of the updates had a error then the FUA would contain a multiple IE with a Flow ID and Flow Failure Code. A status of SUCCESS indicates that the information in the corresponding FUN message has been accepted and is now the responsibility of the FAS. 3.7. Flow Change Request (FCR) Message Status is set to SUCCESS in FCR messages. In addition, a FCR message may contain the following IEs: Flow ID IE - identifier for the flow. Flow State IE - set to inactive to stop a flow. Optional Operating Policy IE - possibly new policy(s) that may apply to this flow. Mandatory Operating Policy IE - possibly new policy(s) that must apply to this flow. Mandatory IE's Flow ID Optional IE's Flow State Optional Operating Policy Mandatory Operating Policy FCR messages are sent by the FAS to the CCE to provide additional (or change existing) operating policy information or to stop a flow. Flow ID is used to identify the flow to which this message applies. The FAS can stop a flow by setting it's flow state to inactive. This will cause the CCE to generate a FUN message with the final flow statistics. It will also cause the CCE to return a inactive flow state on the given flow. If the FAS wishes to change operating policy information it merely includes the new information in the FCR message along with the flow id. 3.8. Flow Change Acknowledge (FCA) Message Status is set to SUCCESS in FCA messages unless an error is detected (see "Error Handling"). Message ID is copied from the FCR message. FCA messages contain IEs if a error was detected in the corresponding FCR message (see "Error Handling"). If an error occurs then a FCR may contain the following IE's Flow ID IE - if FAS requested statistics on an unknown flow. Amsden, et. al. Informational [Page 17] RFC 2124 LFAP March 1997 Flow Failure Code - for the Flow ID IE above. FCA messages are sent by a switch CCE in response to an FCR. 3.9. Administrative Request (AR) Message Status is set to SUCCESS in AR messages. In addition, AR messages may contain the Command IEs: Mandatory IE's Command IE AR messages are sent by either the a switch CCE or the FAS when they seeks to perform one of the Command IE's. 3.10. Administrative Request Acknowledge (ARA) Message Status reflects the result of the corresponding AR message (see Error Handling for details). Message ID is copied from the AR message. In addition, ARA messages may have the following IEs: Flow ID IE - if FAS requested statistics on an unknown flow. Flow Failure Code - for the Flow ID IE above. Flow Identifier Prefix IE - if the ARA is the response to a CCE Command to RETURN_FLOW_PREFIX. ARA messages are sent by a FAS or CCE in response to AR message received CCE or FAS respectively. 4. Error Handling Incompatible version - Receipt of any LFAP request or notification message, with a version number other than that (or those) supported by the receiving component will result in a response (acknowledge) message with a Status of VERSION. The resulting message will contain no IEs and, as a result, may be considered a generic FAILURE message. Corrupted message contents - Receipt of a LFAP message which cannot be understood will result in a similar generic FAILURE message with Status set to CORRUPTED. A FAA message may contain a Flow ID IE only if this IE is included in the portion of the corrupt LFAP message that is before the point where corruption occurs. The LFAP sender should re-send the original message at least one time if it is still desired to admit the requested connection. Amsden, et. al. Informational [Page 18] RFC 2124 LFAP March 1997 With the exception of incompatible version and corrupted message contents, error handling is naturally related to the processing of response messages by both response sender and receiver. Below sections are thus organized around processing of FAA, FUA, FCA and ARA messages. 4.1. FAA Related Error Handling Non-unique Flow ID - Receipt of a FAR message with a non-unique Flow ID may occur for two reasons: the CCE may have re-sent a FAR message and an error may have occurred in the ID generation function. If the entire message is the same in every respect, with the possible exception of Message ID, as a FAR message received previously, the FAS will respond in the same way as it would have responded to that prior message. Otherwise, the Flow ID will be returned with a Flow Failure Code set to AMBIGUOUS. The CCE should choose a new Flow ID and retry the FAR message if it is still desired to admit the requested connection. Flow is inadmissible - The FAS may determine that flow is not admissible for policy reasons. In this case the Flow ID is returned along with the Flow Failure Code of POLICY_REJECT. 4.2. FUA Related Error Handling Flow Not Admitted - Receipt of Flow information for an unadmitted connection. Flow ID IE identifies a flow which was not admitted or for which admission status has been lost. The FAS will return the Flow ID and a Flow Failure Code of NO_SUCH_FLOW. The switch CCE should send an appropriate FAR message. The FAS may track occurrences of this error and send a FCR message to the CCE requesting dropping of the reported connection. 4.3. FCA Related Error Handling Flow change requested for a non-existent flow - The Flow ID IE identifies a connection for which this CCE has no state information. The FCA message has the Flow ID and a Flow Failure Code set to NO_SUCH_FLOW and contains the Flow ID and copied from the corresponding FCR message. Policy changes requested were not supported by the CCE. The FCA message has the Flow ID and a Flow Failure Code set to POLICY_REJECT and contains the Flow ID copied from the corresponding FCR message. Amsden, et. al. Informational [Page 19] RFC 2124 LFAP March 1997 4.4. ARA Related Error Handling Flow statistics requested for a non-existent flow - The Flow ID IE identified a connection for which this CCE has no state information. The ARA message has the Flow ID and a Flow Failure Code set to NO_SUCH_FLOW and contains the Flow ID copied from the corresponding FCR message. If there were multiple flows that were non-existent then the multi ie format could have the Flow Failure Code in the fixed information section and the individual Flow ID's in the record section. 5. Security Considerations Security issues are not discussed in this memo. 6. Author's Addresses Paul Amsden Phone: +1 (603) 337-7408 EMail: amsden@ctron.com Jim Amweg Phone: +1 (603) 337-5247 EMail: amsden@ctron.com Paul Calato Phone: +1 (603) 337-7625 EMail: amsden@ctron.com Stephen Bensley Phone: +1 (603) 337-7061 EMail: amsden@ctron.com Gregory Lyons Phone: +1 (603) 337-5318 EMail: amsden@ctron.com Cabletron Systems, Inc. is located at: P.O. Box 5005 Rochester, NH, 03866-5005 USA Amsden, et. al. Informational [Page 20] RFC 2124 LFAP March 1997 7. References [363] "B-ISDN ATM Adaptation Layer (AAL) Specification," International Telecommunication Union, ITU-T Recommendation I.363, Mar. 1993. [1443] "Textual Conventions for version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1443, April 1993. [1700] Reynolds, J., and J. Postel, "Assigned Numbers", STD 2, RFC 1700, October 1994. [8824] Information technology - Open Systems Interconnection - "Specification of Abstract Syntax Notation One (ASN.1), Second edition", ISO/IEC TR 8824: 1990 (E) 1990-12-15. [9577] "Telecommunications and Information Exchange Between Systems - Protocol Identification in the Network Layer", ISO/IEC TR 9577: 1990 (E) 1990-10-15. [LANE] "LAN Emulation Over ATM Specification - Version 1.0", ATM Forum af-lane-021.000, January, 1995. Amsden, et. al. Informational [Page 21]