EZ5 MIB Catalog

CISCO-VIRTUAL-NIC-MIB

2009-10-26

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 * ****** ****** ******

Download CISCO-VIRTUAL-NIC-MIB.txt Open CISCO-VIRTUAL-NIC-MIB.txt in a new tab

TABLES (3)

Tables (3)

NameOID
cvnVethIfTable1.3.6.1.4.1.9.9.710.1.1.1
cvnPinningTable1.3.6.1.4.1.9.9.710.1.1.2
cvnConnecteeTable1.3.6.1.4.1.9.9.710.1.2.1

END OF TOC

Table details

cvnVethIfTable

1.3.6.1.4.1.9.9.710.1.1.1

Index: cvnVethInterface

A list of virtual ethernet interfaces managed by VSM.

cvnVethInterface

1.3.6.1.4.1.9.9.710.1.1.1.1.1

InterfaceIndexA unique value, greater than zero, for each interface or interface sub-layer in the managed system. It is recommended that values are assigned contiguously starting from 1. The value for each interface sub-layer must remain constant at least from one re-initialization of the entity's network management system to the next re-initialization. (1..2147483647) · Integer32 · hint d

The value of ifIndex for the virtual ethernet interface.

cvnVethAdapter

1.3.6.1.4.1.9.9.710.1.1.1.1.2

SnmpAdminStringAn octet string containing administrative information, preferably in human-readable form. To facilitate internationalization, this information is represented using the ISO/IEC IS 10646-1 character set, encoded as an octet string using the UTF-8 transformation format described in [RFC2279]. Since additional code points are added by amendments to the 10646 standard from time to time, implementations must be prepared to encounter any code point from 0x00000000 to 0x7fffffff. Byte sequences that do not correspond to the valid UTF-8 encoding of a code point or are outside this range are prohibited. The use of control codes should be avoided. When it is necessary to represent a newline, the control code sequence CR LF should be used. The use of leading or trailing white space should be avoided. For code points not directly supported by user interface hardware or software, an alternative means of entry and display, such as hexadecimal, may be provided. For information encoded in 7-bit US-ASCII, the UTF-8 encoding is identical to the US-ASCII encoding. UTF-8 may require multiple bytes to represent a single character / code point; thus the length of this object in octets may be different from the number of characters encoded. Similarly, size constraints refer to the number of encoded octets, not the number of characters represented by an encoding. Note that when this TC is used for an object that is used or envisioned to be used as an index, then a SIZE restriction MUST be specified so that the number of sub-identifiers for any object instance does not exceed the limit of 128, as defined by [RFC3416]. Note that the size of an SnmpAdminString object is measured in octets, not characters. SIZE (0..255) · OCTET STRING · hint 255t

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.

cvnVethOwner

1.3.6.1.4.1.9.9.710.1.1.1.1.3

SnmpAdminStringAn octet string containing administrative information, preferably in human-readable form. To facilitate internationalization, this information is represented using the ISO/IEC IS 10646-1 character set, encoded as an octet string using the UTF-8 transformation format described in [RFC2279]. Since additional code points are added by amendments to the 10646 standard from time to time, implementations must be prepared to encounter any code point from 0x00000000 to 0x7fffffff. Byte sequences that do not correspond to the valid UTF-8 encoding of a code point or are outside this range are prohibited. The use of control codes should be avoided. When it is necessary to represent a newline, the control code sequence CR LF should be used. The use of leading or trailing white space should be avoided. For code points not directly supported by user interface hardware or software, an alternative means of entry and display, such as hexadecimal, may be provided. For information encoded in 7-bit US-ASCII, the UTF-8 encoding is identical to the US-ASCII encoding. UTF-8 may require multiple bytes to represent a single character / code point; thus the length of this object in octets may be different from the number of characters encoded. Similarly, size constraints refer to the number of encoded octets, not the number of characters represented by an encoding. Note that when this TC is used for an object that is used or envisioned to be used as an index, then a SIZE restriction MUST be specified so that the number of sub-identifiers for any object instance does not exceed the limit of 128, as defined by [RFC3416]. Note that the size of an SnmpAdminString object is measured in octets, not characters. SIZE (0..255) · OCTET STRING · hint 255t

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.

cvnVethHostID

1.3.6.1.4.1.9.9.710.1.1.1.1.4

Unsigned32

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.

cvnVethHostAddrType

1.3.6.1.4.1.9.9.710.1.1.1.1.5

