CISCO-VIRTUAL-NIC-MIB
File:
CISCO-VIRTUAL-NIC-MIB.mib (21272 bytes)
Imported modules
Imported symbols
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 |
|
|
|
cvnVethIfTable |
1.3.6.1.4.1.9.9.710.1.1.1 |
A list of virtual ethernet interfaces managed by VSM. |
Status: current |
Access: not-accessible |
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. |
Status: current |
Access: not-accessible |
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. |
Status: current |
Access: not-accessible |
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. |
Status: current |
Access: read-only |
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. |
Status: current |
Access: read-only |
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. |
Status: current |
Access: read-only |
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. |
Status: current |
Access: read-only |
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. |
Status: current |
Access: read-only |
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. |
Status: current |
Access: read-only |
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. |
Status: current |
Access: read-only |
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. |
Status: current |
Access: read-only |
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. |
Status: current |
Access: read-only |
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. |
Status: current |
Access: not-accessible |
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. |
Status: current |
Access: not-accessible |
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. |
Status: current |
Access: read-write |
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. |
Status: current |
Access: not-accessible |
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. |
Status: current |
Access: not-accessible |
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 |
Status: current |
Access: read-only |
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. |
Status: current |
Access: read-only |
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 |
Status: current |
Access: read-only |
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. |
Status: current |
Access: read-only |
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 |
Status: current |
Access: read-only |
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. |
Status: current |
Access: read-only |
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. |
Status: current |
Access: read-only |
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 |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
INTEGER |
unknown(1), pnic(2), vnic(3), vswif(4), vmknic(5) |
|
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. |
Status: current |
Access: read-only |
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. |
Status: current |
Access: read-only |
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. |
Status: current |
Access: read-only |
OBJECT-GROUP |
|
|
|
cvnConnecteeGroup |
1.3.6.1.4.1.9.9.710.2.2.3 |
A collection of objects providing management
information of connectee. |
Status: current |
Access: read-only |
OBJECT-GROUP |
|
|
|