draft-ietf-opsawg-vmm-mib-02.txt   draft-ietf-opsawg-vmm-mib-03.txt 
OPSAWG H. Asai OPSAWG H. Asai
Internet-Draft Univ. of Tokyo Internet-Draft Univ. of Tokyo
Intended status: Standards Track M. MacFaden Intended status: Standards Track M. MacFaden
Expires: May 14, 2015 VMware Inc. Expires: November 27, 2015 VMware Inc.
J. Schoenwaelder J. Schoenwaelder
Jacobs University Jacobs University
K. Shima K. Shima
IIJ Innovation Institute Inc. IIJ Innovation Institute Inc.
T. Tsou T. Tsou
Huawei Technologies (USA) Huawei Technologies (USA)
November 10, 2014 May 26, 2015
Management Information Base for Virtual Machines Controlled by a Management Information Base for Virtual Machines Controlled by a
Hypervisor Hypervisor
draft-ietf-opsawg-vmm-mib-02 draft-ietf-opsawg-vmm-mib-03
Abstract Abstract
This document defines a portion of the Management Information Base This document defines a portion of the Management Information Base
(MIB) for use with network management protocols in the Internet (MIB) for use with network management protocols in the Internet
community. In particular, this specifies objects for managing community. In particular, this specifies objects for managing
virtual machines controlled by a hypervisor (a.k.a. virtual machine virtual machines controlled by a hypervisor (a.k.a. virtual machine
monitor). monitor).
Status of this Memo Status of this Memo
skipping to change at page 1, line 42 skipping to change at page 1, line 42
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/. Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on May 14, 2015. This Internet-Draft will expire on November 27, 2015.
Copyright Notice Copyright Notice
Copyright (c) 2014 IETF Trust and the persons identified as the Copyright (c) 2015 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of (http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License. described in the Simplified BSD License.
Table of Contents Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. The Internet-Standard Management Framework . . . . . . . . . . 4 2. The Internet-Standard Management Framework . . . . . . . . . . 4
3. Overview and Objectives . . . . . . . . . . . . . . . . . . . 5 3. Overview and Objectives . . . . . . . . . . . . . . . . . . . 5
4. Structure of the VM-MIB Module . . . . . . . . . . . . . . . . 7 4. Structure of the VM-MIB Module . . . . . . . . . . . . . . . . 7
5. Relationship to Other MIB Modules . . . . . . . . . . . . . . 12 5. Relationship to Other MIB Modules . . . . . . . . . . . . . . 10
6. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 13 6. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 11
7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 49 6.1. VM-MIB . . . . . . . . . . . . . . . . . . . . . . . . . . 11
8. Security Considerations . . . . . . . . . . . . . . . . . . . 50 6.2. IANA-STORAGE-MEDIA-TYPE-MIB . . . . . . . . . . . . . . . 45
9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 51 7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 47
10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 52 8. Security Considerations . . . . . . . . . . . . . . . . . . . 48
10.1. Normative References . . . . . . . . . . . . . . . . . . 52 9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 49
10.2. Informative References . . . . . . . . . . . . . . . . . 53 10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Appendix A. State Transition Table . . . . . . . . . . . . . . . 54 10.1. Normative References . . . . . . . . . . . . . . . . . . . 50
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 56 10.2. Informative References . . . . . . . . . . . . . . . . . . 51
Appendix A. State Transition Table . . . . . . . . . . . . . . . 52
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 54
1. Introduction 1. Introduction
This document defines a portion of the Management Information Base This document defines a portion of the Management Information Base
(MIB) for use with network management protocols in the Internet (MIB) for use with network management protocols in the Internet
community. In particular, this specifies objects for managing community. In particular, this specifies objects for managing
virtual machines controlled by a hypervisor (a.k.a. virtual machine virtual machines controlled by a hypervisor (a.k.a. virtual machine
monitor). A hypervisor controls multiple virtual machines on a monitor). A hypervisor controls multiple virtual machines on a
single physical machine by allocating resources to each virtual single physical machine by allocating resources to each virtual
machine using virtualization technologies. Therefore, this MIB machine using virtualization technologies. Therefore, this MIB
module contains information on virtual machines and their resources module contains information on virtual machines and their resources
controlled by a hypervisor as well as hypervisor's hardware and controlled by a hypervisor as well as hypervisor's hardware and
software information. software information.
The design of this MIB module has been derived from enterprise The design of this MIB module has been derived from product-specific
specific MIB modules, namely a MIB module for managing guests of the MIB modules, namely a MIB module for managing guests of the Xen
Xen hypervisor, a MIB module for managing virtual machines controlled hypervisor, a MIB module for managing virtual machines controlled by
by the VMware hypervisor, and a MIB module using the libvirt the VMware hypervisor, and a MIB module using the libvirt programming
programming interface to access different hypervisors. However, this interface to access different hypervisors. However, this MIB module
MIB module attempts to generalize the managed objects to support attempts to generalize the managed objects to support other
other implementations of hypervisors. implementations of hypervisors.
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119]. document are to be interpreted as described in RFC 2119 [RFC2119].
2. The Internet-Standard Management Framework 2. The Internet-Standard Management Framework
For a detailed overview of the documents that describe the current For a detailed overview of the documents that describe the current
Internet-Standard Management Framework, please refer to section 7 of Internet-Standard Management Framework, please refer to section 7 of
RFC 3410 [RFC3410]. Managed objects are accessed via a virtual RFC 3410 [RFC3410]. Managed objects are accessed via a virtual
skipping to change at page 5, line 52 skipping to change at page 5, line 52
virtual memory, virtual storage devices, and virtual network virtual memory, virtual storage devices, and virtual network
interfaces to virtual machines from physical resources. interfaces to virtual machines from physical resources.
Figure 1: An example of a virtualization environment Figure 1: An example of a virtualization environment
On the common implementations of hypervisors, a hypervisor allocates On the common implementations of hypervisors, a hypervisor allocates
virtual resources from physical resources; virtual CPUs, virtual virtual resources from physical resources; virtual CPUs, virtual
memory, virtual storage devices, and virtual network interfaces to memory, virtual storage devices, and virtual network interfaces to
virtual machines as shown in Figure 1. Since the virtual resources virtual machines as shown in Figure 1. Since the virtual resources
allocated to virtual machines are managed by the hypervisor, the MIB allocated to virtual machines are managed by the hypervisor, the MIB
objects are managed at a hypervisor. In case that the objects are objects are managed at the hypervisor. In case that the objects are
accessed through the SNMP, an SNMP agent is launched at the accessed through the SNMP, an SNMP agent is launched at the
hypervisor to provide access to the objects. hypervisor to provide access to the objects.
The objects are managed from the viewpoint of the operators of The objects are managed from the viewpoint of the operators of
hypervisors, but not the operators of virtual machines; i.e., the hypervisors, but not the operators of virtual machines; i.e., the
objects do not take into account the actual resource utilization on objects do not take into account the actual resource utilization on
each virtual machine but the resource allocation from the physical each virtual machine but the resource allocation from the physical
resources. For example, vmNetworkIfIndex indicates the virtual resources. For example, vmNetworkIfIndex indicates the virtual
interface associated with an interface of a virtual machine at the interface associated with an interface of a virtual machine at the
hypervisor, and consequently, the `in' and `out' directions denote hypervisor, and consequently, the `in' and `out' directions denote
skipping to change at page 6, line 25 skipping to change at page 6, line 25
to a virtual machine', respectively. Moreover, to a virtual machine', respectively. Moreover,
vmStorageAllocatedSize denotes the size allocated by the hypervisor, vmStorageAllocatedSize denotes the size allocated by the hypervisor,
but not the size actually used by the operating system on the virtual but not the size actually used by the operating system on the virtual
machine. This means that vmStorageDefinedSize and machine. This means that vmStorageDefinedSize and
vmStorageAllocatedSize do not take different values when the vmStorageAllocatedSize do not take different values when the
vmStorageSourceType is `block' or `raw'. vmStorageSourceType is `block' or `raw'.
The objectives of this document are the followings: 1) This document The objectives of this document are the followings: 1) This document
defines the MIB objects common to many hypervisors for the management defines the MIB objects common to many hypervisors for the management
of virtual machines controlled by a hypervisor. 2) This document of virtual machines controlled by a hypervisor. 2) This document
clarifies the relationship between other MIB modules for managing clarifies the relationship with other MIB modules for managing host
host computers and network devices. computers and network devices.
4. Structure of the VM-MIB Module 4. Structure of the VM-MIB Module
The MIB module is organized into a group of scalars and tables. The The MIB module is organized into a group of scalars and tables. The
scalars below `vmHypervisor' provide basic information about the scalars below `vmHypervisor' provide basic information about the
hypervisor. The `vmTable' lists the virtual machines (guests) that hypervisor. The `vmTable' lists the virtual machines (guests) that
are known to the hypervisor. The `vmCpuTable' provides the mapping are known to the hypervisor. The `vmCpuTable' provides the mapping
table of virtual CPUs to virtual machines, including CPU time used by table of virtual CPUs to virtual machines, including CPU time used by
each virtual CPU. The 'vmCpuAffinityTable' provides the affinity of each virtual CPU. The 'vmCpuAffinityTable' provides the affinity of
each virtual CPU to a physical CPU. The `vmStorageTable' provides each virtual CPU to a physical CPU. The `vmStorageTable' provides
skipping to change at page 8, line 5 skipping to change at page 8, line 5
a pointer `vmStorageParent' to the physical storage device. The a pointer `vmStorageParent' to the physical storage device. The
`vmNetworkTable' provides the list of virtual network interfaces and `vmNetworkTable' provides the list of virtual network interfaces and
their mapping to virtual machines. Each entry in the their mapping to virtual machines. Each entry in the
`vmNetworkTable' also provides a pointer `vmNetworkIfIndex' to the `vmNetworkTable' also provides a pointer `vmNetworkIfIndex' to the
corresponding entry in the `ifTable' of IF-MIB [RFC2863]. In case corresponding entry in the `ifTable' of IF-MIB [RFC2863]. In case
that an entry in the `vmNetworkTable' has a corresponding parent that an entry in the `vmNetworkTable' has a corresponding parent
physical network interface managed in the `ifTable' of IF-MIB, the physical network interface managed in the `ifTable' of IF-MIB, the
entry contains a pointer `vmNetworkParent' to the physical network entry contains a pointer `vmNetworkParent' to the physical network
interface. interface.
!: Notification Notation:
+-------------+ + - - - - - - +
| finite | | transient |
| vmOperState | | vmOperState |
+-------------+ + - - - - - - +
================================================================ +-------------+
| vmOperState | : Finite state; the first line presents the
| | `vmOperState', and the second line presents a
+-------------+ notification generated if applicable.
+--------------+ + - - - - - - - + +-------------+ + - - - - - - +
| suspended |<--| suspending | | paused | | vmOperState | : Transient state; first line presents the
| !vmSuspended | | !vmSuspending | | !vmPaused | | | `vmOperState', and the second line presents a
+--------------+ + - - - - - - - + +-------------+ + - - - - - - + notification generated if applicable.
| ^ ^
| | |
v | |
+ - - - - - - + +-------------+<----------+ + - - - - - - -+
| resuming |-->| running |<-------------->| migrating |
| !vmResuming | | !vmRunning | | !vmMigrating |
+ - - - - - - + +-------------+ + - - - - - - -+
| ^ ^
| | |
| +-------------------+ |
| | |
v v v
+ - - - - - - - - + +-------------+
| shuttingdown |--------->| shutdown |
| !vmShuttingdown | | !vmShutdown |
+ - - - - - - - - + +-------------+
^ |
| v !vmDeleted
+ - - - - - -+ +------------+ + - - - - - - + (Deleted from
| blocked | | crashed | | preparing | vmTable)
| !vmBlocked | | !vmCrashed | | |
+ - - - - - -+ +------------+ + - - - - - - +
The state transition of a virtual machine ! : Notification; a text followed by the symbol "!"
denotes a notification generated.
=====================================================================
+---------------+ + - - - - - - - -+ +------------+
| suspended(6) |<--| suspending(5) | | paused(8) |
| !vmSuspended | | !vmSuspending | | !vmPaused |
+---------------+ + - - - - - - - -+ +------------+
| ^ ^
| | |
v | |
+ - - - - - - -+ +-------------+<----------+ + - - - - - - - +
| resuming(7) |-->| running(4) |<-------------->| migrating(9) |
| !vmResuming | | !vmRunning | | !vmMigrating |
+ - - - - - - -+ +-------------+ + - - - - - - - +
| ^ ^
| | |
| +-------------------+ |
| | |
v v v
+ - - - - - - - - - + +---------------+
| shuttingdown(10) |--------->| shutdown(11) |
| !vmShuttingdown | | !vmShutdown |
+ - - - - - - - - - + +---------------+
^ |
| v !vmDeleted
+--------------+ + - - - - - - - -+ (Deleted from
| crashed(12) | | preparing(3) | vmTable)
| !vmCrashed | | |
+--------------+ + - - - - - - - -+
The overview of the state transition of a virtual machine
Figure 2: State transition of a virtual machine Figure 2: State transition of a virtual machine
The `vmAdminState' and `vmOperState' textual conventions define an The `vmAdminState' and `vmOperState' textual conventions define an
administrative state and an operational state model for virtual administrative state and an operational state model for virtual
machines. Events causing transitions between major operational machines. Events causing transitions between major operational
states will cause the generation of notifications. Per virtual states will cause the generation of notifications. Per virtual
machine (per-VM) notifications (vmRunning, vmShutdown, vmPaused, machine (per-VM) notifications (vmRunning, vmShutdown, vmPaused,
vmSuspended, vmCrashed, vmDeleted) are generated if vmSuspended, vmCrashed, vmDeleted) are generated if
vmPerVMNotificationsEnabled is true(1). Bulk notifications vmPerVMNotificationsEnabled is true(1). Bulk notifications
(vmBulkRunning, vmBulkShutdown, vmBulkPaused, vmBulkSuspended, (vmBulkRunning, vmBulkShutdown, vmBulkPaused, vmBulkSuspended,
vmBulkCrashed, vmBulkDeleted) are generated if vmBulkCrashed, vmBulkDeleted) are generated if
vmBulkNotificationsEnabled is true(1). The transition of vmBulkNotificationsEnabled is true(1). The overview of the
`vmOperState' by the write access to `vmAdminState' and the transition of `vmOperState' by the write access to `vmAdminState' and
notifications generated by the operational state changes are the notifications generated by the operational state changes are
summarized in Figure 2. Note that the notifications shown in this illustrated in Figure 2. The detailed state transition is summarized
figure are per-VM notifications. In the case of Bulk notifications, in Appendix A. Note that the notifications shown in this figure are
the prefix `vm' is replaced with 'vmBulk'. per-VM notifications. In the case of Bulk notifications, the prefix
`vm' is replaced with 'vmBulk'.
The bulk notification mechanism is designed to reduce the number of The bulk notification mechanism is designed to reduce the number of
notifications that are trapped by an SNMP manager. This is because notifications that are trapped by an SNMP manager. This is because
the number of virtual machines managed by a bunch of hypervisors in a the number of virtual machines managed by a bunch of hypervisors in a
datacenter possibly becomes several thousands or more, and datacenter possibly becomes several thousands or more, and
consequently, many notifications could be trapped if these virtual consequently, many notifications could be trapped if these virtual
machines frequently change their administrative state. The per-VM machines frequently change their administrative state. The per-VM
notifications carry more detailed information, but the scalability notifications carry more detailed information, but the scalability is
shall be a problem. An implementation shall support both, either of, a problem. An implementation MUST support both, either of, or none
or none of per-VM notifications and bulk notifications. The of per-VM notifications and bulk notifications. The notification
notification filtering mechanism described in section 6 of RFC 3413 filtering mechanism described in section 6 of RFC 3413 [RFC3413] is
[RFC3413] is used by the management applications to control the used by the management applications to control the notifications.
notifications.
The MIB module provides a few writable objects that can be used to
make non-persistent changes, e.g., changing the memory allocation or
the CPU allocation. It is not the goal of this MIB module to provide
a configuration interface for virtual machines since other protocols
and data modeling languages are more suitable for this task.
The OID tree structure of the MIB module is shown below.
--vmMIB (1.3.6.1.2.1.yyy)
+--vmNotifications(0)
| +--vmRunning(1) [vmName, vmUUID, vmOperState]
| +--vmShuttingdown(2) [vmName, vmUUID, vmOperState]
| +--vmShutdown(3) [vmName, vmUUID, vmOperState]
| +--vmPaused(4) [vmName, vmUUID, vmOperState]
| +--vmSuspending(5) [vmName, vmUUID, vmOperState]
| +--vmSuspended(6) [vmName, vmUUID, vmOperState]
| +--vmResuming(7) [vmName, vmUUID, vmOperState]
| +--vmMigrating(8) [vmName, vmUUID, vmOperState]
| +--vmCrashed(9) [vmName, vmUUID, vmOperState]
| +--vmBlocked(10) [vmName, vmUUID, vmOperState]
| +--vmDeleted(11) [vmName, vmUUID, vmOperState, vmPersistent]
| +--vmBulkRunning(12) [vmAffectedVMs]
| +--vmBulkShutdown(13) [vmAffectedVMs]
| +--vmBulkShuttingdown(14) [vmAffectedVMs]
| +--vmBulkPaused(15) [vmAffectedVMs]
| +--vmBulkSuspending(16) [vmAffectedVMs]
| +--vmBulkSuspended(17) [vmAffectedVMs]
| +--vmBulkResuming(18) [vmName, vmUUID, vmOperState]
| +--vmBulkMigrating(19) [vmAffectedVMs]
| +--vmBulkCrashed(20) [vmAffectedVMs]
| +--vmBulkBlocked(21) [vmAffectedVMs]
| +--vmBulkDeleted(22) [vmAffectedVMs]
+--vmObjects(1)
| +--vmHypervisor(1)
| | +-- r-n SnmpAdminString vmHvSoftware(1)
| | +-- r-n SnmpAdminString vmHvVersion(2)
| | +-- r-n OBJECT IDENTIFIER vmHvObjectID(3)
| | +-- r-n TimeTicks vmHvUpTime(4)
| +-- r-n Integer32 vmNumber(2)
| +-- r-n TimeTicks vmTableLastChange(3)
| +--vmTable(4)
| | +--vmEntry(1) [vmIndex]
| | +-- --- VirtualMachineIndex vmIndex(1)
| | +-- r-n SnmpAdminString vmName(2)
| | +-- r-n UUIDorZero vmUUID(3)
| | +-- r-n SnmpAdminString vmOSType(4)
| | +-- r-n VirtualMachineAdminState
| | | vmAdminState(5)
| | +-- r-n VirtualMachineOperState
| | | vmOperState(6)
| | +-- r-n VirtualMachineAutoStart
| | | vmAutoStart(7)
| | +-- r-n VirtualMachinePersistent
| | | vmPersistent(8)
| | +-- r-n Integer32 vmCurCpuNumber(9)
| | +-- r-n Integer32 vmMinCpuNumber(10)
| | +-- r-n Integer32 vmMaxCpuNumber(11)
| | +-- r-n Integer32 vmMemUnit(12)
| | +-- r-n Integer32 vmCurMem(13)
| | +-- r-n Integer32 vmMinMem(14)
| | +-- r-n Integer32 vmMaxMem(15)
| | +-- r-n TimeTicks vmUpTime(16)
| | +-- r-n Counter64 vmCpuTime(17)
| +--vmCpuTable(5)
| | +--vmCpuEntry(1) [vmIndex, vmCpuIndex]
| | +-- --- VirtualMachineCpuIndex
| | | vmCpuIndex(1)
| | +-- r-n Counter64 vmCpuCoreTime(2)
| +--vmCpuAffinityTable(6)
| | +--vmCpuAffinityEntry(1) [vmIndex,
| | | vmCpuIndex,
| | | vmCpuPhysIndex]
| | +-- --- Integer32 vmCpuPhysIndex(1)
| | +-- r-n Integer32 vmCpuAffinity(2)
| +--vmStorageTable(7)
| | +--vmStorageEntry(1) [vmStorageVmIndex, vmStorageIndex]
| | +-- --- VirtualMachineIndexOrZero
| | | vmStorageVmIndex(1)
| | +-- --- VirtualMachineStorageIndex
| | | vmStorageIndex(2)
| | +-- r-n Integer32 vmStorageParent(3)
| | +-- r-n VirtualMachineStorageSourceType
| | | vmStorageSourceType(4)
| | +-- r-n SnmpAdminString vmStorageSourceTypeString(5)
| | +-- r-n SnmpAdminString vmStorageResourceID(6)
| | +-- r-n VirtualMachineStorageAccess
| | | vmStorageAccess(7)
| | +-- r-n VirtualMachineStorageMediaType
| | | vmStorageMediaType(8)
| | +-- r-n SnmpAdminString vmStorageMediaTypeString(9)
| | +-- r-n Integer32 vmStorageSizeUnit(10)
| | +-- r-n Integer32 vmStorageDefinedSize(11)
| | +-- r-n Integer32 vmStorageAllocatedSize(12)
| | +-- r-n Counter64 vmStorageReadIOs(13)
| | +-- r-n Counter64 vmStorageWriteIOs(14)
| | +-- r-n Counter64 vmStorageReadOctets(15)
| | +-- r-n Counter64 vmStorageWriteOctets(16)
| | +-- r-n Counter64 vmStorageReadLatency(17)
| | +-- r-n Counter64 vmStorageWriteLatency(18)
| +--vmNetworkTable(8)
| | +--vmNetworkEntry(1) [vmIndex, vmNetworkIndex]
| | +-- --- VirtualMachineNetworkIndex
| | | vmNetworkIndex(1)
| | +-- r-n InterfaceIndexOrZero vmNetworkIfIndex(2)
| | +-- r-n InterfaceIndexOrZero vmNetworkParent(3)
| | +-- r-n SnmpAdminString vmNetworkModel(4)
| | +-- r-n PhysAddress vmNetworkPhysAddress(5)
| +-- rwn TruthValue vmPerVMNotificationsEnabled(9)
| +-- rwn TruthValue vmBulkNotificationsEnabled(10)
| +-- --n VirtualMachineList vmAffectedVMs(11)
+--vmConformance(2)
+--vmCompliances(1)
| +--vmFullCompliances(1)
| +--vmReadOnlyCompliances(2)
+--vmGroups(2)
+--vmHypervisorGroup(1)
+--vmVirtualMachineGroup(2)
+--vmCpuGroup(3)
+--vmCpuAffinityGroup(4)
+--vmStorageGroup(5)
+--vmNetworkGroup(6)
+--vmPerVMNotificationOptionalGroup(7)
+--vmBulkNotificationsVariablesGroup(8)
+--vmBulkNotificationOptionalGroup(9)
5. Relationship to Other MIB Modules 5. Relationship to Other MIB Modules
HOST-RESOURCES-MIB [RFC2790] defines the MIB objects for managing HOST-RESOURCES-MIB [RFC2790] defines the MIB objects for managing
host systems. Hypervisors shall implement HOST-RESOURCES-MIB. On host systems. Hypervisors MUST implement HOST-RESOURCES-MIB. On
systems implementing HOST-RESOURCES-MIB, the objects of HOST- systems implementing HOST-RESOURCES-MIB, the objects of HOST-
RESOURCES-MIB indicate resources of a hypervisor. Some objects of RESOURCES-MIB indicate resources of a hypervisor. Some objects of
HOST-RESOURCES-MIB shall also be used to indicate physical resources HOST-RESOURCES-MIB are used to indicate physical resources through
through indexes. On systems implementing HOST-RESOURCES-MIB, the indexes. On systems implementing HOST-RESOURCES-MIB, the
`vmCpuPhysIndex' points to the processor's `hrDeviceIndex' in the `vmCpuPhysIndex' points to the processor's `hrDeviceIndex' in the
`hrProcessorTable'. The `vmStorageParent' also points to the storage `hrProcessorTable'. The `vmStorageParent' also points to the storage
device's `hrStorageIndex' in the `hrStorageTable'. device's `hrStorageIndex' in the `hrStorageTable'.
HOST-RESOURCES-MIB shall be implemented on systems running on virtual
machines. It enables to manage the objects related to the resources
of virtual machines from the viewpoint of virtual machine operators.
However, from the viewpoint of hypervisor operators, it cannot obtain
the list of virtual machines controlled by a hypervisor and the
relationship between physical and virtual resources. This document
defines the objects of these information.
IF-MIB [RFC2863] defines the MIB objects for managing network IF-MIB [RFC2863] defines the MIB objects for managing network
interfaces. Both physical and virtual network interfaces are interfaces. Both physical and virtual network interfaces are
required to be contained in the `ifTable' of IF-MIB. The virtual required to be contained in the `ifTable' of IF-MIB. The virtual
network interfaces in the `ifTable' of IF-MIB are pointed from the network interfaces in the `ifTable' of IF-MIB are pointed from the
`vmNetworkTable' defined in this document through a pointer `vmNetworkTable' defined in this document through a pointer
`vmNetworkIfIndex'. In case that an entry in the `vmNetworkTable' `vmNetworkIfIndex'. In case that an entry in the `vmNetworkTable'
has a corresponding parent physical network interface managed in the has a corresponding parent physical network interface managed in the
`ifTable' of IF-MIB, the entry contains a pointer `vmNetworkParent' `ifTable' of IF-MIB, the entry contains a pointer `vmNetworkParent'
to the physical network interface. to the physical network interface.
The objects related to virtual switches are not also included in the The objects related to virtual switches are not included in the MIB
MIB module defined in this document though virtual switches shall be module defined in this document though virtual switches MAY be placed
placed on a hypervisor. This is because the virtual network on a hypervisor. This is because the virtual network interfaces are
interfaces are the lowest abstraction of network resources allocated the lowest abstraction of network resources allocated to a virtual
to a virtual machine. Instead of including the objects related to machine. Instead of including the objects related to virtual
virtual switches, for example, IEEE8021-BRIDGE-MIB switches, for example, IEEE8021-BRIDGE-MIB [IEEE8021-BRIDGE-MIB] and
[IEEE8021-BRIDGE-MIB] and IEEE8021-Q-BRIDGE-MIB IEEE8021-Q-BRIDGE-MIB [IEEE8021-Q-BRIDGE-MIB] could be used.
[IEEE8021-Q-BRIDGE-MIB] could be used.
The other objects related to virtual machines such as management IP The other objects related to virtual machines such as management IP
addresses of a virtual machine are not included in this MIB module addresses of a virtual machine are not included in this MIB module
because this MIB module defines the objects common to general because this MIB module defines the objects common to general
hypervisors but they are specific to some hypervisors. They may be hypervisors but they are specific to some hypervisors. They may be
included in the entLogicalTable of ENTITY-MIB [RFC6933]. included in the entLogicalTable of ENTITY-MIB [RFC6933].
6. Definitions 6. Definitions
6.1. VM-MIB
VM-MIB DEFINITIONS ::= BEGIN VM-MIB DEFINITIONS ::= BEGIN
IMPORTS IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, TimeTicks, MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, TimeTicks,
Counter64, Integer32, mib-2 Counter64, Integer32, mib-2
FROM SNMPv2-SMI FROM SNMPv2-SMI
OBJECT-GROUP, MODULE-COMPLIANCE, NOTIFICATION-GROUP OBJECT-GROUP, MODULE-COMPLIANCE, NOTIFICATION-GROUP
FROM SNMPv2-CONF FROM SNMPv2-CONF
TEXTUAL-CONVENTION, PhysAddress, TruthValue TEXTUAL-CONVENTION, PhysAddress, TruthValue
FROM SNMPv2-TC FROM SNMPv2-TC
SnmpAdminString SnmpAdminString
FROM SNMP-FRAMEWORK-MIB FROM SNMP-FRAMEWORK-MIB
UUIDorZero UUIDorZero
FROM UUID-TC-MIB FROM UUID-TC-MIB
InterfaceIndexOrZero InterfaceIndexOrZero
FROM IF-MIB; FROM IF-MIB
IANAStorageMediaType
FROM IANA-STORAGE-MEDIA-TYPE-MIB;
vmMIB MODULE-IDENTITY vmMIB MODULE-IDENTITY
LAST-UPDATED "201410260000Z" -- 26 October 2014 LAST-UPDATED "201505260000Z" -- 26 May 2015
ORGANIZATION "IETF Operations and Management Area Working Group" ORGANIZATION "IETF Operations and Management Area Working Group"
CONTACT-INFO CONTACT-INFO
" "
WG E-mail: opsawg@ietf.org WG E-mail: opsawg@ietf.org
Mailing list subscription info: Mailing list subscription info:
https://www.ietf.org/mailman/listinfo/opsawg https://www.ietf.org/mailman/listinfo/opsawg
Hirochika Asai Hirochika Asai
The University of Tokyo The University of Tokyo
7-3-1 Hongo 7-3-1 Hongo
skipping to change at page 14, line 24 skipping to change at page 12, line 28
USA USA
Email: tina.tsou.zouting@huawei.com Email: tina.tsou.zouting@huawei.com
" "
DESCRIPTION DESCRIPTION
"This MIB module is for use in managing a hypervisor and "This MIB module is for use in managing a hypervisor and
virtual machines controlled by the hypervisor. The OID virtual machines controlled by the hypervisor. The OID
`yyy' is temporary one, and it must be assigned by IANA `yyy' is temporary one, and it must be assigned by IANA
when this becomes an official document. when this becomes an official document.
Copyright (c) 2014 IETF Trust and the persons identified Copyright (c) 2015 IETF Trust and the persons identified
as authors of the code. All rights reserved. as authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with Redistribution and use in source and binary forms, with
or without modification, is permitted pursuant to, and or without modification, is permitted pursuant to, and
subject to the license terms contained in, the subject to the license terms contained in, the
Simplified BSD License set forth in Section 4.c of the Simplified BSD License set forth in Section 4.c of the
IETF Trust's Legal Provisions Relating to IETF Documents IETF Trust's Legal Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info)." (http://trustee.ietf.org/license-info)."
REVISION "201410260000Z" -- 26 October 2014 REVISION "201505260000Z" -- 26 May 2015
DESCRIPTION DESCRIPTION
"The original version of this MIB, published as "The original version of this MIB, published as
RFCXXXX." RFCXXXX."
::= { mib-2 yyy } ::= { mib-2 yyy }
vmNotifications OBJECT IDENTIFIER ::= { vmMIB 0 } vmNotifications OBJECT IDENTIFIER ::= { vmMIB 0 }
vmObjects OBJECT IDENTIFIER ::= { vmMIB 1 } vmObjects OBJECT IDENTIFIER ::= { vmMIB 1 }
vmConformance OBJECT IDENTIFIER ::= { vmMIB 2 } vmConformance OBJECT IDENTIFIER ::= { vmMIB 2 }
-- Textual conversion definitions -- Textual conversion definitions
-- --
VirtualMachineIndex ::= TEXTUAL-CONVENTION VirtualMachineIndex ::= TEXTUAL-CONVENTION
DISPLAY-HINT "d" DISPLAY-HINT "d"
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A unique value, greater than zero, identifying a "A unique value, greater than zero, identifying a
virtual machine. The value for each virtual machine virtual machine. The value for each virtual machine
must remain constant at least from one re-initialization MUST remain constant at least from one re-initialization
of the hypervisor to the next re-initialization." of the hypervisor to the next re-initialization."
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
VirtualMachineIndexOrZero ::= TEXTUAL-CONVENTION VirtualMachineIndexOrZero ::= TEXTUAL-CONVENTION
DISPLAY-HINT "d" DISPLAY-HINT "d"
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This textual convention is an extension of the "This textual convention is an extension of the
VirtualMachineIndex convention. This extension permits VirtualMachineIndex convention. This extension permits
the additional value of zero. The meaning of the value the additional value of zero. The meaning of the value
zero is object-specific and must therefore be defined as zero is object-specific and MUST therefore be defined as
part of the description of any object which uses this part of the description of any object which uses this
syntax. Examples of the usage of zero might include syntax. Examples of the usage of zero might include
situations where a virtual machine is unknown, or when situations where a virtual machine is unknown, or when
none or all virtual machines need to be referenced." none or all virtual machines need to be referenced."
SYNTAX Integer32 (0..2147483647) SYNTAX Integer32 (0..2147483647)
VirtualMachineAdminState ::= TEXTUAL-CONVENTION VirtualMachineAdminState ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The administrative state of a virtual machine: "The administrative state of a virtual machine:
skipping to change at page 15, line 47 skipping to change at page 13, line 51
and will be restored at next running(1). and will be restored at next running(1).
paused(3) The administrative state indicating the paused(3) The administrative state indicating the
virtual machine is resident in memory but virtual machine is resident in memory but
is no longer scheduled to execute by the is no longer scheduled to execute by the
hypervisor. hypervisor.
shutdown(4) The administrative state of the virtual shutdown(4) The administrative state of the virtual
machine indicating the virtual machine machine indicating the virtual machine
is currently offline or should be taken is currently offline or should be taken
shutting down. shutting down."
destroy(5) The administrative state of the virtual
machine indicating the virtual machine
should be forcibly shutdown. After the
destroy operation, the administrative
state should be automatically changed to
shutdown(4)."
SYNTAX INTEGER { SYNTAX INTEGER {
running(1), running(1),
suspended(2), suspended(2),
paused(3), paused(3),
shutdown(4), shutdown(4)
destroy(5)
} }
VirtualMachineOperState ::= TEXTUAL-CONVENTION VirtualMachineOperState ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The operational state of a virtual machine: "The operational state of a virtual machine:
unknown(1) The operational state of the virtual unknown(1) The operational state of the virtual
machine is unknown, e.g., because the machine is unknown, e.g., because the
implementation failed to obtain the state implementation failed to obtain the state
skipping to change at page 16, line 41 skipping to change at page 14, line 38
preparing(3) The operational state of the virtual preparing(3) The operational state of the virtual
machine indicating the virtual machine is machine indicating the virtual machine is
currently in the process of preparation, currently in the process of preparation,
e.g., allocating and initializing virtual e.g., allocating and initializing virtual
storage after creating (defining) virtual storage after creating (defining) virtual
machine. machine.
running(4) The operational state of the virtual running(4) The operational state of the virtual
machine indicating the virtual machine is machine indicating the virtual machine is
currently executed but it is not in the currently executed but it is not in the
process of preparing(3), suspending(6), process of preparing(3), suspending(5),
resuming(8), migrating(10), and resuming(7), migrating(9), and
shuttingdown(11). shuttingdown(10).
blocked(5) The operational state of the virtual
machine indicating the execution of the
virtual machine is currently blocked,
e.g., waiting for some action of the
hypervisor to finish. This is a
transient state from/to other states.
suspending(6) The operational state of the virtual suspending(5) The operational state of the virtual
machine indicating the virtual machine is machine indicating the virtual machine is
currently in the process of suspending currently in the process of suspending
to save its memory and CPU execution to save its memory and CPU execution
state to persistent store. This is a state to persistent store. This is a
transient state from running(4) to transient state from running(4) to
suspended(7). suspended(6).
suspended(7) The operational state of the virtual suspended(6) The operational state of the virtual
machine indicating the virtual machine is machine indicating the virtual machine is
currently suspended, which means the currently suspended, which means the
memory and CPU execution state of the memory and CPU execution state of the
virtual machine are saved to persistent virtual machine are saved to persistent
store. During this state, the virtual store. During this state, the virtual
machine is not scheduled to execute by machine is not scheduled to execute by
the hypervisor. the hypervisor.
resuming(8) The operational state of the virtual resuming(7) The operational state of the virtual
machine indicating the virtual machine is machine indicating the virtual machine is
currently in the process of resuming currently in the process of resuming
to restore its memory and CPU execution to restore its memory and CPU execution
state from persistent store. This is a state from persistent store. This is a
transient state from suspended(7) to transient state from suspended(6) to
running(4). running(4).
paused(9) The operational state of the virtual paused(8) The operational state of the virtual
machine indicating the virtual machine is machine indicating the virtual machine is
resident in memory but no longer resident in memory but no longer
scheduled to execute by the hypervisor. scheduled to execute by the hypervisor.
migrating(10) The operational state of the virtual migrating(9) The operational state of the virtual
machine indicating the virtual machine is machine indicating the virtual machine is
currently in the process of migration currently in the process of migration
from/to another hypervisor. from/to another hypervisor.
shuttingdown(11) shuttingdown(10)
The operational state of the virtual The operational state of the virtual
machine indicating the virtual machine is machine indicating the virtual machine is
currently in the process of shutting currently in the process of shutting
down. This is a transient state from down. This is a transient state from
running(4) to shutdown(12). running(4) to shutdown(11).
shutdown(12) The operational state of the virtual shutdown(11) The operational state of the virtual
machine indicating the virtual machine is machine indicating the virtual machine is
down, and CPU execution is no longer down, and CPU execution is no longer
scheduled by the hypervisor and its scheduled by the hypervisor and its
memory is not resident in the hypervisor. memory is not resident in the hypervisor.
crashed(13) The operational state of the virtual crashed(12) The operational state of the virtual
machine indicating the virtual machine machine indicating the virtual machine
has crashed." has crashed."
SYNTAX INTEGER { SYNTAX INTEGER {
unknown(1), unknown(1),
other(2), other(2),
preparing(3), preparing(3),
running(4), running(4),
blocked(5), suspending(5),
suspending(6), suspended(6),
suspended(7), resuming(7),
resuming(8), paused(8),
paused(9), migrating(9),
migrating(10), shuttingdown(10),
shuttingdown(11), shutdown(11),
shutdown(12), crashed(12)
crashed(13)
} }
VirtualMachineAutoStart ::= TEXTUAL-CONVENTION VirtualMachineAutoStart ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The autostart configuration of a virtual machine: "The autostart configuration of a virtual machine:
unknown(1) The autostart configuration is unknown, unknown(1) The autostart configuration is unknown,
e.g., because the implementation failed e.g., because the implementation failed
to obtain the autostart configuration to obtain the autostart configuration
skipping to change at page 19, line 33 skipping to change at page 17, line 21
persistent(2), persistent(2),
transient(3) transient(3)
} }
VirtualMachineCpuIndex ::= TEXTUAL-CONVENTION VirtualMachineCpuIndex ::= TEXTUAL-CONVENTION
DISPLAY-HINT "d" DISPLAY-HINT "d"
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A unique value for each virtual machine, greater than "A unique value for each virtual machine, greater than
zero, identifying a virtual CPU assigned to a virtual zero, identifying a virtual CPU assigned to a virtual
machine. The value for each virtual CPU must remain machine. The value for each virtual CPU MUST remain
constant at least from one re-initialization of the constant at least from one re-initialization of the
hypervisor to the next re-initialization." hypervisor to the next re-initialization."
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
VirtualMachineStorageIndex ::= TEXTUAL-CONVENTION VirtualMachineStorageIndex ::= TEXTUAL-CONVENTION
DISPLAY-HINT "d" DISPLAY-HINT "d"
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A unique value for each virtual machine, greater than "A unique value for each virtual machine, greater than
zero, identifying a virtual storage device allocated to zero, identifying a virtual storage device allocated to
a virtual machine. The value for each virtual storage a virtual machine. The value for each virtual storage
device must remain constant at least from one device MUST remain constant at least from one
re-initialization of the hypervisor to the next re-initialization of the hypervisor to the next
re-initialization." re-initialization."
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
VirtualMachineStorageSourceType ::= TEXTUAL-CONVENTION VirtualMachineStorageSourceType ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The source type of a virtual storage device: "The source type of a virtual storage device:
unknown(1) The source type is unknown, e.g., because unknown(1) The source type is unknown, e.g., because
skipping to change at page 20, line 35 skipping to change at page 18, line 24
raw(4), raw(4),
sparse(5), sparse(5),
network(6) network(6)
} }
VirtualMachineStorageAccess ::= TEXTUAL-CONVENTION VirtualMachineStorageAccess ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The access permission of a virtual storage: "The access permission of a virtual storage:
readwrite(1) The virtual storage is a read-write unknown(1) The access permission of the virtual
storage is unknown.
readwrite(2) The virtual storage is a read-write
device. device.
readonly(2) The virtual storage is a read-only readonly(3) The virtual storage is a read-only
device." device."
SYNTAX INTEGER { SYNTAX INTEGER {
readwrite(1), unknown(1),
readonly(2) readwrite(2),
} readonly(3)
VirtualMachineStorageMediaType ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"The media type of a virtual storage device:
unknown(1) The media type is unknown, e.g., because
the implementation failed to obtain the
media type from the hypervisor.
other(2) The media type is other than those
defined in this conversion.
hardDisk(3) The media type is hard disk.
opticalDisk(4) The media type is optical disk."
SYNTAX INTEGER {
other(1),
unknown(2),
hardDisk(3),
opticalDisk(4)
} }
VirtualMachineNetworkIndex ::= TEXTUAL-CONVENTION VirtualMachineNetworkIndex ::= TEXTUAL-CONVENTION
DISPLAY-HINT "d" DISPLAY-HINT "d"
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A unique value for each virtual machine, greater than "A unique value for each virtual machine, greater than
zero, identifying a virtual network interface allocated zero, identifying a virtual network interface allocated
to the virtual machine. The value for each virtual to the virtual machine. The value for each virtual
network interface must remain constant at least from one network interface MUST remain constant at least from one
re-initialization of the hypervisor to the next re-initialization of the hypervisor to the next
re-initialization." re-initialization."
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
VirtualMachineList ::= TEXTUAL-CONVENTION VirtualMachineList ::= TEXTUAL-CONVENTION
DISPLAY-HINT "1x" DISPLAY-HINT "1x"
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Each octet within this value specifies a set of eight "Each octet within this value specifies a set of eight
virtual machine vmIndex, with the first octet specifying virtual machine vmIndex, with the first octet specifying
skipping to change at page 22, line 4 skipping to change at page 19, line 22
the host is represented by a single bit within the value the host is represented by a single bit within the value
of this object. If that bit has a value of '1', then of this object. If that bit has a value of '1', then
that virtual machine is included in the set of virtual that virtual machine is included in the set of virtual
machines; the virtual machine is not included if its bit machines; the virtual machine is not included if its bit
has a value of '0'." has a value of '0'."
SYNTAX OCTET STRING SYNTAX OCTET STRING
-- The hypervisor group -- The hypervisor group
-- --
-- A collection of objects common to all hypervisors. -- A collection of objects common to all hypervisors.
-- --
vmHypervisor OBJECT IDENTIFIER ::= { vmObjects 1 } vmHypervisor OBJECT IDENTIFIER ::= { vmObjects 1 }
vmHvSoftware OBJECT-TYPE vmHvSoftware OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..255)) SYNTAX SnmpAdminString (SIZE (0..255))
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A textual description of the hypervisor software. This "A textual description of the hypervisor software. This
value should not include its version, and it should be value SHOULD not include its version as it SHOULD be
included in `vmHvVersion'." included in `vmHvVersion'."
::= { vmHypervisor 1 } ::= { vmHypervisor 1 }
vmHvVersion OBJECT-TYPE vmHvVersion OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..255)) SYNTAX SnmpAdminString (SIZE (0..255))
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A textual description of the version of the hypervisor "A textual description of the version of the hypervisor
software." software."
skipping to change at page 24, line 31 skipping to change at page 21, line 49
} }
vmIndex OBJECT-TYPE vmIndex OBJECT-TYPE
SYNTAX VirtualMachineIndex SYNTAX VirtualMachineIndex
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A unique value, greater than zero, identifying the "A unique value, greater than zero, identifying the
virtual machine. The value assigned to a given virtual virtual machine. The value assigned to a given virtual
machine may not persist across re-initialization of the machine may not persist across re-initialization of the
hypervisor. A command generator must use the vmUUID to hypervisor. A command generator MUST use the vmUUID to
identify a given virtual machine of interest." identify a given virtual machine of interest."
::= { vmEntry 1 } ::= { vmEntry 1 }
vmName OBJECT-TYPE vmName OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..255)) SYNTAX SnmpAdminString (SIZE (0..255))
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A textual name of the virtual machine." "A textual name of the virtual machine."
::= { vmEntry 2 } ::= { vmEntry 2 }
vmUUID OBJECT-TYPE vmUUID OBJECT-TYPE
SYNTAX UUIDorZero SYNTAX UUIDorZero
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The virtual machine's 128-bit UUID or the zero-length "The virtual machine's 128-bit UUID or the zero-length
string when a UUID is not available. The UUID if set string when a UUID is not available. The UUID if set
must uniquely identify a virtual machine from all other MUST uniquely identify a virtual machine from all other
virtual machines in an administrative region. A virtual machines in an administrative domain. A
zero-length octet string is returned if no UUID zero-length octet string is returned if no UUID
information is known." information is known."
::= { vmEntry 3 } ::= { vmEntry 3 }
vmOSType OBJECT-TYPE vmOSType OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..255)) SYNTAX SnmpAdminString (SIZE (0..255))
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A textual description containing operating system "A textual description containing operating system
skipping to change at page 25, line 27 skipping to change at page 22, line 45
started. This may differ from the actual operating started. This may differ from the actual operating
system in case the virtual machine boots into a system in case the virtual machine boots into a
different operating system." different operating system."
::= { vmEntry 4 } ::= { vmEntry 4 }
vmAdminState OBJECT-TYPE vmAdminState OBJECT-TYPE
SYNTAX VirtualMachineAdminState SYNTAX VirtualMachineAdminState
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The administrative power state of the virtual machine." "The administrative state of the virtual machine."
::= { vmEntry 5 } ::= { vmEntry 5 }
vmOperState OBJECT-TYPE vmOperState OBJECT-TYPE
SYNTAX VirtualMachineOperState SYNTAX VirtualMachineOperState
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The operational state of the virtual machine." "The operational state of the virtual machine."
::= { vmEntry 6 } ::= { vmEntry 6 }
skipping to change at page 26, line 46 skipping to change at page 24, line 15
"The maximum number of virtual CPUs that are assigned to "The maximum number of virtual CPUs that are assigned to
the virtual machine when it is in a power-on state. The the virtual machine when it is in a power-on state. The
value -1 indicates that there is no limit." value -1 indicates that there is no limit."
::= { vmEntry 11 } ::= { vmEntry 11 }
vmMemUnit OBJECT-TYPE vmMemUnit OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The multiplication unit for vmCurMem, vmMinMem, and "The multiplication unit in byte for vmCurMem, vmMinMem,
vmMaxMem. For example, when this value is 1024, the and vmMaxMem. For example, when this value is 1024, the
memory size unit for vmCurMem, vmMinMem, and vmMaxMem is memory size unit for vmCurMem, vmMinMem, and vmMaxMem is
KiB." KiB."
::= { vmEntry 12 } ::= { vmEntry 12 }
vmCurMem OBJECT-TYPE vmCurMem OBJECT-TYPE
SYNTAX Integer32 (0..2147483647) SYNTAX Integer32 (0..2147483647)
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The current memory size currently allocated to the "The current memory size currently allocated to the
skipping to change at page 29, line 47 skipping to change at page 27, line 15
vmCpuAffinity Integer32 vmCpuAffinity Integer32
} }
vmCpuPhysIndex OBJECT-TYPE vmCpuPhysIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A value identifying a physical CPU on the hypervisor. "A value identifying a physical CPU on the hypervisor.
On systems implementing the HOST-RESOURCES-MIB, the On systems implementing the HOST-RESOURCES-MIB, the
value must be the same value that is used as the index value MUST be the same value that is used as the index
in the hrProcessorTable (hrDeviceIndex)." in the hrProcessorTable (hrDeviceIndex)."
::= { vmCpuAffinityEntry 2 } ::= { vmCpuAffinityEntry 2 }
vmCpuAffinity OBJECT-TYPE vmCpuAffinity OBJECT-TYPE
SYNTAX INTEGER { SYNTAX INTEGER {
unknown(0), -- unknown unknown(0), -- unknown
enable(1), -- enabled enable(1), -- enabled
disable(2) -- disabled disable(2) -- disabled
} }
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The CPU affinity of this virtual CPU to the physical "The CPU affinity of this virtual CPU to the physical
CPU represented by `vmCpuPhysIndex'." CPU represented by `vmCpuPhysIndex'."
::= { vmCpuAffinityEntry 3 } ::= { vmCpuAffinityEntry 3 }
-- The virtual storage devices on each virtual machine. This -- The virtual storage devices on each virtual machine. This
-- document defines some overlapped objects with hrStorage in -- document defines some overlapped objects with hrStorage in
-- HOST-RESOURCES-MIB [RFC2790], because virtual resources shall be -- HOST-RESOURCES-MIB [RFC2790], because virtual resources are
-- allocated from the hypervisor's resources, which is the `host -- allocated from the hypervisor's resources, which is the `host
-- resources' -- resources'
vmStorageTable OBJECT-TYPE vmStorageTable OBJECT-TYPE
SYNTAX SEQUENCE OF VmStorageEntry SYNTAX SEQUENCE OF VmStorageEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The conceptual table of virtual storage devices "The conceptual table of virtual storage devices
attached to the virtual machine." attached to the virtual machine."
::= { vmObjects 7 } ::= { vmObjects 7 }
skipping to change at page 30, line 50 skipping to change at page 28, line 19
VmStorageEntry ::= VmStorageEntry ::=
SEQUENCE { SEQUENCE {
vmStorageVmIndex VirtualMachineIndexOrZero, vmStorageVmIndex VirtualMachineIndexOrZero,
vmStorageIndex VirtualMachineStorageIndex, vmStorageIndex VirtualMachineStorageIndex,
vmStorageParent Integer32, vmStorageParent Integer32,
vmStorageSourceType VirtualMachineStorageSourceType, vmStorageSourceType VirtualMachineStorageSourceType,
vmStorageSourceTypeString vmStorageSourceTypeString
SnmpAdminString, SnmpAdminString,
vmStorageResourceID SnmpAdminString, vmStorageResourceID SnmpAdminString,
vmStorageAccess VirtualMachineStorageAccess, vmStorageAccess VirtualMachineStorageAccess,
vmStorageMediaType VirtualMachineStorageMediaType, vmStorageMediaType IANAStorageMediaType,
vmStorageMediaTypeString vmStorageMediaTypeString
SnmpAdminString, SnmpAdminString,
vmStorageSizeUnit Integer32, vmStorageSizeUnit Integer32,
vmStorageDefinedSize Integer32, vmStorageDefinedSize Integer32,
vmStorageAllocatedSize Integer32, vmStorageAllocatedSize Integer32,
vmStorageReadIOs Counter64, vmStorageReadIOs Counter64,
vmStorageWriteIOs Counter64, vmStorageWriteIOs Counter64,
vmStorageReadOctets Counter64, vmStorageReadOctets Counter64,
vmStorageWriteOctets Counter64, vmStorageWriteOctets Counter64,
vmStorageReadLatency Counter64, vmStorageReadLatency Counter64,
skipping to change at page 32, line 39 skipping to change at page 30, line 6
vmStorageAccess OBJECT-TYPE vmStorageAccess OBJECT-TYPE
SYNTAX VirtualMachineStorageAccess SYNTAX VirtualMachineStorageAccess
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The access permission of the virtual storage device." "The access permission of the virtual storage device."
::= { vmStorageEntry 7 } ::= { vmStorageEntry 7 }
vmStorageMediaType OBJECT-TYPE vmStorageMediaType OBJECT-TYPE
SYNTAX VirtualMachineStorageMediaType SYNTAX IANAStorageMediaType
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The media type of the virtual storage device." "The media type of the virtual storage device."
::= { vmStorageEntry 8 } ::= { vmStorageEntry 8 }
vmStorageMediaTypeString OBJECT-TYPE vmStorageMediaTypeString OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..255)) SYNTAX SnmpAdminString (SIZE (0..255))
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
skipping to change at page 33, line 13 skipping to change at page 30, line 28
"A (detailed) textual string of the virtual storage "A (detailed) textual string of the virtual storage
media. For example, this represents the specific driver media. For example, this represents the specific driver
name of the emulated media such as `IDE' and `SCSI'." name of the emulated media such as `IDE' and `SCSI'."
::= { vmStorageEntry 9 } ::= { vmStorageEntry 9 }
vmStorageSizeUnit OBJECT-TYPE vmStorageSizeUnit OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The multiplication unit for vmStorageDefinedSize and "The multiplication unit in byte for
vmStorageAllocatedSize. For example, when this value is vmStorageDefinedSize and vmStorageAllocatedSize. For
1048576, the storage size unit for vmStorageDefinedSize example, when this value is 1048576, the storage size
and vmStorageAllocatedSize is MiB." unit for vmStorageDefinedSize and vmStorageAllocatedSize
is MiB."
::= { vmStorageEntry 10 } ::= { vmStorageEntry 10 }
vmStorageDefinedSize OBJECT-TYPE vmStorageDefinedSize OBJECT-TYPE
SYNTAX Integer32 (-1|0..2147483647) SYNTAX Integer32 (-1|0..2147483647)
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The defined virtual storage size defined in the unit "The defined virtual storage size defined in the unit
designated by vmStorageSizeUnit. If this information is designated by vmStorageSizeUnit. If this information is
not available, this value shall be -1." not available, this value MUST be -1."
::= { vmStorageEntry 11 } ::= { vmStorageEntry 11 }
vmStorageAllocatedSize OBJECT-TYPE vmStorageAllocatedSize OBJECT-TYPE
SYNTAX Integer32 (-1|0..2147483647) SYNTAX Integer32 (-1|0..2147483647)
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The storage size allocated to the virtual storage from "The storage size allocated to the virtual storage from
a physical storage in the unit designated by a physical storage in the unit designated by
vmStorageSizeUnit. When the virtual storage is block vmStorageSizeUnit. When the virtual storage is block
device or raw file, this value and vmStorageDefinedSize device or raw file, this value and vmStorageDefinedSize
are supposed to equal. This value MUST NOT be different are supposed to equal. This value MUST NOT be different
from vmStorageDefinedSize when vmStorageSourceType is from vmStorageDefinedSize when vmStorageSourceType is
`block' or `raw'. If this information is not available, `block' or `raw'. If this information is not available,
this value shall be -1." this value MUST be -1."
::= { vmStorageEntry 12 } ::= { vmStorageEntry 12 }
vmStorageReadIOs OBJECT-TYPE vmStorageReadIOs OBJECT-TYPE
SYNTAX Counter64 SYNTAX Counter64
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of read I/O requests. "The number of read I/O requests.
Discontinuities in the value of this counter can occur Discontinuities in the value of this counter can occur
skipping to change at page 35, line 11 skipping to change at page 32, line 26
SYNTAX Counter64 SYNTAX Counter64
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The total number of microseconds read requests have "The total number of microseconds read requests have
been queued for this device. been queued for this device.
This would typically be implemented by storing the high This would typically be implemented by storing the high
precision system time stamp of when the request is precision system time stamp of when the request is
received from the virtual machine with the request, the received from the virtual machine with the request, the
difference between this initial timestamp and the time difference between this initial timestamp and the time
at which the requested operation has completed should be at which the requested operation has completed SHOULD be
converted to microseconds and accumulated. converted to microseconds and accumulated.
Discontinuities in the value of this counter can occur at Discontinuities in the value of this counter can occur at
re-initialization of the hypervisor, and administrative re-initialization of the hypervisor, and administrative
state (vmAdminState) changes of the virtual machine." state (vmAdminState) changes of the virtual machine."
::= { vmStorageEntry 17 } ::= { vmStorageEntry 17 }
vmStorageWriteLatency OBJECT-TYPE vmStorageWriteLatency OBJECT-TYPE
SYNTAX Counter64 SYNTAX Counter64
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The total number of microseconds write requests have "The total number of microseconds write requests have
been queued for this device. been queued for this device.
This would typically be implemented by storing the high This would typically be implemented by storing the high
precision system time stamp of when the request is precision system time stamp of when the request is
received from the virtual machine with the request, the received from the virtual machine with the request, the
difference between this initial timestamp and the time difference between this initial timestamp and the time
at which the requested operation has completed should be at which the requested operation has completed SHOULD be
converted to microseconds and accumulated. converted to microseconds and accumulated.
Discontinuities in the value of this counter can occur Discontinuities in the value of this counter can occur
at re-initialization of the hypervisor, and at re-initialization of the hypervisor, and
administrative state (vmAdminState) changes of the administrative state (vmAdminState) changes of the
virtual machine." virtual machine."
::= { vmStorageEntry 18 } ::= { vmStorageEntry 18 }
-- The virtual network interfaces on each virtual machine. -- The virtual network interfaces on each virtual machine.
vmNetworkTable OBJECT-TYPE vmNetworkTable OBJECT-TYPE
SYNTAX SEQUENCE OF VmNetworkEntry SYNTAX SEQUENCE OF VmNetworkEntry
skipping to change at page 36, line 35 skipping to change at page 33, line 50
allocated to the virtual machine." allocated to the virtual machine."
::= { vmNetworkEntry 1 } ::= { vmNetworkEntry 1 }
vmNetworkIfIndex OBJECT-TYPE vmNetworkIfIndex OBJECT-TYPE
SYNTAX InterfaceIndexOrZero SYNTAX InterfaceIndexOrZero
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of ifIndex which corresponds to this virtual "The value of ifIndex which corresponds to this virtual
network interface. If this device is not represented in network interface. If this device is not represented in
the ifTable, then this value shall be zero." the ifTable, then this value MUST be zero."
::= { vmNetworkEntry 2 } ::= { vmNetworkEntry 2 }
vmNetworkParent OBJECT-TYPE vmNetworkParent OBJECT-TYPE
SYNTAX InterfaceIndexOrZero SYNTAX InterfaceIndexOrZero
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of ifIndex which corresponds to the parent "The value of ifIndex which corresponds to the parent
(i.e., physical) device of this virtual device on. The (i.e., physical) device of this virtual device on. The
value zero denotes this virtual device is not any child value zero denotes this virtual device is not any child
skipping to change at page 38, line 21 skipping to change at page 35, line 34
vmOperState vmOperState
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of a virtual machine has been changed to state of a virtual machine has been changed to
running(4) from some other state. The other state is running(4) from some other state. The other state is
indicated by the included value of vmOperState." indicated by the included value of vmOperState."
::= { vmNotifications 1 } ::= { vmNotifications 1 }
vmShutdown NOTIFICATION-TYPE vmShuttingdown NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmName, vmName,
vmUUID, vmUUID,
vmOperState vmOperState
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of a virtual machine has been changed to state of a virtual machine has been changed to
shutdown(12) from some other state. The other state is shuttingdown(10) from some other state. The other state
indicated by the included value of vmOperState." is indicated by the included value of vmOperState."
::= { vmNotifications 2 } ::= { vmNotifications 2 }
vmShuttingdown NOTIFICATION-TYPE vmShutdown NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmName, vmName,
vmUUID, vmUUID,
vmOperState vmOperState
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of a virtual machine has been changed to state of a virtual machine has been changed to
shuttingdown(11) from some other state. The other state shutdown(11) from some other state. The other state is
is indicated by the included value of vmOperState." indicated by the included value of vmOperState."
::= { vmNotifications 3 } ::= { vmNotifications 3 }
vmPaused NOTIFICATION-TYPE vmPaused NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmName, vmName,
vmUUID, vmUUID,
vmOperState vmOperState
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of a virtual machine has been changed to state of a virtual machine has been changed to
paused(9) from some other state. The other state is paused(8) from some other state. The other state is
indicated by the included value of vmOperState." indicated by the included value of vmOperState."
::= { vmNotifications 4 } ::= { vmNotifications 4 }
vmSuspending NOTIFICATION-TYPE vmSuspending NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmName, vmName,
vmUUID, vmUUID,
vmOperState vmOperState
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of a virtual machine has been changed to state of a virtual machine has been changed to
suspending(6) from some other state. The other state is suspending(5) from some other state. The other state is
indicated by the included value of vmOperState." indicated by the included value of vmOperState."
::= { vmNotifications 5 } ::= { vmNotifications 5 }
vmSuspended NOTIFICATION-TYPE vmSuspended NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmName, vmName,
vmUUID, vmUUID,
vmOperState vmOperState
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of a virtual machine has been changed to state of a virtual machine has been changed to
suspended(7) from some other state. The other state is suspended(6) from some other state. The other state is
indicated by the included value of vmOperState." indicated by the included value of vmOperState."
::= { vmNotifications 6 } ::= { vmNotifications 6 }
vmResuming NOTIFICATION-TYPE vmResuming NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmName, vmName,
vmUUID, vmUUID,
vmOperState vmOperState
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of a virtual machine has been changed to state of a virtual machine has been changed to
resuming(8) from some other state. The other state is resuming(7) from some other state. The other state is
indicated by the included value of vmOperState." indicated by the included value of vmOperState."
::= { vmNotifications 7 } ::= { vmNotifications 7 }
vmMigrating NOTIFICATION-TYPE vmMigrating NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmName, vmName,
vmUUID, vmUUID,
vmOperState vmOperState
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of a virtual machine has been changed to state of a virtual machine has been changed to
migrating(10) from some other state. The other state is migrating(9) from some other state. The other state is
indicated by the included value of vmOperState." indicated by the included value of vmOperState."
::= { vmNotifications 8 } ::= { vmNotifications 8 }
vmCrashed NOTIFICATION-TYPE vmCrashed NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmName, vmName,
vmUUID, vmUUID,
vmOperState vmOperState
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when a virtual machine "This notification is generated when a virtual machine
has been crashed. The previos state of the virtual has been crashed. The previos state of the virtual
machine is indicated by the included value of machine is indicated by the included value of
vmOperState." vmOperState."
::= { vmNotifications 9 } ::= { vmNotifications 9 }
vmBlocked NOTIFICATION-TYPE
OBJECTS {
vmName,
vmUUID,
vmOperState
}
STATUS current
DESCRIPTION
"This notification is generated when the operational
state of a virtual machine has been changed to
blocked(5). The previos state of the virtual machine is
indicated by the included value of vmOperState."
::= { vmNotifications 10 }
vmDeleted NOTIFICATION-TYPE vmDeleted NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmName, vmName,
vmUUID, vmUUID,
vmOperState, vmOperState,
vmPersistent vmPersistent
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when a virtual machine "This notification is generated when a virtual machine
has been deleted. The prior state of the virtual has been deleted. The prior state of the virtual
machine is indicated by the included value of machine is indicated by the included value of
vmOperState." vmOperState."
::= { vmNotifications 11 } ::= { vmNotifications 10 }
vmBulkRunning NOTIFICATION-TYPE vmBulkRunning NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmAffectedVMs vmAffectedVMs
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of one or more virtual machine has been changed to state of one or more virtual machine has been changed to
running(4) from a all prior states except for running(4) from a all prior states except for
running(4). Management stations are encouraged to running(4). Management stations are encouraged to
subsequently poll the subset of virtual machines of subsequently poll the subset of virtual machines of
interest for vmOperState." interest for vmOperState."
::= { vmNotifications 12 } ::= { vmNotifications 11 }
vmBulkShuttingdown NOTIFICATION-TYPE vmBulkShuttingdown NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmAffectedVMs vmAffectedVMs
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of one or more virtual machine has been changed to state of one or more virtual machine has been changed to
shuttingdown(11) from a state other than shuttingdown(10) from a state other than
shuttingdown(11). Management stations are encouraged to shuttingdown(10). Management stations are encouraged to
subsequently poll the subset of virtual machines of subsequently poll the subset of virtual machines of
interest for vmOperState." interest for vmOperState."
::= { vmNotifications 13 } ::= { vmNotifications 12 }
vmBulkShutdown NOTIFICATION-TYPE vmBulkShutdown NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmAffectedVMs vmAffectedVMs
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of one or more virtual machine has been changed to state of one or more virtual machine has been changed to
shutdown(12) from a state other than shutdown(12). shutdown(11) from a state other than shutdown(11).
Management stations are encouraged to subsequently poll Management stations are encouraged to subsequently poll
the subset of virtual machines of interest for the subset of virtual machines of interest for
vmOperState." vmOperState."
::= { vmNotifications 14 } ::= { vmNotifications 13 }
vmBulkPaused NOTIFICATION-TYPE vmBulkPaused NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmAffectedVMs vmAffectedVMs
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of one or more virtual machines have been changed state of one or more virtual machines have been changed
to paused(9) from a state other than paused(9). to paused(8) from a state other than paused(8).
Management stations are encouraged to subsequently poll Management stations are encouraged to subsequently poll
the subset of virtual machines of interest for the subset of virtual machines of interest for
vmOperState." vmOperState."
::= { vmNotifications 15 } ::= { vmNotifications 14 }
vmBulkSuspending NOTIFICATION-TYPE vmBulkSuspending NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmAffectedVMs vmAffectedVMs
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of one or more virtual machines have been changed state of one or more virtual machines have been changed
to suspending(6) from a state other than suspending(6). to suspending(5) from a state other than suspending(5).
Management stations are encouraged to subsequently poll Management stations are encouraged to subsequently poll
the subset of virtual machines of interest for the subset of virtual machines of interest for
vmOperState." vmOperState."
::= { vmNotifications 16 } ::= { vmNotifications 15 }
vmBulkSuspended NOTIFICATION-TYPE vmBulkSuspended NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmAffectedVMs vmAffectedVMs
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of one or more virtual machines have been changed state of one or more virtual machines have been changed
to suspended(7) from a state other than suspended(7). to suspended(6) from a state other than suspended(6).
Management stations are encouraged to subsequently poll Management stations are encouraged to subsequently poll
the subset of virtual machines of interest for the subset of virtual machines of interest for
vmOperState." vmOperState."
::= { vmNotifications 17 } ::= { vmNotifications 16 }
vmBulkResuming NOTIFICATION-TYPE vmBulkResuming NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmAffectedVMs vmAffectedVMs
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of one or more virtual machines have been changed state of one or more virtual machines have been changed
to resuming(8) from a state other than resuming(8). to resuming(7) from a state other than resuming(7).
Management stations are encouraged to subsequently poll Management stations are encouraged to subsequently poll
the subset of virtual machines of interest for the subset of virtual machines of interest for
vmOperState." vmOperState."
::= { vmNotifications 18 } ::= { vmNotifications 17 }
vmBulkMigrating NOTIFICATION-TYPE vmBulkMigrating NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmAffectedVMs vmAffectedVMs
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when the operational "This notification is generated when the operational
state of one or more virtual machines have been changed state of one or more virtual machines have been changed
to migrating(10) from a state other than migrating(10). to migrating(9) from a state other than migrating(9).
Management stations are encouraged to subsequently poll Management stations are encouraged to subsequently poll
the subset of virtual machines of interest for the subset of virtual machines of interest for
vmOperState." vmOperState."
::= { vmNotifications 19 } ::= { vmNotifications 18 }
vmBulkCrashed NOTIFICATION-TYPE vmBulkCrashed NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmAffectedVMs vmAffectedVMs
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when one or more virtual "This notification is generated when one or more virtual
machines have been crashed. Management stations are machines have been crashed. Management stations are
encouraged to subsequently poll the subset of virtual encouraged to subsequently poll the subset of virtual
machines of interest for vmOperState." machines of interest for vmOperState."
::= { vmNotifications 20 } ::= { vmNotifications 19 }
vmBulkBlocked NOTIFICATION-TYPE
OBJECTS {
vmAffectedVMs
}
STATUS current
DESCRIPTION
"This notification is generated when the operational
state of one or more virtual machines have been changed
to blocked(5) from a state other than blocked(5).
Management stations are encouraged to subsequently poll
the subset of virtual machines of interest for
vmOperState."
::= { vmNotifications 21 }
vmBulkDeleted NOTIFICATION-TYPE vmBulkDeleted NOTIFICATION-TYPE
OBJECTS { OBJECTS {
vmAffectedVMs vmAffectedVMs
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This notification is generated when one or more virtual "This notification is generated when one or more virtual
machines have been deleted. Management stations are machines have been deleted. Management stations are
encouraged to subsequently poll the subset of virtual encouraged to subsequently poll the subset of virtual
machines of interest for vmOperState." machines of interest for vmOperState."
::= { vmNotifications 22 } ::= { vmNotifications 20 }
-- Compliance definitions: -- Compliance definitions:
vmCompliances OBJECT IDENTIFIER ::= { vmConformance 1 } vmCompliances OBJECT IDENTIFIER ::= { vmConformance 1 }
vmGroups OBJECT IDENTIFIER ::= { vmConformance 2 } vmGroups OBJECT IDENTIFIER ::= { vmConformance 2 }
vmFullCompliances MODULE-COMPLIANCE vmFullCompliances MODULE-COMPLIANCE
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Compliance statement for implementations supporting "Compliance statement for implementations supporting
read/write access, according to the object definitions." read/write access, according to the object definitions."
skipping to change at page 44, line 45 skipping to change at page 41, line 31
vmHypervisorGroup, vmHypervisorGroup,
vmVirtualMachineGroup, vmVirtualMachineGroup,
vmCpuGroup, vmCpuGroup,
vmCpuAffinityGroup, vmCpuAffinityGroup,
vmStorageGroup, vmStorageGroup,
vmNetworkGroup vmNetworkGroup
} }
GROUP vmPerVMNotificationOptionalGroup GROUP vmPerVMNotificationOptionalGroup
DESCRIPTION DESCRIPTION
"Support for per-VM notifications is optional. If not "Support for per-VM notifications is optional. If not
implemented then vmPerVMNotificationsEnabled must report implemented then vmPerVMNotificationsEnabled MUST report
false(2)." false(2)."
GROUP vmBulkNotificationsVariablesGroup GROUP vmBulkNotificationsVariablesGroup
DESCRIPTION DESCRIPTION
"Necessary only if vmPerVMNotificationOptionalGroup is "Necessary only if vmPerVMNotificationOptionalGroup is
implemented." implemented."
GROUP vmBulkNotificationOptionalGroup GROUP vmBulkNotificationOptionalGroup
DESCRIPTION DESCRIPTION
"Support for bulk notifications is optional. If not "Support for bulk notifications is optional. If not
implemented then vmBulkNotificationsEnabled must report implemented then vmBulkNotificationsEnabled MUST report
false(2)." false(2)."
::= { vmCompliances 1 } ::= { vmCompliances 1 }
vmReadOnlyCompliances MODULE-COMPLIANCE vmReadOnlyCompliances MODULE-COMPLIANCE
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Compliance statement for implementations supporting "Compliance statement for implementations supporting
only readonly access." only readonly access."
MODULE -- this module MODULE -- this module
skipping to change at page 48, line 10 skipping to change at page 44, line 44
NOTIFICATIONS { NOTIFICATIONS {
vmRunning, vmRunning,
vmShuttingdown, vmShuttingdown,
vmShutdown, vmShutdown,
vmPaused, vmPaused,
vmSuspending, vmSuspending,
vmSuspended, vmSuspended,
vmResuming, vmResuming,
vmMigrating, vmMigrating,
vmCrashed, vmCrashed,
vmBlocked,
vmDeleted vmDeleted
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of notifications for per-VM notification "A collection of notifications for per-VM notification
of changes to virtual machine state (vmOperState) as of changes to virtual machine state (vmOperState) as
reported by a hypervisor." reported by a hypervisor."
::= { vmGroups 7 } ::= { vmGroups 7 }
vmBulkNotificationsVariablesGroup OBJECT-GROUP vmBulkNotificationsVariablesGroup OBJECT-GROUP
skipping to change at page 48, line 41 skipping to change at page 45, line 26
NOTIFICATIONS { NOTIFICATIONS {
vmBulkRunning, vmBulkRunning,
vmBulkShuttingdown, vmBulkShuttingdown,
vmBulkShutdown, vmBulkShutdown,
vmBulkPaused, vmBulkPaused,
vmBulkSuspending, vmBulkSuspending,
vmBulkSuspended, vmBulkSuspended,
vmBulkResuming, vmBulkResuming,
vmBulkMigrating, vmBulkMigrating,
vmBulkCrashed, vmBulkCrashed,
vmBulkBlocked,
vmBulkDeleted vmBulkDeleted
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of notifications for bulk notification of "A collection of notifications for bulk notification of
changes to virtual machine state (vmOperState) as changes to virtual machine state (vmOperState) as
reported by a given hypervisor." reported by a given hypervisor."
::= { vmGroups 9 } ::= { vmGroups 9 }
END END
6.2. IANA-STORAGE-MEDIA-TYPE-MIB
IANA-STORAGE-MEDIA-TYPE-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, mib-2
FROM SNMPv2-SMI
TEXTUAL-CONVENTION
FROM SNMPv2-TC;
ianaStorageMediaTypeMIB MODULE-IDENTITY
LAST-UPDATED "201505260000Z" -- 26 May 2015
ORGANIZATION "IANA"
CONTACT-INFO
"TBD"
DESCRIPTION
"This MIB module defines Textual Conventions
representing the media type of a storage device.
Copyright (c) 2015 IETF Trust and the persons identified
as authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with
or without modification, is permitted pursuant to, and
subject to the license terms contained in, the
Simplified BSD License set forth in Section 4.c of the
IETF Trust's Legal Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info)."
REVISION "201505260000Z" -- 26 May 2015
DESCRIPTION
"The original version of this MIB, published as
RFCXXXX."
::= { mib-2 zzz }
IANAStorageMediaType ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"The media type of a storage device:
unknown(1) The media type is unknown, e.g., because
the implementation failed to obtain the
media type from the hypervisor.
other(2) The media type is other than those
defined in this conversion.
hardDisk(3) The media type is hard disk.
opticalDisk(4) The media type is optical disk.
floppyDisk(5) The media type is floppy disk."
SYNTAX INTEGER {
other(1),
unknown(2),
hardDisk(3),
opticalDisk(4),
floppyDisk(5)
}
END
7. IANA Considerations 7. IANA Considerations
This document defines the first version of the IANA-maintained IANA-
STORAGE-MEDIA-TYPE-MIB module, which allows new storage media types
to be added to the enumeration in IANAStorageMediaType. An Expert
Review, as defined in RFC 5226 [RFC5226], is REQUIRED for each
modification.
The MIB module in this document uses the following IANA-assigned The MIB module in this document uses the following IANA-assigned
OBJECT IDENTIFIER values recorded in the SMI Numbers registry: OBJECT IDENTIFIER values recorded in the SMI Numbers registry:
Descriptor OBJECT IDENTIFIER value Descriptor OBJECT IDENTIFIER value
---------- ----------------------- ---------- -----------------------
vmMIB { mib-2 TBD } vmMIB { mib-2 TBD }
IANAStorageMediaTypeMIB { mib-2 TBD }
8. Security Considerations 8. Security Considerations
There are two objects defined in this MIB, There are two objects defined in this MIB,
vmPerVMNotificationsEnabled and vmBulkNotificationsEnabled, that have vmPerVMNotificationsEnabled and vmBulkNotificationsEnabled, that have
a MAX-ACCESS clause of read-write. Such objects may be considered a MAX-ACCESS clause of read-write. Enabling notifications can lead
sensitive or vulnerable in some network environments. The support to a noticeable number of notifications if many virtual machines
for SET operations in a non-secure environment without proper change their state concurrently. Hence, such objects may be
considered sensitive or vulnerable in some network environments. The
support for SET operations in a non-secure environment without proper
protection can have a negative effect on the management system. It protection can have a negative effect on the management system. It
is recommended that attention be given to these objects in scenarios is recommended that attention be given to these objects in scenarios
that DO NOT use SNMPv3 strong security, i.e. authentication and that DO NOT use SNMPv3 strong security, i.e. authentication and
encryption. When SNMPv3 strong security is not used, these objects encryption. When SNMPv3 strong security is not used, these objects
should have access of read-only, not read-write. SHOULD have access of read-only, not read-write.
There are a number of managed objects in this MIB that may contain There are a number of managed objects in this MIB that may contain
sensitive information. The objects in the vmHvSoftware and sensitive information. The objects in the vmHvSoftware and
vmHvVersion list information about the hypervisor's software and vmHvVersion list information about the hypervisor's software and
version. Some may wish not to disclose to others which software they version. Some may wish not to disclose to others which software they
are running. Further, an inventory of the running software and are running. Further, an inventory of the running software and
versions may be helpful to an attacker who hopes to exploit software versions may be helpful to an attacker who hopes to exploit software
bugs in certain applications. Moreover, the objects in the vmTable, bugs in certain applications. Moreover, the objects in the vmTable,
vmCpuTable, vmCpuAffinityTable, vmStorageTable and vmNetworkTable vmCpuTable, vmCpuAffinityTable, vmStorageTable and vmNetworkTable
list information about the virtual machines and their virtual list information about the virtual machines and their virtual
skipping to change at page 52, line 51 skipping to change at page 50, line 51
December 2002. December 2002.
[RFC3418] Presuhn, R., "Management Information Base (MIB) for the [RFC3418] Presuhn, R., "Management Information Base (MIB) for the
Simple Network Management Protocol (SNMP)", STD 62, Simple Network Management Protocol (SNMP)", STD 62,
RFC 3418, December 2002. RFC 3418, December 2002.
[RFC4122] Leach, P., Mealling, M., and R. Salz, "A Universally [RFC4122] Leach, P., Mealling, M., and R. Salz, "A Universally
Unique IDentifier (UUID) URN Namespace", RFC 4122, Unique IDentifier (UUID) URN Namespace", RFC 4122,
July 2005. July 2005.
[RFC5226] Narten, T. and H. Alvestrand, "Guidelines for Writing an
IANA Considerations Section in RFCs", BCP 26, RFC 5226,
May 2008.
[RFC6933] Bierman, A., Romascanu, D., Quittek, J., and M. [RFC6933] Bierman, A., Romascanu, D., Quittek, J., and M.
Chandramouli, "Entity MIB (Version 4)", RFC 6933, Chandramouli, "Entity MIB (Version 4)", RFC 6933,
May 2013. May 2013.
10.2. Informative References 10.2. Informative References
[RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart,
"Introduction and Applicability Statements for Internet- "Introduction and Applicability Statements for Internet-
Standard Management Framework", RFC 3410, December 2002. Standard Management Framework", RFC 3410, December 2002.
skipping to change at page 54, line 27 skipping to change at page 52, line 27
| suspending | (suspend | suspended | vmSuspended | | | suspending | (suspend | suspended | vmSuspended | |
| | operation | | vmBulkSuspended | | | operation | | vmBulkSuspended |
| | completed) | | | | | completed) | | |
| | | | | | | | | |
| running | suspended | suspending | vmSuspending | | | running | suspended | suspending | vmSuspending | |
| | | | vmBulkSuspending | | | | | vmBulkSuspending |
| | | | | | | | | |
| | shutdown | shuttingdown | vmShuttingdown | | | | shutdown | shuttingdown | vmShuttingdown | |
| | | | vmBulkShuttingdown | | | | | vmBulkShuttingdown |
| | | | | | | | | |
| | destroy | shutdown | vmShutdown | |
| | | | vmBulkShutdown |
| | | | |
| | (migration to | migrating | vmMigrating | | | | (migration to | migrating | vmMigrating | |
| | other | | vmBulkMingrating | | | other | | vmBulkMingrating |
| | hypervisor | | | | | hypervisor | | |
| | initiated) | | | | | initiated) | | |
| | | | | | | | | |
| resuming | (resume | running | vmRunning | | | resuming | (resume | running | vmRunning | |
| | opeartion | | vmBulkRunning | | | opeartion | | vmBulkRunning |
| | completed) | | | | | completed) | | |
| | | | | | | | | |
| paused | running | running | vmRunning | | | paused | running | running | vmRunning | |
skipping to change at page 55, line 27 skipping to change at page 53, line 21
| | completed) | | | | | completed) | | |
| | | | | | | | | |
| | (migration to | shutdown | vmShutdown | | | | (migration to | shutdown | vmShutdown | |
| | other | | vmBulkShutdown | | | other | | vmBulkShutdown |
| | hypervisor | | | | | hypervisor | | |
| | completed) | | | | | completed) | | |
| | | | | | | | | |
| preparing | (preparation | shutdown | vmShutdown | | | preparing | (preparation | shutdown | vmShutdown | |
| | completed) | | vmBulkShutdown | | | completed) | | vmBulkShutdown |
| | | | | | | | | |
| blocked | (blocking | (previous | - |
| | operation | state) | |
| | completed) | | |
| | | | |
| crashed | - | - | - | | crashed | - | - | - |
| | | | | | | | | |
| (any) | (blocking | blocked | vmBlocked | |
| | operation | | vmBulkBlocked |
| | initiated) | | |
| | | | |
| | (crashed) | crashed | vmCrashed | | | | (crashed) | crashed | vmCrashed | |
| | | | vmBulkCrashed | | | | | vmBulkCrashed |
| | | | | | | | | |
| (no state) | (preparation | preparing | - | | (no state) | (preparation | preparing | - |
| | initiated) | | | | | initiated) | | |
| | | | | | | | | |
| | (migrate from | shutdown (*) | vmShutdown | | | | (migrate from | shutdown (*) | vmShutdown | |
| | other | | vmBulkShutdown | | | other | | vmBulkShutdown |
| | hypervisor | | | | | hypervisor | | |
| | initiated) | | | | | initiated) | | |
 End of changes. 106 change blocks. 
389 lines changed or deleted 273 lines changed or added

This html diff was produced by rfcdiff 1.42. The latest version is available from http://tools.ietf.org/tools/rfcdiff/