CISCO-VIRTUAL-NIC-MIB

File: CISCO-VIRTUAL-NIC-MIB.mib (21272 bytes)

Imported modules

SNMPv2-SMI SNMPv2-CONF SNMPv2-TC
IF-MIB SNMP-FRAMEWORK-MIB INET-ADDRESS-MIB
CISCO-SMI

Imported symbols

MODULE-IDENTITY OBJECT-TYPE Unsigned32
Integer32 OBJECT-GROUP MODULE-COMPLIANCE
MacAddress InterfaceIndex SnmpAdminString
InetAddressType InetAddress ciscoMgmt

Defined Types

CvnVethIfEntry  
SEQUENCE    
  cvnVethInterface InterfaceIndex
  cvnVethAdapter SnmpAdminString
  cvnVethOwner SnmpAdminString
  cvnVethHostID Unsigned32
  cvnVethHostAddrType InetAddressType
  cvnVethHostAddr InetAddress
  cvnVethPortProfileUsed SnmpAdminString
  cvnVethIfProfileAlias SnmpAdminString
  cvnVethIfAdditionalState INTEGER
  cvnVethStateReason SnmpAdminString

CvnPinningEntry  
SEQUENCE    
  cvnPinnedSubGrpId Integer32

CvnConnecteeEntry  
SEQUENCE    
  cvnConnecteeAttachType INTEGER
  cvnDVSPort Unsigned32
  cvnConnecteeName SnmpAdminString
  cvnConnecteeUuid SnmpAdminString
  cvnConnecteeType INTEGER
  cvnConnecteeMac MacAddress
  cvnConnecteeDeviceName SnmpAdminString
  cvnConnecteeDeviceType INTEGER

Defined Values

ciscoVirtualNicMIB 1.3.6.1.4.1.9.9.710
This MIB module defines MIB objects which provide mechanisms to manage the parameters used by or related to Virtual NIC. Virtual switch extends across one or more virtualization servers which host the VM instances. Each virtualization server is represented as a line card module and is assigned to a unique slot in the virtual chassis. All the ports on the virtual switch which can be hooked up to VM VNICs or to special hypervisor ports (e.g. vmk or vswif ports) are represented as virtual ethernet interfaces. Virtual ethernet interfaces(veths) represent the switching ports on the virtual switch which provide networking connectivity to virtual packet based interfaces such as the Virtual NIC (VNIC) interfaces defined on a Virtual Machine (VM). These interfaces are configurable and provide operational information to the network administrator. The assignment of virtual ethernet interface ports to a VM does not change when the VM is migrated. Glossary: APC - Asymmetric Port Channel DVS - Distributed Virtual switch NIC - Network Interface Card NIV - Network interface virtualization PCI - Peripheral Component Interconnect VEM - Virtual Ethernet Module VNIC - Virtual Network Interface Card VSM - Virtual Supervisor Module VM - Virtual Machine VMK - Virtual Machine Kernel VMKNIC - Virtual Machine Kernel Network Interface Card VSWIF - a virtual management port on hosts running VMware ESX. UUID - Universally Unique identifier connectee - Entity connected to a system using veth. eg: Virtual machine System Diagram : ************** * VSM * ************** ' ' ' ' ' ' ' ' ******** ******** * VEM * * VEM * ******** ******** ' ' ' ' ' ' ****** ****** ****** * VM * * VM * * VM * ****** ****** ******
MODULE-IDENTITY    

ciscoVirtualNicMIBNotifs 1.3.6.1.4.1.9.9.710.0
OBJECT IDENTIFIER    

ciscoVirtualNicMIBObjects 1.3.6.1.4.1.9.9.710.1
OBJECT IDENTIFIER    

ciscoVirtualNicMIBConformance 1.3.6.1.4.1.9.9.710.2
OBJECT IDENTIFIER    

cvnInterfaceObjects 1.3.6.1.4.1.9.9.710.1.1
OBJECT IDENTIFIER    

cvnConnecteeObjects 1.3.6.1.4.1.9.9.710.1.2
OBJECT IDENTIFIER    

cvnVethIfTable 1.3.6.1.4.1.9.9.710.1.1.1
A list of virtual ethernet interfaces managed by VSM.
OBJECT-TYPE    
  SEQUENCE OF  
    CvnVethIfEntry

cvnVethIfEntry 1.3.6.1.4.1.9.9.710.1.1.1.1
An entry containing management information for a particular virtual ethernet interface. Entries are created by the system when virtual Ethernet interfaces are registered to VSM. Entries are removed when virtual Ethernet interfaces are removed from VSM.
OBJECT-TYPE    
  CvnVethIfEntry  

