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/