PW-DRAFT05-MIB: View SNMP OID List / Download MIB

This MIB module contains managed object definitions for Pseudo Wire operation as in: Bryant., et al, 'PWE3 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

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.

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.

This notification is generated when the PW has been deleted, i.e. when the pwVcRowStatus has been set to destroy(6), the PW has been deleted by a non-MIB application or due to auto discovery process.

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.

This table specifies information for configuring and status monitoring which are common to all service types and PSN types.

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. A row is created by the operator or by the agent if the PW is created by non-SNMP application or due to autodiscovery process. None of the read-create objects values can be changed when pwVcRowStatus is in the active(1) state. Changes are allowed when the pwRowStatus is in notInService(2) or notReady(3) states only. If the operator need to change one of the values for an active row (for example in order to fix a mismatch in configuration between the local node and the peer), the pwVcRowStatus should be first changed to notInService(2), the objects may be changed now, and later to active(1) in order to re-initiate the signaling process with the new values in effect.

Index for the conceptual row identifying a PW within this PW Emulation table.

This value indicate the service to be carried over this PW.

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. Enumeration: 'pwIdFecSignaling': 2, 'genFecSignaling': 3, 'manual': 1, 'other': 5, 'l2tpControlProtocol': 4.

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. Enumeration: 'ip': 3, 'mplsOverIp': 4, 'mpls': 1, 'other': 6, 'l2tp': 2, 'gre': 5.

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.

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 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.

Denotes the address type of the peer node. It should be set to 'unknown' if PE/PW maintenance protocol is not used and the address is unknown.

This object contain the value of the peer node address of the PW/PE maintenance protocol entity. This object SHOULD contain a value of all zeroes if not applicable (pwVcPeerAddrType is 'unknown').

If the PW is attached to another PW instead of a local native service, this item indicates the pwVcIndex of the attached PW, and the PW specific entry in the service MIB module MUST not be created. Otherwise, this object MUST be set to zero.

If the PW is represented in the ifTable as an ifIndex, this item holds the ifIndex of the PW in the ifTable, otherwise it MUST be set to zero.

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.

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.

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.

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.

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. Applicable if pwVcOwner equal 'genFecSignaling'. Should be set to NULL (zero length) if not applicable.

Defines 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.

If not equal zero, the optional IfMtu object in the signaling protocol will be sent with this value, representing the locally supported MTU size over the interface (or the virtual interface) associated with the PW.

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.

Indicates the capabilities to be advertised by this node to the peer.

Obtained from the Group ID field as received via the signaling 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.

If signaling is used for PW establishment, this object indicates the status of the control word negotiation, and in both signaling or manual configuration indicates if CW is to be present or not for this PW.

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.

Indicates the interface description string as received by the maintenance protocol, MUST be NULL string if not applicable or not known yet.

Indicates the capabilities as advertised by the peer.

If set to value other than zero, indicates that fragmentation is desired for this PW.

The status of the fragmentation based on the local configuration and the peer capabilities as advertised by the peer if control protocol is used.

The local configuration of FCS retention for this PW. FCS retention can be configured for PW types HDLC, PPP and Ethernet only. If the agent does not support FCS retention the error should be configured in pwVcFcsRetentionStatus. Enumeration: 'fcsRetentionEnable': 2, 'fcsRetentionDisable': 1.