InetAddressType0 = unknown1 = ipv42 = ipv63 = ipv4z4 = ipv6z16 = dnsA value that represents a type of Internet address. unknown(0) An unknown address type. This value MUST be used if the value of the corresponding InetAddress object is a zero-length string. It may also be used to indicate an IP address that is not in one of the formats defined below. ipv4(1) An IPv4 address as defined by the InetAddressIPv4 textual convention. ipv6(2) An IPv6 address as defined by the InetAddressIPv6 textual convention. ipv4z(3) A non-global IPv4 address including a zone index as defined by the InetAddressIPv4z textual convention. ipv6z(4) A non-global IPv6 address including a zone index as defined by the InetAddressIPv6z textual convention. dns(16) A DNS domain name as defined by the InetAddressDNS textual convention. Each definition of a concrete InetAddressType value must be accompanied by a definition of a textual convention for use with that InetAddressType. To support future extensions, the InetAddressType textual convention SHOULD NOT be sub-typed in object type definitions. It MAY be sub-typed in compliance statements in order to require only a subset of these address types for a compliant implementation. Implementations must ensure that InetAddressType objects and any dependent objects (e.g., InetAddress objects) are consistent. An inconsistentValue error must be generated if an attempt to change an InetAddressType object would, for example, lead to an undefined InetAddress value. In particular, InetAddressType/InetAddress pairs must be changed together if the address type changes (e.g., from ipv6(2) to ipv4(1)). · Integer32

The type of Internet address of the VEM which hosts the VM.

cvnVethHostAddr

1.3.6.1.4.1.9.9.710.1.1.1.1.6

InetAddressDenotes a generic Internet address. An InetAddress value is always interpreted within the context of an InetAddressType value. Every usage of the InetAddress textual convention is required to specify the InetAddressType object that provides the context. It is suggested that the InetAddressType object be logically registered before the object(s) that use the InetAddress textual convention, if they appear in the same logical row. The value of an InetAddress object must always be consistent with the value of the associated InetAddressType object. Attempts to set an InetAddress object to a value inconsistent with the associated InetAddressType must fail with an inconsistentValue error. When this textual convention is used as the syntax of an index object, there may be issues with the limit of 128 sub-identifiers specified in SMIv2, STD 58. In this case, the object definition MUST include a 'SIZE' clause to limit the number of potential instance sub-identifiers; otherwise the applicable constraints MUST be stated in the appropriate conceptual row DESCRIPTION clauses, or in the surrounding documentation if there is no single DESCRIPTION clause that is appropriate. SIZE (0..255) · OCTET STRING

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.

cvnVethPortProfileUsed

1.3.6.1.4.1.9.9.710.1.1.1.1.7

SnmpAdminStringAn octet string containing administrative information, preferably in human-readable form. To facilitate internationalization, this information is represented using the ISO/IEC IS 10646-1 character set, encoded as an octet string using the UTF-8 transformation format described in [RFC2279]. Since additional code points are added by amendments to the 10646 standard from time to time, implementations must be prepared to encounter any code point from 0x00000000 to 0x7fffffff. Byte sequences that do not correspond to the valid UTF-8 encoding of a code point or are outside this range are prohibited. The use of control codes should be avoided. When it is necessary to represent a newline, the control code sequence CR LF should be used. The use of leading or trailing white space should be avoided. For code points not directly supported by user interface hardware or software, an alternative means of entry and display, such as hexadecimal, may be provided. For information encoded in 7-bit US-ASCII, the UTF-8 encoding is identical to the US-ASCII encoding. UTF-8 may require multiple bytes to represent a single character / code point; thus the length of this object in octets may be different from the number of characters encoded. Similarly, size constraints refer to the number of encoded octets, not the number of characters represented by an encoding. Note that when this TC is used for an object that is used or envisioned to be used as an index, then a SIZE restriction MUST be specified so that the number of sub-identifiers for any object instance does not exceed the limit of 128, as defined by [RFC3416]. Note that the size of an SnmpAdminString object is measured in octets, not characters. SIZE (0..255) · OCTET STRING · hint 255t

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.

cvnVethIfProfileAlias

1.3.6.1.4.1.9.9.710.1.1.1.1.8

