CISCO-IETF-VPLS-GENERIC-MIB

All MIBs › CISCO-IETF-VPLS-GENERIC-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2007-10-22

Category: Cisco Devices, MPLS and Traffic Engineering, VPN and Security

Description: Implements the IETF generic VPLS MIB for Virtual Private LAN Service instance management.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) 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.

What Is CISCO-IETF-VPLS-GENERIC-MIB?

CISCO-IETF-VPLS-GENERIC-MIB is a Cisco Systems proprietary MIB (based on an IETF VPLS MIB Internet-Draft) providing generic managed-object definitions for Virtual Private LAN Service over any underlying pseudowire network (LDP- or BGP-signaled). Its configuration table records VPLS instance name/description, admin status, MAC learning/aging and discard-unknown-destination flags, forwarding-table high/low watermarks, MTU, VPN ID, service type, and storage type, while a status table reports operational status and peer count, and a pseudowire-binding table associates PWs with VPLS instances. As a configuration/status MIB it lets an administrator confirm a VPLS instance's operational status and peer count. It is deployed on Cisco routers offering VPLS services. Engineers can download the CISCO-IETF-VPLS-GENERIC-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-IETF-VPLS-GENERIC-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

Cisco routers (VPLS services)

Monitoring Examples

An administrator checks cvplsStatusOperStatus and cvplsStatusPeerCount to confirm a VPLS instance has established the expected number of pseudowire peers on a Cisco provider-edge router.

What Can Be Monitored

VPLS instance operational status and pseudowire peer count

Imported Objects

From CISCO-IETF-PW-TC-MIB

CpwVcIndexType

From CISCO-SMI

ciscoExperiment

OBJECT-IDENTITY

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Counter32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

RowStatus
StorageType
TruthValue

From VPN-TC-STD-MIB

VPNIdOrZero

How to Use in IPNetwork Monitor

Example using cvplsStatusPeerCount OID:

Select a Cisco router (VPLS services) as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type cvplsStatusPeerCount into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. This object specifies the number of peers present in this vpls instance. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
cvplsGenericMIB	1.3.6.1.4.1.9.10.138			This MIB module contains generic managed object definitions for Virtual Private LAN Services as in [L2VPN-VPLS-LDP] and [L2VPN-VPLS-BGP] This MIB module enables the use of any underlying Pseudo Wire network. This MIB is based on the following IETF document. http://www.ietf.org/internet-drafts/draft-ietf-l2vpn-vpls-mib-00.txt
cvplsNotifications	1.3.6.1.4.1.9.10.138.0
NTF cvplsStatusChanged	1.3.6.1.4.1.9.10.138.0.1			The cvplsStatusChanged notification is generated when there is a change in the administrative or operating status of a VPLS service.
NTF cvplsFwdFullAlarmRaised	1.3.6.1.4.1.9.10.138.0.2			The cvplsFwdFullAlarmRaised notification is generated when the utilization of the Forwarding database is above the value specified by cvplsConfigFwdFullHighWatermark.
NTF cvplsFwdFullAlarmCleared	1.3.6.1.4.1.9.10.138.0.3			The cvplsFwdFullAlarmCleared notification is generated when the utilization of the Forwarding database is below the value specified by cvplsConfigFwdFullLowWatermark.
cvplsObjects	1.3.6.1.4.1.9.10.138.1
U32 cvplsConfigIndexNext	1.3.6.1.4.1.9.10.138.1.1	Unsigned32	read-only	This object contains an appropriate value to be used for cvplsConfigIndex when creating entries in the cvplsConfigTable. The value 0 indicates that no unassigned entries are available. To obtain the value of cvplsConfigIndex for a new entry in the cvplsConfigTable, the manager issues a management protocol retrieval operation to obtain the current value of cvplsConfigIndex. 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.
cvplsConfigTable	1.3.6.1.4.1.9.10.138.1.2		not-accessible	This table specifies information for configuring and monitoring Virtual Private Lan Services(VPLS).
cvplsConfigEntry	1.3.6.1.4.1.9.10.138.1.2.1		not-accessible	A row in this table represents a Virtual Private Lan Service(VPLS) in a packet network. It is indexed by cvplsConfigIndex, which uniquely identifies a single VPLS. A row is created by the operator or by the agent if a VPLS service is created by non-SNMP application or due to autodiscovery process. None of the read-create objects values can be changed when cvplsConfigRowStatus is in the active(1) state. Changes are allowed when the cvplsConfigRowStatus is in notInService(2) or notReady(3) states only. If the operator needs to change one of the values for an active row the cvplsConfigRowStatus 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.
U32 cvplsConfigIndex	1.3.6.1.4.1.9.10.138.1.2.1.1	Unsigned32	not-accessible	Unique index for the conceptual row identifying a VPLS service.
STR cvplsConfigName	1.3.6.1.4.1.9.10.138.1.2.1.2	SnmpAdminString	read-create	A textual name of the VPLS. If there is no local name, or this object is otherwise not applicable, then this object MUST contain a zero-length octet string.
STR cvplsConfigDescr	1.3.6.1.4.1.9.10.138.1.2.1.3	SnmpAdminString	read-create	A textual string containing information about the VPLS service. If there is no information for this VPLS service, then this object MUST contain a zero-length octet string.
INT cvplsConfigAdminStatus	1.3.6.1.4.1.9.10.138.1.2.1.4	INTEGER	read-create	The desired administrative state of the VPLS service. If the administrative status of the Vpls service is changed to enable then this service is able to utilize the pseudo wire to perform the tasks of a VPLS service. The testing(3) state indicates that no operational packets can be passed.
T/F cvplsConfigMacLearning	1.3.6.1.4.1.9.10.138.1.2.1.6	TruthValue	read-create	This object specifies if MAC Learning is enabled in this service. If this object is true then Mac Learning is enabled. If false, then Mac Learning is disabled.
T/F cvplsConfigDiscardUnknownDest	1.3.6.1.4.1.9.10.138.1.2.1.7	TruthValue	read-create	If the value of this object is 'true', then frames received with an unknown destination MAC are discarded in this VPLS. If 'false', then the packets are processed.
T/F cvplsConfigMacAging	1.3.6.1.4.1.9.10.138.1.2.1.8	TruthValue	read-create	If the value of this object is 'true' then the MAC aging process is enabled in this VPLS. If 'false', then the MAC aging process is disabled
U32 cvplsConfigFwdFullHighWatermark	1.3.6.1.4.1.9.10.138.1.2.1.10	Unsigned32	read-create	This object specifies the utilization of the forwarding database for this VPLS instance at which the cvplsFwdFullAlarmRaised notification will be sent.
U32 cvplsConfigFwdFullLowWatermark	1.3.6.1.4.1.9.10.138.1.2.1.11	Unsigned32	read-create	This object specifies the utilization of the forwarding database for this VPLS instance at which the cvplsFwdFullAlarmCleared notification will be sent.
ROW cvplsConfigRowStatus	1.3.6.1.4.1.9.10.138.1.2.1.12	RowStatus	read-create	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.
U32 cvplsConfigMtu	1.3.6.1.4.1.9.10.138.1.2.1.13	Unsigned32	read-create	The value of this object specifies the MTU of this vpls instance.
VPN cvplsConfigVpnId	1.3.6.1.4.1.9.10.138.1.2.1.14	VPNIdOrZero	read-only	This object indicates the IEEE 802-1990 VPN ID of the associated VPLS service.
INT cvplsConfigServiceType	1.3.6.1.4.1.9.10.138.1.2.1.15	INTEGER	read-create	The value of this object specifies the type of service emulated by this vpls instance.
STO cvplsConfigStorageType	1.3.6.1.4.1.9.10.138.1.2.1.16	StorageType	read-create	This variable indicates the storage type for this row.
cvplsStatusTable	1.3.6.1.4.1.9.10.138.1.3		not-accessible	This table provides information for monitoring Virtual Private Lan Services(VPLS).
cvplsStatusEntry	1.3.6.1.4.1.9.10.138.1.3.1		not-accessible	A row in this table represents a Virtual Private Lan Service(VPLS) in a packet network. It is indexed by cvplsConfigIndex, which uniquely identifies a single VPLS. A row in this table is automatically created by the agent when a VPLS service is configured.
INT cvplsStatusOperStatus	1.3.6.1.4.1.9.10.138.1.3.1.1	INTEGER	read-only	The current operational state of this VPLS Service.
C32 cvplsStatusPeerCountEx	1.3.6.1.4.1.9.10.138.1.3.1.2	Counter32	read-only	This object specifies the number of peers present in this vpls instance.
cvplsPwBindTable	1.3.6.1.4.1.9.10.138.1.4		not-accessible	This table provides an association between a VPLS service and the corresponding Pseudo Wires. A service can have more than one Pseudo Wire association. Pseudo Wires are defined in the pwTable
cvplsPwBindEntry	1.3.6.1.4.1.9.10.138.1.4.1		not-accessible	Each row represents an association between a VPLS instance and one or more Pseudo Wires defined in the pwTable. Each index is unique in describing an entry in this table. However both indexes are required to define the one to many association of service to pseudowire.
CPW cvplsPwBindIndex	1.3.6.1.4.1.9.10.138.1.4.1.1	CpwVcIndexType	not-accessible	Secondary Index for the conceptual row identifying a pseudowire within the PwEntry which MUST match an entry from the PW-STD-MIB's PwTable which represents an already-provisioned pseudowire that is then associated with this VPLS instance.
INT cvplsPwBindConfigType	1.3.6.1.4.1.9.10.138.1.4.1.2	INTEGER	read-create	The value of this object indicates whether the Pseudo Wire binding was created manually or via autodiscovery. The value of this object must be specified when the row is created and cannot be changed while the row status is active(1)
INT cvplsPwBindType	1.3.6.1.4.1.9.10.138.1.4.1.3	INTEGER	read-create	The value of this object indicates whether the Pseudo Wire binding is of type mesh or spoke. The value of this object must be specified when the row is created and cannot be changed while the row status is active(1)
ROW cvplsPwBindRowStatus	1.3.6.1.4.1.9.10.138.1.4.1.4	RowStatus	read-create	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
STO cvplsPwBindStorageType	1.3.6.1.4.1.9.10.138.1.4.1.5	StorageType	read-create	This variable indicates the storage type for this row.
T/F cvplsStatusNotifEnable	1.3.6.1.4.1.9.10.138.1.5	TruthValue	read-write	If this object is set to true(1), then it enables the emission of cvplsStatusChanged notification; otherwise this notification is not emitted.
U32 cvplsNotificationMaxRate	1.3.6.1.4.1.9.10.138.1.6	Unsigned32	read-write	This object indicates the maximum number of notifications issued per second. If events occur more rapidly, the implementation may simply fail to emit these notifications during that period, or may queue them until an appropriate time. A value of 0 means no throttling is applied and events may be notified at the rate at which they occur.
cvplsConformance	1.3.6.1.4.1.9.10.138.2
cvplsCompliances	1.3.6.1.4.1.9.10.138.2.1
cvplsModuleFullCompliance	1.3.6.1.4.1.9.10.138.2.1.1			Compliance requirement for implementations that provide full support for CISCO-IETF-VPLS-GENERIC-MIB. Such devices can then be monitored and configured using this MIB module.
cvplsModuleReadOnlyCompliance	1.3.6.1.4.1.9.10.138.2.1.2			Compliance requirement for implementations that only provide read-only support for CISCO-IETF-VPLS-GENERIC-MIB. Such devices can then be monitored but cannot be configured using this MIB modules.
cvplsGroups	1.3.6.1.4.1.9.10.138.2.2
cvplsGroup	1.3.6.1.4.1.9.10.138.2.2.1			The group of objects supporting management of L2VPN VPLS services
cvplsPwBindGroup	1.3.6.1.4.1.9.10.138.2.2.2			The group of objects supporting management of Pseudo Wire (PW) Binding to VPLS.
cvplsNotificationGroup	1.3.6.1.4.1.9.10.138.2.2.3			The group of notifications supporting the Notifications generated for VPLS Services

RFC description

MIB for Virtual Private LAN Services (VPLS) using any underlying Pseudo Wire network for L2VPN connectivity.

Start monitoring Cisco routers (VPLS services) 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 CISCO-IETF-VPLS-GENERIC-MIB