PDN-SLE-DEVICE-CONTROL-MIB DEFINITIONS ::= BEGIN -- Copyright (C) 1999 Paradyne Corporation. -- Version : 0.2 DRAFT -- Last Updated : Song Bi 03/10/00 -- Last Updated : Wayne Jadoo 3/7/00 -- Last Updated : Wayne Jadoo 1/14/00 -- Last Updated : Wayne Jadoo 1/12/00 -- Last Updated : Wayne Jadoo 10/7/99 -- Last Updated : Wayne Jadoo 10/6/99 -- Last Updated : Wayne Jadoo 10/5/99 -- Last Updated : Wayne Jadoo 09/27/99 -- Last Updated : Wayne Jadoo 09/20/99 -- Last Updated : Rajesh Gowda 09/15/99 -- Last Updated : Wayne Jadoo 09/13/99 -- This MIB contains objects that is used to perform -- various operations on a device. -- History -- 08/26/1999 -- Initial Version. -- 09/07/99 Wayne Jadoo -- changed pdn to dev -- 09/13/99 Wayne Jadoo -- added filetransfer mib and isn switch bank table. -- 09/20/99 Wayne Jadoo -- 09/20/1999 - file transfer success/fail traps -- 09/27/99 Wayne Jadoo -- Change name to DEVICE-CONTROL-MIB -- Added Mib object devFileXferSendEvent to filexfer table to -- enable/disable the sending of the -- filetransfer event trap and changed enterprise to -- devControlMIBObject from ent-8800 -- Wayne Jadoo 10/5/99 -- used the SNMPv2-TC defines for objects -- Wayne Jadoo 10/6/99 -- Suppressed the index in the file transfer mib. -- Wayne Jadoo 10/7/99 -- Imported PDN-HEADER-HEADER mib -- Wayne Jadoo 1/12/00 -- Created devControlFactoryDefault -- to enable device to be reset to factory defaults. -- Wayne Jadoo 1/14/00 -- Added objects to reset various TCP counters. -- Wayne Jadoo 3/7/00 -- Removed resetToFactoryDefaults and -- removed reseting of the layer 3 counters. -- Song Bi 03/10/00 -- Added a new object devFileXferXferTime -- in devFileXferConfigTable. IMPORTS ResetStates FROM PDN-SLE-TC TRAP-TYPE FROM RFC-1215 IpAddress, Counter, TimeTicks FROM RFC1155-SMI OBJECT-TYPE FROM RFC-1212 entPhysicalIndex FROM ENTITY-MIB pdn-sle FROM PDN-HEADER-MIB RowStatus, DisplayString FROM SNMPv2-TC ; devControlMIBObject OBJECT IDENTIFIER ::= { pdn-sle 4 } devHwControl OBJECT IDENTIFIER ::= { devControlMIBObject 1 } devFileXferConfig OBJECT IDENTIFIER ::= { devControlMIBObject 2 } devFirmwareControl OBJECT IDENTIFIER ::= { devControlMIBObject 3 } devControlFactoryDefault OBJECT IDENTIFIER ::= { devControlMIBObject 4 } devControlResetCounter OBJECT IDENTIFIER ::= { devControlMIBObject 5 } -- Device Reset Object -- Used to reset (warm boot) the device. devControlTable OBJECT-TYPE SYNTAX SEQUENCE OF DevControlEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A table that contains generic information about Card Control." ::= { devHwControl 1 } devControlEntry OBJECT-TYPE SYNTAX DevControlEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A list of information for device Control." INDEX { entPhysicalIndex } ::= { devControlTable 1 } DevControlEntry ::= SEQUENCE { devControlReset ResetStates } devControlReset OBJECT-TYPE SYNTAX ResetStates ACCESS read-write STATUS mandatory DESCRIPTION "Writing the value reset(2) to this object initiates a Hardware power-on reset of the device. Writing the value reset(3) causes the device to re-configure itself with factory defaults. The value read from this object is noOp(1)." ::= { devControlEntry 1 } -- ======================================================= -- -- The Paradyne File Transfer Group (J.Strain) -- ======================================================= devFileXferConfigTable OBJECT-TYPE SYNTAX SEQUENCE OF DevFileXferConfigEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The Paradyne FileXfer Client Config Table." ::= { devFileXferConfig 1 } devFileXferConfigEntry OBJECT-TYPE SYNTAX DevFileXferConfigEntry ACCESS not-accessible STATUS mandatory DESCRIPTION " Use of the File Tranfer MIB could be used with other MIBS in the following manner: a) Use another MIB/means to verify available space /make room for a file to be transfered to this device b) Use this MIB to download the file c) Use another MIB/means to select the file you want to make active if your selecting firmware for example. d) Use another MIB/means to reset the device. A management station wishing to initiate a file transfer needs to create an entry in this table. To do so, you must first identify the entPhysicalIndex of the device you intend to do the transfer with. You should then create the associated instance of the row status It must also, either in the same or in successive PDUs, create an instance of devFileXferFileName, devFileXferFileType, . devFileXferServerIpAddress, devFileXferOperation. It should also modify the default values for the other configuration objects if the defaults are not appropriate. Once the appropriate instance of all the configuration objects have been created, either by an explicit SNMP set request or by default, the row status should be set to active to initiate the request. Note that this entire procedure may be initiated via a single set request which specifies a row status of createAndGo as well as specifies valid values for the non-defaulted configuration objects. Once the DevFileXferConfigEntry request has been created (i.e. the devFileXferRowStatus has been made active), the entry cannot be modified - the only operation possible after this is to delete the row. Once the request completes, the management station should retrieve the values of the status objects of interest, and should then delete the entry. In order to prevent old entries from clogging the table, entries could be aged out, but an entry will never be deleted within 5 minutes of completing. " INDEX { entPhysicalIndex } ::= { devFileXferConfigTable 1 } DevFileXferConfigEntry ::= SEQUENCE { devFileXferFileName DisplayString, devFileXferCopyProtocol INTEGER, devFileXferFileType INTEGER, devFileXferServerIpAddress IpAddress, devFileXferUserName DisplayString, devFileXferUserPassword DisplayString, devFileXferOperation INTEGER, devFileXferPktsSent Counter, devFileXferPktsRecv Counter, devFileXferOctetsSent Counter, devFileXferOctetsRecv Counter, devFileXferOwnerString OCTET STRING, devFileXferStatus INTEGER, devFileXferErrorStatus INTEGER, devFileXferSendEvent INTEGER, devFileXferRowStatus RowStatus, devFileXferXferTime TimeTicks } devFileXferFileName OBJECT-TYPE SYNTAX DisplayString ACCESS read-write STATUS mandatory DESCRIPTION "This object contains the name of the filetransfer file." ::= { devFileXferConfigEntry 1 } devFileXferCopyProtocol OBJECT-TYPE SYNTAX INTEGER { tftp(1), ftp(2) } ACCESS read-write STATUS mandatory DESCRIPTION "The transfer protocol that should be used to copy the file across the network. If the file transfer is to occur locally on the SNMP agent, the method of transfer is left upto the implementation, and is not restricted to the protocols below." -- DEFVAL { tftp } ::= { devFileXferConfigEntry 2 } devFileXferFileType OBJECT-TYPE SYNTAX INTEGER { firmware(1), config(2) } ACCESS read-write STATUS mandatory DESCRIPTION "Specifies the type of file your want to transfer." ::= { devFileXferConfigEntry 3 } devFileXferServerIpAddress OBJECT-TYPE SYNTAX IpAddress ACCESS read-write STATUS mandatory DESCRIPTION "This object contains the file transfer server's IP address. " ::= { devFileXferConfigEntry 4 } devFileXferUserName OBJECT-TYPE SYNTAX DisplayString ACCESS read-write STATUS mandatory DESCRIPTION "This object contains the username if a username is needed to login to the server." ::= { devFileXferConfigEntry 5 } devFileXferUserPassword OBJECT-TYPE SYNTAX DisplayString ACCESS read-write STATUS mandatory DESCRIPTION "This object contains the password if a password is needed to login to the server. This object will return null on a read operation." ::= { devFileXferConfigEntry 6 } devFileXferOperation OBJECT-TYPE SYNTAX INTEGER { get(1), put(2) } ACCESS read-write STATUS mandatory DESCRIPTION "This object contains the operation the file transfer wants to perform." ::= { devFileXferConfigEntry 7 } devFileXferPktsSent OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "This object contains the the number of packets sent to the server at the time of interrogation." ::= { devFileXferConfigEntry 8 } devFileXferPktsRecv OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "This object contains the the number of packets received from the server at the time of interrogation." ::= { devFileXferConfigEntry 9 } devFileXferOctetsSent OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "This object contains the the number of octets sent to the server at the time of interrogation." ::= { devFileXferConfigEntry 10 } devFileXferOctetsRecv OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "This object contains the the number of octets received from the server at the time of interrogation." ::= { devFileXferConfigEntry 11 } devFileXferOwnerString OBJECT-TYPE SYNTAX OCTET STRING (SIZE(0..255)) ACCESS read-write STATUS mandatory DESCRIPTION "The entity which currently has the 'ownership' required to invoke the operation on this index." ::= { devFileXferConfigEntry 12 } devFileXferStatus OBJECT-TYPE SYNTAX INTEGER { none(1), success(2), failure(3), inprogress(4) } ACCESS read-only STATUS mandatory DESCRIPTION "This object contains the status of the file transfer." ::= { devFileXferConfigEntry 13 } devFileXferErrorStatus OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "This object contains the reason code of the failure determined in devFileXferStatus. The reason code are specific to the file transfer protocol. Please refer to the file transfer protocols respective RFC for clarification of the error code value meanings. TFTP Error Codes from rfc 1350 FTP Error Codes from rfc 959" ::= { devFileXferConfigEntry 14 } devFileXferSendEvent OBJECT-TYPE SYNTAX INTEGER { active(1), inactive(2) } ACCESS read-write STATUS mandatory DESCRIPTION "This object indicates whether or not to send the devFileXferEvent event trap ." ::= { devFileXferConfigEntry 15 } devFileXferRowStatus OBJECT-TYPE SYNTAX RowStatus ACCESS read-write STATUS mandatory DESCRIPTION "This object is used to create a new row or delete an existing row in this table." ::= { devFileXferConfigEntry 16 } devFileXferXferTime OBJECT-TYPE SYNTAX TimeTicks ACCESS read-only STATUS mandatory DESCRIPTION "This object indicates the elapsed time (in hundredths of a second) of the file transfer." ::= { devFileXferConfigEntry 17 } -- ==================================================================== -- -- Firmware Control Table -- -- This table is used to control and provide information concerning -- firmware/executable images. -- -- ==================================================================== devFirmwareControlTable OBJECT-TYPE SYNTAX SEQUENCE OF DevFirmwareControlEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A list of the current Firmware Releases and their associated status. Each Firmware Release will be indexed by a number from 1 to N. The user will be able to view the Firmware Release String and Operational Status of the release (valid or invalid) and activate a valid Firmware Release by changing the Administration Status to active." ::= { devFirmwareControl 1 } devFirmwareControlEntry OBJECT-TYPE SYNTAX DevFirmwareControlEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The Device Firmware Release entry." INDEX { entPhysicalIndex, devFirmwareControlIndex } ::= { devFirmwareControlTable 1 } DevFirmwareControlEntry ::= SEQUENCE { devFirmwareControlIndex INTEGER, devFirmwareControlRelease DisplayString, devFirmwareControlOperStatus INTEGER, devFirmwareControlAdminStatus INTEGER } devFirmwareControlIndex OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "This object is used to index the Firmware table (range 1 to N)." ::= { devFirmwareControlEntry 1 } devFirmwareControlRelease OBJECT-TYPE SYNTAX DisplayString (SIZE (1..16)) ACCESS read-only STATUS mandatory DESCRIPTION "This object indicates the Software Release for this Firmware. If the Software Firmware is Operational Status is invalid, the Software Revision Number will be blank." ::= { devFirmwareControlEntry 2 } devFirmwareControlOperStatus OBJECT-TYPE SYNTAX INTEGER { valid(1), invalid(2), unknown(3) } ACCESS read-only STATUS mandatory DESCRIPTION "This object indicates whether or not the indexed Firmware entry contains a valid(1) or invalid(2) Firmware." ::= { devFirmwareControlEntry 3 } devFirmwareControlAdminStatus OBJECT-TYPE SYNTAX INTEGER { active(1), inactive(2) } ACCESS read-write STATUS mandatory DESCRIPTION "This object indicates whether or not the indexed Firmware entry is active(1) or inactive(2). Writing active(1) will activate that software release and cause the unit to reset (response may timeout). Writing active(1) to a Firmware entry whose devFirmwareControlOperStatus is invalid will return BAD VALUE. Writing inactive(2) will always return BAD VALUE." ::= { devFirmwareControlEntry 4 } -- -- File Transfer Traps -- devFileXferEvent TRAP-TYPE ENTERPRISE devControlMIBObject VARIABLES { devFileXferStatus , devFileXferErrorStatus, devFileXferOperation, devFileXferFileType, devFileXferFileName } DESCRIPTION "This trap is to communicate a couple of things about the completion of a file transfer. devFileXferStatus - Did it complete successfully or not. devFileXferErrorStatus - If not, what was the error code. devFileXferOperation - What operation was performed?. devFileXferFileType - Was it a firmware xfer or config? devFileXferFileName - The name of the file transfered. " ::= 1 END