draft-ietf-opsawg-vmm-mib-01.txt   draft-ietf-opsawg-vmm-mib-02.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: January 5, 2015 VMware Inc. Expires: May 14, 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)
July 4, 2014 November 10, 2014
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-01 draft-ietf-opsawg-vmm-mib-02
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 January 5, 2015. This Internet-Draft will expire on May 14, 2015.
Copyright Notice Copyright Notice
Copyright (c) 2014 IETF Trust and the persons identified as the Copyright (c) 2014 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
skipping to change at page 2, line 21 skipping to change at page 2, line 21
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 . . . . . . . . . . . . . . 12
6. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 13 6. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 13
7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 48 7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 49
8. Security Considerations . . . . . . . . . . . . . . . . . . . 49 8. Security Considerations . . . . . . . . . . . . . . . . . . . 50
9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 50 9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 51
10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 51 10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 52
10.1. Normative References . . . . . . . . . . . . . . . . . . 51 10.1. Normative References . . . . . . . . . . . . . . . . . . 52
10.2. Informative References . . . . . . . . . . . . . . . . . 52 10.2. Informative References . . . . . . . . . . . . . . . . . 53
Appendix A. State Transition Table . . . . . . . . . . . . . . . 53 Appendix A. State Transition Table . . . . . . . . . . . . . . . 54
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 55 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 56
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
skipping to change at page 11, line 23 skipping to change at page 11, line 23
| | +-- r-n VirtualMachineStorageAccess | | +-- r-n VirtualMachineStorageAccess
| | | vmStorageAccess(7) | | | vmStorageAccess(7)
| | +-- r-n VirtualMachineStorageMediaType | | +-- r-n VirtualMachineStorageMediaType
| | | vmStorageMediaType(8) | | | vmStorageMediaType(8)
| | +-- r-n SnmpAdminString vmStorageMediaTypeString(9) | | +-- r-n SnmpAdminString vmStorageMediaTypeString(9)
| | +-- r-n Integer32 vmStorageSizeUnit(10) | | +-- r-n Integer32 vmStorageSizeUnit(10)
| | +-- r-n Integer32 vmStorageDefinedSize(11) | | +-- r-n Integer32 vmStorageDefinedSize(11)
| | +-- r-n Integer32 vmStorageAllocatedSize(12) | | +-- r-n Integer32 vmStorageAllocatedSize(12)
| | +-- r-n Counter64 vmStorageReadIOs(13) | | +-- r-n Counter64 vmStorageReadIOs(13)
| | +-- r-n Counter64 vmStorageWriteIOs(14) | | +-- 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) | +--vmNetworkTable(8)
| | +--vmNetworkEntry(1) [vmIndex, vmNetworkIndex] | | +--vmNetworkEntry(1) [vmIndex, vmNetworkIndex]
| | +-- --- VirtualMachineNetworkIndex | | +-- --- VirtualMachineNetworkIndex
| | | vmNetworkIndex(1) | | | vmNetworkIndex(1)
| | +-- r-n InterfaceIndexOrZero vmNetworkIfIndex(2) | | +-- r-n InterfaceIndexOrZero vmNetworkIfIndex(2)
| | +-- r-n InterfaceIndexOrZero vmNetworkParent(3) | | +-- r-n InterfaceIndexOrZero vmNetworkParent(3)
| | +-- r-n SnmpAdminString vmNetworkModel(4) | | +-- r-n SnmpAdminString vmNetworkModel(4)
| | +-- r-n PhysAddress vmNetworkPhysAddress(5) | | +-- r-n PhysAddress vmNetworkPhysAddress(5)
| +-- rwn TruthValue vmPerVMNotificationsEnabled(9) | +-- rwn TruthValue vmPerVMNotificationsEnabled(9)
| +-- rwn TruthValue vmBulkNotificationsEnabled(10) | +-- rwn TruthValue vmBulkNotificationsEnabled(10)
skipping to change at page 13, line 25 skipping to change at page 13, line 25
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;
vmMIB MODULE-IDENTITY vmMIB MODULE-IDENTITY
LAST-UPDATED "201407040000Z" -- 4 July 2014 LAST-UPDATED "201410260000Z" -- 26 October 2014
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 34 skipping to change at page 14, line 34
Copyright (c) 2014 IETF Trust and the persons identified Copyright (c) 2014 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 "201407040000Z" -- 4 July 2014 REVISION "201410260000Z" -- 26 October 2014
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
skipping to change at page 31, line 10 skipping to change at page 31, line 10
SnmpAdminString, SnmpAdminString,
vmStorageResourceID SnmpAdminString, vmStorageResourceID SnmpAdminString,
vmStorageAccess VirtualMachineStorageAccess, vmStorageAccess VirtualMachineStorageAccess,
vmStorageMediaType VirtualMachineStorageMediaType, vmStorageMediaType VirtualMachineStorageMediaType,
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,
vmStorageWriteOctets Counter64,
vmStorageReadLatency Counter64,
vmStorageWriteLatency Counter64
} }
vmStorageVmIndex OBJECT-TYPE vmStorageVmIndex OBJECT-TYPE
SYNTAX VirtualMachineIndexOrZero SYNTAX VirtualMachineIndexOrZero
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This value identifies the virtual machine (guest) this "This value identifies the virtual machine (guest) this
storage device has been allocated to. The value zero storage device has been allocated to. The value zero
indicates that the storage device is currently not indicates that the storage device is currently not
skipping to change at page 34, line 18 skipping to change at page 34, line 22
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of write I/O requests. "The number of write I/O requests.
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 14 } ::= { vmStorageEntry 14 }
vmStorageReadOctets OBJECT-TYPE
SYNTAX Counter64
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of bytes read from this device.
Discontinuities in the value of this counter can occur
at re-initialization of the hypervisor, and
administrative state (vmAdminState) changes of the
virtual machine."
::= { vmStorageEntry 15 }
vmStorageWriteOctets OBJECT-TYPE
SYNTAX Counter64
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of bytes written to this device.
Discontinuities in the value of this counter can occur
at re-initialization of the hypervisor, and
administrative state (vmAdminState) changes of the
virtual machine."
::= { vmStorageEntry 16 }
vmStorageReadLatency OBJECT-TYPE
SYNTAX Counter64
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of microseconds read requests have
been queued for this device.
This would typically be implemented by storing the high
precision system time stamp of when the request is
received from the virtual machine with the request, the
difference between this initial timestamp and the time
at which the requested operation has completed should be
converted to microseconds and accumulated.
Discontinuities in the value of this counter can occur at
re-initialization of the hypervisor, and administrative
state (vmAdminState) changes of the virtual machine."
::= { vmStorageEntry 17 }
vmStorageWriteLatency OBJECT-TYPE
SYNTAX Counter64
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of microseconds write requests have
been queued for this device.
This would typically be implemented by storing the high
precision system time stamp of when the request is
received from the virtual machine with the request, the
difference between this initial timestamp and the time
at which the requested operation has completed should be
converted to microseconds and accumulated.
Discontinuities in the value of this counter can occur
at re-initialization of the hypervisor, and
administrative state (vmAdminState) changes of the
virtual machine."
::= { 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
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The conceptual table of virtual network interfaces "The conceptual table of virtual network interfaces
attached to the virtual machine." attached to the virtual machine."
::= { vmObjects 8 } ::= { vmObjects 8 }
skipping to change at page 45, line 47 skipping to change at page 47, line 22
vmStorageSourceType, vmStorageSourceType,
vmStorageSourceTypeString, vmStorageSourceTypeString,
vmStorageResourceID, vmStorageResourceID,
vmStorageAccess, vmStorageAccess,
vmStorageMediaType, vmStorageMediaType,
vmStorageMediaTypeString, vmStorageMediaTypeString,
vmStorageSizeUnit, vmStorageSizeUnit,
vmStorageDefinedSize, vmStorageDefinedSize,
vmStorageAllocatedSize, vmStorageAllocatedSize,
vmStorageReadIOs, vmStorageReadIOs,
vmStorageWriteIOs vmStorageWriteIOs,
vmStorageReadOctets,
vmStorageWriteOctets,
vmStorageReadLatency,
vmStorageWriteLatency
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of objects providing insight into the "A collection of objects providing insight into the
virtual storage devices controlled by a hypervisor." virtual storage devices controlled by a hypervisor."
::= { vmGroups 5 } ::= { vmGroups 5 }
vmNetworkGroup OBJECT-GROUP vmNetworkGroup OBJECT-GROUP
OBJECTS { OBJECTS {
-- vmNetworkIndex, -- vmNetworkIndex,
skipping to change at page 50, line 8 skipping to change at page 51, line 8
It is then a customer/user responsibility to ensure that the SNMP It is then a customer/user responsibility to ensure that the SNMP
entity giving access to an instance of this MIB, is properly entity giving access to an instance of this MIB, is properly
configured to give access to the objects only to those principals configured to give access to the objects only to those principals
(users) that have legitimate rights to indeed GET or SET (change/ (users) that have legitimate rights to indeed GET or SET (change/
create/delete) them. create/delete) them.
9. Acknowledgements 9. Acknowledgements
The authors like to thank Joe Marcus Clarke, Randy Presuhn, David The authors like to thank Joe Marcus Clarke, Randy Presuhn, David
Black, Joel Jaeggli, Tom Petch, Andy Bierman, and C. M. Heard for Black, Joel Jaeggli, Tom Petch, Andy Bierman, C. M. Heard, and Ian
providing helpful comments during the development of this West for providing helpful comments during the development of this
specification. specification.
Juergen Schoenwaelder was partly funded by Flamingo, a Network of Juergen Schoenwaelder was partly funded by Flamingo, a Network of
Excellence project (ICT-318488) supported by the European Commission Excellence project (ICT-318488) supported by the European Commission
under its Seventh Framework Programme. under its Seventh Framework Programme.
10. References 10. References
10.1. Normative References 10.1. Normative References
skipping to change at page 55, line 31 skipping to change at page 56, line 31
Juergen Schoenwaelder Juergen Schoenwaelder
Jacobs University Jacobs University
Campus Ring 1 Campus Ring 1
Bremen 28759 Bremen 28759
Germany Germany
Email: j.schoenwaelder@jacobs-university.de Email: j.schoenwaelder@jacobs-university.de
Keiichi Shima Keiichi Shima
IIJ Innovation Institute Inc. IIJ Innovation Institute Inc.
3-13 Kanda-Nishikicho 2-10-2 Fujimi
Chiyoda-ku, Tokyo 101-0054 Chiyoda-ku, Tokyo 102-0071
JP JP
Email: keiichi@iijlab.net Email: keiichi@iijlab.net
Tina Tsou Tina Tsou
Huawei Technologies (USA) Huawei Technologies (USA)
2330 Central Expressway 2330 Central Expressway
Santa Clara CA 95050 Santa Clara CA 95050
USA USA
 End of changes. 13 change blocks. 
20 lines changed or deleted 95 lines changed or added

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