CISCO-VIRTUAL-NW-IF-MIB

All MIBs › CISCO-VIRTUAL-NW-IF-MIB

Organization: Cisco Systems Inc.

Last Updated: 2002-10-02

Category: Cisco Devices, Network Interfaces

Description: Manages virtual network interface configuration and statistics for overlay and virtualized network environments on Cisco.

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-VIRTUAL-NW-IF-MIB?

CISCO-VIRTUAL-NW-IF-MIB is a Cisco enterprise MIB for managing virtual network interfaces that map to VSAN (virtual storage area network) and VLAN constructs on Cisco storage networking and switching platforms. It exposes a virtual interface table capturing interface type, identifier, index, Fibre Channel ID association, operational status, and status-cause descriptions, along with configuration, statistics, and notification object groups. Administrators use it to monitor the hardware/software operational status of virtual interfaces, primarily whether a virtual interface is up, down, or in a fault state, and to read the operational-status-cause text explaining why an interface went down. Its object naming and VSAN/Fibre Channel references suggest dependency on Cisco's Fibre Channel and VSAN MIB conventions and general SNMPv2 conformance frameworks. It is typically deployed on Cisco MDS/Nexus storage switches and multilayer director platforms that virtualize network interfaces across VSAN and VLAN boundaries. Engineers can download the CISCO-VIRTUAL-NW-IF-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-VIRTUAL-NW-IF-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 MDS storage switches
Cisco Nexus/virtualized switching platforms

Monitoring Examples

An operator would poll virtualNwIfTable/virtualNwIfEntry, keyed by virtualNwIfIndex, to check virtualNwIfOperStatusCause and virtualNwIfOperStatusCauseDescr for a given virtualNwIfId; a non-zero cause code combined with a descriptive string like a link failure would flag a virtual interface outage. The virtualNwIfFcId field lets the admin correlate the virtual interface to its underlying Fibre Channel ID for VSAN troubleshooting. Provisioning changes are tracked via virtualNwIfRowStatus, and ciscoVirtualNwIfObjects/virtualNwIfNotifications provide traps when interface state changes occur.

What Can Be Monitored

virtual interface operational status
operational status cause/description
VSAN/Fibre Channel ID mapping
interface type and index
row/provisioning status
interface state-change notifications

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From CISCO-ST-TC

FcAddressId

From ENTITY-MIB

entPhysicalIndex

OBJECT-TYPE

From IF-MIB

InterfaceIndex
ifName	OBJECT-TYPE

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

RowStatus

How to Use in IPNetwork Monitor

Example using virtualNwIfOperStatusCause OID:

Select a Cisco MDS storage switches / Nexus virtualized switching platform 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 virtualNwIfOperStatusCause 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. The cause of current operational state of the interface. 'none(1)' - no failure. 'adminDown(2)' - 'ifAdminStatus' is down(2). 'vsanNotOperational(3) - VSAN not operational. 'noFcid(4)' - failed to get an FCID. 'kernelConfFailure(5)' - failed to configure the network device. 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 an INTEGER-type OID, Value bounds is the most useful condition here — trigger an alert if the value is anything other than 'none', since that indicates the condition this object reports has changed to one worth investigating. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoVirtualNwIfMIB	1.3.6.1.4.1.9.9.290			The MIB module for management of virtual network interfaces to VSAN and VLAN.
ciscoVirtualNwIfObjects	1.3.6.1.4.1.9.9.290.1
virtualNwIfConfig	1.3.6.1.4.1.9.9.290.1.1
virtualNwIfTable	1.3.6.1.4.1.9.9.290.1.1.1		not-accessible	This table contains one entry for each local virtual interface to a VSAN or VLAN, at most one such interface per processor on a Supervisor or Line card managed by the agent. Each such processor will have an entry in the entPhysicalTable ( from ENTITY-MIB ) and will have a unique PhysicalIndex. For e.g. if Line card has 2 processors on it then each processor will have a entry in the entPhysicaltable and each will have unique PhysicalIndex. It is possible that there can be multiple VSAN's or VLAN's per processor, but the network manager can create only one virtual interface for a VSAN and only one for a VLAN per physical entity i.e. per processor on the card. Note:Processor is represented as a physical entity in the entPhysicalTable. Each such interface has a unique ifIndex assigned by the agent. When requested to create an entry in this table, the agent also creates a corresponding entry in the ifTable of IF-MIB and also an entry in the cieIfInterfaceTable of CISCO-IF-EXTENSION-MIB. Next, the agent fills in the values of virtualNwIfIndex, after which the creation of the entry in this table completes. The ciiIPIfAddressTable of CISCO-IP-IF-MIB can be used to configure the IP addresses. The ifTable and this table can be used to monitor the interface. Entries in this table are created by network managers. But the entries can be deleted either by the network managers or will be deleted by the agent if the corresponding VSAN or VLAN is deleted. An entry will be allowed to be created only if the corresponding VSAN or VLAN has been created. The ifType for an created interface of type 'vsan(1)' will be 'fibreChannel(56)' and of type 'vlan(2)' would be 'ethernetCsmacd(6)'.
virtualNwIfEntry	1.3.6.1.4.1.9.9.290.1.1.1.1		not-accessible	Each entry provides information on a local virtual interface for a VSAN or VLAN.
INT virtualNwIfType	1.3.6.1.4.1.9.9.290.1.1.1.1.1	INTEGER	not-accessible	If the virtualNwIfType is vsan(1) and if the corresponding virtual interface is enabled ( ifAdminStatus='up' ), then the operational state of virtual interface will become active ( ifOperStatus='up' ) only if the VSAN state is active and a FCID is obtained through a successful FLOGI. Even if the desired state of the virtual interface is enabled ( ifAdminStatus='up' ), but if the VSAN state is non-active or FCID has not been obtained, then the virtual interface is disabled(ifOperStatus='down'). Only when the VSAN state becomes active and an FCID is obtained will the virtual interface be enabled ( ifOperStatus='up' ). An interface can be disabled while its VSAN exists by setting ifAdminStatus='down'. When an VSAN is deleted, the corresponding interface ( if created ) is also deleted. If the virtualNwIfType is vlan(2) and if the corresponding virtual interface is enabled ( ifAdminStatus='up' ) , then the virtual interface will become active ( ifOperStatus='up' ) only if the VLAN state is active. Even if the desired state of the virtual interface is enabled(ifAdminStatus='up'), but if the VLAN state is non-active, then the virtual interface is disabled ( ifOperStatus='down' ) . Only when the VLAN state becomes active will the virtual interface be enabled ( ifOperStatus='up' ). An interface can be disabled while its VLAN exists by setting ifAdminStatus='down'. When an VLAN is deleted, the corresponding interface ( if created ) is also deleted.
U32 virtualNwIfId	1.3.6.1.4.1.9.9.290.1.1.1.1.2	Unsigned32	not-accessible	The id of VSAN or VLAN, according to the value of virtualNwIfType.
NUM virtualNwIfIndex	1.3.6.1.4.1.9.9.290.1.1.1.1.3	InterfaceIndex	read-only	The ifIndex of this interface. This value is dynamically assigned by the agent. It is valid whenever the value of the corresponding virtualNwIfRowStatus is 'active'. The ifType of interface of type vsan(1) will be 'fibreChannel(56)' and of type 'vlan(2)' would be 'ethernetCsmacd(6)'.
ADR virtualNwIfFcId	1.3.6.1.4.1.9.9.290.1.1.1.1.4	FcAddressId	read-only	The Fibre Channel Identifier(FC-ID) of this interface. This object is relevant to interfaces with 'virtualNwIfType' of vsan(1) only.
INT virtualNwIfOperStatusCauseEx	1.3.6.1.4.1.9.9.290.1.1.1.1.5	INTEGER	read-only	The cause of current operational state of the interface. 'none(1)' - no failure. 'adminDown(2)' - 'ifAdminStatus' is down(2). 'vsanNotOperational(3) - VSAN not operational. 'noFcid(4)' - failed to get an FCID. 'kernelConfFailure(5)' - failed to configure the network device. The current operational state of the interface is shown by the 'ifOperStatus' defined in rfc2863. This object will show 'none(1)' for all the 'ifOperStatus' values except for 'down(2)'. It will show one of the values defined above if 'ifOperStatus' is 'down(2)'.
STR virtualNwIfOperStatusCauseDescr	1.3.6.1.4.1.9.9.290.1.1.1.1.6	SnmpAdminString	read-only	The description for the cause of current operational state of the interface, shown by the object 'virtualNwIfOperStatusCause'.
ROW virtualNwIfRowStatus	1.3.6.1.4.1.9.9.290.1.1.1.1.7	RowStatus	read-create	The status of this conceptual row.
virtualNwIfStatistics	1.3.6.1.4.1.9.9.290.1.2
virtualNwIfNotification	1.3.6.1.4.1.9.9.290.1.3
virtualNwIfNotifications	1.3.6.1.4.1.9.9.290.1.3.0
NTF virtualNwIfCreateEntryNotify	1.3.6.1.4.1.9.9.290.1.3.0.1			This notification is generated by the agent whenever an virtual interface is created in the, 'virtualNwIfTable'. Note that this notification is generated only when a new entry is added to the table and not for any modifications to an existing entry.
NTF virtualNwIfDeleteEntryNotify	1.3.6.1.4.1.9.9.290.1.3.0.2			This notification is generated by the agent whenever an virtual interface is deleted from the 'virtualNwIfTable'.
virtualNwIfMIBConformance	1.3.6.1.4.1.9.9.290.2
virtualNwIfMIBCompliances	1.3.6.1.4.1.9.9.290.2.1
virtualNwIfMIBCompliance	1.3.6.1.4.1.9.9.290.2.1.1			The compliance statement for entities which implement the CISCO-VIRTUAL-NW-IF-MIB mib.
virtualNwIfMIBGroups	1.3.6.1.4.1.9.9.290.2.2
virtualNwIfGroup	1.3.6.1.4.1.9.9.290.2.2.1			A collection of objects related to virtual interface parameters.
virtualNwIfNotificationGroup	1.3.6.1.4.1.9.9.290.2.2.2			A collection of notifications for monitoring virtual interfaces.

RFC description

Cisco virtual network interface management for VSAN and VLAN configuration.

Start monitoring Cisco MDS storage switches / Nexus virtualized switching platforms 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-VIRTUAL-NW-IF-MIB