PW-MPLS-STD-MIB

All MIBs › PW-MPLS-STD-MIB

Organization: Pseudowire Emulation Edge-to-Edge (PWE3) Working Group.

Last Updated: 2009-06-12

Category: MPLS and Traffic Engineering, Pseudowire

Description: Defines managed objects for managing pseudowire (PW) operation over MPLS packet-switched networks.

IPNetwork Monitor uses several OIDs from this MIB in network discovery and polling the applicable devices. Start monitoring PW-MPLS-STD-MIB with a free 30-day trial of IPNetwork Monitor.

What Is PW-MPLS-STD-MIB?

PW-MPLS-STD-MIB is the IETF standards-track MIB (RFC-based, PWE3 working group) that complements the base PW-STD-MIB by defining managed objects specifically for pseudowire operation over MPLS packet-switched networks. It exposes configuration and status data binding each pseudowire to its MPLS transport characteristics: MPLS encapsulation type, EXP-bits handling mode, TTL, and the local/peer LDP identifiers used to signal the pseudowire's label bindings, plus an outbound-specific table for egress-direction parameters. Its monitoring value is service/software operational status -- confirming a given pseudowire is correctly bound to its MPLS label switched path and LDP session, which is essential for detecting a down or misconfigured Layer 2 VPN circuit. As stated in its own description, it explicitly depends on and complements the PW-STD-MIB (and implicitly on MPLS-LDP-related MIBs) for the base pseudowire object model. It is deployed on MPLS provider-edge routers delivering pseudowire (Layer 2 VPN, e.g. VPWS) services to enterprise customers, as defined in the PW-MPLS-STD-MIB RFC.

IPNetwork Monitor allows you to monitor SNMP objects defined in PW-MPLS-STD-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

MPLS provider-edge routers delivering pseudowire/L2VPN services

Monitoring Examples

A provider-edge router administrator would poll pwMplsTable entries (pwMplsEntry keyed the same as the base pwTable) to check pwMplsLocalLdpID and pwMplsPeerLdpID, confirming the correct LDP session pairing for a customer's pseudowire, and would inspect pwMplsTtl and pwMplsExpBitsMode/pwMplsExpBits to verify QoS marking and TTL behavior match the service design. The pwMplsOutboundTable (pwMplsOutboundEntry) would be checked separately when egress-direction MPLS parameters differ from the main binding, such as in asymmetric pseudowire configurations. A pseudowire showing an unexpected pwMplsMplsType or a mismatched LDP identifier would point to a signaling misconfiguration preventing the L2VPN circuit from coming up.

What Can Be Monitored

pseudowire-to-MPLS binding
local/peer LDP identifiers
MPLS EXP bits and TTL handling
outbound MPLS parameters
pseudowire MPLS encapsulation type

Imported Objects

From IF-MIB

InterfaceIndexOrZero

From MPLS-LSR-STD-MIB

MplsIndexType

From MPLS-TC-STD-MIB

MplsLdpIdentifier
MplsLsrIdentifier
MplsTunnelIndex
MplsTunnelInstanceIndex

From PW-STD-MIB

pwIndex

OBJECT-TYPE

From PW-TC-STD-MIB

PwIndexType

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

MODULE-IDENTITY
OBJECT-TYPE
Unsigned32
mib-2

From SNMPv2-TC

StorageType

OIDs