cvnVethInterface 1.3.6.1.4.1.9.9.710.1.1.1.1.1
The value of ifIndex for the virtual ethernet interface.
OBJECT-TYPE    
  InterfaceIndex  

cvnVethAdapter 1.3.6.1.4.1.9.9.710.1.1.1.1.2
This object indicates the network adapter used by virtual ethernet interface port. This object contains the Network Adapter ID if Virtual Machine is attached to VNIC. This object contains VMK ID if the Virtual Machine is attached to VMKNIC. This object contains value of 'vswif' if the Virtual Machine is attached to VSWIF.
OBJECT-TYPE    
  SnmpAdminString  

cvnVethOwner 1.3.6.1.4.1.9.9.710.1.1.1.1.3
The name of the Virtual Machine that owns this virtual ethernet interface. When a Virtual Machine attaches to one of the port in physical server via this virtual ethernet interface, this VM will be considered as the owner of this virtual ethernet interface. When Virtual Machine moves from one host to another, its virtual ethernet interface remains unchanged.
OBJECT-TYPE    
  SnmpAdminString  

cvnVethHostID 1.3.6.1.4.1.9.9.710.1.1.1.1.4
A unique identifier, assigned by the system, of the registered VEM. A VEM is registered and host a virtual ethernet interface when a Virtual Machine attaches to such VEM by using virtual ethernet interface. A unique identifier, logical module number, is assigned for every VEM. This object contains value of zero if VEM is directly attached to the switch.
OBJECT-TYPE    
  Unsigned32  

cvnVethHostAddrType 1.3.6.1.4.1.9.9.710.1.1.1.1.5
The type of Internet address of the VEM which hosts the VM.
OBJECT-TYPE    
  InetAddressType  

cvnVethHostAddr 1.3.6.1.4.1.9.9.710.1.1.1.1.6
The Internet address of the VEM which hosts the VM. The type of this address is determined by the value of the cvnVethHostAddrType object. This object also indicates the management address of the VEM. Value of this object may be changed when virtual ethernet interface moves from one VEM to another VEM.
OBJECT-TYPE    
  InetAddress  

cvnVethPortProfileUsed 1.3.6.1.4.1.9.9.710.1.1.1.1.7
The name of port profile which has been applied to the current virtual ethernet interface. Port Profile contains a set of configuration parameters. For example, switchport mode, channel group no., channel group mode, security policy. Port profile is assigned during the registration of virtual ethernet interface.
OBJECT-TYPE    
  SnmpAdminString  

cvnVethIfProfileAlias 1.3.6.1.4.1.9.9.710.1.1.1.1.8
The profile alias as seen in external virtualization server for the profile used by this virtual ethernet interface.
OBJECT-TYPE    
  SnmpAdminString  

cvnVethIfAdditionalState 1.3.6.1.4.1.9.9.710.1.1.1.1.9
This object indicates the additional state of the virtual ethernet interface. none - no additional state. participating - interface is up and participating. Virtual machine is currently connected to system using this interface. suspended - interface is down and has been suspended. errDisabled - interface is down due to error disabled. nonParticipating - interface is up but not participating.
OBJECT-TYPE    
  INTEGER none(1), participating(2), suspended(3), errDisabled(4), nonParticipating(5)  

cvnVethStateReason 1.3.6.1.4.1.9.9.710.1.1.1.1.10
This object indicates the reason for the additional state specified in cvnVethIfAdditionalState.
OBJECT-TYPE    
  SnmpAdminString  

cvnPinningTable 1.3.6.1.4.1.9.9.710.1.1.2
A list of virtual ethernet interfaces which supports pinning functionality in VSM. Pinning is a mechanism of directing traffic to or from a interface through a particular interface in a switch. By default, system use load balancing algorithm to pick the best possible physical interface automatically. However, user may use pinning functionality to instrument the finite control on the traffic flow between virtual ethernet interfaces and actual physical interfaces in VSM. For example, user may want to configure that packets from a particular virtual ethernet interface always go out through first interface in the port channel irrespective of load balancing policy on the switch. In order to achieve this, user can pin the virtual ethernet interface to first interface of the switch.
OBJECT-TYPE    
  SEQUENCE OF  
    CvnPinningEntry

cvnPinningEntry 1.3.6.1.4.1.9.9.710.1.1.2.1
An entry containing pinning management information for a particular virtual ethernet interface. Entry is created by the system when a virtual Ethernet interface with pinning functionality is registered to VSM. Entry is removed when a virtual Ethernet interface with pinning functionality is removed from VSM.
OBJECT-TYPE    
  CvnPinningEntry  