The status of the FCS retention negotiation process based on local configuration and the remote advertisement. remoteIndicationUnknown - set if a FEC has not been received from the remote. remoteRequestFcsRetention - indicates that the peer has requested for FCS retention. FCS retention will be used if the local node is capable and configured to use it for this PW. fcsRetentionEnabled - FCS retention is enabled (both peers were configured for FCS retention for signaled PW, or the local node is configured and capable for FCS retention. fcsRetentionDisabled - FCS retention is disabled (not configured locally or not advertised by the peer). localFcsRetentionCfgErr - Set if the local node has been configured for FCS retention but is not capable to support it. fcsRetentionFcsSizeMismatch - Set if there is a FCS size mismatch between the loacl and the peer node. Bits: 'fcsRetentionFcsSizeMismatch': 5, 'remoteRequestFcsRetention': 1, 'localFcsRetentionCfgErr': 4, 'fcsRetentionEnabled': 2, 'remoteIndicationUnknown': 0, 'fcsRetentionDisabled': 3.

The PW label used in the outbound direction (i.e. toward 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.

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.

The canonical name assigned to the PW.

A textual string containing information about the PW. If there is no description this object contains a zero length string.

System time when this PW was created.

Specifies the total time this PW operStatus has been Up(1).

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.

The desired operational status of this PW. Enumeration: 'down': 2, 'testing': 3, 'up': 1.

This object indicates 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 are set in pwVcLocalStatus or pwVcRemoteStatus. It indicates 'lowerLayerDown' if the only reason for not being in the 'up' state is either outer tunnel or physical layer down of the network side is in the down state. All other states are declared base on the description in the textual convention.

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.

Indicates 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. Enumeration: 'notYetKnown': 2, 'notApplicable': 1, 'remoteCapable': 3, 'remoteNotCapable': 4.

Indicates 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.

The number of seconds, including partial seconds, that have elapsed since the beginning of the current interval measurement period.

The number of previous 15-minute intervals for which data was collected.

For creating, modifying, and deleting this row. None of the read-create objects in the conceptual rows may be changed when this object is in the active(1) state.

This variable indicates the storage type for this object.

This table provides per-PW performance information for the current interval.

An entry in this table is created by the agent for every PW.

High capacity counter for number of packets received by the PW (from the PSN) in the current 15-minute interval. This is the 64 bit version of pwVcPerfCurrentInPackets, if pwVcPerfCurrentInHCPackets is supported according to the rules spelled out in RFC2863.

High capacity counter for number of bytes received by the PW (from the PSN) in the current 15-minute interval. This is the 64 bit version of pwVcPerfCurrentInBytes, if pwVcPerfCurrentInHCBytes is supported according to the rules spelled out in RFC2863.

High capacity counter for number of packets forwarded by the PW (to the PSN) in the current 15-minute interval. This is the 64 bit version of pwVcPerfCurrentOutPackets, if pwVcPerfCurrentOutHCPackets is supported according to the rules spelled out in RFC2863.

High capacity counter for number of bytes forwarded by the PW (to the PSN) in the current 15-minute interval. This is the 64 bit version of pwVcPerfCurrentOutBytes, if pwVcPerfCurrentOutHCBytes is supported according to the rules spelled out in RFC2863.

The counter for number of packets received by the PW (from the PSN) in the current 15-minute interval. This is the 32 bit version of pwVcPerfCurrentInHCPackets, if pwVcPerfCurrentInHCPackets is supported according to the rules spelled out in RFC2863.

The counter for number of bytes received by the PW (from the PSN) in the current 15-minute interval. It MUST be equal to the least significant 32 bits of pwVcPerfCurrentInHCBytes, if pwVcPerfCurrentInHCBytes is supported according to the rules spelled out in RFC2863.

The counter for number of packets forwarded by the PW (to the PSN) in the current 15-minute interval. It MUST be equal to the least significant 32 bits of pwVcPerfCurrentOutHCPackets, if pwVcPerfCurrentOutHCPackets is supported according to the rules spelled out in RFC2863.

The counter for number of bytes forwarded by the PW (to the PSN) in the current 15-minute interval. It MUST be equal to the least significant 32 bits of pwVcPerfCurrentOutHCBytes, if pwVcPerfCurrentOutHCBytes is supported according to the rules spelled out in RFC2863.

This table provides per-PW performance information for each interval.

An entry in this table is created agent for every PW.

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.

This variable indicates if the data for this interval is valid.

The duration of this interval in seconds.

High capacity counter for number of packets received by the PW (from the PSN) during the interval. This is the 64 bit version of pwVcPerfIntervalInPackets, if pwVcPerfIntervalInHCPackets is supported according to the rules spelled out in RFC2863.

High capacity counter for number of bytes received by the PW (from the PSN) during the interval. This is the 64 bit version of pwVcPerfIntervalInBytes, if pwVcPerfIntervalInHCBytes is supported according to the rules spelled out in RFC2863.

High capacity counter for number of packets forwarded by the PW (to the PSN) during the interval. This is the 64 bit version of pwVcPerfIntervalOutPackets, if pwVcPerfIntervalOutHCPackets is supported according to the rules spelled out in RFC2863.

High capacity counter for number of bytes forwarded by the PW (to the PSN) during the interval. This is the 64 bit version of pwVcPerfIntervalOutBytes, if pwVcPerfIntervalOutHCBytes is supported according to the rules spelled out in RFC2863.

This value represents the number of packets received by this PW during the interval. It MUST be equal to the least significant 32 bits of pwVcPerfIntervalInHCPackets if pwVcPerfIntervalInHCPackets is supported according to the rules spelled out in RFC2863.

This value represents the number of bytes received by this PW during the interval. It MUST be equal to the least significant 32 bits of if pwVcPerfIntervalInHCBytes is supported according to the rules spelled out in RFC2863.

This value represents the number of packets sent by this PW during the interval. It MUST be equal to the least significant 32 bits of pwVcPerfIntervalOutHCPackets if pwVcPerfIntervalOutHCPackets is supported according to the rules spelled out in RFC2863.

This value represents the number of bytes sent by this PW during the interval. It MUST be equal to the least significant 32 bits of pwVcPerfIntervalOutHCBytes if pwVcPerfIntervalOutHCBytes is supported according to the rules spelled out in RFC2863.

This table provides per-PW Performance information from PW start time or management application reset.

An entry in this table is created by the agent for every PW. pwVcPerfTotalDiscontinuityTime indicates the time of the last discontinuity in any of these objects.

High capacity counter for the total number of packets received by the PW (from the PSN). This is the 64 bit version of pwVcPerfTotalInPackets, if pwVcPerfTotalInHCPackets is supported according to the rules spelled out in RFC2863.

High capacity counter for the total number of bytes received by the PW (from the PSN). This is the 64 bit version of pwVcPerfTotalInBytes, if pwVcPerfTotalInHCBytes is supported according to the rules spelled out in RFC2863.

High capacity counter for the total number of packets forwarded by the PW (to the PSN). This is the 64 bit version of pwVcPerfTotalOutPackets, if pwVcPerfTotalOutHCPackets is supported according to the rules spelled out in RFC2863.

High capacity counter for the total number of bytes forwarded by the PW (to the PSN). This is the 64 bit version of pwVcPerfTotalOutBytes, if pwVcPerfTotalOutHCBytes is supported according to the rules spelled out in RFC2863.

This value represents the total number of packets received by this PW. It MUST be equal to the least significant 32 bits of pwVcPerfTotalInHCPackets if pwVcPerfTotalInHCPackets is supported according to the rules spelled out in RFC2863.

This value represents the total number of bytes received by this PW. It MUST be equal to the least significant 32 bits of if pwVcPerfTotalInHCBytes is supported according to the rules spelled out in RFC2863.

This value represents the total number of packets sent by this PW. It MUST be equal to the least significant 32 bits of pwVcPerfTotalOutHCPackets if pwVcPerfTotalOutHCPackets is supported according to the rules spelled out in RFC2863.

This value represents the total number of bytes sent by this PW. It MUST be equal to the least significant 32 bits of pwVcPerfTotalOutHCBytes if pwVcPerfTotalOutHCBytes is supported according to the rules spelled out in RFC2863.

The value of sysUpTime on the most recent occasion at which any one or more of this row Counter32 or 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.

Counter for number of error at the PW processing level, for example packets received with unknown PW label.

This table enables the reverse mapping the unique PWid parameters and the pwVcIndex. The table is not applicable for PW created manually or by using the generalized FEC.

An entry in this table MUST be created by the agent for every PW created by the pwVcTable for which pwVcOwner equals aepwIdFecSignaling.

The PW type (indicates the service) of this PW.

The PW ID of this PW. Zero if the PW is configured manually.

IP address type of the peer node.

IP address type of the peer node.

The value that represents the PW in the pwVcTable.

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.

An entry in this table is created by the agent for every PW configured in pwVcTable.

IP address type of the peer node.

IP address type of the peer node.

The PW type (indicates the service) of this PW.

The PW ID of this PW. Zero if the PW is configured manually.

The value that represents the PW in the pwVcTable.

If this object is set to true(1), then it enables the emission of pwVcUp and pwVcDown notifications; otherwise these notifications are not emitted.

If this object is set to true(1), then it enables the emission of pwVcDeleted notification; otherwise this notification is not emitted.

This object defines the maximum number of PW notifications that can be emitted from the device per second.

Collection of objects that are required in all implementations that support the PW MIB module.

Collection of objects required for PW ID configuration and signaling.

Collection of objects required for generalized FEC configuration and signaling.

Collection of objects required for FCS retention configuration and signaling.

Collection of objects required for fragmentation configuration and signaling.

Collection of objects required for PW status configuration and signaling.

Collection of objects for getting the next available index.

Collection of objects for controlling the PW setup and holding priority.

Collection of objects for PW configuration and signaling.

Collection of general objects needed for managing the total running performance parameters.

Collection of 32 bits objects needed for PW running total performance collection.

Collection of HC objects needed for PW running total performance collection.

Collection of general objects needed for managing the interval performance parameters.

Collection of 32 bits objects needed for PW performance collection in 15 minutes intervals.

Collection of HC objects needed for PW performance collection in 15 minutes intervals.

Collection of objects contained in the reverse mapping tables.

Collection of objects for controlling the PW notifications.

Collection PW notifications objects.

The compliance statement for agents that provide full support for PW MIB Module. Such devices can then be monitored and also be configured using this MIB module.

The compliance statement for agents that provide read only support for PW MIB Module. Such devices can then be monitored but cannot be configured using this MIB module.