OID symbolic	OID numeric	Type	Access	Description
pwMplsStdMIB	1.3.6.1.2.1.181			This MIB module complements the PW-STD-MIB module for PW operation over MPLS. Copyright (c) 2009 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of Internet Society, IETF or IETF Trust, nor the names of specific contributors, may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. This version of this MIB module is part of RFC 5602; see the RFC itself for full legal notices.
pwMplsNotifications	1.3.6.1.2.1.181.0
pwMplsObjects	1.3.6.1.2.1.181.1
pwMplsTable	1.3.6.1.2.1.181.1.1		not-accessible	This table controls MPLS-specific parameters when the PW is going to be carried over MPLS PSN.
pwMplsEntry	1.3.6.1.2.1.181.1.1.1		not-accessible	A row in this table represents parameters specific to MPLS PSN for a pseudowire (PW). The row is created automatically by the local agent if the pwPsnType is mpls(1). It is indexed by pwIndex, which uniquely identifies a singular PW. Manual entries in this table SHOULD be preserved after a reboot, and the agent MUST ensure the integrity of those entries. If the set of entries of a specific row were found to be nonconsistent after reboot, the PW pwOperStatus MUST be declared as down(2). Any read-write object in this table MAY be changed at any time; however, change of some objects (for example, pwMplsMplsType) during PW forwarding state MAY cause traffic disruption.
BIT pwMplsMplsType	1.3.6.1.2.1.181.1.1.1.1	Bits	read-write	This object is set by the operator to indicate the outer tunnel types, if existing. mplsTe(0) is used if the outer tunnel is set up by MPLS-TE, and mplsNonTe(1) is used if the outer tunnel is set up by LDP or manually. A combination of mplsTe(0) and mplsNonTe(1) MAY exist. pwOnly(2) is used if there is no outer tunnel label, i.e., in static provisioning without an MPLS tunnel. pwOnly(2) cannot be combined with mplsNonTe(1) or mplsTe(0). An implementation that can identify automatically that the peer node is directly connected MAY support the bit pwOnly(2) as read-only.
INT pwMplsExpBitsMode	1.3.6.1.2.1.181.1.1.1.2	INTEGER	read-write	This object is set by the operator to determine the PW shim label EXP bits. The value of outerTunnel(1) is used where there is an outer tunnel -- pwMplsMplsType equals to mplsTe(0) or mplsNonTe(1). Note that in this case, there is no need to mark the PW label with the EXP bits, since the PW label is not visible to the intermediate nodes. If there is no outer tunnel, specifiedValue(2) SHOULD be used to indicate that the value is specified by pwMplsExpBits. Setting serviceDependant(3) indicates that the EXP bits are set based on a rule that is implementation specific.
U32 pwMplsExpBits	1.3.6.1.2.1.181.1.1.1.3	Unsigned32	read-write	This object is set by the operator if pwMplsExpBitsMode is set to specifiedValue(2) to indicate the MPLS EXP bits to be used on the PW shim label. Otherwise, it SHOULD be set to zero.
U32 pwMplsTtl	1.3.6.1.2.1.181.1.1.1.4	Unsigned32	read-write	This object is set by the operator to indicate the PW TTL value to be used on the PW shim label.
OID pwMplsLocalLdpID	1.3.6.1.2.1.181.1.1.1.5	MplsLdpIdentifier	read-write	The LDP identifier of the LDP entity that creates this PW in the local node. As the PW labels are always set from the per-platform label space, the last two octets in the LDP ID MUST always both be zeros.
U32 pwMplsLocalLdpEntityIndex	1.3.6.1.2.1.181.1.1.1.6	Unsigned32	read-write	The local node LDP Entity Index of the LDP entity creating this PW.
OID pwMplsPeerLdpID	1.3.6.1.2.1.181.1.1.1.7	MplsLdpIdentifier	read-only	The peer LDP identifier of the LDP session. This object SHOULD return the value zero if LDP is not used or if the value is not yet known.
STO pwMplsStorageType	1.3.6.1.2.1.181.1.1.1.8	StorageType	read-write	This variable indicates the storage type for this row.
pwMplsOutboundTable	1.3.6.1.2.1.181.1.2		not-accessible	This table reports and configures the current outbound MPLS tunnels (i.e., toward the PSN) or the physical interface in the case of a PW label only that carries the PW traffic. It also reports the current outer tunnel and LSP that forward the PW traffic.
pwMplsOutboundEntry	1.3.6.1.2.1.181.1.2.1		not-accessible	A row in this table configures the outer tunnel used for carrying the PW traffic toward the PSN. In the case of PW label only, it configures the interface that will carry the PW traffic. An entry in this table augments the pwMplsEntry, and is created automatically when the corresponding row has been created by the agent in the pwMplsEntry. This table points to the appropriate MPLS MIB module: In the MPLS-TE case, the three objects relevant to the indexing of a TE tunnel head-end (as used in the MPLS-TE-STD-MIB) are to be configured, and the tunnel instance indicates the LSP that is currently in use for forwarding the traffic. In the case of signaled non-TE MPLS (an outer tunnel label assigned by LDP), the table points to the XC entry in the LSR-STD-MIB. If the non-TE MPLS tunnel is manually configured, the operator configures the XC pointer to this tunnel. In the case of PW label only (no outer tunnel), the ifIndex of the port to carry the PW is configured here. It is possible to associate a PW to one TE tunnel head-end and a non-TE tunnel together. An indication in this table will report the currently active one. In addition, in the TE case, the table reports the active tunnel instance (i.e., the specific LSP in use). Any read-write object in this table MAY be changed at any time; however, change of some objects (for example, MPLS-TE indexes) during PW forwarding state MAY cause traffic disruption.
MPL pwMplsOutboundLsrXcIndex	1.3.6.1.2.1.181.1.2.1.1	MplsIndexType	read-write	This object is applicable if the pwMplsMplsType mplsNonTe(1) bit is set, and MUST return a value of zero otherwise. If the outer tunnel is signaled, the object is read-only and indicates the XC index in the MPLS-LSR-STD-MIB of the outer tunnel toward the peer. Otherwise (tunnel is set up manually), the operator defines the XC index of the manually created outer tunnel through this object.
MPL pwMplsOutboundTunnelIndex	1.3.6.1.2.1.181.1.2.1.2	MplsTunnelIndex	read-write	This object is applicable if the pwMplsMplsType mplsTe(0) bit is set, and MUST return a value of zero otherwise. It is part of the set of indexes for the outbound tunnel. The operator sets this object to represent the desired tunnel head-end toward the peer for carrying the PW traffic.
MPL pwMplsOutboundTunnelInstance	1.3.6.1.2.1.181.1.2.1.3	MplsTunnelInstanceIndex	read-only	This object is applicable if the pwMplsMplsType mplsTe(0) bit is set, and MUST return a value of zero otherwise. It indicates the actual tunnel instance that is currently active and carrying the PW traffic. It SHOULD return the value zero if the information from the MPLS-TE application is not yet known.
OID pwMplsOutboundTunnelLclLSR	1.3.6.1.2.1.181.1.2.1.4	MplsLsrIdentifier	read-write	This object is applicable if the pwMplsMplsType mplsTe(0) bit is set, and MUST return a value of all zeros otherwise. It is part of the set of indexes for the outbound tunnel. The operator sets this object to represent the desired tunnel head-end toward the peer for carrying the PW traffic.
OID pwMplsOutboundTunnelPeerLSR	1.3.6.1.2.1.181.1.2.1.5	MplsLsrIdentifier	read-write	This object is applicable if the pwMplsMplsType mplsTe(0) bit is set, and MUST return a value of zero otherwise. It is part of the set of indexes for the outbound tunnel. Note that in most cases, it equals to pwPeerAddr.
NUM pwMplsOutboundIfIndex	1.3.6.1.2.1.181.1.2.1.6	InterfaceIndexOrZero	read-write	This object is applicable if the pwMplsMplsType pwOnly(0) bit is set, and MUST return a value of zero otherwise. The operator configures the ifIndex of the outbound port in this case.
INT pwMplsOutboundTunnelTypeInUse	1.3.6.1.2.1.181.1.2.1.7	INTEGER	read-only	This object indicates the current tunnel that is carrying the PW traffic. The value of notYetKnown(1) should be used if the agent is currently unable to determine which tunnel or interface is carrying the PW, for example, because both tunnels are in operational status down.
pwMplsInboundTable	1.3.6.1.2.1.181.1.3		not-accessible	This table indicates the PW LDP XC entry in the MPLS-LSR-STD-MIB for signaled PWs.
pwMplsInboundEntry	1.3.6.1.2.1.181.1.3.1		not-accessible	A row in this table is created by the agent for each signaled PW, and shows the XC index related to the PW signaling in the inbound direction in the MPLS-LSR-STD-MIB that controls and display the information for all the LDP signaling processes in the local node.
MPL pwMplsInboundXcIndex	1.3.6.1.2.1.181.1.3.1.1	MplsIndexType	read-only	The XC index representing this PW in the inbound direction. It MUST return the value zero if the information is not yet known.
pwMplsNonTeMappingTable	1.3.6.1.2.1.181.1.4		not-accessible	This table indicates the PW association to the outbound tunnel in non-TE applications, maps the PW to its (inbound) XC entry, and indicates the PW-to-physical interface mapping for a PW without an outer tunnel.
pwMplsNonTeMappingEntry	1.3.6.1.2.1.181.1.4.1		not-accessible	A row in this table displays the association between the PW and - its non-TE MPLS outbound outer tunnel, - its XC entry in the MPLS-LSR-STD-MIB, or - its physical interface if there is no outer tunnel (PW label only) and manual configuration. Rows are created in this table by the agent depending on the setting of pwMplsMplsType: - If the pwMplsMplsType mplsNonTe(1) bit is set, the agent creates a row for the outbound direction (pwMplsNonTeMappingDirection set to psnBound(1)). The pwMplsNonTeMappingXcIndex holds the XC index in the MPLS-LSR-STD-MIB of the PSN-bound outer tunnel. pwMplsNonTeMappingIfIndex MUST be zero for this row. - If the pwMplsMplsType pwOnly(2) bit is set, the agent creates a row for the outbound direction (pwMplsNonTeMappingDirection set to psnBound(1)). The pwMplsNonTeMappingIfIndex holds the ifIndex of the physical port this PW will use in the outbound direction. pwMplsNonTeMappingXcIndex MUST be zero for this row. - If the PW has been set up by a signaling protocol (i.e., pwOwner equal pwIdFecSignaling(2) or genFecSignaling(3)), the agent creates a row for the inbound direction (pwMplsNonTeMappingDirection set to fromPsn(2)). The pwMplsNonTeMappingXcIndex holds the XC index in the MPLS-LSR-STD-MIB of the PW LDP-generated XC entry. pwMplsNonTeMappingIfIndex MUST be zero for this row. An application can use this table to quickly retrieve the PW carried over specific non-TE MPLS outer tunnel or physical interface.
INT pwMplsNonTeMappingDirection	1.3.6.1.2.1.181.1.4.1.1	INTEGER	not-accessible	Index for the conceptual XC row identifying the tunnel-to-PW mappings, indicating the direction of the packet flow for this entry. psnBound(1) indicates that the entry is related to packets toward the PSN. fromPsn(2) indicates that the entry is related to packets coming from the PSN.
MPL pwMplsNonTeMappingXcIndex	1.3.6.1.2.1.181.1.4.1.2	MplsIndexType	not-accessible	See the description clause of pwMplsNonTeMappingEntry for the usage guidelines of this object.
NUM pwMplsNonTeMappingIfIndex	1.3.6.1.2.1.181.1.4.1.3	InterfaceIndexOrZero	not-accessible	See the description clause of pwMplsNonTeMappingEntry for the usage guidelines of this object.
PWI pwMplsNonTeMappingPwIndex	1.3.6.1.2.1.181.1.4.1.4	PwIndexType	read-only	The value that represents the PW in the pwTable.
pwMplsTeMappingTable	1.3.6.1.2.1.181.1.5		not-accessible	This table reports the PW association to the outbound MPLS tunnel for MPLS-TE applications.
pwMplsTeMappingEntry	1.3.6.1.2.1.181.1.5.1		not-accessible	A row in this table represents the association between a PW and its MPLS-TE outer (head-end) tunnel. An application can use this table to quickly retrieve the list of the PWs that are configured on a specific MPLS-TE outer tunnel. The pwMplsTeMappingTunnelInstance reports the actual LSP out of the tunnel head-end that is currently forwarding the traffic. The table is indexed by the head-end indexes of a TE tunnel and the PW index.
MPL pwMplsTeMappingTunnelIndex	1.3.6.1.2.1.181.1.5.1.1	MplsTunnelIndex	not-accessible	Primary index for the conceptual row identifying the MPLS-TE tunnel that is carrying the PW traffic.
MPL pwMplsTeMappingTunnelInstance	1.3.6.1.2.1.181.1.5.1.2	MplsTunnelInstanceIndex	not-accessible	This object identifies the MPLS-TE LSP that is carrying the PW traffic. It MUST return the value zero if the information of the specific LSP is not yet known. Note that based on the recommendation in the MPLS-TC-STD-MIB, instance index 0 should refer to the configured tunnel interface.
OID pwMplsTeMappingTunnelPeerLsrID	1.3.6.1.2.1.181.1.5.1.3	MplsLsrIdentifier	not-accessible	This object identifies the peer LSR when the outer tunnel is MPLS-TE.
OID pwMplsTeMappingTunnelLocalLsrID	1.3.6.1.2.1.181.1.5.1.4	MplsLsrIdentifier	not-accessible	This object identifies the local LSR.
PWI pwMplsTeMappingPwIndex	1.3.6.1.2.1.181.1.5.1.5	PwIndexType	read-only	This object returns the value that represents the PW in the pwTable.
pwMplsConformance	1.3.6.1.2.1.181.2
pwMplsGroups	1.3.6.1.2.1.181.2.1
pwMplsGroup	1.3.6.1.2.1.181.2.1.1			Collection of objects needed for PW over MPLS PSN configuration.
pwMplsOutboundMainGroup	1.3.6.1.2.1.181.2.1.2			Collection of objects needed for outbound association of PW and MPLS tunnel.
pwMplsOutboundTeGroup	1.3.6.1.2.1.181.2.1.3			Collection of objects needed for outbound association of PW and MPLS-TE tunnel.
pwMplsInboundGroup	1.3.6.1.2.1.181.2.1.4			Collection of objects needed for inbound PW presentation. This group MUST be supported if PW signaling through LDP is used.
pwMplsMappingGroup	1.3.6.1.2.1.181.2.1.5			Collection of objects needed for mapping association of PW and MPLS tunnel.
pwMplsCompliances	1.3.6.1.2.1.181.2.2
pwMplsModuleFullCompliance	1.3.6.1.2.1.181.2.2.1			The compliance statement for agents that provide full support for the PW-MPLS-STD-MIB module. Such devices can then be monitored and also be configured using this MIB module.
pwMplsModuleReadOnlyCompliance	1.3.6.1.2.1.181.2.2.2			The compliance statement for agents that provide read- only support for the PW-MPLS-STD-MIB module. Such devices can then be monitored but cannot be configured using this MIB module.

RFC description

Pseudowire MPLS standard MIB for MPLS tunnel-based pseudo-wire operation and management.

Start monitoring MPLS provider-edge routers with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download PW-MPLS-STD-MIB

What Is PW-MPLS-STD-MIB?

Supported Devices

Monitoring Examples

What Can Be Monitored

This MIB depends on

Related MIBs

RFC description