SnmpAdminStringAn octet string containing administrative information, preferably in human-readable form. To facilitate internationalization, this information is represented using the ISO/IEC IS 10646-1 character set, encoded as an octet string using the UTF-8 transformation format described in [RFC2279]. Since additional code points are added by amendments to the 10646 standard from time to time, implementations must be prepared to encounter any code point from 0x00000000 to 0x7fffffff. Byte sequences that do not correspond to the valid UTF-8 encoding of a code point or are outside this range are prohibited. The use of control codes should be avoided. When it is necessary to represent a newline, the control code sequence CR LF should be used. The use of leading or trailing white space should be avoided. For code points not directly supported by user interface hardware or software, an alternative means of entry and display, such as hexadecimal, may be provided. For information encoded in 7-bit US-ASCII, the UTF-8 encoding is identical to the US-ASCII encoding. UTF-8 may require multiple bytes to represent a single character / code point; thus the length of this object in octets may be different from the number of characters encoded. Similarly, size constraints refer to the number of encoded octets, not the number of characters represented by an encoding. Note that when this TC is used for an object that is used or envisioned to be used as an index, then a SIZE restriction MUST be specified so that the number of sub-identifiers for any object instance does not exceed the limit of 128, as defined by [RFC3416]. Note that the size of an SnmpAdminString object is measured in octets, not characters. SIZE (0..255) · OCTET STRING · hint 255t

The profile alias as seen in external virtualization server for the profile used by this virtual ethernet interface.

cvnVethIfAdditionalState

1.3.6.1.4.1.9.9.710.1.1.1.1.9

INTEGER1 = none2 = participating3 = suspended4 = errDisabled5 = nonParticipating · Integer32

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.

cvnVethStateReason

1.3.6.1.4.1.9.9.710.1.1.1.1.10

SnmpAdminStringAn octet string containing administrative information, preferably in human-readable form. To facilitate internationalization, this information is represented using the ISO/IEC IS 10646-1 character set, encoded as an octet string using the UTF-8 transformation format described in [RFC2279]. Since additional code points are added by amendments to the 10646 standard from time to time, implementations must be prepared to encounter any code point from 0x00000000 to 0x7fffffff. Byte sequences that do not correspond to the valid UTF-8 encoding of a code point or are outside this range are prohibited. The use of control codes should be avoided. When it is necessary to represent a newline, the control code sequence CR LF should be used. The use of leading or trailing white space should be avoided. For code points not directly supported by user interface hardware or software, an alternative means of entry and display, such as hexadecimal, may be provided. For information encoded in 7-bit US-ASCII, the UTF-8 encoding is identical to the US-ASCII encoding. UTF-8 may require multiple bytes to represent a single character / code point; thus the length of this object in octets may be different from the number of characters encoded. Similarly, size constraints refer to the number of encoded octets, not the number of characters represented by an encoding. Note that when this TC is used for an object that is used or envisioned to be used as an index, then a SIZE restriction MUST be specified so that the number of sub-identifiers for any object instance does not exceed the limit of 128, as defined by [RFC3416]. Note that the size of an SnmpAdminString object is measured in octets, not characters. SIZE (0..255) · OCTET STRING · hint 255t

This object indicates the reason for the additional state specified in cvnVethIfAdditionalState.

cvnPinningTable

1.3.6.1.4.1.9.9.710.1.1.2

Index: cvnVethInterface

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.

cvnPinnedSubGrpId

1.3.6.1.4.1.9.9.710.1.1.2.1.1

Integer32 (-1..2147483647)

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.

cvnConnecteeTable

1.3.6.1.4.1.9.9.710.1.2.1

Index: cvnVethInterface

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.

cvnConnecteeAttachType

1.3.6.1.4.1.9.9.710.1.2.1.1.1

INTEGER1 = none2 = vem3 = niv · Integer32

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

cvnDVSPort

1.3.6.1.4.1.9.9.710.1.2.1.1.2

Unsigned32

This object indicates the port of DVS to which virtual ethernet interface is attached.

cvnConnecteeName

1.3.6.1.4.1.9.9.710.1.2.1.1.3

SnmpAdminStringAn octet string containing administrative information, preferably in human-readable form. To facilitate internationalization, this information is represented using the ISO/IEC IS 10646-1 character set, encoded as an octet string using the UTF-8 transformation format described in [RFC2279]. Since additional code points are added by amendments to the 10646 standard from time to time, implementations must be prepared to encounter any code point from 0x00000000 to 0x7fffffff. Byte sequences that do not correspond to the valid UTF-8 encoding of a code point or are outside this range are prohibited. The use of control codes should be avoided. When it is necessary to represent a newline, the control code sequence CR LF should be used. The use of leading or trailing white space should be avoided. For code points not directly supported by user interface hardware or software, an alternative means of entry and display, such as hexadecimal, may be provided. For information encoded in 7-bit US-ASCII, the UTF-8 encoding is identical to the US-ASCII encoding. UTF-8 may require multiple bytes to represent a single character / code point; thus the length of this object in octets may be different from the number of characters encoded. Similarly, size constraints refer to the number of encoded octets, not the number of characters represented by an encoding. Note that when this TC is used for an object that is used or envisioned to be used as an index, then a SIZE restriction MUST be specified so that the number of sub-identifiers for any object instance does not exceed the limit of 128, as defined by [RFC3416]. Note that the size of an SnmpAdminString object is measured in octets, not characters. SIZE (0..255) · OCTET STRING · hint 255t

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

