Internet Draft David Zelig Expires: July 2004 Corrigent Systems Thomas D. Nadeau Cisco Systems, Inc. Dave Danenberg Litchfield Communications, Inc. Sharon Mantin AxONLink January 2004 Pseudo Wire (PW) Management Information Base draft-ietf-pwe3-pw-mib-03.txt Status of this Memo This document is an Internet-Draft and is in full conformance with all provisions of Section 10 of RFC2026. 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/ietf/1id-abstracts.txt The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. Copyright (C) The Internet Society (2001). All rights reserved. 1 Abstract This memo defines an experimental portion of the Management Information Base (MIB) for use with network management protocols in the Internet community. In particular, it describes managed objects for modeling of Pseudo Wire (PW) services on a general Packet Switched Net (PSN). Zelig et al. Expires July 2004 [page 1] Pseudo Wire (PW) Management January 2004 Information Base Table of Contents 1 Abstract.......................................................1 2 Introduction...................................................2 3 Terminology....................................................3 4 The Internet-Standard Management Framework.....................3 5 Feature Checklist..............................................3 6 PWE3 MIB Modules usage.........................................3 6.1 MIB modules Architecture.....................................3 6.2 PW-STD-MIB usage.............................................4 6.3 Relations to other PWE3 MIB modules..........................4 6.4 Relations to the ifTable.....................................5 6.5 Example of the PW MIB modules usage..........................5 7 Object definitions.............................................7 8 Security considerations.......................................37 9 IANA considerations...........................................39 10 References..................................................39 10.1 Normative references........................................39 10.2 Informative references......................................40 11 Author's Addresses..........................................40 12 Full Copyright Statement....................................41 13 Intellectual Property Notice................................41 2 Introduction This document describes a model for managing pseudo wire services for transmission over a packet Switched Network (PSN). This MIB module is generic and common to all types of PSN and PW services. This document is closely related to [FRARCH], describing the transport and encapsulation of L1 and L2 services over any type of PSN and MPLS respectively, creating a Pseudo Wire (PW) service. This document describes the MIB objects that define the generic pseudo wire association to the PSN and pseudo wire configurations that are not specific to the carried service. A PW type field will be used to point to the relevant service MIB tables, described in other documents, and a similar PSN type field will point to PSN specific modules, for example [PWMPLSMIB]. Conventions used in this document The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC-2119 [BCP14]. Zelig et al Expires July 2004 [page 2] Pseudo Wire (PW) Management January 2004 Information Base 3 Terminology This document uses terminology from the document describing the PW architecture [PWARCH]. 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 [RFC2580]. 5 Feature Checklist The PW MIB module is designed to satisfy the following requirements and constraints: - The MIB is designed to be extensible to all types of PSN. PSN type specific MIB modules will be defined in additional documents. - The MIB enables the use of any emulated service. Emulated service specific MIB modules will be defined in additional documents. - The MIB module supports manually configured PWs. - The MIB module supports the PW ID and Group ID, as well as the generalized PW ID identification. - The MIB module supports point-to-point PW connections. 6 PWE3 MIB Modules usage 6.1 MIB modules Architecture The MIB module structure for defining a PW service is composed from three types of modules. The first type is the PW MIB module, which configures general parameters of the PW that are common to all types of emulated services and PSN types. Zelig et al Expires July 2004 [page 3] Pseudo Wire (PW) Management January 2004 Information Base The second type of modules is PSN type specific module. There is a different module for each type of PSN. These modules associate the PW with one or more "tunnels" that carry the service over the PSN. These modules are defined in other documents; see for example [PWMPLSMIB]. The third type of modules is service-specific module, which is emulated signal type dependent. These modules are defined in other documents; see for example [CEPMIB]. [PWTC] defines some of the object types used in these modules. 6.2 PW MIB usage An entry in the PW table (pwVcTable) MUST exist for all PW types (ATM, FR, Ethernet, SONET, etc.). This table holds generic parameters related to the PW creation and monitoring. A row can be created in the pwVcTable by: 1) The operator creates a row in the PwVcTable when configuring the node for a new service. This mode MUST be supported by the agent, and MUST used when creating a non-signaled PW (manually assigned). 2) The operator creates a row in pwVcIndexMappingTable with the known PWid unique identifiers (peer IP address, PW index and peer indexes. The agent creates a row in pwVcTable with the (internally) selected pwVcindex. The EMS can now retrieve the pwVcindex from the pwVcIndexMappingTable and continue to configure the required parameters to set-up the PW. This mode is OPTIONAL. It cannot be used in the generalized FEC signaling or for non- signaled PW. 2) The agent when if a signaling message has been received from a peer node for a combination of signaling identifications parameters already unknown to the local node. This mode is OPTIONAL. 3) The agent for PW created automatically due to some auto discovery application. This mode is OPTIONAL. - The agent creates the rows in the (locally supported) performance tables and reverse mapping tables in PW MIB. 6.3 Relations to other PWE3 MIB modules - Based on the PSN type defined for the PW, rows are created in PSN specific module (for example [PWMPLSMIB]) and associated to the PW table by the common pwVcindex. Zelig et al Expires July 2004 [page 4] Pseudo Wire (PW) Management January 2004 Information Base - Based on the PW type defined for the PW, rows are created in service-specific module (for example [CEPMIB]) and associated to the PW table by the common pwVcindex. - Unless all the necessary entries in the applicable tables have been created and all the parameters have been consistently configured in those tables, signaling cannot be performed from the local node, and the pwVcOperStatus should report ænotPresentÆ. 6.4 Relations to the ifTable The PW itself is in general not an ifIndex as it's own, from agent scalability reasons. In many cases the PW is associated via the MIB tables to an ifIndex the VC is emulating. This ifIndex may represent a physical entity - for example a PW emulating a SONET path as in CEP: The PW itself is not an ifIndex, however the MIB associate the PW to the ifIndex of the path to be emulated. In some cases, the PW will be associated to an ifIndex representing a virtual interface. An example is VPLS service where the PW emulates a logical interface of a (logical) bridge. The physical ports association to the VPLS service instance is defined in non- PW MIBs in this case. Exception to the above MAY exist in some services, where it is convenient to manage the PW as an ifIndex in the ifTable. A special ifType to represent a PW virtual interface (exact number to be assigned by IANA) will be used in the ifTable in this case. Note that the ifIndex that carry the PW toward/from the PSN is in general not explicitly configured via PW MIB modules except in rare cases. In most cases the PW is carried inside a PSN tunnel, and the interfaces carrying the tunnel are specified in the related MIBs that control the PSN tunnels. 6.5 Example of the PW MIB modules usage In this section we provide an example of using the MIB objects described in section 7 to set up a CEP PW over MPLS PSN. While this example is not meant to illustrate every permutation of the MIB, it is intended as an aid to understanding some of the key concepts. It is meant to be read after going through the MIB itself. In this example a PW service for CEP is configured over an MPLS PSN (MPLS-TE tunnel). It uses LDP as in [PWCNTRL] for service set- up. In PW MIB: In pwVcTable: { Zelig et al Expires July 2004 [page 5] Pseudo Wire (PW) Management January 2004 Information Base pwVcIndex 5, pwVcType cep, pwVcOwner pwIdFecSignaling, pwVcPsnType mpls, pwVcSetUpPriority 0, -- Highest pwVcHoldingPriority 0, -- Highest pwVcInboundMode loose, pwVcPeerAddrType ipv4, pwVcPeerAddr 1.4.3.2, -- In this case equal to the -- peer LDP entity IP addr pwVcID 10, pwVcLocalGroupID 12, .. pwVcCwPreference true, -- Actually ignored for CEP pwVcLocalIfMtu 0, -- Do not send ifMtu parameter pwVcLocalIfString false, -- Do not send interface string pwVcCapabAdvert 0, -- Does not support status -- report to the peer. pwVcRemoteGroupID 0xFFFF, -- Will be received by -- maintenance protocol pwVcRemoteCwStatus notKnownYet, pwVcRemoteIfMtu 0, pwVcRemoteIfString "", pwVcRemoteCapabilities notYetKnown, .. pwVcOutboundVcLabel 0xFFFF, -- Will be received by -- maintenance protocol pwVcInboundVcLabel 0xFFFF, -- Will be set by maintenance -- protocol pwVcName "Example of CEP VC", pwVcDescr "", .. pwVcAdminStatus up, .. } The agent now creates a row in pwVcMplsTable [PWMPLS] based on the pwVcindex. The EMS should configure this table with MPLS specific values. In PW MPLS MIB: In pwVcMplsTable: { pwVcMplsMplsType mplsTe, pwVcMplsExpBitsMode outerTunnel, pwVcMplsExpBits 0, -- Not applicable Zelig et al Expires July 2004 [page 6] Pseudo Wire (PW) Management January 2004 Information Base pwVcMplsTtl 2, ... } The operator now associates the PW with an outgoing TE tunnel, via PwVcMplsTeMappingTable. Note that the agent created the first entry because pwVcMplsMplsType was set to æmplsTeÆ, but if required the operator may create additional tables as necessary: In PwVcMplsTeMappingTable: { pwVcMplsTeMappingTunnelIndex 500, pwVcMplsTeMappingTunnelInstance 0, pwVcMplsTeMappingTunnelPeerLsrID 1.4.3.2 pwVcMplsTeMappingTunnelLocalLsrID 1.2.3.4, -- Always the LSR ID -- of the current node. pwVcMplsTeMappingVcIndex 5, .. } A row in PwVcMplsOutboundTable will be created by the agent and will enable easy lookup for the outbound tunnel configured for a certain pwVcindex. For the operation in the service specific MIB module, see the specific MIB module memo. This example is continued in the memo describing the PW CEP MIB [CEPMIB]. 7 Object definitions PW-DRAFT04-MIB DEFINITIONS ::= BEGIN IMPORTS NOTIFICATION-TYPE, MODULE-IDENTITY, OBJECT-TYPE, Integer32, Unsigned32, Counter64, TimeTicks FROM SNMPv2-SMI MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF TruthValue, RowStatus, StorageType, TimeStamp FROM SNMPv2-TC SnmpAdminString FROM SNMP-FRAMEWORK-MIB PwVcIndexType, PwGroupID, PwVcIDType, PwOperStatus, PwVcType, PwVcAttachmentIdentifierType, Zelig et al Expires July 2004 [page 7] Pseudo Wire (PW) Management January 2004 Information Base PwVcRemoteCwStatus, PwVcCapabilities, PwVcStatus, PwVcFragSize, PwVcFragStatus, pwStdMIB FROM PW-TC-DRAFT04-MIB InetAddressType, InetAddress FROM INET-ADDRESS-MIB ; pwVcMIB MODULE-IDENTITY LAST-UPDATED "200312101200Z" -- 10 January 2004 12:00:00 EST ORGANIZATION "Pseudo Wire Edge to Edge Emulation (PWE3) Working Group" CONTACT-INFO " David Zelig Postal: Corrigent Systems 126, Yigal Alon St. Tel Aviv, ISRAEL Phone: +972-3-6945273 E-mail: davidz@corrigent.com Thomas D. Nadeau Postal: Cisco Systems, Inc. 250 Apollo Drive Chelmsford, MA 01824 Tel: +1-978-497-3051 Email: tnadeau@cisco.com Dave Danenberg Postal: Litchfield Communications, Inc. 76 Westbury Park Rd Princeton Building East Watertown, CT 06795 Tel: +1-860-945-1573 x3180 Email: dave_danenberg@litchfieldcomm.com Sharon Mantin Postal: AxONLink (Israel) Ltd 9 Bareket St. Petah Tikva 49517, Israel Tel: +972-3-9263972 Email: sharon.mantin@axonlink.com The PWE3 Working Group (email distribution pwe3@ietf.org, http://www.ietf.org/html.charters/pwe3-charter.html) " DESCRIPTION "This MIB module contains managed object definitions for Pseudo Wire operation as in: Bryant., et al, 'PWE3 Zelig et al Expires July 2004 [page 8] Pseudo Wire (PW) Management January 2004 Information Base architecture', Martini, L., et al, 'Pseudowire Setup and Maintenance using LDP', and Townsley, M., et al, 'Layer Two Tunneling Protocol (Version 3)'. -- Editor note: will add RFC numbers when available. This MIB module enables the use of any underlying packet switched network (PSN). MIB nodules that will support PW operations over specific PSN types are defined in separate memos. The indexes for this MIB module are also used to index the PSN-specific tables and the PW-specific tables. The PW Type dictates which PW-specific MIB module to use. 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 Ed.: replace yyyy with actual RFC number & remove this note " -- Revision history. REVISION "200312101200Z" -- 10 January 2004 12:00:00 EST DESCRIPTION " published as draft-ietf-pw-mib-04. Changes from previous drafts: - Changing textual convention back to TruthValue where required for correct compilation. - Editing description clauses. - Adapting main description clause to MIB boilerplate. - Adapat MIB names to STD-MIB naming convention. - Add pwVcRemoteStatusCapable. - Add PW delete notification. - Add pwVcLastChanged. - Clarify usage of pwVcIndexMappingTable. " REVISION "200307211200Z" -- 21 July 2003 12:00:00 EST DESCRIPTION " published as draft-ietf-pw-mib-02. Changes from previous draft: 1) Aligned with draft-pwe3-control-protocol-02.txt 2) Add support for Generalized ID FEC Element option. 3) Add support for fragmentation status. 3) Add notifications and notification control. 4) Remove control word to service specific MIB modules. " REVISION Zelig et al Expires July 2004 [page 9] Pseudo Wire (PW) Management January 2004 Information Base "200205261200Z" -- 26 May 2002 12:00:00 EST DESCRIPTION "Moved to draft-ietf-00 status. Changes from previous draft: 1) Change name of pwVcPriority to pwVcSetUpPriority and added pwVcHoldingPriority. 2) Add pwVcIdMappingTable and pwVcPeersMappingTable to help ordered query of the MIB tables for EMS applications. 3) Clarification to work in progress objects. 4) Editorial and typos in descriptions. 5) Added pwVcPerfTotalDiscontinuityTime and pwVcPerfIntervalTimeElapsed. 6) Remove 32 bit counters. " REVISION "200201301200Z" -- 30 January 2002 12:00:00 EST DESCRIPTION " Changes from -01 draft: 1) Inbound and outbound clarification and name changes. 2) Removing pwVcPeerIpv4Addr and pwVcPeerIpv6Addr, replacing them with pwVcPeerAddr and adding type for address type selection. 3) Adding type for VC OperStatus. 4) Adding pwVcTimeElapsed and pwVcValidIntervals. " REVISION "200111071200Z" -- 7 November 2001 12:00:00 EST DESCRIPTION "Changes from -00 draft: 1) Remove VcInstance from tables indexes in order to simplify the MIB. 2) Removing APS 1+1 table. 3) Changing hdlcCisco to hdlc in pwVcType. 4) Add description of VC label at pending PW signaling stage. 5) Add interval valid object in interval performance tables. 6) Remove VC APS notification. 7) Change 'conservative'/'liberal' to 'strict'/'loose'. 8) Add objects for interface MTU, use of control word, interface string. 9) Ordering of objects based on functionality. 10) Update operation of pwVcOperStatus. " REVISION "200107111200Z" -- 11 July 2001 12:00:00 EST DESCRIPTION "draft-00 version" Zelig et al Expires July 2004 [page 10] Pseudo Wire (PW) Management January 2004 Information Base ::= { pwStdMIB 2 } -- To be assigned by IANA -- Top-level components of this MIB. -- Notifications pwVcNotifications OBJECT IDENTIFIER ::= { pwVcMIB 0 } -- Tables, Scalars pwVcObjects OBJECT IDENTIFIER ::= { pwVcMIB 1 } -- Conformance pwVcConformance OBJECT IDENTIFIER ::= { pwVcMIB 2 } -- PW Virtual Connection (VC) Table pwVcIndexNext OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "This object contains an appropriate value to be used for pwVcIndex when creating entries in the pwVcTable. The value 0 indicates that no unassigned entries are available. To obtain the value of pwVcIndex for a new entry in the pwVcTable, the manager issues a management protocol retrieval operation to obtain the current value of pwVcIndex. After each retrieval operation, the agent should modify the value to reflect the next unassigned index. After a manager retrieves a value the agent will determine through its local policy when this index value will be made available for reuse." ::= { pwVcObjects 1 } pwVcTable OBJECT-TYPE SYNTAX SEQUENCE OF PwVcEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table specifies information for configuring and status monitoring which are common to all service types and PSN types." ::= { pwVcObjects 2 } pwVcEntry OBJECT-TYPE SYNTAX PwVcEntry MAX-ACCESS not-accessible Zelig et al Expires July 2004 [page 11] Pseudo Wire (PW) Management January 2004 Information Base STATUS current DESCRIPTION "A row in this table represents a pseudo wire (PW) virtual connection (VC) across a packet network. It is indexed by pwVcIndex, which uniquely identifying a singular connection. " INDEX { pwVcIndex } ::= { pwVcTable 1 } PwVcEntry ::= SEQUENCE { pwVcIndex PwVcIndexType, pwVcType PwVcType, pwVcOwner INTEGER, pwVcPsnType INTEGER, pwVcSetUpPriority Integer32, pwVcHoldingPriority Integer32, pwVcPeerAddrType InetAddressType, pwVcPeerAddr InetAddress, pwVcID PwVcIDType, pwVcLocalGroupID PwGroupID, pwVcGroupAttachmentID PwVcAttachmentIdentifierType, pwVcLocalAttachmentID PwVcAttachmentIdentifierType, pwVcPeerAttachmentID PwVcAttachmentIdentifierType, pwVcCwPreference TruthValue, pwVcLocalIfMtu Unsigned32, pwVcLocalIfString TruthValue, pwVcLocalCapabAdvert PwVcCapabilities, pwVcRemoteGroupID PwGroupID, pwVcRemoteCwStatus PwVcRemoteCwStatus, pwVcRemoteIfMtu Unsigned32, pwVcRemoteIfString SnmpAdminString, pwVcRemoteCapabilities PwVcCapabilities, pwVcFragmentCfgSize PwVcFragSize, pwVcRmtFragCapability PwVcFragStatus, pwVcOutboundVcLabel Unsigned32, pwVcInboundVcLabel Unsigned32, pwVcName SnmpAdminString, pwVcDescr SnmpAdminString, pwVcCreateTime TimeStamp, pwVcUpTime TimeTicks, pwVcLastChange TimeTicks, pwVcAdminStatus INTEGER, pwVcOperStatus PwOperStatus, pwVcLocalStatus PwVcStatus, Zelig et al Expires July 2004 [page 12] Pseudo Wire (PW) Management January 2004 Information Base pwVcRemoteStatusCapable INTEGER, pwVcRemoteStatus PwVcStatus, pwVcTimeElapsed Integer32, pwVcValidIntervals Integer32, pwVcRowStatus RowStatus, pwVcStorageType StorageType } pwVcIndex OBJECT-TYPE SYNTAX PwVcIndexType MAX-ACCESS not-accessible STATUS current DESCRIPTION "Index for the conceptual row identifying a PW within this PW Emulation table." ::= { pwVcEntry 1 } pwVcType OBJECT-TYPE SYNTAX PwVcType MAX-ACCESS read-create STATUS current DESCRIPTION "This value indicate the service to be carried over this PW. " ::= { pwVcEntry 2 } pwVcOwner OBJECT-TYPE SYNTAX INTEGER { manual (1), pwIdFecSignaling (2), -- PW signaling with PW ID FEC genFecSignaling (3), -- Generalized attachment FEC l2tpControlProtocol (4), other (5) } MAX-ACCESS read-create STATUS current DESCRIPTION "Set by the operator to indicate the protocol responsible for establishing this PW. Value 'manual' is used in all cases where no maintenance protocol (PW signaling) is used to set-up the PW, i.e. require configuration of entries in the PW tables including PW labels, etc. The value æpwIdFecSignaling' is used in case of signaling with the Pwid FEC element with LDP signaling, and 'genFecSignaling' is used of the generalized FEC with LDP is used for signaling purposes. The value 'l2tpControlProtocol' indicate the use of L2TP control protocol. Value 'other' is used for other types of signaling." Zelig et al Expires July 2004 [page 13] Pseudo Wire (PW) Management January 2004 Information Base ::= { pwVcEntry 3 } pwVcPsnType OBJECT-TYPE SYNTAX INTEGER { mpls (1), l2tp (2), ip (3), mplsOverIp (4),-- May be combined with 'mpls' in the future gre (5), other (6) } MAX-ACCESS read-create STATUS current DESCRIPTION "Set by the operator to indicate the PSN type on which this PW will be carried. Based on this object, the relevant PSN table entries are created in the in the PSN specific MIB modules. For example, if mpls(1) is defined, the agent create an entry in pwVcMplsTable, which further define the MPLS PSN configuration. " ::= { pwVcEntry 4 } pwVcSetUpPriority OBJECT-TYPE SYNTAX Integer32 (0..7) MAX-ACCESS read-create STATUS current DESCRIPTION "This object define the relative set-up priority of the PW in a lowest-to-highest fashion, where 0 is the highest priority. PWs with the same priority are treated with equal priority. Dropped VC will be set 'dormant' (as indicated in pwVcOperStatus). This value is significant if there are competing resources between VCs and the implementation support this feature. If not supported or not relevant, the value of zero MUST be used." DEFVAL { 0 } ::= { pwVcEntry 5 } pwVcHoldingPriority OBJECT-TYPE SYNTAX Integer32 (0..7) MAX-ACCESS read-create STATUS current DESCRIPTION "This object define the relative holding priority of the PW in a lowest-to-highest fashion, where 0 is the highest priority. PWs with the same priority are treated with Zelig et al Expires July 2004 [page 14] Pseudo Wire (PW) Management January 2004 Information Base equal priority. Dropped VC will be set 'dormant' (as indicated in pwVcOperStatus). This value is significant if there are competing Resources between PWs and the implementation support this feature. If not supported or not relevant, the value of zero MUST be used." DEFVAL { 0 } ::= { pwVcEntry 6 } pwVcPeerAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-create STATUS current DESCRIPTION "Denotes the address type of the peer node maintenance protocol (signaling) address if PW maintenance protocol is used for the PW creation. It should be set to 'unknown' if PE/PW maintenance protocol is not used, i.e. pwVcOwner is set to 'manual'. " DEFVAL { ipv4 } ::= { pwVcEntry 8 } pwVcPeerAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-create STATUS current DESCRIPTION "This object contain the value of the peer node address of the PW/PE maintenance protocol entity. This object should contain a value of 0 if not applicable (manual configuration of the PW)." ::= { pwVcEntry 9 } pwVcID OBJECT-TYPE SYNTAX PwVcIDType MAX-ACCESS read-create STATUS current DESCRIPTION "Used in the outgoing PW ID field within the 'Virtual Circuit FEC Element'. Applicable if pwVcOwner equal 'pwIdFecSignaling' or 'l2tpControlProtocol', should be set to zero otherwise." REFERENCE "Martini, et al, ." ::= { pwVcEntry 10 } pwVcLocalGroupID OBJECT-TYPE SYNTAX PwGroupID Zelig et al Expires July 2004 [page 15] Pseudo Wire (PW) Management January 2004 Information Base MAX-ACCESS read-create STATUS current DESCRIPTION "Used in the Group ID field sent to the peer PWES within the maintenance protocol used for PW setup. Applicable if pwVcOwner equal 'pwIdFecSignaling' or 'l2tpControlProtocol', should be set to zero otherwise." REFERENCE "Martini, et al, ." ::= { pwVcEntry 11 } pwVcGroupAttachmentID OBJECT-TYPE SYNTAX PwVcAttachmentIdentifierType MAX-ACCESS read-create STATUS current DESCRIPTION "This object is an octet string representing the attachment group identifier (AGI) this PW belongs too, which typically identifies the VPN ID. Applicable if pwVcOwner equal 'genFecSignaling'. Should be set to NULL (zero length) if not applicable." REFERENCE "Martini, et al, ." ::= { pwVcEntry 12 } pwVcLocalAttachmentID OBJECT-TYPE SYNTAX PwVcAttachmentIdentifierType MAX-ACCESS read-create STATUS current DESCRIPTION "This object is an octet string representing the local forwarder attachment individual identifier (AII) to be used by this PW. It is used as the SAII for outgoing signaling messages and the TAII in the incoming messages from the peer. Applicable if pwVcOwner equal 'genFecSignaling'. Should be set to NULL (zero length) if not applicable. " REFERENCE "Martini, et al, ." ::= { pwVcEntry 13 } pwVcPeerAttachmentID OBJECT-TYPE SYNTAX PwVcAttachmentIdentifierType MAX-ACCESS read-create STATUS current DESCRIPTION "This object is an octet string representing the peer forwarder attachment individual identifier (AII) to be used by this PW. It is used as the TAII for outgoing signaling messages and the SAII in the incoming messages from the peer. Zelig et al Expires July 2004 [page 16] Pseudo Wire (PW) Management January 2004 Information Base Applicable if pwVcOwner equal 'genFecSignaling'. Should be set to NULL (zero length) if not applicable. " REFERENCE "Martini, et al, ." ::= { pwVcEntry 14 } pwVcCwPreference OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "Define if the control word will be sent with each packet by the local node. Some PW types mandate the use of control word, and is such cases the value configured has no effect on the existence of the control word." REFERENCE "Martini, et al, ." DEFVAL { false } ::= { pwVcEntry 15 } pwVcLocalIfMtu OBJECT-TYPE SYNTAX Unsigned32 (0..65535) MAX-ACCESS read-create STATUS current DESCRIPTION "If not equal zero, the optional IfMtu object in the maintenance protocol will be sent with this value, representing the locally supported MTU size over the interface (or the virtual interface) associated with the PW." REFERENCE "Martini, et al, ." DEFVAL { 0 } ::= { pwVcEntry 16 } pwVcLocalIfString OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "Each PW is associated to an interface (or a virtual interface) in the ifTable of the node as part of the service configuration. This object defines if the maintenance protocol will send the interface's name as appears on the ifTable in the name object as part of the maintenance protocol. If set to false, the optional element will not be sent." REFERENCE "Martini, et al, ." Zelig et al Expires July 2004 [page 17] Pseudo Wire (PW) Management January 2004 Information Base DEFVAL { false } ::= { pwVcEntry 17 } pwVcLocalCapabAdvert OBJECT-TYPE SYNTAX PwVcCapabilities MAX-ACCESS read-create STATUS current DESCRIPTION "Indicate the capabilities to be advertised by this node to the peer." REFERENCE "Martini, et al, ." ::= { pwVcEntry 18 } pwVcRemoteGroupID OBJECT-TYPE SYNTAX PwGroupID MAX-ACCESS read-only STATUS current DESCRIPTION "Obtained from the Group ID field as received via the maintenance protocol used for VC setup, zero if not used. Value of 0xFFFF shall be used if the object is yet to be defined by the PW maintenance protocol." REFERENCE "Martini, et al, ." ::= { pwVcEntry 19 } pwVcRemoteCwStatus OBJECT-TYPE SYNTAX PwVcRemoteCwStatus MAX-ACCESS read-create STATUS current DESCRIPTION "If maintenance protocol is used for PW establishment, this parameter indicates the status of the control word negotiation. " REFERENCE "Martini, et al, . " ::= { pwVcEntry 20 } pwVcRemoteIfMtu OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The remote interface MTU as (optionally) received from the remote node via the maintenance protocol. Should be zero if this parameter is not available or not used." REFERENCE Zelig et al Expires July 2004 [page 18] Pseudo Wire (PW) Management January 2004 Information Base "Martini, et al, ." ::= { pwVcEntry 21 } pwVcRemoteIfString OBJECT-TYPE SYNTAX SnmpAdminString (SIZE (0..80)) MAX-ACCESS read-only STATUS current DESCRIPTION "Indicate the interface description string as received by the maintenance protocol, MUST be NULL string if not applicable or not known yet." REFERENCE "Martini, et al, ." ::= { pwVcEntry 22 } pwVcRemoteCapabilities OBJECT-TYPE SYNTAX PwVcCapabilities MAX-ACCESS read-only STATUS current DESCRIPTION "Indicate the capabilities as advertised by the peer." REFERENCE "Martini, et al, ." ::= { pwVcEntry 23 } pwVcFragmentCfgSize OBJECT-TYPE SYNTAX PwVcFragSize MAX-ACCESS read-create STATUS current DESCRIPTION "If set to value other than zero, indicate that fragmantation is desired for this PW." ::= { pwVcEntry 24 } pwVcRmtFragCapability OBJECT-TYPE SYNTAX PwVcFragStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of the fragmentation based on the local configuration and the peer capabilities as advertised by the peer if control protocol is used." ::= { pwVcEntry 25 } pwVcOutboundVcLabel OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "The PW label used in the outbound direction (i.e. toward the PSN). It may be set up manually if owner is 'manual' Zelig et al Expires July 2004 [page 19] Pseudo Wire (PW) Management January 2004 Information Base or automatically otherwise. Examples: For MPLS PSN, it represents the 20 bits of PW tag, for L2TP it represent the 32 bits Session ID. If the label is not yet known (signaling in process), the object should return a value of 0xFFFF." ::= { pwVcEntry 26 } pwVcInboundVcLabel OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "The PW label used in the inbound direction (i.e. packets received from the PSN. It may be set up manually if owner is 'manual' or automatically otherwise. Examples: For MPLS PSN, it represents the 20 bits of PW tag, for L2TP it represent the 32 bits Session ID. If the label is not yet known (signaling in process), the object should return a value of 0xFFFF." ::= { pwVcEntry 27 } pwVcName OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "The canonical name assigned to the PW." ::= { pwVcEntry 28 } pwVcDescr OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "A textual string containing information about the PW. If there is no description this object contains a zero length string." ::= { pwVcEntry 29 } pwVcCreateTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "System time when this PW was created." ::= { pwVcEntry 30 } pwVcUpTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current Zelig et al Expires July 2004 [page 20] Pseudo Wire (PW) Management January 2004 Information Base DESCRIPTION "Specifies the total time this PW operStatus has been Up(1)." ::= { pwVcEntry 31 } pwVcLastChange OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime at the time the PW entered its current operational state. If the current state was entered prior to the last re-initialization of the local network management subsystem, then this object contains a zero value." ::= { pwVcEntry 32 } pwVcAdminStatus OBJECT-TYPE SYNTAX INTEGER { up(1), -- ready to pass packets down(2), testing(3) -- in some test mode } MAX-ACCESS read-create STATUS current DESCRIPTION "The desired operational status of this PW." ::= { pwVcEntry 33 } pwVcOperStatus OBJECT-TYPE SYNTAX PwOperStatus MAX-ACCESS read-only STATUS current DESCRIPTION "This object indicate the operational status of the PW, it does not reflect however the status of the CE bound interface. It is set to down only if pwNotForwarding, psnFacingPwRxFault, or psnFacingPwTxFault indications is set in pwVcLocalStatus or pwVcRemoteStatus. It indicate 'lowerLayerDown' only if the only reason for not being in the 'up' state is either outer tunnel failure. All other states are declared base on the description in the textual convention. " ::= { pwVcEntry 34 } pwVcLocalStatus OBJECT-TYPE SYNTAX PwVcStatus MAX-ACCESS read-only Zelig et al Expires July 2004 [page 21] Pseudo Wire (PW) Management January 2004 Information Base STATUS current DESCRIPTION "Indicates the status of the PW in the local node. The various indications in this object should be available independent of the ability of the local node to advertise them or the remote node to accept these status indications through the control protocol. " ::= { pwVcEntry 35 } pwVcRemoteStatusCapable OBJECT-TYPE SYNTAX INTEGER { notApplicable (1), notYetKnown (2), remoteCapable (3), remoteNotCapable (4) } MAX-ACCESS read-only STATUS current DESCRIPTION "Indicate the remote node capability to advertise the PW status notification. notAppicable should be reported for manually set PW, or if the local node is not capable of sending the status notification object. notYetKnown should be reported if the signaling protocol has not yet finished the process of capability determination. remoteCapable and remoteNotcapable should be reported based on the initial signaling exchange that has determined the remote node capability. " ::= { pwVcEntry 36 } pwVcRemoteStatus OBJECT-TYPE SYNTAX PwVcStatus MAX-ACCESS read-only STATUS current DESCRIPTION "Indicate the status of the PW as was advertised by the remote. If the remote is not capable of advertising the status object, or the local node is not able to accept the status object through signaling, then the applicable bit is 'pwNotForwarding' which is set if the remote has sent label release or label withdraw for this PW. " ::= { pwVcEntry 37 } pwVcTimeElapsed OBJECT-TYPE SYNTAX Integer32 (1..900) Zelig et al Expires July 2004 [page 22] Pseudo Wire (PW) Management January 2004 Information Base MAX-ACCESS read-only STATUS current DESCRIPTION "The number of seconds, including partial seconds, that have elapsed since the beginning of the current measurement period. If, for some reason, such as an adjustment in the system's time-of-day clock, the current interval exceeds the maximum value, the agent will return the maximum value. " ::= { pwVcEntry 38 } pwVcValidIntervals OBJECT-TYPE SYNTAX Integer32 (0..96) MAX-ACCESS read-only STATUS current DESCRIPTION "The number of previous 15-minute intervals for which data was collected. An agent with PW capability must be capable of supporting at least n intervals. The minimum value of n is 4, The default of n is 32 and the maximum value of n is 96. The value will be unless the measurement was (re-) started within the last (*15) minutes, in which case the value will be the number of complete 15 minute intervals for which the agent has at least some data. In certain cases (e.g., in the case where the agent is a proxy) it is possible that some intervals are unavailable. In this case, this interval is the maximum interval number for which data is available. " ::= { pwVcEntry 39 } pwVcRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "For creating, modifying, and deleting this row." ::= { pwVcEntry 40 } pwVcStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-create STATUS current DESCRIPTION "This variable indicates the storage type for this object." ::= { pwVcEntry 41 } -- End of PW Virtual Connection Table Zelig et al Expires July 2004 [page 23] Pseudo Wire (PW) Management January 2004 Information Base -- PW Performance Table. pwVcPerfCurrentTable OBJECT-TYPE SYNTAX SEQUENCE OF PwVcPerfCurrentEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table provides per-PW performance information for the current interval." ::= { pwVcObjects 3 } pwVcPerfCurrentEntry OBJECT-TYPE SYNTAX PwVcPerfCurrentEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in this table is created by the agent for every PW." INDEX { pwVcIndex } ::= { pwVcPerfCurrentTable 1 } PwVcPerfCurrentEntry ::= SEQUENCE { pwVcPerfCurrentInHCPackets Counter64, pwVcPerfCurrentInHCBytes Counter64, pwVcPerfCurrentOutHCPackets Counter64, pwVcPerfCurrentOutHCBytes Counter64 } pwVcPerfCurrentInHCPackets OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "High capacity counter for number of packets received by the PW (from the PSN) in the current 15 minute interval. " ::= { pwVcPerfCurrentEntry 1 } pwVcPerfCurrentInHCBytes OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "High capacity counter for number of bytes received by the PW (from the PSN) in the current 15 minute interval. " ::= { pwVcPerfCurrentEntry 2 } pwVcPerfCurrentOutHCPackets OBJECT-TYPE Zelig et al Expires July 2004 [page 24] Pseudo Wire (PW) Management January 2004 Information Base SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "High capacity counter for number of packets forwarded by the PW (to the PSN) in the current 15 minute interval. " ::= { pwVcPerfCurrentEntry 3 } pwVcPerfCurrentOutHCBytes OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "High capacity counter for number of bytes forwarded by the PW (to the PSN) in the current 15 minute interval. " ::= { pwVcPerfCurrentEntry 4 } -- End of PW Perf current Table -- PW Performance Interval Table. pwVcPerfIntervalTable OBJECT-TYPE SYNTAX SEQUENCE OF PwVcPerfIntervalEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table provides per-PW performance information for each interval." ::= { pwVcObjects 4 } pwVcPerfIntervalEntry OBJECT-TYPE SYNTAX PwVcPerfIntervalEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in this table is created agent for every PW." INDEX { pwVcIndex, pwVcPerfIntervalNumber } ::= { pwVcPerfIntervalTable 1 } PwVcPerfIntervalEntry ::= SEQUENCE { pwVcPerfIntervalNumber Integer32, pwVcPerfIntervalValidData TruthValue, pwVcPerfIntervalTimeElapsed Integer32, pwVcPerfIntervalInHCPackets Counter64, pwVcPerfIntervalInHCBytes Counter64, pwVcPerfIntervalOutHCPackets Counter64, pwVcPerfIntervalOutHCBytes Counter64 } Zelig et al Expires July 2004 [page 25] Pseudo Wire (PW) Management January 2004 Information Base pwVcPerfIntervalNumber OBJECT-TYPE SYNTAX Integer32 (1..96) MAX-ACCESS not-accessible STATUS current DESCRIPTION "A number N, between 1 and 96, which identifies the interval for which the set of statistics is available. The interval identified by 1 is the most recently completed 15 minute interval, and the interval identified by N is the interval immediately preceding the one identified by N-1. The minimum range of N is 1 through 4. The default range is 1 to 32. The maximum range of N is 1 through 96. " REFERENCE "Tesink, K. 'Definitions of Managed Objects for the SONET/SDH Interface Type', RFC 2558" ::= { pwVcPerfIntervalEntry 1 } pwVcPerfIntervalValidData OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "This variable indicates if the data for this interval is valid." ::= { pwVcPerfIntervalEntry 2 } pwVcPerfIntervalTimeElapsed OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The duration of a particular interval in seconds. Adjustments in the system's time-of-day clock, may cause the interval to be greater or less than the normal value. Therefore this actual interval value is provided." ::= { pwVcPerfIntervalEntry 3 } pwVcPerfIntervalInHCPackets OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "High capacity counter for number of packets received by the PW (from the PSN) in a particular 15-minute interval." ::= { pwVcPerfIntervalEntry 4 } pwVcPerfIntervalInHCBytes OBJECT-TYPE SYNTAX Counter64 Zelig et al Expires July 2004 [page 26] Pseudo Wire (PW) Management January 2004 Information Base MAX-ACCESS read-only STATUS current DESCRIPTION "High capacity counter for number of bytes received by the PW (from the PSN) in a particular 15-minute interval." ::= { pwVcPerfIntervalEntry 5 } pwVcPerfIntervalOutHCPackets OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "High capacity counter for number of packets forwarded by the PW (to the PSN) in a particular 15-minute interval." ::= { pwVcPerfIntervalEntry 6 } pwVcPerfIntervalOutHCBytes OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "High capacity counter for number of bytes forwarded by the PW (to the PSN) in a particular 15-minute interval." ::= { pwVcPerfIntervalEntry 7 } -- End of PW Performance Interval Table -- PW Performance Total Table. pwVcPerfTotalTable OBJECT-TYPE SYNTAX SEQUENCE OF PwVcPerfTotalEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table provides per-PW Performance information from PW start time." ::= { pwVcObjects 5 } pwVcPerfTotalEntry OBJECT-TYPE SYNTAX PwVcPerfTotalEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in this table is created by the agent for every PW." INDEX { pwVcIndex } ::= { pwVcPerfTotalTable 1 } Zelig et al Expires July 2004 [page 27] Pseudo Wire (PW) Management January 2004 Information Base PwVcPerfTotalEntry ::= SEQUENCE { pwVcPerfTotalInHCPackets Counter64, pwVcPerfTotalInHCBytes Counter64, pwVcPerfTotalOutHCPackets Counter64, pwVcPerfTotalOutHCBytes Counter64, pwVcPerfTotalDiscontinuityTime TimeStamp } pwVcPerfTotalInHCPackets OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "High capacity counter for number of packets received by the PW (from the PSN)." ::= { pwVcPerfTotalEntry 1 } pwVcPerfTotalInHCBytes OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "High capacity counter for number of bytes received by the PW (from the PSN)." ::= { pwVcPerfTotalEntry 2 } pwVcPerfTotalOutHCPackets OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "High capacity counter for number of packets forwarded by the PW (to the PSN)." ::= { pwVcPerfTotalEntry 3 } pwVcPerfTotalOutHCBytes OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "High capacity counter for number of bytes forwarded by the PW (to the PSN)." ::= { pwVcPerfTotalEntry 4 } pwVcPerfTotalDiscontinuityTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime on the most recent occasion at which any one or more of this row Counter32 or Zelig et al Expires July 2004 [page 28] Pseudo Wire (PW) Management January 2004 Information Base Counter64 suffered a discontinuity. If no such discontinuities have occurred since the last re- initialization of the local management subsystem, then this object contains a zero value." ::= { pwVcPerfTotalEntry 5 } -- End of PW Perf Total Table -- Error counter scalar pwVcPerfTotalErrorPackets OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "Counter for number of error at PW level processing, for example packets received with unknown PW label." ::= { pwVcObjects 6 } -- Reverse mapping tables pwVcIndexMappingTable OBJECT-TYPE SYNTAX SEQUENCE OF PwVcIndexMappingEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table enable (1) retrieving of the PW index from the node for specific PW based on the unique PW parameters (peer IP, PW type and PW ID), and (2) for existing PW the reverse mapping between these parameters and the pwVcIndex. The table is not applicable for PW created manually or by using the generalized FEC." ::= { pwVcObjects 7 } pwVcIndexMappingEntry OBJECT-TYPE SYNTAX PwVcIndexMappingEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "When used in option (1) above, the EMS create a row by setting the indexes of the table and then acquire the pwVcIndex from the node. For existing PWs (2), the table allow retrieval of the pwVcIndex from the peer address, PW type and PW ID. An implementation may not support option (1), but an entry in this table MUST be created by the agent for every PW configured by the pwVcTable if such entry do not exist." INDEX { pwVcIndexMappingVcType, pwVcIndexMappingVcID, pwVcIndexMappingPeerAddrType, pwVcIndexMappingPeerAddr Zelig et al Expires July 2004 [page 29] Pseudo Wire (PW) Management January 2004 Information Base } ::= { pwVcIndexMappingTable 1 } PwVcIndexMappingEntry ::= SEQUENCE { pwVcIndexMappingVcType PwVcType, pwVcIndexMappingVcID PwVcIDType, pwVcIndexMappingPeerAddrType InetAddressType, pwVcIndexMappingPeerAddr InetAddress, pwVcIndexMappingVcIndex PwVcIndexType, pwVcIndexMappingRowStatus RowStatus, pwVcIndexMappingStorageType StorageType } pwVcIndexMappingVcType OBJECT-TYPE SYNTAX PwVcType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The PW type (indicate the service) of this PW." ::= { pwVcIndexMappingEntry 1 } pwVcIndexMappingVcID OBJECT-TYPE SYNTAX PwVcIDType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The PW ID of this PW. Zero if the PW is configured manually." ::= { pwVcIndexMappingEntry 2 } pwVcIndexMappingPeerAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "IP address type of the peer node." ::= { pwVcIndexMappingEntry 3 } pwVcIndexMappingPeerAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible STATUS current DESCRIPTION "IP address type of the peer node." ::= { pwVcIndexMappingEntry 4 } pwVcIndexMappingVcIndex OBJECT-TYPE SYNTAX PwVcIndexType MAX-ACCESS read-only STATUS current DESCRIPTION Zelig et al Expires July 2004 [page 30] Pseudo Wire (PW) Management January 2004 Information Base "The value that represent the PW in the pwVcTable." ::= { pwVcIndexMappingEntry 5 } pwVcIndexMappingRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "For creating, modifying, and deleting this row." ::= { pwVcIndexMappingEntry 6 } pwVcIndexMappingStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-create STATUS current DESCRIPTION "This variable indicates the storage type for this object." ::= { pwVcIndexMappingEntry 7 } pwVcPeerMappingTable OBJECT-TYPE SYNTAX SEQUENCE OF PwVcPeerMappingEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table provides reverse mapping of the existing PW based on PW type and PW ID ordering. This table is typically useful for EMS ordered query of existing PWs." ::= { pwVcObjects 8 } pwVcPeerMappingEntry OBJECT-TYPE SYNTAX PwVcPeerMappingEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in this table is created by the agent for every PW configured in pwVcTable." INDEX { pwVcPeerMappingPeerAddrType, pwVcPeerMappingPeerAddr, pwVcPeerMappingVcType, pwVcPeerMappingVcID, pwVcPeerMappingVcIndex} ::= { pwVcPeerMappingTable 1 } PwVcPeerMappingEntry ::= SEQUENCE { pwVcPeerMappingPeerAddrType InetAddressType, pwVcPeerMappingPeerAddr InetAddress, pwVcPeerMappingVcType PwVcType, pwVcPeerMappingVcID PwVcIDType, pwVcPeerMappingVcIndex PwVcIndexType Zelig et al Expires July 2004 [page 31] Pseudo Wire (PW) Management January 2004 Information Base } pwVcPeerMappingPeerAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "IP address type of the peer node." ::= { pwVcPeerMappingEntry 1 } pwVcPeerMappingPeerAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible STATUS current DESCRIPTION "IP address type of the peer node." ::= { pwVcPeerMappingEntry 2 } pwVcPeerMappingVcType OBJECT-TYPE SYNTAX PwVcType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The PW type (indicate the service) of this PW." ::= { pwVcPeerMappingEntry 3 } pwVcPeerMappingVcID OBJECT-TYPE SYNTAX PwVcIDType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The PW ID of this PW. Zero if the PW is configured manually." ::= { pwVcPeerMappingEntry 4 } pwVcPeerMappingVcIndex OBJECT-TYPE SYNTAX PwVcIndexType MAX-ACCESS read-only STATUS current DESCRIPTION "The value that represent the PW in the pwVcTable." ::= { pwVcPeerMappingEntry 5 } -- End of reverse mapping tables pwVcUpDownNotifEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "If this object is set to true(1), then it enables Zelig et al Expires July 2004 [page 32] Pseudo Wire (PW) Management January 2004 Information Base the emission of pwVcUp and pwVcDown notifications; otherwise these notifications are not emitted." REFERENCE "See also RFC3413 for explanation that notifications are under the ultimate control of the MIB modules in this document." DEFVAL { false } ::= { pwVcObjects 9 } pwVcNotifRate OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-write STATUS current DESCRIPTION "This object defines the maximum number of PW notifications that can be emitted from the device per second." ::= { pwVcObjects 10 } -- Notifications - PW pwVcDown NOTIFICATION-TYPE OBJECTS { pwVcOperStatus, --start of range pwVcOperStatus --end of range } STATUS current DESCRIPTION "This notification is generated when the pwVcOperStatus object for one or more contiguous entries in pwVcTable are about to enter the down(2) state from some other state. The included values of pwVcOperStatus MUST all be set equal to this down(2) state. The two instances of pwVcOperStatus in this notification indicate the range of indexes that are affected. Note that all the indexes of the two ends of the range can be derived from the instance identifiers of these two objects. For cases where a contiguous range of cross-connects have transitioned into the down(2) state at roughly the same time, the device SHOULD issue a single notification for each range of contiguous indexes in an effort to minimize the emission of a large number of notifications. If a notification has to be issued for just a single cross-connect entry, then the instance identifier (and values) of the two pwVcOperStatus objects MUST be identical." ::= { pwVcNotifications 1 } pwVcUp NOTIFICATION-TYPE OBJECTS { pwVcOperStatus, --start of range pwVcOperStatus --end of range Zelig et al Expires July 2004 [page 33] Pseudo Wire (PW) Management January 2004 Information Base } STATUS current DESCRIPTION "This notification is generated when the pwVcOperStatus object for one or more contiguous entries in pwVcTable are about to enter the up(1) state from some other state. The included values of pwVcOperStatus MUST both be set equal to this new state (i.e: up(1)). The two instances of pwVcOperStatus in this notification indicate the range of indexes that are affected. Note that all the indexes of the two ends of the range can be derived from the instance identifiers of these two objects. For cases where a contiguous range of cross-connects have transitioned into the up(1) state at roughly the same time, the device SHOULD issue a single notification for each range of contiguous indexes in an effort to minimize the emission of a large number of notifications. If a notification has to be issued for just a single cross-connect entry, then the instance identifier (and values) of the two pwVcOperStatus objects MUST be the identical." ::= { pwVcNotifications 2 } pwVcDeleted NOTIFICATION-TYPE OBJECTS { pwVcType, pwVcID, pwVcPeerAddrType, pwVcPeerAddr } STATUS current DESCRIPTION "This notification is generated when the PW has been deleted, i.e. when the pwVcRowStatus has been set to destroy(6). " ::= { pwVcNotifications 3 } -- End of notifications. -- conformance information pwVcGroups OBJECT IDENTIFIER ::= { pwVcConformance 1 } pwVcCompliances OBJECT IDENTIFIER ::= { pwVcConformance 2 } pwModuleCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for agent that support PW operation." Zelig et al Expires July 2004 [page 34] Pseudo Wire (PW) Management January 2004 Information Base MODULE -- this module MANDATORY-GROUPS { pwVcGroup, pwVcPeformanceTotalGroup } ::= { pwVcCompliances 1 } -- Units of conformance. pwVcGroup OBJECT-GROUP OBJECTS { pwVcIndexNext, pwVcType, pwVcOwner, pwVcPsnType, pwVcSetUpPriority, pwVcHoldingPriority, pwVcPeerAddrType, pwVcPeerAddr, pwVcID, pwVcLocalGroupID, pwVcGroupAttachmentID, pwVcLocalAttachmentID, pwVcPeerAttachmentID, pwVcCwPreference, pwVcLocalIfMtu, pwVcLocalIfString, pwVcLocalCapabAdvert, pwVcRemoteGroupID, pwVcRemoteCwStatus, pwVcRemoteIfMtu, pwVcRemoteIfString, pwVcRemoteCapabilities, pwVcFragmentCfgSize, pwVcRmtFragCapability, pwVcOutboundVcLabel, pwVcInboundVcLabel, pwVcName, pwVcDescr, pwVcCreateTime, pwVcUpTime, pwVcLastChange, pwVcAdminStatus, pwVcOperStatus, pwVcLocalStatus, pwVcRemoteStatusCapable, pwVcRemoteStatus, pwVcTimeElapsed, pwVcValidIntervals, pwVcRowStatus, pwVcStorageType } Zelig et al Expires July 2004 [page 35] Pseudo Wire (PW) Management January 2004 Information Base STATUS current DESCRIPTION "Collection of objects needed for PW configuration." ::= { pwVcGroups 1 } pwVcPeformanceTotalGroup OBJECT-GROUP OBJECTS { pwVcPerfTotalInHCPackets, pwVcPerfTotalInHCBytes, pwVcPerfTotalOutHCPackets, pwVcPerfTotalOutHCBytes, pwVcPerfTotalDiscontinuityTime, pwVcPerfTotalErrorPackets } STATUS current DESCRIPTION "Collection of objects needed for PW running total performance collection." ::= { pwVcGroups 2 } pwVcPeformanceIntervalGroup OBJECT-GROUP OBJECTS { pwVcPerfCurrentInHCPackets, pwVcPerfCurrentInHCBytes, pwVcPerfCurrentOutHCPackets, pwVcPerfCurrentOutHCBytes, pwVcPerfIntervalValidData, pwVcPerfIntervalTimeElapsed, pwVcPerfIntervalInHCPackets, pwVcPerfIntervalInHCBytes, pwVcPerfIntervalOutHCPackets, pwVcPerfIntervalOutHCBytes } STATUS current DESCRIPTION "Collection of objects needed for PW performance collection in 15 minutes intervals." ::= { pwVcGroups 3 } pwVcMappingTablesGroup OBJECT-GROUP OBJECTS { pwVcIndexMappingVcIndex, pwVcIndexMappingRowStatus, pwVcIndexMappingStorageType, Zelig et al Expires July 2004 [page 36] Pseudo Wire (PW) Management January 2004 Information Base pwVcPeerMappingVcIndex } STATUS current DESCRIPTION "Collection of objects contained in the reverse mapping tables." ::= { pwVcGroups 4 } pwVcNotificationControlGroup OBJECT-GROUP OBJECTS { pwVcUpDownNotifEnable, pwVcNotifRate } STATUS current DESCRIPTION "Collection of objects for controlling the PW notifications." ::= { pwVcGroups 5 } pwVcNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS { pwVcUp, pwVcDown, pwVcDeleted } STATUS current DESCRIPTION "Collection of objects for controlling the PW notifications." ::= { pwVcGroups 6 } -- END of PW-STD-MIB END 8 Security considerations It is clear that this MIB module is potentially useful for monitoring of PW capable PEs. This MIB 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. Zelig et al Expires July 2004 [page 37] Pseudo Wire (PW) Management January 2004 Information Base 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 pwVcTable contains objects to configure PW parameters on a Provider Edge (PE) device. Unauthorized access to objects in this table, could result in disruption of traffic on the network. The objects pwVcUpDownNotifEnable and pwVcNotifRate control the reports from the network element to the EMS. Unauthorized access to these objects could result in disruption of configuration and status change reporting, resulting mis-view of the network conditions. 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. 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 pwVcTable, pwVcPerfCurrentTable, pwVcPerfIntervalTable, pwVcPerfTotalTable, pwVcIndexMappingTable and pwVcPeerMappingTable collectively show the pseudo wire connectivity topology and its performance characteristics. 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 Zelig et al Expires July 2004 [page 38] Pseudo Wire (PW) Management January 2004 Information Base 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 IANA considerations As requested in the PW TC MIB [PWTCMIB], PWE3 related standards track MIB modules should be rooted under the pwStdMIB subtree. The IANA is requested to assign { pwStdMIB 2 } to the PW MIB module specified in this document. 10 References 10.1 Normative references [PWARCH] Bryant et al, ôPWE3 Architectureö, work-in-progress. [PWREQ] Xiao et al, "Requirements for Pseudo Wire Emulation Edge-to-Edge (PWE3)", work-in-progress. [L2TPv3] Townsley, et al., "Layer Two Tunneling Protocol (Version 3) "L2TPv3"", work-in-progress [PWCNTRL] Martini et al, "Pseudowire Setup and Maintenance using LDP", work-in-progress. [PWFRAG] Malis, A. et al, ôPWE3 Fragmentation and Reassemblyö, work-in-progress. [PWTC] Nadeau, T., et al, "Definitions for Textual Conventions and OBJECT-IDENTITIES for Pseudo-Wires Management", work-in-progress [PWMPLSMIB] Zelig,D., et al, ôPseudo Wire (PW) Over MPLS PSN Management Information Baseö, work-in-progress. [Assigned] Reynolds, J., and J. Postel, "Assigned Numbers", RFC 1700, October 1994. See also: http://www.isi.edu/in- notes/iana/assignments/smi-numbers [IANAFamily] Internet Assigned Numbers Authority (IANA), ADDRESS FAMILY NUMBERS,(http://www.isi.edu/in- notes/iana/assignements/address-family-numbers), for MIB see: ftp://ftp.isi.edu/mib/ianaaddressfamilynumbers.mib [IFMIB] McCloghrie, K., and F. Kastenholtz, "The Interfaces Group MIB using SMIv2", RFC 2863, June 2000. Zelig et al Expires July 2004 [page 39] Pseudo Wire (PW) Management January 2004 Information Base [RFC2434] Narten, T. and H. Alvestrand, "Guidelines for Writing an IANA Considerations Section in RFCs", BCP: 26, RFC 2434, October 1998. [BCP14] Bradner, S., "Key words for use in RFCs to Indicate requirement Levels", BCP 14, RFC 2119, March 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. [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. 10.2 Informative references [RFC3410] Case, J., Mundy, R., Partain, D. and B. Stewart, Introduction and Applicability Statements for Internet- Standard Management Framework", RFC 3410, December 2002. 11 Author's 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. 250 Apollo Drive Chelmsford, MA 01824 Email: tnadeau@cisco.com Dave Danenberg Litchfield Communications, Inc. 76 Westbury Park Rd Princeton Building East Watertown, CT 06795 Email: dave_danenberg@litchfieldcomm.com Zelig et al Expires July 2004 [page 40] Pseudo Wire (PW) Management January 2004 Information Base Sharon Mantin AxONLink (Israel) Ltd 9 Bareket St. Petah Tikva 49517, Israel Phone: +972-3-9263972 Email: sharon.mantin@axonlink.com 12 Full Copyright Statement Copyright (C) The Internet Society (2000). All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS 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. 13 Intellectual Property Notice The IETF takes no position regarding the validity or scope of any intellectual property 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; neither does it represent that it has made any effort to identify any such rights. Information on the IETF's procedures with respect to rights in standards-track and standards-related documentation can be found in BCP-11 [RFC2028]. Copies of claims of rights made available for publication 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 implementors or users of this specification can be obtained from the IETF Secretariat. Zelig et al Expires July 2004 [page 41] Pseudo Wire (PW) Management January 2004 Information Base 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 practice this standard. Please address the information to the IETF Executive Director. Zelig et al Expires July 2004 [page 42]