cvnPinnedSubGrpId 1.3.6.1.4.1.9.9.710.1.1.2.1.1
This object indicates the sub-group ID to which virtual ethernet interface is pinned. This object returns negative vlaue (-1) if subgroup id is not assigned.
OBJECT-TYPE    
  Integer32 -1..2147483647  

cvnConnecteeTable 1.3.6.1.4.1.9.9.710.1.2.1
A list of connectees which are currently attached to virtual ethernet interfaces. Virtual machine connects to a physical entity using a virtual ethernet interface. In this scenario the Virtual Machine is called connectee, physical entity is called host. Whenever a Virtual Machine is connected using virtual ethernet interface we have mapping between physical and virtual interfaces. This object gives the mapping of all virtual ehternet interfaces to their corresponding physical entities.
OBJECT-TYPE    
  SEQUENCE OF  
    CvnConnecteeEntry

cvnConnecteeEntry 1.3.6.1.4.1.9.9.710.1.2.1.1
An entry containing management information for a particular connectee. Entry is created when a connectee connects to VSM. Entry is deleted when a connectee has been disconnected.
OBJECT-TYPE    
  CvnConnecteeEntry  

cvnConnecteeAttachType 1.3.6.1.4.1.9.9.710.1.2.1.1.1
This object indicates how virtual ethernet interface is attached to this system. none - virtual ethernet interface is not participating. vem - Always a dynamic attachment. For this type of attachment switching is done by host at software layer. niv - A fixed or dynamic attachment. For this type of attachment switching is done in asics
OBJECT-TYPE    
  INTEGER none(1), vem(2), niv(3)  

cvnDVSPort 1.3.6.1.4.1.9.9.710.1.2.1.1.2
This object indicates the port of DVS to which virtual ethernet interface is attached.
OBJECT-TYPE    
  Unsigned32  

cvnConnecteeName 1.3.6.1.4.1.9.9.710.1.2.1.1.3
This object indicates the name of the connectee attached to virtual ethernet interface. For example it will return name of virtual machine or host connected to the system
OBJECT-TYPE    
  SnmpAdminString  

cvnConnecteeUuid 1.3.6.1.4.1.9.9.710.1.2.1.1.4
This object indicates the UUID of the connectee attached to this virtual ethernet interface.
OBJECT-TYPE    
  SnmpAdminString  

cvnConnecteeType 1.3.6.1.4.1.9.9.710.1.2.1.1.5
This object indicates the type of connectee attached to this virtual ethernet interface. Connectee type can be host, Virtual Machine from different vendors etc. unknown - The type of connectee is unknown. vmwareVm - Connectee is a Virtual Machine vmwareHost - Connectee is a host
OBJECT-TYPE    
  INTEGER unknown(1), vmwareVm(2), vmwareHost(3)  

cvnConnecteeMac 1.3.6.1.4.1.9.9.710.1.2.1.1.6
This object indicates the MAC address of the connectee.
OBJECT-TYPE    
  MacAddress  

cvnConnecteeDeviceName 1.3.6.1.4.1.9.9.710.1.2.1.1.7
This object indicates the device ID or port ID of the connectee to which virtual ethernet interface is attached to.
OBJECT-TYPE    
  SnmpAdminString  

cvnConnecteeDeviceType 1.3.6.1.4.1.9.9.710.1.2.1.1.8
This object indicates the type of connectee device attached to this virtual ethernet interface. Connectee Device type can be VMKNIC, VSWIF,VNIC etc. unknown - The device type is none of followings. pnic - Physical NIC vnic - Virtual NIC vswif - Virtual Switch Interface vmknic - Virtual machine kernel NIC
OBJECT-TYPE    
  INTEGER unknown(1), pnic(2), vnic(3), vswif(4), vmknic(5)  

ciscoVirtualNicMIBCompliances 1.3.6.1.4.1.9.9.710.2.1
OBJECT IDENTIFIER    

ciscoVirtualNicMIBGroups 1.3.6.1.4.1.9.9.710.2.2
OBJECT IDENTIFIER    

virtualNicMIBCompliance 1.3.6.1.4.1.9.9.710.2.1.1
The compliance statement for entities which implement the CISCO-VIRTUAL-NIC-MIB.
MODULE-COMPLIANCE    

cvnVethGroup 1.3.6.1.4.1.9.9.710.2.2.1
A collection of objects providing the virtual ethernet interface management information on the device.
OBJECT-GROUP    

cvnPinningGroup 1.3.6.1.4.1.9.9.710.2.2.2
A collection of objects providing management information of pinning functionality.
OBJECT-GROUP    

cvnConnecteeGroup 1.3.6.1.4.1.9.9.710.2.2.3
A collection of objects providing management information of connectee.
OBJECT-GROUP