Network Working Group V. Rangan INTERNET-DRAFT Rhapsody Networks Inc. February 2001 NFS version 4 MIB for Server Implementations draft-rangan-nfsv4-mib-00.txt Status of this Memo This document is an Internet-Draft and is in full conformance with all provisions of Section 10 of RFC 2026 [1]. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its 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 and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as Reference material or to cite them other than as ``work in progress''. The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/lid-abstracts.txt The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html 1. Abstract This memo defines an experimental portion of the Management Information Base (MIB) for use with network management protocols in the Internet Community. In particular, it defines objects used for the management of NFS version 4 Protocol (NFSv4) implementations. 1.1 Copyright Notice Copyright (C) The Internet Society (2001). All Rights Reserved. The SNMP Management Framework presently consists of five major components: An overall architecture, described in RFC 2571 [RFC2571]. Mechanisms for describing and naming objects and events for the purpose of management. The first version of this Structure of Management Information (SMI) is called SMIv1 and described in STD 16, RFC 1155 [RFC1155], STD 16, RFC 1212 [RFC1212] and RFC 1215 [RFC1215]. The second version, called SMIv2, is described in STD 58, RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 [RFC2580]. Message protocols for transferring management information. The first version of the SNMP message protocol is Rangan, et al. [Page 1] Internet-Draft NFS version 4 MIB February 2001 called SNMPv1 and described in STD 15, RFC 1157 [RFC1157]. A second version of the SNMP message protocol, which is not an Internet standards track protocol, is called SNMPv2c and described in RFC 1901 [RFC1901] and RFC 1906 [RFC1906]. The third version of the message protocol is called SNMPv3 and described in RFC 1906 [RFC1906], RFC 2572 [RFC2572] and RFC 2574 [RFC2574]. Protocol operations for accessing management information. The first set of protocol operations and associated PDU formats is described in STD 15, RFC 1157 [RFC1157]. A second set of protocol operations and associated PDU formats is described in RFC 1905 [RFC1905]. A set of fundamental applications described in RFC 2573 [RFC2573] and the view-based access control mechanism described in RFC 2575 [RFC2575]. A more detailed introduction to the current SNMP Management Framework can be found in RFC 2570 [RFC2570]. Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. Objects in the MIB are defined using the mechanisms defined in the SMI. This memo specifies a MIB module that is compliant to the SMIv2. A MIB conforming to the SMIv1 can be produced through the appropriate translations. The resulting translated MIB must be semantically equivalent, except where objects or events are omitted because no translation is possible (use of Counter64). Some machine readable information in SMIv2 will be converted into textual descriptions in SMIv1 during the translation process. However, this loss of machine readable information is not considered to change the semantics of the MIB. 4. Discussion The reader of this MIB is assumed to be familiar with the NFS version 4 protocol, as defined in [RFC3010]. In the tradition of the Simple Network Management Protocol (SNMP) this MIB defines the minimum number of objects necessary for providing as rich a set of management information. Thus, this MIB provides a set of objects from which other management information may be derived. Additionally, this MIB structure is intended to satisfy fault, configuration, performance, accounting, and security management for an NFS version 4 server implementation. There may be a need for providing a MIB for the client side implementation of the protocol, as well as intermediaries such as a file cache. This will be covered in a future MIB definition. It is currently structured around objects such as clients, filesystems and operations in the context of a filesystem. Note that while it may be possible to provide information at the granularity of a file, that Rangan, et al. [Page 2] Internet-Draft NFS version 4 MIB February 2001 would potentially increase the amount of information that would have to be collected. The root of the objects in this MIB is the nfsv4mgmt object. Below this object, the following tables exist. serverTable lists all server instances that the SNMP agent provides objects for. fsTable lists all root-level filesystem instances known. This table contains an entry for each fs_root pathname that this server would present in a fs_locations attribute. fsLockTable lists all locks and information related to locks, on a per file system basis. Each object contains a fairly standard list of statistics. Some would appear to be redundant, and could be computed from lower-level objects. However, some of the objects are transient (clients, and even filesystems), so we felt that duplicating them was not too high of a price for the availability of good information. There are no doubt still some important statistics and other information still missing; the authors would welcome any comments. One area where there could be quite a bit of value is in tracking the RPC layer as well. 5. MIB Definitions nfsV4-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-IDENTITY, OBJECT-TYPE, Unsigned32, IpAddress, Counter32, Counter64, experimental -- mib-2 FROM SNMPv2-SMI TEXTUAL-CONVENTION, RowStatus, DisplayString, TruthValue, DateAndTime FROM SNMPv2-TC InterfaceIndex FROM IF-MIB MODULE-COMPLIANCE, OBJECT-GROUP -- MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF ; nfsv4Module MODULE-IDENTITY Rangan, et al. [Page 3] Internet-Draft NFS version 4 MIB February 2001 LAST-UPDATED "0002280001Z" -- Feb. 28, 2001 ORGANIZATION "NFS v4 Working Group" CONTACT-INFO " Venkat Rangan Postal: Rhapsody Networks, Inc 3450 West Warrent Av. Fremont, CA USA 94859 Tel: +1 510-743-3000 Fax: +1 510-743-3001 E-mail: venkat@rhapsodynetworks.com" DESCRIPTION "First version of MIB for NFS v4 Server implementationss" ::= { experimental 1 } -- We need to get an experimental number for this MIB. nfsv4Objects OBJECT-IDENTITY STATUS current DESCRIPTION "NFSv4 MIB objects are all defined in this branch." ::= { nfsv4Module 1 } nfsv4ServerObjects OBJECT-IDENTITY STATUS current DESCRIPTION "NFSv4 MIB objects available at the Server implementation are all defined in this branch." ::= { nfsv4Objects 1 } nfsv4ClientObjects OBJECT-IDENTITY STATUS current DESCRIPTION "NFSv4 MIB objects available at the Client implementation are all defined in this branch." ::= { nfsv4Objects 2 } nfsv4Notifications OBJECT-IDENTITY STATUS current DESCRIPTION "NFSv4 MIB objects for providing traps and notifications." ::= { nfsv4Objects 3 } nfsv4Conformance OBJECT-IDENTITY Rangan, et al. [Page 4] Internet-Draft NFS version 4 MIB February 2001 STATUS current DESCRIPTION "NFSv4 MIB objects for describing conformance." ::= { nfsv4Objects 4 } -- Textual Conventions FsStateId ::= TEXTUAL-CONVENTION DISPLAY-HINT "255a" STATUS current DESCRIPTION "Opaque State ID." SYNTAX OCTET STRING (SIZE(0..8)) FsClientId ::= TEXTUAL-CONVENTION DISPLAY-HINT "255a" STATUS current DESCRIPTION "Opaque Client handle." SYNTAX OCTET STRING (SIZE(0..8)) FsFileHandle ::= TEXTUAL-CONVENTION DISPLAY-HINT "255a" STATUS current DESCRIPTION "Corresponds to the filehandle conventions." SYNTAX OCTET STRING (SIZE(0..128)) -- Object Definitions serverCount OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of server instances exported by the server. In a multi-homed server implementation, each interface could export a server." ::= { nfsv4ServerObjects 1 } -- -- we define an overall server table that descibes all the servers -- that are exported through this SNMP agent. In most cases, there is -- a single SNMP agent that services SNMP MIB requests for a multi-server, -- multi-homed system. serverTable OBJECT-TYPE SYNTAX SEQUENCE OF ServerEntry MAX-ACCESS not-accessible STATUS current Rangan, et al. [Page 5] Internet-Draft NFS version 4 MIB February 2001 DESCRIPTION "This table describes overall objects and counters for each server that is exported." ::= { nfsv4ServerObjects 2 } serverEntry OBJECT-TYPE SYNTAX ServerEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This describes each entry of the server table. This table is indexed by the serverIndex object." INDEX { serverIndex } ::= { serverTable 1 } -- the errors and counters maintained are per-server, regardless of -- filesystems. in most cases, these error counters are updated -- whenever the server replies with the particular error to the client. -- in some cases however, the server generates an error on its own, without -- a client request tirggering the error ServerEntry ::= SEQUENCE { serverIndex Unsigned32, serverName DisplayString, serverDescription DisplayString, numFs Counter32, numClients Counter32, nfsOkOps Counter32, accessErrs Counter32, badHandleErrs Counter32, badTypeErrs Counter32, badCookieErrs Counter32, badSeqIdErrs Counter32, badStateIdErrs Counter32, clidInuseErrs Counter32, delayErrs Counter32, deniedErrs Counter32, dquotErrs Counter32, existsErrs Counter32, expiredErrs Counter32, fBigErrs Counter32, fhExpiredErrs Counter32, graceErrs Counter32, invalErrs Counter32, ioErrs Counter32, isDirErrs Counter32, leaseMovedErrs Counter32, lockedErrs Counter32, lockRangeErrs Counter32, Rangan, et al. [Page 6] Internet-Draft NFS version 4 MIB February 2001 verMisMatchErrs Counter32, numLinkErrs Counter32, movedErrs Counter32, nameTooLongErrs Counter32, noDevErrs Counter32, noEntErrs Counter32, noFileHandleErrs Counter32, noSpaceErrs Counter32, notDirErrs Counter32, notEmptyErrs Counter32, notSuppErrs Counter32, notSameErrs Counter32, nxIoErrs Counter32, oldStateIdErrs Counter32, permErrs Counter32, readDirNoSpcErrs Counter32, resourceErrs Counter32, roFsErrs Counter32, sameErrs Counter32, serverFaultErrs Counter32, shareDeniedErrs Counter32, staleErrs Counter32, staleClientIdErrs Counter32, staleStateIdErrs Counter32, symlinkErrs Counter32, wrongSecErrs Counter32, xDevErrs Counter32 } serverIndex OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "This is an index into the server table." ::= { serverEntry 1 } serverName OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "This is a name for the server, typically in the same form as reported by the fs_location attribute." ::= { serverEntry 2 } serverDescription OBJECT-TYPE SYNTAX DisplayString Rangan, et al. [Page 7] Internet-Draft NFS version 4 MIB February 2001 MAX-ACCESS read-only STATUS current DESCRIPTION "Descriptive text for the server." ::= { serverEntry 3 } numFs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of non-pseudo filesystems exported by this server." ::= { serverEntry 4 } numClients OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of clients that have accessed this server. In order to minimize impact in counting this, the server may count the times the server issued a ClientId, regardless of whether the same ClientId was issued previously." ::= { serverEntry 5 } nfsOkOps OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Counts the number of operations that completed successfully." ::= { serverEntry 6 } accessErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Permission denied errors. The client does not have the correct permission to perform the requested." ::= { serverEntry 8 } badHandleErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Illegal NFS file handle errors." Rangan, et al. [Page 8] Internet-Draft NFS version 4 MIB February 2001 ::= { serverEntry 9 } badTypeErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of times an attempt was made to create an object of a type not supported by the server." ::= { serverEntry 10 } badCookieErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "number of times READDIR cookie is stale." ::= { serverEntry 11 } badSeqIdErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times sequence number in a locking request is neither the next expected number or the last number processed." ::= { serverEntry 12 } badStateIdErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times StateId was not consistant with current server instance." ::= { serverEntry 13 } clidInuseErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times Client Id requested was already in use by another client." ::= { serverEntry 14 } delayErrs OBJECT-TYPE Rangan, et al. [Page 9] Internet-Draft NFS version 4 MIB February 2001 SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times server returned the NFS4ERR_DELAY." ::= { serverEntry 15 } deniedErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times the server denied an attempt to lock a file." ::= { serverEntry 16 } dquotErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of times Quota exceeded errors were generated." ::= { serverEntry 17 } existsErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "File exists errors." ::= { serverEntry 18 } expiredErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times lease has expired while processing a request." ::= { serverEntry 19 } fBigErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of File too large errors." ::= { serverEntry 20 } fhExpiredErrs OBJECT-TYPE Rangan, et al. [Page 10] Internet-Draft NFS version 4 MIB February 2001 SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a volatile file handle provided in the client request has already expired at the server." ::= { serverEntry 21 } graceErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of requests that came in which could not be serviced because the server is in its grace period." ::= { serverEntry 22 } invalErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times an invalid argument was received." ::= { serverEntry 23 } ioErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of I/O errors encountered by the server." ::= { serverEntry 24 } isDirErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times the caller specified a directory in a non-directory operation." ::= { serverEntry 25 } leaseMovedErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a lease being renewed is associated with a file Rangan, et al. [Page 11] Internet-Draft NFS version 4 MIB February 2001 system that has been migrated to a new server." ::= { serverEntry 26 } lockedErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a read or write operation was attempted on a locked file." ::= { serverEntry 27 } lockRangeErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a lock request is operating on a sub-range of a current lock for the lock owner and the server does not support this type of request." ::= { serverEntry 28 } verMisMatchErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times the server has received a request that specifies an unsupported minor version. The server must return a COMPOUND4res with a zero length operations result array." ::= { serverEntry 29 } numLinkErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Count of Too many hard links errors" ::= { serverEntry 30 } movedErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a request came for a filehandle that was migrated to another server." ::= { serverEntry 31 } Rangan, et al. [Page 12] Internet-Draft NFS version 4 MIB February 2001 nameTooLongErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times the filename in an operation was too long." ::= { serverEntry 32 } noDevErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times No such device error was reported." ::= { serverEntry 33 } noEntErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times the file or directory name specified does not exist." ::= { serverEntry 34 } noFileHandleErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times NFS4ERR_NOFILEHANDLE was returned." ::= { serverEntry 35 } noSpaceErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times the space on server's filesystem would have exceeded." ::= { serverEntry 36 } notDirErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a directory operation was attempted on a Rangan, et al. [Page 13] Internet-Draft NFS version 4 MIB February 2001 non-directory object." ::= { serverEntry 37 } notEmptyErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times an attempt was made to remove a directory that was not empty." ::= { serverEntry 38 } notSuppErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times an unsupported operation was attempted." ::= { serverEntry 39 } notSameErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times the attributes were not same as provided to client." ::= { serverEntry 40 } nxIoErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a No such device or address error was issued." ::= { serverEntry 41 } oldStateIdErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a stateid was used which was issued in an earlier instance." ::= { serverEntry 42 } permErrs OBJECT-TYPE SYNTAX Counter32 Rangan, et al. [Page 14] Internet-Draft NFS version 4 MIB February 2001 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a privileged user operation was attempted by a non-provileged user." ::= { serverEntry 43 } readDirNoSpcErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a READDIR response could not be delivered due to space being exceeded." ::= { serverEntry 44 } resourceErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times resource exceeded error occured while processing a COMPOUND procedure." ::= { serverEntry 45 } roFsErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a modifying operation was issued on a Read-only file system." ::= { serverEntry 46 } sameErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times NFS4ERR_SAME was issued." ::= { serverEntry 47 } serverFaultErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times an error outside an NFS v4 protocol error Rangan, et al. [Page 15] Internet-Draft NFS version 4 MIB February 2001 occurred." ::= { serverEntry 48 } shareDeniedErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times OPEN failed because of share conflict." ::= { serverEntry 49 } staleErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times an invalid file handle was sent on a request." ::= { serverEntry 50 } staleClientIdErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a client id was issued in a request, which could not be identified by the server." ::= { serverEntry 51 } staleStateIdErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a client used a stateid from an earlier server instance." ::= { serverEntry 52 } symlinkErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times LOOKUP and OPEN of a path refers to a symbolic link." ::= { serverEntry 53 } wrongSecErrs OBJECT-TYPE SYNTAX Counter32 Rangan, et al. [Page 16] Internet-Draft NFS version 4 MIB February 2001 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times wrong security mechanism was used." ::= { serverEntry 54 } xDevErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a cross-device hard link was attempted." ::= { serverEntry 55 } -- -- the number of non-pseudo file systems that are exported by this -- server. fsCount OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of file system instances exported by the server. In a multi-homed server implementation, each interface could export a server." ::= { nfsv4ServerObjects 3 } -- -- the file system table that descibes all the root-level file systems -- that are that are visible through this SNMP agent. In most cases, there is -- a single SNMP agent that services SNMP MIB requests for all file systems -- exported by that server. fsTable OBJECT-TYPE SYNTAX SEQUENCE OF FsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table describes overall objects and counters for each file system that is exported." ::= { nfsv4ServerObjects 4 } fsEntry OBJECT-TYPE SYNTAX FsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This describes each entry of the file system table. This table is indexed by the fsIndex object." Rangan, et al. [Page 17] Internet-Draft NFS version 4 MIB February 2001 INDEX { fsIndex } ::= { fsTable 1 } FsEntry ::= SEQUENCE { fsIndex Unsigned32, fsPath DisplayString, numPersistFh Counter32, numVolatileFh Counter32, numStateId Counter32, accessCheckReqs Counter32, closeReqs Counter32, commitReqs Counter32, createReqs Counter32, delegPurgeReqs Counter32, delegReturnReqs Counter32, getAttrReqs Counter32, getFhReqs Counter32, createLinkReqs Counter32, lockReqs Counter32, testLockReqs Counter32, unlockReqs Counter32, lookupReqs Counter32, lookupParentReqs Counter32, nverifyReqs Counter32, openReqs Counter32, openAttrReqs Counter32, openConfirmReqs Counter32, openDowngradeReqs Counter32, putFhReqs Counter32, putPubFhReqs Counter32, readReqs Counter32, readDirReqs Counter32, readLinkReqs Counter32, removeReqs Counter32, renameReqs Counter32, renewReqs Counter32, restoreFhReqs Counter32, saveFhReqs Counter32, secInfoReqs Counter32, setAttrReqs Counter32, setClientIdReqs Counter32, setClientIdConfirmReqs Counter32, verifyReqs Counter32, writeReqs Counter32, cbGetAttrReqs Counter32, cbRecallReqs Counter32 } Rangan, et al. [Page 18] Internet-Draft NFS version 4 MIB February 2001 fsIndex OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "This is an index into the file system table." ::= { fsEntry 1 } fsPath OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "This is a path to the file system, exported by the server and corresponds to the fs_root object of the fs_locations attribute." ::= { fsEntry 2 } numPersistFh OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of persistent file handles that have been created." ::= { fsEntry 3 } numVolatileFh OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of volatile file handles that have been created." ::= { fsEntry 4 } numStateId OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of locks (stateIds) on file handles that have been created." ::= { fsEntry 5 } accessCheckReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of access check requests processed." ::= { fsEntry 6 } Rangan, et al. [Page 19] Internet-Draft NFS version 4 MIB February 2001 closeReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of close requests processed." ::= { fsEntry 7 } commitReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of commit requests processed." ::= { fsEntry 8 } createReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of create requests processed." ::= { fsEntry 9 } delegPurgeReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of purge delegations requests processed." ::= { fsEntry 10 } delegReturnReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of return delegations that have been created." ::= { fsEntry 11 } getAttrReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of get attribute requests that have been processed." ::= { fsEntry 12 } Rangan, et al. [Page 20] Internet-Draft NFS version 4 MIB February 2001 getFhReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of get file handle requests that have been processed." ::= { fsEntry 13 } createLinkReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of create link requests that have been processed." ::= { fsEntry 14 } lockReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of lock requests that have been processed." ::= { fsEntry 15 } testLockReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of test lock requests that have been processed." ::= { fsEntry 16 } unlockReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of unlock requests that have been processed." ::= { fsEntry 17 } lookupReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of lookup requests that have been processed." ::= { fsEntry 18 } Rangan, et al. [Page 21] Internet-Draft NFS version 4 MIB February 2001 lookupParentReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of lookup parent requests that have been processed." ::= { fsEntry 19 } nverifyReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Verify Different Attribute requests that have been processed." ::= { fsEntry 20 } openReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of open requests that have been processed." ::= { fsEntry 21 } openAttrReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of open attribute requests that have been processed." ::= { fsEntry 22 } openConfirmReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of open confirm requests that have been processed." ::= { fsEntry 23 } openDowngradeReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of open downgrade requests that have been processed." ::= { fsEntry 24 } Rangan, et al. [Page 22] Internet-Draft NFS version 4 MIB February 2001 putFhReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Set Current Filehandle requests that have been processed." ::= { fsEntry 25 } putPubFhReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Set Public Filehandle requests that have been processed." ::= { fsEntry 26 } readReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Read requests that have been processed." ::= { fsEntry 27 } readDirReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Read Directory requests that have been processed." ::= { fsEntry 28 } readLinkReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Read Symbolic Link requests that have been processed." ::= { fsEntry 29 } removeReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Remove Object requests that have been processed." ::= { fsEntry 30 } Rangan, et al. [Page 23] Internet-Draft NFS version 4 MIB February 2001 renameReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Rename Directory Entry requests that have been processed." ::= { fsEntry 31 } renewReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Renew Lease requests that have been processed." ::= { fsEntry 32 } restoreFhReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Restore Saved Filehandle requests that have been processed." ::= { fsEntry 33 } saveFhReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Save Current Filehandle requests that have been processed." ::= { fsEntry 34 } secInfoReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Obtain Available Security requests that have been processed." ::= { fsEntry 35 } setAttrReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Set Attribute requests that have been processed." ::= { fsEntry 36 } Rangan, et al. [Page 24] Internet-Draft NFS version 4 MIB February 2001 setClientIdReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Set ClientId requests that have been processed." ::= { fsEntry 37 } setClientIdConfirmReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Confirm ClientId requests that have been processed." ::= { fsEntry 38 } verifyReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Verify Same Attribute requests that have been processed." ::= { fsEntry 39 } writeReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Write requests that have been processed." ::= { fsEntry 40 } cbGetAttrReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Get Attribute callbacks that have been issued by the server." ::= { fsEntry 41 } cbRecallReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of times server issued a callback to recall a delegation." ::= { fsEntry 42 } Rangan, et al. [Page 25] Internet-Draft NFS version 4 MIB February 2001 -- -- the file system lock table describes the locks currently -- held by clients, per the view of the stateid in the server. -- it is available per file system. fsLockTable OBJECT-TYPE SYNTAX SEQUENCE OF FsLockEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table describes objects and counters for each lock owned by the server in a specific file system." ::= { nfsv4ServerObjects 5 } fsLockEntry OBJECT-TYPE SYNTAX FsLockEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This describes each entry of the file lock table. This table is indexed by the fsLockIndex object as well as the file system Index." INDEX { lockFsIndex, lockIndex } ::= { fsLockTable 1 } FsLockEntry ::= SEQUENCE { lockFsIndex Unsigned32, lockIndex Unsigned32, stateId FsStateId, clientId FsClientId, lockFh FsFileHandle, lockOffset Unsigned32, lockLength Unsigned32, accessTime Counter32 } lockFsIndex OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "This is an index into the file system table, within which the locked filehandle resides." ::= { fsLockEntry 1 } lockIndex OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION Rangan, et al. [Page 26] Internet-Draft NFS version 4 MIB February 2001 "This is an index into the lock table." ::= { fsLockEntry 2 } stateId OBJECT-TYPE SYNTAX FsStateId MAX-ACCESS read-only STATUS current DESCRIPTION "This is a stateId identifying the lock." ::= { fsLockEntry 3 } clientId OBJECT-TYPE SYNTAX FsClientId MAX-ACCESS read-only STATUS current DESCRIPTION "This is the clientId that created this lock." ::= { fsLockEntry 4 } lockFh OBJECT-TYPE SYNTAX FsFileHandle MAX-ACCESS read-only STATUS current DESCRIPTION "This is the file handle on which the lock is applied." ::= { fsLockEntry 5 } lockOffset OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "This is the offset in file for the byte-range locking." ::= { fsLockEntry 6 } lockLength OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "This is the length of the byte-range that has been locked." ::= { fsLockEntry 7 } accessTime OBJECT-TYPE SYNTAX DateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION Rangan, et al. [Page 27] Internet-Draft NFS version 4 MIB February 2001 "The date and time that the last valid access occured to the file handle and range that was locked." ::= { fsLockEntry 8 } END Rangan, et al. [Page 28] Internet-Draft NFS version 4 MIB February 2001 5. References [RFC3010] Shepler, S., Callaghan, B., Robinson, D., Thurlow, R., Beame, C., Eisler, M., Noveck, D.NFS version 4 Protocol, RFC 3010, December 2000. [RFC2571] Harrington, D., Presuhn, R., and B. Wijnen, An Architecture for Describing SNMP Management Frameworks, RFC 2571, April 1999. [RFC1155] Rose, M., and K. McCloghrie, Structure and Identification of Management Information for TCP/IP- based Internets, STD 16, RFC 1155, May 1990. [RFC1212] Rose, M., and K. McCloghrie, Concise MIB Definitions, STD 16, RFC 1212, March 1991. [RFC1215] M. Rose, A Convention for Defining Traps for use with the SNMP, RFC 1215, March 1991. [RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, Structure of Management Information Version 2 (SMIv2), STD 58, RFC 2578, April 1999. [RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, Textual Conventions for SMIv2, STD 58, RFC 2579, April 1999. [RFC2580] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, Conformance Statements for SMIv2, STD 58, RFC 2580, April 1999. [RFC1157] Case, J., Fedor, M., Schoffstall, M., and J. Davin, Simple Network Management Protocol, STD 15, RFC 1157, May 1990. [RFC1901] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, Introduction to Community-based SNMPv2, RFC 1901, January 1996. [RFC1906] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, Transport Mappings for Version 2 of the Simple Network Management Protocol (SNMPv2), RFC 1906, January 1996. [RFC2572] Case, J., Harrington D., Presuhn R., and B. Wijnen, Message Processing and Dispatching for the Simple Network Management Protocol (SNMP), RFC 2572, April Rangan, et al. [Page 29] Internet-Draft NFS version 4 MIB February 2001 1999. [RFC2574] Blumenthal, U., and B. Wijnen, User-based Security Model (USM) for version 3 of the Simple Network Management Protocol (SNMPv3), RFC 2574, April 1999. [RFC1905] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, Protocol Operations for Version 2 of the Simple Network Management Protocol (SNMPv2), RFC 1905, January 1996. [RFC2573] Levi, D., Meyer, P., and B. Stewart, SNMPv3 Applications, RFC 2573, April 1999. [RFC2575] Wijnen, B., Presuhn, R., and K. McCloghrie, View-based Access Control Model (VACM) for the Simple Network Management Protocol (SNMP), RFC 2575, April 1999. [RFC2570] Case, J., Mundy, R., Partain, D., and B. Stewart, Introduction to Version 3 of the Internet-standard Network Management Framework, RFC 2570, April 1999. Rangan, et al. [Page 30]