Internet Draft David Zelig Expires: February 2006 Corrigent Systems Thomas D. Nadeau Cisco Systems, Inc. July 2005 Ethernet Pseudo Wire (PW) Management Information Base draft-ietf-pwe3-enet-mib-06.txt Status of this Memo By submitting this Internet-Draft, each author represents that any applicable patent or other IPR claims of which he or she is aware have been or will be disclosed, and any of which he or she becomes aware will be disclosed, in accordance with Section 6 of BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." The list of current Internet-Drafts can be accessed at http://www.ietf.org/1id-abstracts.html The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. Abstract This memo defines an experimental portion of the Management Information Base for use with network management protocols in the Internet community. In particular, it describes managed objects for modeling of Point-to-Point Ethernet Pseudo Wire Edge-to-Edge service carried over a general Packet Switched Network. Table of Contents Abstract......................................................1 1 Introduction..................................................2 2 Terminology...................................................3 3 The Internet-Standard Management Framework....................3 Zelig & Nadeau, Ed. Expires February 2006 [Page 1] Internet Draft PW-ENET-STD-MIB July 2005 4 PWE3 MIB Architecture Applicability...........................3 5.1 PW-ENET-STD-MIB Usage.........................................4 5.2 PW-ENET Management Model......................................5 5.3 Example of MIB Usage..........................................6 5.4 Service Delimiting Modes......................................6 6 PWE3 Ethernet MIB Module Definitions..........................9 7 References...................................................24 7.1 Normative references.........................................24 7.2 Informative references.......................................25 8 Security Considerations......................................23 9 Author's Addresses...........................................25 10 Intellectual Property Notice.................................26 11 Full Copyright Statement.....................................26 12 IANA considerations..........................................24 12.1 IANA Considerations for PW-ENET-STD-MIB 2. Introduction This document describes a model for managing Ethernet pseudo wire services for transmission over a packet Switched Network (PSN). This MIB module is generic and common to all types of PSNs supported in the PWE3 architecture [RFC3985], which describes the transport and encapsulation of L1 and L2 services over supported PSN types. In particular, the MIB module associates a port or specific VLANs on top of a physical Ethernet port or a virtual Ethernet interface (for VPLS service) to a point-to-point PW. It is complementary to the [PWMIB], which is used to manage the generic PW parameters common to all service, including all supported PSN types. 3. Terminology This document uses terminology from the document describing the PWE3 architecture [RFC3985] and from [PWENET]. 4. The Internet-Standard Management Framework For a detailed overview of the documents that describe the current Internet-Standard Management Framework, please refer to section 7 of RFC 3410 [RFC3410]. Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. MIB objects are generally accessed through the Simple Network Management Protocol (SNMP). Objects in the MIB are defined using the mechanisms defined in the Structure of Management Information (SMI). This memo specifies a MIB module that is compliant to the SMIv2, which is described in STD 58, RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 Zelig & Nadeau, Ed. Expires February 2006 [Page 2] Internet Draft PW-ENET-STD-MIB July 2005 [RFC2580]. 6. PWE3 MIB Architecture Applicability The MIB module structure for defining a PW service is composed of three layers of MIB modules functioning together. This general model is defined in the PWE3 architecture [RFC3985], and described in further detail in [PWMIB]. The MIB module defined in this document defines a element of the service layer containing an ethernet service-specific module. The Etherlike-MIB [RFC3635] does not support virtual Ethernet ports, however it is sometimes desired to manage the PW as an Ethernet port via the Etherlike-MIB. This MIB module supports an option to recognize the PW as an ifIndex, enabling standard use of the Etherlike-MIB to manage the PW. 5.1 PW-ENET-STD-MIB Usage - The PW table (pwTable) is used for all PW types (ATM, FR, Ethernet, SONET, etc.). This table contains high level generic parameters related to the PW creation. A row is typically created by the operator (see [PWMIB] for other options) for each PW service. - Based on the PSN type defined for the PW, rows are created in PSN specific module and associated to the pwTable by the common pwIndex. - If the PW type is Ethernet or EthernetTagged a row is created by the agent in pwEnetTable. - When using a MPLS PSN, it may be required to separate the same Ethernet services to multiple PWs in order to support multiple COS on the same service. In this case, multiple PWs, each with the appropriate COS will be created to the same destination, and classification will be based also on the Ethernet PRI bits marking. The MIB allow any combinations of multiple PRI setting to PSN COS mapping (The exact PSN marking (EXP bits, DSCP etc.) is out of scope of this MIB). In these cases, pwEnetTable will hold multiple rows with the same Ethernet port and VLAN mapping, each PW will need to be created separately by the signaling process. 5.2 PW-ENET-STD-MIB Management Model The management model for the Ethernet PW is shown in figure 1, and is based on the PW proposed layering [RFC3985]. Zelig & Nadeau, Ed. Expires February 2006 [Page 3] Internet Draft PW-ENET-STD-MIB July 2005 +--------------------------------------+ | PE Device | +--------------------------------------+ Single | | | AC | | Single | PW Instance <------>o Forwarder + PW Instance X<=========> | | | +--------------------------------------+ ^ | May be modeled as ifIndex Notation: o A physical CE-bound PE port + A PW IWF instance interface to the forwarder. X A PE PSN-bound port. Figure 1: A simple point-to-point service In the typical point-to-point service, the object pwEnetPortIfIndex associates the physical CE-bound PE port ('o') to the PW (it is allowed to have multiple PWs associated to the same physical port). This MIB module also manages some of the possible operations of the forwarder. In some models it is convenient to model the forwarder virtual interface to a PW IWF instance ('+') as an ifIndex. As discussed in the [PWMIB], this is possible by using the PW ifType in the ifTable and indicating the ifIndex in the main pwTable. In case of Ethernet PW a virtual interface of ifType = etherLike will be assigned on top of the PW interface to enable statistics gathering and statuses and other management configuration tasks via existing tools. This way, the PW instance is managed as virtual Ethernet interface in the PE. The model for using the PW in non-point to point applications, such as VPLS are done with the same principle in mind, except that the creation of the tables is related typically to an auto-discovery process. 5.3 Example of MIB usage Assume we would like to create a PW of type VLAN between two PEs, for VLAN value 5. - Follows the example in [PWMIB], except that the pwType is equal 'ethernetTagged'. Zelig & Nadeau, Ed. Expires February 2006 [Page 4] Internet Draft PW-ENET-STD-MIB July 2005 - The agent creates a row in pwEnetTable and pwEnetStatsTable for the specified pwindex. The pwEnetPwInstance is automatically selected by the agent to the value of '1'. - The operator fills the following entries in the pwEnetTable: pwEnetPwVlan 5, pwEnetVlanMode noChange, pwEnetPortVlan 5, pwEnetPortIfIndex 1001, pwEnetVcIfIndex 0, -- Not managed in the -- Etherlike MIB module .. . - The PW is ready for forwarding when signaling has been accomplished successfully between the two peers. 5.4 Service Delimiting Modes In this section we will describe how the MIB module supports point- to-point applications with various VLAN service delimiting options on the physical port and the PW modes and VLAN values. In the VPLS case the PW is attached to a virtual interface that is attached to a bridge or VPLS forwarder, and it is assumed that this bridge function would be responsible for the packet modifications between the physical port or other virtual port and the virtual port the PW is attached to. There are 3 main services that are supported by this MIB module. 1) Port mode: In this mode, the whole traffic from the port is mapped to the PW. 1a) In the typical application, the packet is sent to the PW as is: pwEnetPwVlan 4097, pwEnetVlanMode portMode, pwEnetPortVlan 4097, pwType Ethernet, 1a) It is possible to add a provider tag (value 10 for example) to the packet when it is sent over the PW: pwEnetPwVlan 10, pwEnetVlanMode addVlan, pwEnetPortVlan 4097, Zelig & Nadeau, Ed. Expires February 2006 [Page 5] Internet Draft PW-ENET-STD-MIB July 2005 pwType MAY equal 'Ethernet' or 'EthernetTagged', 'EthernetTagged' is RECOMMENDED. 2) Single VLAN: In this mode, only the first VLAN field on the packet from the physical port is the service delimiting tag, as an example VLAN=5. The following options of processing are possible: 2a) One to one mapping: the service delimiting tag is kept as is on the PW. pwEnetPwVlan 5, pwEnetVlanMode noChange, pwEnetPortVlan 5, pwType MAY equal 'Ethernet' or 'EthernetTagged', 'EthernetTagged' is RECOMMENDED. 2b) One to one mapping: the service delimiting tag change it's value (to value of 6) on the PW. pwEnetPwVlan 6, pwEnetVlanMode changeVlan, pwEnetPortVlan 5, pwType MAY equal 'Ethernet' or 'EthernetTagged', 'EthernetTagged' is RECOMMENDED. 2c) The service delimiting tag is removed when the packet is sent to the PW. pwEnetPwVlan 5, pwEnetVlanMode removeVlan, pwEnetPortVlan 4097, pwType MAY equal 'Ethernet' or 'EthernetTagged', 'EthernetTagged' is RECOMMENDED. One should note that this mode is also applicable when the service delimiting tag is a service provider tag (VLAN=5 in this case), and the service provider actually replace the map the traffic to a single PW independent of the packet format on top of this VLAN. 2d) Untagged packets mapped to a PW as is (packets with a VLAN field from tha same port MAY be mapped to other PWs). pwEnetPwVlan 4096, pwEnetVlanMode noChange, pwEnetPortVlan 4096, Zelig & Nadeau, Ed. Expires February 2006 [Page 6] Internet Draft PW-ENET-STD-MIB July 2005 pwType MAY equal 'Ethernet' or 'EthernetTagged', 'EthernetTagged' is RECOMMENDED. 2e) Untagged packets mapped to a PW, and a VLAN field is added to the packet. pwEnetPwVlan 6, pwEnetVlanMode addVlan, pwEnetPortVlan 4096, pwType MAY equal 'Ethernet' or 'EthernetTagged', 'EthernetTagged' is RECOMMENDED. 2f) A provider VLAN (value 10) is added to the packet coming with VLAN value 5 before it is sent to the PW. pwEnetPwVlan 10, pwEnetVlanMode addVlan, pwEnetPortVlan 5, pwType MAY equal 'Ethernet' or 'EthernetTagged', 'EthernetTagged' is RECOMMENDED. 3) Nested VLAN (QinQ): When only the first VLAN is the service delimiting tag, the modes as described in 2) SHOULD be used. In other cases, i.e. the service delimiting tag is both the first VLAN and the second VLAN, the following option is supported by this MIB module. Other scenarios are considered out of the scope and should be handled by other MIB modules that manage the forwarder. Assuming the provider tag equals 5 and the (inner) VLAN equal 100, this traffic can be mapped to the PW without the provider tag by using the following configuration: pwEnetPwVlan 100, pwEnetVlanMode removeVLAN, pwEnetPortVlan 5, pwType MAY equal 'Ethernet' or 'EthernetTagged', 'EthernetTagged' is RECOMMENDED. Packets of the same provider tag MAY be mapped to other PWs. 6. PWE3 Ethernet MIB Module Definitions PW-ENET-STD-MIB DEFINITIONS ::= BEGIN IMPORTS OBJECT-TYPE, MODULE-IDENTITY Zelig & Nadeau, Ed. Expires February 2006 [Page 7] Internet Draft PW-ENET-STD-MIB July 2005 FROM SNMPv2-SMI -- [RFC2578] MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF -- [RFC2580] StorageType, RowStatus FROM SNMPv2-TC -- [RFC2579] InterfaceIndexOrZero FROM IF-MIB -- [RFC2863] ZeroBasedCounter32 FROM RMON2-MIB -- [RFC2021] pwIndex FROM PW-STD-MIB -- [PWMIB] -- RFC Editor: Please replace -- PWMIB with correct RFC # pwMIB, PwVlanCfg, PwIndexType FROM PW-TC-STD-MIB; -- [PWTC] -- RFC Editor: Please replace -- PWTC with correct RFC # pwEnetStdMIB MODULE-IDENTITY LAST-UPDATED "200406101200Z" -- 10 June 2004 12:00:00 GMT ORGANIZATION "IETF PWE3 Working group" CONTACT-INFO "David Zelig E-mail: davidz@corrigent.com Thomas D. Nadeau Email: tnadeau@cisco.com " DESCRIPTION "This MIB module describes a model for managing Ethernet point-to-point pseudo wire services over a Packet Switched Network (PSN). Copyright (C) The Internet Society (date). This version of this MIB module is part of RFC yyyy; see the RFC itself for full legal notices. -- RFC Editor: replace yyyy with actual RFC number & remove this note " -- Revision history. REVISION "200507121200Z" -- 12 July 2005 12:00:00 GMT DESCRIPTION "Initial version published as part of RFC XXXX." -- RFC Editor: Please replace XXXX with RFC number. Zelig & Nadeau, Ed. Expires February 2006 [Page 8] Internet Draft PW-ENET-STD-MIB July 2005 ::= { pwMIB XXXX } -- RFC Editor: please replace -- XXXX with IANA assigne value. -- See IANA considerations sect. pwEnetObjects OBJECT IDENTIFIER ::= { pwEnetStdMIB 1 } pwEnetConformance OBJECT IDENTIFIER ::= { pwEnetStdMIB 2 } -- -- Ethernet PW table -- pwEnetTable OBJECT-TYPE SYNTAX SEQUENCE OF PwEnetEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains the index to the Ethernet tables associated with this ETH PW, the VLAN configuration and VLAN mode." ::= { pwEnetObjects 1 } pwEnetEntry OBJECT-TYPE SYNTAX PwEnetEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table is indexed by the same index that was created for the associated entry in the PW generic table in the PW MIB module. The PwIndex and the pwEnetPwInstance are used as indexes to allow multiple VLANs to exist on the same PW. An entry is created in this table by the agent for every entry in the pwTable with a pwType of 'ethernetTagged' or 'ethernet'. Additional rows may be created by the operator or the agent if multiple entries are required for the same PW. The value of pwEnetPwInstance can be arbitrary selected to make the row unique, however implementations that know the VLAN field value when the row is created MAY use the value of the VLAN itself for better readability and backward compatibility with older versions of this MIB module. This table provides Ethernet port mapping and VLAN configuration for each Ethernet PW." INDEX { pwIndex, pwEnetPwInstance } ::= { pwEnetTable 1 } Zelig & Nadeau, Ed. Expires February 2006 [Page 9] Internet Draft PW-ENET-STD-MIB July 2005 PwEnetEntry ::= SEQUENCE { pwEnetPwInstance PwIndexType, pwEnetPwVlan PwVlanCfg, pwEnetVlanMode INTEGER, pwEnetPortVlan PwVlanCfg, pwEnetPortIfIndex InterfaceIndexOrZero, pwEnetVcIfIndex InterfaceIndexOrZero, pwEnetRowStatus RowStatus, pwEnetStorageType StorageType } pwEnetPwInstance OBJECT-TYPE SYNTAX PwIndexType MAX-ACCESS not-accessible STATUS current DESCRIPTION "If multiple rows are mapped to the same PW, this index is used to uniquely identify the individual row. If the value of the VLAN field is known at the time of of row creation, the value of pwEnetPwVlan MAY be used for better readability and backward compatibility with older versions of this MIB module. Otherwise the value of '1' SHOULD be set to the first row for each pwIndex for better readability and in order that the management application would know in advance how to access the first row when it was created by the agent. " ::= { pwEnetEntry 1 } pwEnetPwVlan OBJECT-TYPE SYNTAX PwVlanCfg MAX-ACCESS read-create STATUS current DESCRIPTION "This Object defines the (service delimiting) VLAN field value on the PW. The value of 4097 MUST be used if the object is not applicable, for example when mapping all packets from an Ethernet port to this PW (raw mode). The value of 4096 MUST be set to indicate untagged frames (from the PW point of view), i.e. when pwEnetVlanMode equals 'noChange' and pwEnetPortVlan equals 4096." ::= { pwEnetEntry 2 } pwEnetVlanMode OBJECT-TYPE SYNTAX INTEGER { other(0), portBased(1), Zelig & Nadeau, Ed. Expires February 2006 [Page 10] Internet Draft PW-ENET-STD-MIB July 2005 noChange(2), changeVlan(3), addVlan(4), removeVlan(5) } MAX-ACCESS read-create STATUS current DESCRIPTION "Indicates the mode of VLAN handling between the port associated to the PW and the PW encapsulation. - 'other' indicate operation that is not defined by this MIB module. - 'portBased' indicates that the forwarder will forward packets between the port and the PW independent of their structure (i.e. there is no service delimiting VLAN tags from the PE standpoint). - 'noChange' indicates that the PW contains the original user VLAN, as specified in pwEnetPortVlan, i.e. the VLAN on the PE-CE link is the service delimiting tag and is kept as is on the PW. This is allowed only for pwType equal 'ethernetTagged'. - 'changeVlan' indicates that the VLAN field on the PW may be different than the VLAN field on the user's port. the VLAN on the PE-CE link is the service delimiting tag but has a different value on the PW. - 'removeVlan' indicates that the encapsulation on the PW does not include the service delimiting VLAN field. Note that PRI bits transparency is lost in this case. - 'addVlan' indicate that a VLAN field will be added on the PSN bound direction. pwEnetPwVlan indicates the value that will be added. - Implementation of 'portsbased', 'removeVlan', 'addVlan' 'other' and 'changeVlan' is OPTIONAL. " DEFVAL { noChange } ::= { pwEnetEntry 3 } pwEnetPortVlan OBJECT-TYPE SYNTAX PwVlanCfg MAX-ACCESS read-create STATUS current DESCRIPTION "This object defines the VLAN value on the physical port (or Zelig & Nadeau, Ed. Expires February 2006 [Page 11] Internet Draft PW-ENET-STD-MIB July 2005 VPLS virtual port) or a mapping of the whole port traffic to the same PW. The value of '4097' NUST be used if the whole port traffic is mapped to the same PW. Note that a pwType of 'ethernetTagged' can still be used if service delimiting tag is added on the PW (pwEnetVlanMode equals 'addVlan'). It MUST be equal to pwEnetPwVlan if pwEnetVlanMode equals'noChange'. The value 4096 indicates that packet without a VLAN field (i.e. untagged frames) on the port are associated to this PW. This allows the same behaviors as assigning 'Default VLAN' to un-tagged frames. " DEFVAL { 4097 } ::= { pwEnetEntry 4 } pwEnetPortIfIndex OBJECT-TYPE SYNTAX InterfaceIndexOrZero MAX-ACCESS read-create STATUS current DESCRIPTION "This object is used to specify the ifIndex of the Ethernet port associated with this PW for point-to-point Ethernet service, or the ifIndex of the virtual interface of the VPLS instance associated with the PW if the service is VPLS. Two rows in this table can point to the same ifIndex only if: 1) It is required to support multiple COS on a MPLS PSN for the same service (i.e.: a combination of ports and VLANs) by the use of multiple PW, each with a different COS. 2) There is no overlap of VLAN values specified in pwEnetPortVlan that are associated with this port. A value of zero indicates that association to an ifIndex is not yet known." ::= { pwEnetEntry 5 } pwEnetVcIfIndex OBJECT-TYPE SYNTAX InterfaceIndexOrZero MAX-ACCESS read-create STATUS current DESCRIPTION "If the PW is modeled as an ifIndex in the ifTable, this Zelig & Nadeau, Ed. Expires February 2006 [Page 12] Internet Draft PW-ENET-STD-MIB July 2005 object indicates the value of the ifIndex representing the Ethernet PW on the PSN side in the Etherlike-MIB. Note that this value may be different from the value of pwIfIndex that represent the ifIndex of the PW for ifType 'pw'." DEFVAL { 0 } ::= { pwEnetEntry 6 } pwEnetRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "Enable creating, deleting and modifying this row." ::= { pwEnetEntry 7 } pwEnetStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-create STATUS current DESCRIPTION "Indicates the storage type of this row." ::= { pwEnetEntry 8 } -- -- Ethernet Priority Mapping Table -- pwEnetMplsPriMappingTable OBJECT-TYPE SYNTAX SEQUENCE OF PwEnetMplsPriMappingTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table may be used for MPLS PSNs if there is a need to hold multiple PW, each with different COS, for the same user service (port + PW VLAN). Such a need may arise if the MPLS network is capable of L-LSP or E-LSP without multiple COS capabilities. Each row is indexed by the pwIndex and indicate the PRI bits on the packet received from the user port (or VPLS virtual port) that are classified to this PW. Note that the EXP bit value of the PW is configured in the PW MPLS MIB module." ::= { pwEnetObjects 2 } pwEnetMplsPriMappingTableEntry OBJECT-TYPE SYNTAX PwEnetMplsPriMappingTableEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION Zelig & Nadeau, Ed. Expires February 2006 [Page 13] Internet Draft PW-ENET-STD-MIB July 2005 "Each entry is created by the operator or by the agent based on local policy if special classification based on the PRI bits is required for this PW." INDEX { pwIndex } ::= { pwEnetMplsPriMappingTable 1 } PwEnetMplsPriMappingTableEntry ::= SEQUENCE { pwEnetMplsPriMapping BITS, pwEnetMplsPriMappingRowStatus RowStatus, pwEnetMplsPriMappingStorageType StorageType } pwEnetMplsPriMapping OBJECT-TYPE SYNTAX BITS { pri000 (0), pri001 (1), pri010 (2), pri011 (3), pri100 (4), pri101 (5), pri110 (6), pri111 (7), untagged (8) } MAX-ACCESS read-create STATUS current DESCRIPTION "This object defines the groups of user PRI mapped into this PW. Each bit set indicates that this user priority is assigned to this PW. The value 'untagged' is used to indicate that untagged frames are also associated to this PW. This object allows the use of different PSN COS based on user marking of PRI bits in MPLS PSN with L-LSP or E-LSP without multiple COS support. In all other cases, the default value MUST be used. It is REQUIRED that there is no overlap on this object between rows serving the same service (port+ PW VLAN). In case of missing BIT configuration between rows to the same service, incoming packets with PRI marking not configured should be handled by the PW with the lowest COS. " REFERENCE "See appendix A of 'Encapsulation Methods for Transport of Zelig & Nadeau, Ed. Expires February 2006 [Page 14] Internet Draft PW-ENET-STD-MIB July 2005 Ethernet Frames Over IP/MPLS Networks' (work-in-progress) for mapping rules of the PRI bits to PSN COS." ::= { pwEnetMplsPriMappingTableEntry 1 } pwEnetMplsPriMappingRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "Enable creating, deleting and modifying this row. pwEnetMplsPriMapping may be changed when this object is in the active(1) state, assuming the new value honors the rules as described in the description clause of pwEnetMplsPriMapping. Otherwise, the row status MUST be set to notActive(3) before a change can be made to pwEnetMplsPriMappingRowStatus." ::= { pwEnetMplsPriMappingTableEntry 2 } pwEnetMplsPriMappingStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-create STATUS current DESCRIPTION "Indicates the storage type of this row." ::= { pwEnetMplsPriMappingTableEntry 3 } -- -- Ethernet PW Statistics Table -- pwEnetStatsTable OBJECT-TYPE SYNTAX SEQUENCE OF PwEnetStatsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains statistical counters specific for Ethernet PW." ::= { pwEnetObjects 3 } pwEnetStatsEntry OBJECT-TYPE SYNTAX PwEnetStatsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Each entry represents the statistics gathered for the PW carrying the Ethernet packets since this PW was first created in the pwEnetTable." INDEX { pwIndex } ::= { pwEnetStatsTable 1 } Zelig & Nadeau, Ed. Expires February 2006 [Page 15] Internet Draft PW-ENET-STD-MIB July 2005 PwEnetStatsEntry ::= SEQUENCE { pwEnetStatsIllegalVlan ZeroBasedCounter32, pwEnetStatsIllegalLength ZeroBasedCounter32 } pwEnetStatsIllegalVlan OBJECT-TYPE SYNTAX ZeroBasedCounter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of packets received (from the PSN) on this PW with an illegal VLAN field, missing VLAN field that was expected, or A VLAN field when it was not expected. This counter is not applicable if the PW type is 'ethernet' (i.e. raw mode), and MUST return the value of zero in this case." ::= { pwEnetStatsEntry 1 } pwEnetStatsIllegalLength OBJECT-TYPE SYNTAX ZeroBasedCounter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of packets that were received with an illegal Ethernet packet length on this PW. An illegal length is defined as being greater than the value in the advertised MTU supported, or shorter than the allowed Ethernet packet size. The agent should start the value of this counter at the value of zero." ::= { pwEnetStatsEntry 2 } --- --- Conformance description --- pwEnetGroups OBJECT IDENTIFIER ::= { pwEnetConformance 1 } pwEnetCompliances OBJECT IDENTIFIER ::= { pwEnetConformance 2 } -- Compliance requirement for fully compliant implementations. pwEnetModuleFullCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for agents that provide full support for PW-ENET MIB Module. Such devices can then be monitored and also be configured using this MIB module." Zelig & Nadeau, Ed. Expires February 2006 [Page 16] Internet Draft PW-ENET-STD-MIB July 2005 MODULE -- this module MANDATORY-GROUPS { pwEnetGroup, pwEnetStatsGroup } GROUP pwEnetMplsPriGroup DESCRIPTION "Collection of objects defining classification to different PW based on the user's PRI bits mapping. This group is optional, and should be implemented only for MPLS PSN where only L-LSP or single OA E-LSP, exists, and different PSN COS is required based on the PRI mapping." OBJECT pwEnetVlanMode DESCRIPTION "An implementation MUST support at least the value noChange(2)." OBJECT pwEnetVcIfIndex MIN-ACCESS read-only DESCRIPTION "Write access and values other than zero are required only for implementations that support the modeling the Ethernet PW in the Etherlike-MIB." OBJECT pwEnetRowStatus SYNTAX RowStatus { active(1), notInService(2), notReady(3) } WRITE-SYNTAX RowStatus { active(1), notInService(2), createAndGo(4), destroy(6) } MIN-ACCESS read-only DESCRIPTION "Support for createAndWait is not required. Support of notReady is not required for implementations that do not support signaling. Support of read-write is not required for implementations that do not support more than one VLAN mapping to the same PW." OBJECT pwEnetMplsPriMappingRowStatus SYNTAX RowStatus { active(1), notInService(2), notReady(3) } WRITE-SYNTAX RowStatus { active(1), notInService(2), createAndGo(4), destroy(6) } DESCRIPTION "Support for createAndWait is not required." ::= { pwEnetCompliances 1 } -- Compliance requirement for read-only compliant implementations. Zelig & Nadeau, Ed. Expires February 2006 [Page 17] Internet Draft PW-ENET-STD-MIB July 2005 pwEnetModuleReadOnlyCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for agents that provide read only support for PW-ENET MIB Module. Such devices can then be monitored but cannot be configured using this MIB module." MODULE -- this module MANDATORY-GROUPS { pwEnetGroup, pwEnetStatsGroup } GROUP pwEnetMplsPriGroup DESCRIPTION "Collection of objects defining classification to different PW based on the user's PRI bits mapping. This group is optional, and should be implemented only for MPLS PSN where only L-LSP or single OA E-LSP, exists, and different PSN COS is required based on the PRI mapping." OBJECT pwEnetPwVlan MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT pwEnetVlanMode MIN-ACCESS read-only DESCRIPTION "Write access is not required. An implementation MUST support at least the value noChange(2)." OBJECT pwEnetPortVlan MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT pwEnetPortIfIndex MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT pwEnetVcIfIndex MIN-ACCESS read-only DESCRIPTION "Write access is not required. Values other than zero are required only for implementations that support the modeling the Ethernet PW in the Etherlike-MIB." OBJECT pwEnetRowStatus SYNTAX RowStatus { active(1), notInService(2), notReady(3) } Zelig & Nadeau, Ed. Expires February 2006 [Page 18] Internet Draft PW-ENET-STD-MIB July 2005 MIN-ACCESS read-only DESCRIPTION "Write access is not required. Support of notReady is not required for implementations that do not support signaling." OBJECT pwEnetStorageType MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT pwEnetMplsPriMapping MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT pwEnetMplsPriMappingRowStatus SYNTAX RowStatus { active(1), notInService(2), notReady(3) } MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT pwEnetMplsPriMappingStorageType MIN-ACCESS read-only DESCRIPTION "Write access is not required." ::= { pwEnetCompliances 2 } -- Units of conformance. pwEnetGroup OBJECT-GROUP OBJECTS { pwEnetPwVlan, pwEnetVlanMode, pwEnetPortVlan, pwEnetPortIfIndex, pwEnetVcIfIndex, pwEnetRowStatus, pwEnetStorageType } STATUS current DESCRIPTION "Collection of objects for basic Ethernet PW config." ::= { pwEnetGroups 1 } pwEnetStatsGroup OBJECT-GROUP OBJECTS { pwEnetStatsIllegalVlan, pwEnetStatsIllegalLength } STATUS current DESCRIPTION Zelig & Nadeau, Ed. Expires February 2006 [Page 19] Internet Draft PW-ENET-STD-MIB July 2005 "Collection of objects counting various PW level errors." ::= { pwEnetGroups 2 } pwEnetMplsPriGroup OBJECT-GROUP OBJECTS { pwEnetMplsPriMapping, pwEnetMplsPriMappingRowStatus, pwEnetMplsPriMappingStorageType } STATUS current DESCRIPTION "Collection of objects defining classification to different PW based on the user's PRI bits mapping. This group is optional, and should be implemented only for MPLS PSN where only L-LSP or single OA E-LSP exists, and different PSN COS is required based on the PRI mapping." ::= { pwEnetGroups 3 } END 7 References 7.1 Normative references [PWENET] Martini, L., et al, "Encapsulation Methods for Transport of Ethernet Frames Over IP/MPLS Networks", draft-ietf-pwe3-ethernet-encap-10.txt, June 2005. [PWTC] Nadeau, T., Zelig, D., "Definitions for Textual Conventions and OBJECT-IDENTITIES for Pseudo-Wires Management", draft-ietf-pwe3-pw-tc-mib-07.txt. [PWMIB] Zelig, D., Nadeau, T., "Pseudo Wire (PW) Management Information Base", draft-ietf-pwe-pw-mib-07.txt, July 2005. [RFC3635] Flick, J., "Definitions of Managed Objects for the Ethernet-like Interface Types", RFC 3635, September 2003. [RFC2021] Waldbusser, S., "Remote Network Monitoring Management Information Base Version 2 using SMIv2", RFC 2021, January 1997. [RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,Rose, M. and S. Waldbusser, "Structure of Management Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. Zelig & Nadeau, Ed. Expires February 2006 [Page 20] Internet Draft PW-ENET-STD-MIB July 2005 [RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M. and S. Waldbusser, "Textual Conventions for SMIv2", STD 58, RFC 2579, April 1999. [RFC2580] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M. and S. Waldbusser, "Conformance Statements for SMIv2", STD 58, RFC 2580, April 1999. [RFC2863] McCloghrie, K., F. Kastenholz, "The Interfaces Group MIB using SMIv2", RFC 2863, June 2000. 7.2 Informative references [RFC3985] Bryant, S., et al, "PWE3 Architecture", RFC3985, March 2005 [RFC2434] Narten, T. and H. Alvestrand, "Guidelines for Writing an IANA Considerations Section in RFCs", BCP: 26, RFC2434, October 1998. [RFC3410] Case, J., Mundy, R., Partain, D. and B. Stewart, Introduction and Applicability Statements for Internet- Standard Management Framework", RFC 3410, December 2002. 8. Security Considerations It is clear that this MIB module is potentially useful for Monitoring of Ethernet PW capable PEs. This MIB module can also be used for configuration of certain objects, and anything that can be configured can be incorrectly configured, with potentially disastrous results. There are a number of management objects defined in this MIB module with a MAX-ACCESS clause of read-write and/or read-create. Such objects may be considered sensitive or vulnerable in some network environments. The support for SET operations in a non-secure environment without proper protection can have a negative effect on network operations. These are the tables and objects and their sensitivity/vulnerability: o the pwEnetTable and the pwEnetMplsPriMappingTable collectively contain objects to provision Ethernet PWs. Unauthorized access to objects in these tables, could result in disruption of traffic on the network. The use of stronger mechanisms such as SNMPv3 security should be considered where possible. Specifically, SNMPv3 VACM and USM MUST be used with any v3 agent which implements this MIB module. Zelig & Nadeau, Ed. Expires February 2006 [Page 21] Internet Draft PW-ENET-STD-MIB July 2005 Administrators should consider whether read access to these objects should be allowed, since read access may be undesirable under certain circumstances. Some of the readable objects in this MIB module "i.e., objects with a MAX-ACCESS other than not-accessible" may be considered sensitive or vulnerable in some network environments. It is thus important to control even GET and/or NOTIFY access to these objects and possibly to even encrypt the values of these objects when sending them over the network via SNMP. These are the tables and objects and their sensitivity/vulnerability: o the pwEnetTable and the pwEnetMplsPriMappingTable collectively show the Ethernet PW service configuration. If an Administrator does not want to reveal this information, then these tables should be considered sensitive/vulnerable. SNMP versions prior to SNMPv3 did not include adequate security. Even if the network itself is secure "for example by using IPSec", even then, there is no control as to who on the secure network is allowed to access and GET/SET "read/change/create/delete" the objects in this MIB module. It is RECOMMENDED that implementers consider the security features as provided by the SNMPv3 framework "see [RFC3410], section 8", including full support for the SNMPv3 cryptographic mechanisms "for authentication and privacy". Further, deployment of SNMP versions prior to SNMPv3 is NOT RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to enable cryptographic security. It is then a customer/operator responsibility to ensure that the SNMP entity giving access to an instance of this MIB module, is properly configured to give access to the objects only to those principals "users" that have legitimate rights to indeed GET or SET "change/create/delete" them. 9. Authors' Addresses David Zelig Corrigent Systems 126, Yigal Alon st. Tel Aviv, ISRAEL Phone: +972-3-6945273 Email: davidz@corrigent.com Thomas D. Nadeau Cisco Systems, Inc. 300 Beaver Brook Road Boxboro, MA 01719 Zelig & Nadeau, Ed. Expires February 2006 [Page 22] Internet Draft PW-ENET-STD-MIB July 2005 Email: tnadeau@cisco.com 10. Intellectual Property Statement The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79. Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf- ipr@ietf.org. 11. Full Copyright Statement Copyright (C) The Internet Society (2005). This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights. This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 12. IANA Considerations PWE3 related standards track PW modules should be rooted under the pwMIB subtree. The IANA is requested to manage that namespace. New assignments can only be made via a Standards Action as specified in [RFC2434]. IANA is requested to make a MIB OID assignment under the Zelig & Nadeau, Ed. Expires February 2006 [Page 23] Internet Draft PW-ENET-STD-MIB July 2005 pwStdMIB branch as specified in section 11.1. 12.1 IANA Considerations for PW-ENET-STD-MIB This document also requests IANA to assign { pwMIB 3 } to the PW-ENET-STD-MIB module specified in this document. Acknowledgement Funding for the RFC Editor function is currently provided by the Internet Society. Zelig & Nadeau, Ed. Expires February 2006 [Page 24]