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