Diff: draft-ietf-disman-script-mib-07.txt - draft-ietf-disman-script-mib-08.txt

	< draft-ietf-disman-script-mib-07.txt	draft-ietf-disman-script-mib-08.txt >

	Network Working Group David Levi	Network Working Group David Levi
	Internet-Draft SNMP Research, Inc.	Internet-Draft SNMP Research, Inc.

	Expires July 1999 Juergen Schoenwaelder	Expires August 1999 Juergen Schoenwaelder
	TU Braunschweig	TU Braunschweig

	27 January 1999	22 February 1999

	Definitions of Managed Objects for the	Definitions of Managed Objects for the
	Delegation of Management Scripts	Delegation of Management Scripts


	<draft-ietf-disman-script-mib-07.txt>	<draft-ietf-disman-script-mib-08.txt>

	Status of this Memo	Status of this Memo


	This document is an Internet-Draft. Internet-Drafts are working	This document is an Internet-Draft and is in full conformance with
	documents of the Internet Engineering Task Force (IETF), its areas,	all provisions of Section 10 of RFC 2026. Internet-Drafts are
	and its working groups. Note that other groups may also distribute	working documents of the Internet Engineering Task Force (IETF), its
	working documents as Internet-Drafts.	areas, and its working groups. Note that other groups may also
		distribute working documents as Internet-Drafts.

	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."


	To view the entire list of current Internet-Drafts, please check the	The list of current Internet-Drafts can be accessed at
	"1id-abstracts.txt" listing contained in the Internet-Drafts Shadow	http://www.ietf.org/ietf/1id-abstracts.txt
	Directories on ftp.is.co.za (Africa), ftp.nordu.net (Northern
	Europe), ftp.nis.garr.it (Southern Europe), munnari.oz.au (Pacific	The list of Internet-Draft Shadow Directories can be accessed at
	Rim), ftp.ietf.org (US East Coast), or ftp.isi.edu (US West Coast).	http://www.ietf.org/shadow.html

	Distribution of this document is unlimited. Please send comments to	Distribution of this document is unlimited. Please send comments to
	the Distributed Management Working Group, <disman@nexen.com>.	the Distributed Management Working Group, <disman@nexen.com>.

	Copyright Notice	Copyright Notice

	Copyright (C) The Internet Society (1999). All Rights Reserved.	Copyright (C) The Internet Society (1999). All Rights Reserved.

	Abstract	Abstract


	skipping to change at page 2, line 22 ¶	skipping to change at page 2, line 22 ¶
	4.1 Script Languages ........................................... 6	4.1 Script Languages ........................................... 6
	4.2 Script Transfer ............................................ 7	4.2 Script Transfer ............................................ 7
	4.3 Script Execution ........................................... 8	4.3 Script Execution ........................................... 8
	5 The Structure of the MIB ..................................... 9	5 The Structure of the MIB ..................................... 9
	5.1 The smLanguageGroup ........................................ 9	5.1 The smLanguageGroup ........................................ 9
	5.2 The smScriptGroup .......................................... 9	5.2 The smScriptGroup .......................................... 9
	5.3 The smCodeGroup ............................................ 10	5.3 The smCodeGroup ............................................ 10
	5.4 The smLaunchGroup .......................................... 11	5.4 The smLaunchGroup .......................................... 11
	5.5 The smRunGroup ............................................. 11	5.5 The smRunGroup ............................................. 11
	6 Definitions .................................................. 13	6 Definitions .................................................. 13

	7 Usage Examples ............................................... 43	7 Usage Examples ............................................... 44
	7.1 Pushing a script via SNMP .................................. 43	7.1 Pushing a script via SNMP .................................. 44
	7.2 Pulling a script from a URL ................................ 44	7.2 Pulling a script from a URL ................................ 45
	7.3 Modifying an existing script ............................... 44	7.3 Modifying an existing script ............................... 45
	7.4 Removing an existing script ................................ 45	7.4 Removing an existing script ................................ 46
	7.5 Creating a launch button ................................... 45	7.5 Creating a launch button ................................... 46
	7.6 Launching a script ......................................... 46	7.6 Launching a script ......................................... 47
	7.7 Terminating a script ....................................... 46	7.7 Terminating a script ....................................... 47
	7.8 Removing a launch button ................................... 47	7.8 Removing a launch button ................................... 48
	8 VACM Configuration Examples .................................. 48	8 VACM Configuration Examples .................................. 49
	8.1 Sandbox for guests ......................................... 48	8.1 Sandbox for guests ......................................... 49
	8.2 Sharing scripts ............................................ 48	8.2 Sharing scripts ............................................ 49
	8.3 Emergency scripts .......................................... 49	8.3 Emergency scripts .......................................... 50
	9 IANA Considerations .......................................... 50	9 IANA Considerations .......................................... 51
	10 Security Considerations ..................................... 51	10 Security Considerations ..................................... 52
	11 Intellectual Property ....................................... 52	11 Intellectual Property ....................................... 53
	12 Acknowledgments ............................................. 52	12 Acknowledgments ............................................. 53
	13 References .................................................. 53	13 References .................................................. 54
	14 Editors' Addresses .......................................... 55	14 Editors' Addresses .......................................... 56
	15 Full Copyright Statement .................................... 55	15 Full Copyright Statement .................................... 56
	16 IANA Language Registration MIB .............................. 56	16 IANA Language Registration MIB .............................. 57

	1. Introduction	1. Introduction

	This memo defines a portion of the Management Information Base (MIB)	This memo defines a portion of the Management Information Base (MIB)
	for use with network management protocols in the Internet community.	for use with network management protocols in the Internet community.
	In particular, it describes a set of managed objects that allow the	In particular, it describes a set of managed objects that allow the
	delegation of management scripts to distributed managers.	delegation of management scripts to distributed managers.

	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

	skipping to change at page 13, line 24 ¶	skipping to change at page 13, line 24 ¶
	RowStatus, TimeInterval, DateAndTime, StorageType, DisplayString	RowStatus, TimeInterval, DateAndTime, StorageType, DisplayString
	FROM SNMPv2-TC	FROM SNMPv2-TC

	MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP	MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
	FROM SNMPv2-CONF	FROM SNMPv2-CONF

	SnmpAdminString	SnmpAdminString
	FROM SNMP-FRAMEWORK-MIB;	FROM SNMP-FRAMEWORK-MIB;

	scriptMIB MODULE-IDENTITY	scriptMIB MODULE-IDENTITY

	LAST-UPDATED "9901271800Z"	LAST-UPDATED "9902221800Z"
	ORGANIZATION "IETF Distributed Management Working Group"	ORGANIZATION "IETF Distributed Management Working Group"
	CONTACT-INFO	CONTACT-INFO
	"David B. Levi	"David B. Levi
	SNMP Research, Inc.	SNMP Research, Inc.
	3001 Kimberlin Heights Road	3001 Kimberlin Heights Road
	Knoxville, TN 37920-9716	Knoxville, TN 37920-9716
	U.S.A.	U.S.A.
	Tel: +1 423 573 1434	Tel: +1 423 573 1434
	E-mail: levi@snmp.com	E-mail: levi@snmp.com


	skipping to change at page 14, line 34 ¶	skipping to change at page 14, line 34 ¶
	smLangEntry OBJECT-TYPE	smLangEntry OBJECT-TYPE
	SYNTAX SmLangEntry	SYNTAX SmLangEntry
	MAX-ACCESS not-accessible	MAX-ACCESS not-accessible
	STATUS current	STATUS current
	DESCRIPTION	DESCRIPTION
	"An entry describing a particular language."	"An entry describing a particular language."
	INDEX { smLangIndex }	INDEX { smLangIndex }
	::= { smLangTable 1 }	::= { smLangTable 1 }

	SmLangEntry ::= SEQUENCE {	SmLangEntry ::= SEQUENCE {

	smLangIndex Unsigned32,	smLangIndex Integer32,
	smLangLanguage OBJECT IDENTIFIER,	smLangLanguage OBJECT IDENTIFIER,
	smLangVersion SnmpAdminString,	smLangVersion SnmpAdminString,
	smLangVendor OBJECT IDENTIFIER,	smLangVendor OBJECT IDENTIFIER,
	smLangRevision SnmpAdminString,	smLangRevision SnmpAdminString,
	smLangDescr SnmpAdminString	smLangDescr SnmpAdminString
	}	}

	smLangIndex OBJECT-TYPE	smLangIndex OBJECT-TYPE

	SYNTAX Unsigned32 (1..4294967295)	SYNTAX Integer32 (1..2147483647)
	MAX-ACCESS not-accessible	MAX-ACCESS not-accessible
	STATUS current	STATUS current
	DESCRIPTION	DESCRIPTION
	"The locally arbitrary, but unique identifier associated	"The locally arbitrary, but unique identifier associated
	with this language entry.	with this language entry.

	The value is expected to remain constant at least from one	The value is expected to remain constant at least from one
	re-initialization of the entity's network management system	re-initialization of the entity's network management system

	to the next re-initialization."	to the next re-initialization.

		Note, the data type and the range of this object must be
		consistent with the definition of smScriptLanguage."
	::= { smLangEntry 1 }	::= { smLangEntry 1 }

	smLangLanguage OBJECT-TYPE	smLangLanguage OBJECT-TYPE
	SYNTAX OBJECT IDENTIFIER	SYNTAX OBJECT IDENTIFIER
	MAX-ACCESS read-only	MAX-ACCESS read-only
	STATUS current	STATUS current
	DESCRIPTION	DESCRIPTION
	"The globally unique identification of the language."	"The globally unique identification of the language."
	::= { smLangEntry 2 }	::= { smLangEntry 2 }


	skipping to change at page 16, line 36 ¶	skipping to change at page 16, line 39 ¶
	smExtsnEntry OBJECT-TYPE	smExtsnEntry OBJECT-TYPE
	SYNTAX SmExtsnEntry	SYNTAX SmExtsnEntry
	MAX-ACCESS not-accessible	MAX-ACCESS not-accessible
	STATUS current	STATUS current
	DESCRIPTION	DESCRIPTION
	"An entry describing a particular language extension."	"An entry describing a particular language extension."
	INDEX { smLangIndex, smExtsnIndex }	INDEX { smLangIndex, smExtsnIndex }
	::= { smExtsnTable 1 }	::= { smExtsnTable 1 }

	SmExtsnEntry ::= SEQUENCE {	SmExtsnEntry ::= SEQUENCE {

	smExtsnIndex Unsigned32,	smExtsnIndex Integer32,
	smExtsnExtension OBJECT IDENTIFIER,	smExtsnExtension OBJECT IDENTIFIER,
	smExtsnVersion SnmpAdminString,	smExtsnVersion SnmpAdminString,
	smExtsnVendor OBJECT IDENTIFIER,	smExtsnVendor OBJECT IDENTIFIER,
	smExtsnRevision SnmpAdminString,	smExtsnRevision SnmpAdminString,
	smExtsnDescr SnmpAdminString	smExtsnDescr SnmpAdminString
	}	}

	smExtsnIndex OBJECT-TYPE	smExtsnIndex OBJECT-TYPE

	SYNTAX Unsigned32 (1..4294967295)	SYNTAX Integer32 (1..2147483647)
	MAX-ACCESS not-accessible	MAX-ACCESS not-accessible
	STATUS current	STATUS current
	DESCRIPTION	DESCRIPTION
	"The locally arbitrary, but unique identifier associated	"The locally arbitrary, but unique identifier associated
	with this language extension entry.	with this language extension entry.

	The value is expected to remain constant at least from one	The value is expected to remain constant at least from one
	re-initialization of the entity's network management system	re-initialization of the entity's network management system
	to the next re-initialization."	to the next re-initialization."
	::= { smExtsnEntry 1}	::= { smExtsnEntry 1}

	skipping to change at page 20, line 8 ¶	skipping to change at page 20, line 12 ¶

	smScriptLanguage OBJECT-TYPE	smScriptLanguage OBJECT-TYPE
	SYNTAX Integer32 (0..2147483647)	SYNTAX Integer32 (0..2147483647)
	MAX-ACCESS read-create	MAX-ACCESS read-create
	STATUS current	STATUS current
	DESCRIPTION	DESCRIPTION
	"The value of this object type identifies an entry in the	"The value of this object type identifies an entry in the
	smLangTable which is used to execute this script.	smLangTable which is used to execute this script.
	The special value 0 may be used by hard-wired scripts	The special value 0 may be used by hard-wired scripts
	that can not be modified and that are executed by	that can not be modified and that are executed by

	internal functions."	internal functions.

		Note, the data type and the range of this object must be
		consistent with the definition of smLangIndex."
	::= { smScriptEntry 4 }	::= { smScriptEntry 4 }

	smScriptSource OBJECT-TYPE	smScriptSource OBJECT-TYPE
	SYNTAX DisplayString	SYNTAX DisplayString
	MAX-ACCESS read-create	MAX-ACCESS read-create
	STATUS current	STATUS current
	DESCRIPTION	DESCRIPTION
	"This object either contains a reference to the script	"This object either contains a reference to the script
	source or an empty string. A reference must be given	source or an empty string. A reference must be given
	in the form of a Uniform Resource Locator (URL) as	in the form of a Uniform Resource Locator (URL) as

	skipping to change at page 26, line 32 ¶	skipping to change at page 26, line 41 ¶
	smLaunchScriptName SnmpAdminString,	smLaunchScriptName SnmpAdminString,
	smLaunchArgument OCTET STRING,	smLaunchArgument OCTET STRING,
	smLaunchMaxRunning Unsigned32,	smLaunchMaxRunning Unsigned32,
	smLaunchMaxCompleted Unsigned32,	smLaunchMaxCompleted Unsigned32,
	smLaunchLifeTime TimeInterval,	smLaunchLifeTime TimeInterval,
	smLaunchExpireTime TimeInterval,	smLaunchExpireTime TimeInterval,
	smLaunchStart Integer32,	smLaunchStart Integer32,
	smLaunchControl INTEGER,	smLaunchControl INTEGER,
	smLaunchAdminStatus INTEGER,	smLaunchAdminStatus INTEGER,
	smLaunchOperStatus INTEGER,	smLaunchOperStatus INTEGER,

	smLaunchRunIndexNext Unsigned32,	smLaunchRunIndexNext Integer32,
	smLaunchStorageType StorageType,	smLaunchStorageType StorageType,
	smLaunchRowStatus RowStatus	smLaunchRowStatus RowStatus
	}	}

	smLaunchOwner OBJECT-TYPE	smLaunchOwner OBJECT-TYPE
	SYNTAX SnmpAdminString (SIZE (0..32))	SYNTAX SnmpAdminString (SIZE (0..32))
	MAX-ACCESS not-accessible	MAX-ACCESS not-accessible
	STATUS current	STATUS current
	DESCRIPTION	DESCRIPTION
	"The manager who owns this row in the smLaunchTable. Every	"The manager who owns this row in the smLaunchTable. Every

	skipping to change at page 30, line 44 ¶	skipping to change at page 31, line 4 ¶
	in the smRunTable will be created indexed by smLaunchOwner,	in the smRunTable will be created indexed by smLaunchOwner,
	smLaunchName and the new value for smRunIndex. The value	smLaunchName and the new value for smRunIndex. The value
	of smLaunchArgument will be copied into smRunArgument,	of smLaunchArgument will be copied into smRunArgument,
	the value of smLaunchLifeTime will be copied to	the value of smLaunchLifeTime will be copied to
	smRunLifeTime, and the value of smLaunchExpireTime	smRunLifeTime, and the value of smLaunchExpireTime
	will be copied to smRunExpireTime.	will be copied to smRunExpireTime.

	The smRunStartTime will be set to the current time and	The smRunStartTime will be set to the current time and
	the smRunState will be set to `initializing' before the	the smRunState will be set to `initializing' before the
	script execution is initiated in the appropriate runtime	script execution is initiated in the appropriate runtime

	system."	system.

		Note, the data type and the range of this object must
		be consistent with the smRunIndex object. Since this
		object might be written from the scheduling MIB, the
		data type Integer32 rather than Unsigned32 is used."
	DEFVAL { 0 }	DEFVAL { 0 }
	::= { smLaunchEntry 10 }	::= { smLaunchEntry 10 }

	smLaunchControl OBJECT-TYPE	smLaunchControl OBJECT-TYPE
	SYNTAX INTEGER {	SYNTAX INTEGER {
	abort(1),	abort(1),
	suspend(2),	suspend(2),
	resume(3),	resume(3),
	nop(4)	nop(4)
	}	}

	skipping to change at page 32, line 12 ¶	skipping to change at page 32, line 25 ¶
	entry can be used to start scripts while a `disabled'	entry can be used to start scripts while a `disabled'
	launch table entry will refuse any attempts to start	launch table entry will refuse any attempts to start
	scripts. The value `enabled' requires that the	scripts. The value `enabled' requires that the
	smLaunchRowStatus object is active. The value	smLaunchRowStatus object is active. The value
	`disabled' requires that there are no entries in the	`disabled' requires that there are no entries in the
	smRunTable associated with this smLaunchTable entry."	smRunTable associated with this smLaunchTable entry."
	DEFVAL { disabled }	DEFVAL { disabled }
	::= { smLaunchEntry 13 }	::= { smLaunchEntry 13 }

	smLaunchRunIndexNext OBJECT-TYPE	smLaunchRunIndexNext OBJECT-TYPE

	SYNTAX Unsigned32	SYNTAX Integer32 (1..2147483647)
	MAX-ACCESS read-only	MAX-ACCESS read-only
	STATUS current	STATUS current
	DESCRIPTION	DESCRIPTION
	"This variable is used for creating rows in the smRunTable.	"This variable is used for creating rows in the smRunTable.
	The value of this variable is a currently unused value	The value of this variable is a currently unused value
	for smRunIndex, which can be written into the smLaunchStart	for smRunIndex, which can be written into the smLaunchStart
	object associated with this row to launch a script.	object associated with this row to launch a script.

	The value returned when reading this variable must be unique	The value returned when reading this variable must be unique
	for the smLaunchOwner and smLauchName associated with this	for the smLaunchOwner and smLauchName associated with this
	row. Subsequent attempts to read this variable must return	row. Subsequent attempts to read this variable must return
	different values.	different values.

	This variable will return the special value 0 if no new rows	This variable will return the special value 0 if no new rows

	can be created."	can be created.

		Note, the data type and the range of this object must be
		consistent with the definition of smRunIndex."
	::= { smLaunchEntry 14 }	::= { smLaunchEntry 14 }

	smLaunchStorageType OBJECT-TYPE	smLaunchStorageType OBJECT-TYPE
	SYNTAX StorageType	SYNTAX StorageType
	MAX-ACCESS read-create	MAX-ACCESS read-create
	STATUS current	STATUS current
	DESCRIPTION	DESCRIPTION
	"This object defines if this row is kept in volatile storage	"This object defines if this row is kept in volatile storage
	and lost upon reboot or if this row is backed up by stable	and lost upon reboot or if this row is backed up by stable
	storage.	storage.

	skipping to change at page 33, line 40 ¶	skipping to change at page 34, line 9 ¶
	SYNTAX SmRunEntry	SYNTAX SmRunEntry
	MAX-ACCESS not-accessible	MAX-ACCESS not-accessible
	STATUS current	STATUS current
	DESCRIPTION	DESCRIPTION
	"An entry describing a particular running or finished	"An entry describing a particular running or finished
	script."	script."
	INDEX { smLaunchOwner, smLaunchName, smRunIndex }	INDEX { smLaunchOwner, smLaunchName, smRunIndex }
	::= { smRunTable 1 }	::= { smRunTable 1 }

	SmRunEntry ::= SEQUENCE {	SmRunEntry ::= SEQUENCE {

	smRunIndex Unsigned32,	smRunIndex Integer32,
	smRunArgument OCTET STRING,	smRunArgument OCTET STRING,
	smRunStartTime DateAndTime,	smRunStartTime DateAndTime,
	smRunEndTime DateAndTime,	smRunEndTime DateAndTime,
	smRunLifeTime TimeInterval,	smRunLifeTime TimeInterval,
	smRunExpireTime TimeInterval,	smRunExpireTime TimeInterval,
	smRunExitCode INTEGER,	smRunExitCode INTEGER,
	smRunResult OCTET STRING,	smRunResult OCTET STRING,
	smRunControl INTEGER,	smRunControl INTEGER,
	smRunState INTEGER,	smRunState INTEGER,
	smRunError SnmpAdminString	smRunError SnmpAdminString
	}	}

	smRunIndex OBJECT-TYPE	smRunIndex OBJECT-TYPE

	SYNTAX Unsigned32 (1..4294967295)	SYNTAX Integer32 (1..2147483647)
	MAX-ACCESS not-accessible	MAX-ACCESS not-accessible
	STATUS current	STATUS current
	DESCRIPTION	DESCRIPTION
	"The locally arbitrary, but unique identifier associated	"The locally arbitrary, but unique identifier associated
	with this running or finished script. This value must be	with this running or finished script. This value must be
	unique for all rows in the smRunTable with the same	unique for all rows in the smRunTable with the same

	smLaunchOwner and smLaunchName."	smLaunchOwner and smLaunchName.

		Note, the data type and the range of this object must be
		consistent with the definition of smLaunchRunIndexNext
		and smLaunchStart."
	::= { smRunEntry 1 }	::= { smRunEntry 1 }

	smRunArgument OBJECT-TYPE	smRunArgument OBJECT-TYPE
	SYNTAX OCTET STRING	SYNTAX OCTET STRING
	MAX-ACCESS read-only	MAX-ACCESS read-only
	STATUS current	STATUS current
	DESCRIPTION	DESCRIPTION
	"The argument supplied to the script when it started."	"The argument supplied to the script when it started."
	DEFVAL { ''H }	DEFVAL { ''H }
	::= { smRunEntry 2 }	::= { smRunEntry 2 }

	skipping to change at page 56, line 18 ¶	skipping to change at page 57, line 18 ¶
	This section should be removed from this document prior to its approval,	This section should be removed from this document prior to its approval,
	at which time this MIB will be administered by IANA.	at which time this MIB will be administered by IANA.

	IANA-LANGUAGE-MIB DEFINITIONS ::= BEGIN	IANA-LANGUAGE-MIB DEFINITIONS ::= BEGIN

	IMPORTS	IMPORTS
	MODULE-IDENTITY, OBJECT-IDENTITY, experimental	MODULE-IDENTITY, OBJECT-IDENTITY, experimental
	FROM SNMPv2-SMI;	FROM SNMPv2-SMI;

	ianaLanguages MODULE-IDENTITY	ianaLanguages MODULE-IDENTITY

	LAST-UPDATED "9901271800Z"	LAST-UPDATED "9902221800Z"
	ORGANIZATION "IANA"	ORGANIZATION "IANA"
	CONTACT-INFO	CONTACT-INFO
	"Internet Assigned Numbers Authority (IANA)	"Internet Assigned Numbers Authority (IANA)

	Postal: USC/Information Sciences Institute	Postal: USC/Information Sciences Institute
	4676 Admiralty Way, Marina del Rey, CA 90292	4676 Admiralty Way, Marina del Rey, CA 90292

	Tel: +1 310 822 1511	Tel: +1 310 822 1511
	E-Mail: iana@isi.edu"	E-Mail: iana@isi.edu"
	DESCRIPTION	DESCRIPTION

End of changes. 22 change blocks.
	49 lines changed or deleted	68 lines changed or added
This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/