mibs/MIBS/extreme/EXTREME-FILETRANSFER-MIB

273 lines
11 KiB
Plaintext
Raw Normal View History

2023-12-05 12:25:34 +01:00
-- ===========================================================================
EXTREME-FILETRANSFER-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, IpAddress, OBJECT-TYPE
FROM SNMPv2-SMI
DisplayString, TestAndIncr, RowStatus
FROM SNMPv2-TC
OwnerString FROM RMON-MIB
extremeAgent FROM EXTREME-BASE-MIB;
extremeFileTransfer MODULE-IDENTITY
LAST-UPDATED "9810211630Z"
ORGANIZATION "Extreme Networks, Inc."
CONTACT-INFO "www.extremenetworks.com"
DESCRIPTION "Extreme File transfer objects"
::= {extremeAgent 10}
-- The file transfer group
extremeFileTransferGroup OBJECT IDENTIFIER ::= { extremeFileTransfer 1 }
extremeFileTransferNextAvailableIndex OBJECT-TYPE
SYNTAX TestAndIncr
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The index of the next free row in the extremeFileTransferTable."
::= { extremeFileTransferGroup 1}
extremeFileTransferTable OBJECT-TYPE
SYNTAX SEQUENCE OF FileTransferEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of pending and completed file transfers."
::= { extremeFileTransferGroup 2 }
extremeFileTransferEntry OBJECT-TYPE
SYNTAX FileTransferEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table entry containing information on a pending
or completed file transfer."
INDEX { extremeFileTransferIndex }
::= { extremeFileTransferTable 1 }
FileTransferEntry ::=
SEQUENCE {
extremeFileTransferIndex INTEGER,
extremeFileTransferServerAddress IpAddress,
extremeFileTransferFileName DisplayString,
extremeFileTransferOperation INTEGER,
extremeFileTransferScheduledTime OCTET STRING,
extremeFileTransferStartAdminStatus INTEGER,
extremeFileTransferStartOperStatus INTEGER,
extremeFileTransferLastExecutionStatus INTEGER,
extremeFileTransferOwner OwnerString,
extremeFileTransferRowStatus RowStatus
}
extremeFileTransferIndex OBJECT-TYPE
SYNTAX INTEGER
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An index into the file transfer table."
::= { extremeFileTransferEntry 1 }
extremeFileTransferServerAddress OBJECT-TYPE
SYNTAX IpAddress
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This is the address of the TFTP server from which to
download the image or configuration or upload the
configuration."
::= { extremeFileTransferEntry 2 }
extremeFileTransferFileName OBJECT-TYPE
SYNTAX DisplayString (SIZE(0..64))
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This is the name of the file to be downloaded or uploaded."
::= { extremeFileTransferEntry 3 }
extremeFileTransferOperation OBJECT-TYPE
SYNTAX INTEGER {
downloadImageToPrimaryImmediate(1),
downloadImageToSecondaryImmediate(2),
downloadConfigImmediate(3),
uploadConfigImmediate(4),
scheduleConfigUploadPeriodic(5),
scheduleConfigUploadOnce(6),
scheduleImageDownloadToPrimaryOnce(7),
scheduleImageDownloadToSecondaryOnce(8),
scheduleConfigDownloadOnce(9)
}
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Indication of the file transfer operation.
This object allows configuration of uploads and/or
downloads either immediately or at a scheduled time.
A value of downloadImageToPrimaryImmediate(1) or
downloadImageToSecondaryImmediate(2) describes immediate
download of a software image to either the primary or
secondary permanent store. A value of
downloadConfigImmediate(3) describes immediate download
of a configuration file to non-volatile store. A value
of uploadConfigImmediate(4) describes the immediate upload
of the currently running configuration to the server.
A value of scheduleConfigUploadOnce(6) describes a single
upload of the current configuration to the server at the
time extremeFileTransferScheduledTime. A value of
scheduleConfigUploadPeriodic(5) describes daily uploads
of the current configuration to the server at the time
extremeFileTransferScheduledTime every day.
A value of scheduleImageDownloadToPrimaryOnce(7) or
scheduleImageDownloadToSecondaryOnce(8) describes a single
download of a software image to either the primary or
secondary permanent store at the time
extremeFileTransferScheduledTime.
This object can be modified only if
extremeFileTransferStartOperStatus for this entry is idle(1).
Note that any attempts to modify this object including
row creation which would result in multiple downloads
would cause the operation to fail. Managers are
strongly recommened to examine the
extremeFileTransferStartOperStatus object for the entries
in the table to determine the status of downloads
before attempting to modify this object."
::= { extremeFileTransferEntry 4 }
extremeFileTransferScheduledTime OBJECT-TYPE -- This convention is from RMON2
SYNTAX OCTET STRING (SIZE (0 | 8 | 11))
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The time of the day at which the file transfer operation
should be initiated. This object is meaningful only for
scheduled file transfers.
field octets contents range
----- ------ -------- -----
1 1-2 year 0..65536
2 3 month 1..12
3 4 day 1..31
4 5 hour 0..23
5 6 minutes 0..59
6 7 seconds 0..60
(use 60 for leap-second)
7 8 deci-seconds 0..9
8 9 direction from UTC '+' / '-'
9 10 hours from UTC 0..11
10 11 minutes from UTC 0..59
For example, Tuesday May 26, 1992 at 1:30:15 PM
EDT would be displayed as:
1992-5-26,13:30:15.0,-4:0
Note that if only local time is known, then
timezone information (fields 8-10) is not
present, and if no time information is known, the null
string is returned."
::= { extremeFileTransferEntry 5 }
extremeFileTransferStartAdminStatus OBJECT-TYPE
SYNTAX INTEGER {
start(1),
cancel(2)
}
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Writing to this object initiates the upload/download or
schedules one. The extremeFileTransferStartOperStatus object
should be checked before attempting to set this object.
This object cannot be modified while the
extremeFileTransferStartOperStatus is inProgress(3). This
object can be set start(1) only if the
extremeFileTransferStartOperStatus is idle(1). A scheduled
upload/download will be cancelled by setting the value of
this object to cancel(2)."
DEFVAL { cancel }
::= { extremeFileTransferEntry 6}
extremeFileTransferStartOperStatus OBJECT-TYPE
SYNTAX INTEGER {
idle(1),
scheduled(2),
inProgress(3)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The agent sets this value to reflect the current status of
the file transfer operation. Reading this object is meaningful
only if the extremeFileTransferRowStatus is active(1). The
current status is determined by the agent by examining the
values for extremeFileTransferOperation and
extremeFileTransferStartAdminStatus."
::= { extremeFileTransferEntry 7 }
extremeFileTransferLastExecutionStatus OBJECT-TYPE
SYNTAX INTEGER { -- These values are from RMON-2
success(1),
statusUnknown(2),
generalError(3),
noResponseFromServer(4),
checksumError(5),
incompatibleImage(6),
tftpFileNotFound(7),
tftpAccessViolation(8),
fileTooLarge(9),
downloadInProgress(10)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The status of the last file transfer operation. This value
is returned as statusUnknown(1) until the
extremeFileTransferRowStatus is set to active(1) or when the
extremeFileTransferStartOperStatus is inProgress(3). After an
upload/download, the agent will update this value with the
result of the file transfer. Managers should read this object
before modifying extremeFileTransferOperation because the
agent would set this value to statusUnknown(2) in such cases."
::= { extremeFileTransferEntry 8 }
extremeFileTransferOwner OBJECT-TYPE
SYNTAX OwnerString(SIZE (0..32))
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Indicates the identity of the manager that configured this
file transfer entry."
::= { extremeFileTransferEntry 9 }
extremeFileTransferRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this table entry. This object can not be
modified while the extremeFileTransferStatus is inProgress(1).
Setting this object to notInService(2) or destroy(6) will
cancel any scheduled uploads if this entry was configured for
one.
Note that any attempts to create new rows which would result
in multiple downloads would cause the row creation to fail.
Similarly, attempting to delete a row while
extremeFileTransferStartOperStatus is inProgress(3) would fail.
Managers are strongly recommened to examine the
extremeFileTransferStartOperStatus object for the entries in
the table to determine the status of downloads before
attempting row creation/deletion."
::= { extremeFileTransferEntry 10 }
END