cvnConnecteeUuid

1.3.6.1.4.1.9.9.710.1.2.1.1.4

SnmpAdminStringAn octet string containing administrative information, preferably in human-readable form. To facilitate internationalization, this information is represented using the ISO/IEC IS 10646-1 character set, encoded as an octet string using the UTF-8 transformation format described in [RFC2279]. Since additional code points are added by amendments to the 10646 standard from time to time, implementations must be prepared to encounter any code point from 0x00000000 to 0x7fffffff. Byte sequences that do not correspond to the valid UTF-8 encoding of a code point or are outside this range are prohibited. The use of control codes should be avoided. When it is necessary to represent a newline, the control code sequence CR LF should be used. The use of leading or trailing white space should be avoided. For code points not directly supported by user interface hardware or software, an alternative means of entry and display, such as hexadecimal, may be provided. For information encoded in 7-bit US-ASCII, the UTF-8 encoding is identical to the US-ASCII encoding. UTF-8 may require multiple bytes to represent a single character / code point; thus the length of this object in octets may be different from the number of characters encoded. Similarly, size constraints refer to the number of encoded octets, not the number of characters represented by an encoding. Note that when this TC is used for an object that is used or envisioned to be used as an index, then a SIZE restriction MUST be specified so that the number of sub-identifiers for any object instance does not exceed the limit of 128, as defined by [RFC3416]. Note that the size of an SnmpAdminString object is measured in octets, not characters. SIZE (0..255) · OCTET STRING · hint 255t

This object indicates the UUID of the connectee attached to this virtual ethernet interface.

cvnConnecteeType

1.3.6.1.4.1.9.9.710.1.2.1.1.5

INTEGER1 = unknown2 = vmwareVm3 = vmwareHost · Integer32

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

cvnConnecteeMac

1.3.6.1.4.1.9.9.710.1.2.1.1.6

MacAddressRepresents an 802 MAC address represented in the `canonical' order defined by IEEE 802.1a, i.e., as if it were transmitted least significant bit first, even though 802.5 (in contrast to other 802.x protocols) requires MAC addresses to be transmitted most significant bit first. SIZE (6) · OCTET STRING · hint 1x:

This object indicates the MAC address of the connectee.

cvnConnecteeDeviceName

1.3.6.1.4.1.9.9.710.1.2.1.1.7

SnmpAdminStringAn octet string containing administrative information, preferably in human-readable form. To facilitate internationalization, this information is represented using the ISO/IEC IS 10646-1 character set, encoded as an octet string using the UTF-8 transformation format described in [RFC2279]. Since additional code points are added by amendments to the 10646 standard from time to time, implementations must be prepared to encounter any code point from 0x00000000 to 0x7fffffff. Byte sequences that do not correspond to the valid UTF-8 encoding of a code point or are outside this range are prohibited. The use of control codes should be avoided. When it is necessary to represent a newline, the control code sequence CR LF should be used. The use of leading or trailing white space should be avoided. For code points not directly supported by user interface hardware or software, an alternative means of entry and display, such as hexadecimal, may be provided. For information encoded in 7-bit US-ASCII, the UTF-8 encoding is identical to the US-ASCII encoding. UTF-8 may require multiple bytes to represent a single character / code point; thus the length of this object in octets may be different from the number of characters encoded. Similarly, size constraints refer to the number of encoded octets, not the number of characters represented by an encoding. Note that when this TC is used for an object that is used or envisioned to be used as an index, then a SIZE restriction MUST be specified so that the number of sub-identifiers for any object instance does not exceed the limit of 128, as defined by [RFC3416]. Note that the size of an SnmpAdminString object is measured in octets, not characters. SIZE (0..255) · OCTET STRING · hint 255t

This object indicates the device ID or port ID of the connectee to which virtual ethernet interface is attached to.

cvnConnecteeDeviceType

1.3.6.1.4.1.9.9.710.1.2.1.1.8

INTEGER1 = unknown2 = pnic3 = vnic4 = vswif5 = vmknic · Integer32

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

↑ To TOC