ENTERASYS-FILE-MANAGEMENT-MIB

All MIBs › ENTERASYS-FILE-MANAGEMENT-MIB

Organization: Enterasys Networks

Last Updated: 2001-12-03

Category: Vendor: Enterasys/Cabletron

Description: Enterasys Networks MIB for managing file transfer, listing, and file system operations on Enterasys network devices.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is ENTERASYS-FILE-MANAGEMENT-MIB?

ENTERASYS-FILE-MANAGEMENT-MIB is a private Enterasys Networks MIB for managing file transfer, listing, and file system operations on Enterasys network devices, such as firmware or configuration file uploads/downloads. It exposes objects tracking transfer request limits and counts, plus a table of individual file transfer requests with their source, destination, and status. Its monitoring role centers on software/operational status of file management jobs: administrators can track how many transfer requests are queued, in progress, or completed, and check the operational status of individual transfers, which is directly relevant to monitoring firmware upgrade or configuration backup jobs on the device. It functions as a self-contained private extension without strong dependency on other standard MIBs. It is deployed on Enterasys switches and routers where automated or manual file transfers (firmware updates, config backups) are managed via SNMP. Engineers can download the ENTERASYS-FILE-MANAGEMENT-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in ENTERASYS-FILE-MANAGEMENT-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Enterasys Networks switch or router

Monitoring Examples

An administrator would poll etsysFileTransferRequestsCurrent against etsysFileTransferRequestLimit to see how close the device is to its concurrent-transfer capacity, and check etsysFileTransferRequestsCompleted to confirm jobs are finishing successfully over time. Within etsysFileTransferRequestTable, indexed by etsysFileTransferRequestIndex, the etsysFileTransferRequestOperStatus field for a given etsysFileTransferRequestSource/etsysFileTransferRequestDestination pair reveals whether a specific firmware or config file transfer succeeded, failed, or is still pending, while etsysFileTransferRequestEnqueuedTime helps identify a transfer that has been stuck in queue longer than expected.

What Can Be Monitored

current vs. maximum concurrent file transfer requests
completed file transfer count
individual file transfer operational status
file transfer enqueue time

Imported Objects

From ENTERASYS-MIB-NAMES

etsysModules

OBJECT-IDENTITY

From HOST-RESOURCES-MIB

hrFSIndex

OBJECT-TYPE

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Gauge32
Integer32
MODULE-IDENTITY
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

DateAndTime
DisplayString
RowStatus
StorageType

How to Use in IPNetwork Monitor

Example using etsysFileTransferRequestsCompleted OID:

Select an Enterasys Networks switch (legacy, later Extreme Networks)/router (file transfer/firmware management) as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type etsysFileTransferRequestsCompleted into the Find box to locate it in the OID tree, then select it and click OK. The number of file transfer requests that have completed successfully or otherwise. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
etsysFileManagementMIB	1.3.6.1.4.1.5624.1.2.15			This MIB module defines a portion of the SNMP enterprise MIBs under the Enterasys enterprise OID pertaining to the transferring and management of files for Enterasys products.
etsysFileTransfer	1.3.6.1.4.1.5624.1.2.15.1
U32 etsysFileTransferRequestLimit	1.3.6.1.4.1.5624.1.2.15.1.1	Unsigned32	read-only	The maximum number of file transfer requests this entity can hold in the etsysFileTransferRequestTable. A value of 0 indicates no configured limit.
G32 etsysFileTransferRequestsCurrent	1.3.6.1.4.1.5624.1.2.15.1.2	Gauge32	read-only	The number of file transfer requests currently in the etsysFileTransferRequestTable.
C32 etsysFileTransferRequestsCompletedEx	1.3.6.1.4.1.5624.1.2.15.1.3	Counter32	read-only	The number of file transfer requests that have completed successfully or otherwise. This object SHOULD be stored in persistent memory.
BIT etsysFileTransferRequestSupportedURLs	1.3.6.1.4.1.5624.1.2.15.1.4	Bits	read-only	The URLs that this entity supports for transferring files. These define the transfer protocols and local file types. In the case that any URL is supported only as a source or destination file then an appropriate SNMP set failure should occur when attempting to use that URL in an unsupported manner. etsysFileTransferFtp - As per rfc1738 ftp://:@:/ url-path: //...//;type= user defaults to anonymous, password to snmp@, port to 21, and type to ASCII. binary and image are both valid types which have the same meaning. domain-name would be the IP address or domain name of the managed entity. etsysFileTransferRcp - rcp://@:///...// port defaults to 514. etsysFileTransferHttp - As per rfc1738 http://:/? port defaults to 80. etsysFileTransferTftp - tftp://:///...// port defaults to 69. etsysFileTransferFile - As per rfc1738 file:/// host can only be specified as localhost or the empty string. This will only be used to specify a file on the managed entity. This indicates that the managed entity supports some form of a file system.
U32 etsysFileTransferRequestNextAvailableIndex	1.3.6.1.4.1.5624.1.2.15.1.5	Unsigned32	read-only	This object indicates the numerically lowest available index within this entity, which may be used for the value of etsysFileTransferRequestIndex in the creation of a new entry in the etsysFileTransferRequestTable. An index is considered available if the index value falls within the range of 1 to etsysFileTransferRequestLimit and is not being used to index an existing entry in the etsysFileTransferRequestTable contained within this entity. A value of zero indicates that all of the entries in the etsysFileTransferRequestTable are currently in use. This value should only be considered a guideline for management creation of etsysFileTransferRequestTable entries, there is no requirement on management to create entries based upon this index value.
etsysFileTransferRequestTable	1.3.6.1.4.1.5624.1.2.15.1.6		not-accessible	A table of file transfer requests.
etsysFileTransferRequestEntry	1.3.6.1.4.1.5624.1.2.15.1.6.1		not-accessible	An entry describing a particular file transfer request.
U32 etsysFileTransferRequestIndex	1.3.6.1.4.1.5624.1.2.15.1.6.1.1	Unsigned32	not-accessible	An arbitrary index for this file transfer request.
STR etsysFileTransferRequestSource	1.3.6.1.4.1.5624.1.2.15.1.6.1.2	DisplayString	read-create	URL of the source file. Any password information MUST NOT be returned on a read. If a managed entity supports some form of a file system and the file URL from rfc1738 then a file copy can be performed by using the file URL for both the source and destination. Activating the row with the URL specifying the same file in the source and destination SHOULD cause the file transfer to fail.
STR etsysFileTransferRequestDestination	1.3.6.1.4.1.5624.1.2.15.1.6.1.3	DisplayString	read-create	URL of the destination file. Any password information MUST NOT be returned on a read. Two transfer request entries SHOULD NOT be allowed to specify the same destination URL. To initiate a second transfer to the same destination URL the original entry must be reused or destroyed. Any errors with the type or format of these URLs SHOULD be reported in the etsysFileTransferRequestErrorDescription object when the row is activated.
INT etsysFileTransferRequestOperStatus	1.3.6.1.4.1.5624.1.2.15.1.6.1.4	INTEGER	read-only	The operational state of the file transfer. inactive - Indicates that the RowStatus of this conceptual row is not in the 'active' state. pending - Indicates that the transfer described by this row is ready to run and waiting in a queue. running - Indicates that the transfer described by this row is running. success - Indicates that the transfer described by this row has successfully run to completion. failure - Indicates that the transfer described by this row has failed to run to completion.
DAT etsysFileTransferRequestEnqueuedTime	1.3.6.1.4.1.5624.1.2.15.1.6.1.5	DateAndTime	read-only	The date and time, in device local time, when this transfer request was last enqueued for execution. The value '0000000000000000'H is returned if this table entry has not yet been queued.
DAT etsysFileTransferRequestCompletionTime	1.3.6.1.4.1.5624.1.2.15.1.6.1.6	DateAndTime	read-only	The date and time, in device local time, when this transfer request was last completed. It SHOULD be reset to the default value when the RowStatus of this conceptual row is set to active. The value '0000000000000000'H is returned if this table entry has not yet run to completion.
I32 etsysFileTransferRequestBytesTransferred	1.3.6.1.4.1.5624.1.2.15.1.6.1.7	Integer32	read-only	The number of bytes currently transferred. A value of -1 indicates that this feature is not supported for the protocol currently selected. This value is reset to its initial state when the etsysFileTransferRequestRowStatus object is set to the active state.
STR etsysFileTransferRequestErrorDescription	1.3.6.1.4.1.5624.1.2.15.1.6.1.8	SnmpAdminString	read-only	This object contains a descriptive error message if the requested transfer failed. Implementations must reset the error message to a zero-length string when the etsysFileTransferRequestRowStatus leaf is set to the active state.
STO etsysFileTransferRequestStorageType	1.3.6.1.4.1.5624.1.2.15.1.6.1.9	StorageType	read-only	Allows applications within the managed entity to define nonVolatile or readOnly rows as required.
ROW etsysFileTransferRequestRowStatus	1.3.6.1.4.1.5624.1.2.15.1.6.1.10	RowStatus	read-create	A control that allows entries to be added, activated, deactivated, and removed from this table. When the value of this object is 'active' none of the other objects in this conceptual row can be modified. Setting this object to the 'active' state from the 'notInService' state will cause the requested file transfer to be initiated or queued. Once the requested file transfer has completed, successfully or otherwise, this leaf will be set to the 'notInService' state by the managed entity. Setting this object to any other valid state from the 'active' state will interrupt the file transfer request. Setting this object to the 'active' state from the 'active' state will not have any affect. Conceptual rows that have been in the 'notInService' state for more than a device specific time period MAY be destroyed by the managed entity.
etsysFileListing	1.3.6.1.4.1.5624.1.2.15.2
etsysFileListingTable	1.3.6.1.4.1.5624.1.2.15.2.1		not-accessible	A table of user files currently stored in a particular file system on this entity. If the Host Resources MIB is not supported and there is only one file system use the value of one for the hrFSIndex. This table should represent a minimal set of information that is commonly available on most file systems.
etsysFileListingEntry	1.3.6.1.4.1.5624.1.2.15.2.1.1		not-accessible	An entry describing a particular file currently stored on this entity.
U32 etsysFileListingIndex	1.3.6.1.4.1.5624.1.2.15.2.1.1.1	Unsigned32	not-accessible	The locally arbitrary, but unique identifier associated with this file entry.
STR etsysFileListingFileName	1.3.6.1.4.1.5624.1.2.15.2.1.1.2	DisplayString	read-only	The fully qualified name of the file.
U32 etsysFileListingFileSize	1.3.6.1.4.1.5624.1.2.15.2.1.1.3	Unsigned32	read-only	The size in bytes of this file.
INT etsysFileListingFileType	1.3.6.1.4.1.5624.1.2.15.2.1.1.4	INTEGER	read-only	The type of file that this entry represents.
DAT etsysFileListingFileDate	1.3.6.1.4.1.5624.1.2.15.2.1.1.5	DateAndTime	read-only	The time and date that this file was last modified, if this information is unavailable return '0000000000000000'H.
STR etsysFileListingFileOrigin	1.3.6.1.4.1.5624.1.2.15.2.1.1.6	DisplayString	read-only	The source URL of this file, if it was created by a transfer, or an application name, if it was created by an application. If this information is unavailable return the null string. Since most of the user files on our devices are, or would be, created by file transfers or applications this would be an interesting but otherwise uncommon piece of information.
etsysFileOperation	1.3.6.1.4.1.5624.1.2.15.3
U32 etsysFileOperationLimit	1.3.6.1.4.1.5624.1.2.15.3.1	Unsigned32	read-only	The maximum number of requests this entity can hold in the etsysFileOperationTable. A value of 0 indicates no configured limit.
G32 etsysFileOperationsCurrent	1.3.6.1.4.1.5624.1.2.15.3.2	Gauge32	read-only	The number of requests currently in the etsysFileOperationTable.
C32 etsysFileOperationsCompleted	1.3.6.1.4.1.5624.1.2.15.3.3	Counter32	read-only	The number of file operations that have completed successfully or otherwise. This object SHOULD be stored in persistent memory.
U32 etsysFileOperationNextAvailableIndex	1.3.6.1.4.1.5624.1.2.15.3.4	Unsigned32	read-only	This object indicates the numerically lowest available index within this entity, which may be used for the value of etsysFileOperationIndex in the creation of a new entry in the etsysFileOperationTable. An index is considered available if the index value falls within the range of 1 to etsysFileOperationLimit and is not being used to index an existing entry in the etsysFileOperationTable contained within this entity. A value of zero indicates that all of the entries in the etsysFileOperationTable are currently in use. This value should only be considered a guideline for management creation of etsysFileOperationTable, there is no requirement on management to create entries based upon this index value.
etsysFileOperationTable	1.3.6.1.4.1.5624.1.2.15.3.5		not-accessible	Entries can be created in this table to rename and delete files on this entity.
etsysFileOperationEntry	1.3.6.1.4.1.5624.1.2.15.3.5.1		not-accessible	An entry describing an operation to be performed on the named file on this entity.
U32 etsysFileOperationIndex	1.3.6.1.4.1.5624.1.2.15.3.5.1.1	Unsigned32	not-accessible	The locally arbitrary, but unique identifier associated with this file operation entry.
INT etsysFileOperationType	1.3.6.1.4.1.5624.1.2.15.3.5.1.2	INTEGER	read-create	The operation that should be performed on the named file.
STR etsysFileOperationFileName	1.3.6.1.4.1.5624.1.2.15.3.5.1.3	SnmpAdminString	read-create	The fully qualified name of the file that this operation will be applied to.
STR etsysFileOperationFileNewName	1.3.6.1.4.1.5624.1.2.15.3.5.1.4	SnmpAdminString	read-create	The new fully qualified name for this file. This object is only required for the rename operation type.
STR etsysFileOperationErrorDescription	1.3.6.1.4.1.5624.1.2.15.3.5.1.5	SnmpAdminString	read-only	This object contains a descriptive error message if the requested operation failed. Implementations must reset the error message to a zero-length string when the etsysFileOperationRowStatus leaf is set to the active state.
ROW etsysFileOperationRowStatus	1.3.6.1.4.1.5624.1.2.15.3.5.1.6	RowStatus	read-create	A control that allows entries to be added, activated, deactivated, and removed from this table. When the value of this object is 'active' none of the other objects in this conceptual row can be modified. Setting this object to the 'active' state from the 'notInService' state will cause the requested file operation to be initiated or queued. Once the requested file operation has completed, successfully or otherwise, this leaf will be set to the 'notInService' state by the managed entity. Setting this object to any other valid state from the 'active' state will cancel the file operation if it has not been started. Setting this object to the 'active' state from the 'active' state will not have any affect. Conceptual rows that have been in the 'notInService' state for some entity specific time period will be destroyed by the managed entity.
etsysFileConformance	1.3.6.1.4.1.5624.1.2.15.4
etsysFileGroups	1.3.6.1.4.1.5624.1.2.15.4.1
etsysFileTransferGroup	1.3.6.1.4.1.5624.1.2.15.4.1.1			A group of objects that provide a means to copy and transfer files.
etsysFileListingGroup	1.3.6.1.4.1.5624.1.2.15.4.1.2			A group of objects that provide a means to list existing files.
etsysFileOperationGroup	1.3.6.1.4.1.5624.1.2.15.4.1.3			A group of objects that provide a means to rename and delete existing files.
etsysFileCompliances	1.3.6.1.4.1.5624.1.2.15.4.2
etsysFileCompliance	1.3.6.1.4.1.5624.1.2.15.4.2.1			The compliance statement for entities which implement the Enterasys File Management MIB. Implementation of this MIB is based on individual product needs.

RFC description

File transfer and management capabilities for Enterasys network devices.

Start monitoring Enterasys Networks switch (legacy, later Extreme Networks)/router (file transfer/firmware management) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download ENTERASYS-FILE-MANAGEMENT-MIB