RS-IMAGECOPY-MIB.txt
-- *****************************************************************
-- RS-IMAGECOPY-MIB Image Copy MIB
--
-- Copyright (c) 2001-2003 RouteScience, Inc.
-- All rights reserved.
--
-- *****************************************************************
RS-IMAGECOPY-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE,
NOTIFICATION-TYPE, Integer32
FROM SNMPv2-SMI
DisplayString
FROM SNMPv2-TC
rsMgmt
FROM ROUTESCIENCE-SMI;
rsImageCopyMIB MODULE-IDENTITY
LAST-UPDATED “200109271243Z”
ORGANIZATION “RouteScience Inc”
CONTACT-INFO
“ RouteScience, Inc.
Postal: 159 Second Avenue
San Mateo, CA 94401
USA
Phone: +1 650 548 3300
Fax: +1 650 342 9044
E-mail: [email protected]
Internet: www.routescience.com”
DESCRIPTION
“The Image Copy MIB for
RouteScience Inc”
::= { rsMgmt 4 }
rsImageCopyNotifications OBJECT IDENTIFIER ::= { rsImageCopyMIB 0 }
rsImageCopyObjects OBJECT IDENTIFIER ::= { rsImageCopyMIB 1 }
--
-- CNA Image Copy Table: for Backup/Restore
--
rsImageCopyTable OBJECT-TYPE
SYNTAX SEQUENCE OF RsImageCopyEntry
ACCESS not-accessible
STATUS mandatory
DESCRIPTION
“A table of Image copy operation entries. Each
entry represents an Image copy operation (to or
from CNA) that has been initiated.”
::= { rsImageCopyObjects 1 }
rsImageCopyEntry OBJECT-TYPE
SYNTAX RsImageCopyEntry
ACCESS not-accessible
STATUS mandatory
DESCRIPTION
“An Image copy operation entry. Each entry consists
of a command, an image type, and a file-url description.
A management station wishing to create an entry should
first generate a pseudo-random serial number to be used
as the index to this sparse table. The station should
then create the associated instance of the row status
object. It must also, either in the same or in successive
PDUs, create the associated instance of the command and
parameter objects. It should also modify the default values
for any of the parameter objects if the defaults are not
appropriate.
Once the appropriate instances of all the command
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 operation. 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 parameter objects.
Once an operation has been started, it cannot be
stopped.
Once the operation completes, the management station should
retrieve the value of the status object and delete the entry.
In order to prevent old entries from clogging the table,
entries will be aged out, but an entry will never be deleted
within 5 minutes of completing.”
INDEX { rsImageCopyIdNumber }
::= { rsImageCopyTable 1 }
RsImageCopyEntry ::= SEQUENCE {
rsImageCopyIdNumber Integer32(0..2147483647),
rsImageCopyCommand INTEGER,
rsImageCopyObjectType INTEGER,
rsImageCopyFileURLName DisplayString,
rsImageCopyOpStatus INTEGER,
rsImageCopyEntryStatus RowStatus
}
rsImageCopyIdNumber OBJECT-TYPE
SYNTAX Integer32(0..2147483647)
ACCESS read-write
STATUS mandatory
DESCRIPTION
“Object which specifies a unique entry in the
table. A management station wishing to initiate a
copy operation should use a pseudo-random value for
this object when creating or modifying an instance of
a rsImageCopyEntry.”
::= { rsImageCopyEntry 1 }
rsImageCopyCommand OBJECT-TYPE
SYNTAX INTEGER {
backup(1),
restore(2),
}
ACCESS read-write
STATUS mandatory
DESCRIPTION
“The copy command to be executed. Mandatory.”
::= { rsImageCopyEntry 2 }
rsImageCopyObjectType OBJECT-TYPE
SYNTAX Integer32 {
image(1),
imageAndConfig(2),
data(3)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
“The type of image object to be copied.”
::= { rsImageCopyEntry 3 }
rsImageCopyFileURLName OBJECT-TYPE
SYNTAX DisplayString(SIZE(1..255))
ACCESS read-write
STATUS mandatory
DESCRIPTION
“File or URL name, either in Flash or on a server,
depending on the type of copy command. Mandatory.
The file-url syntax is of the form
ftp://host[:port]/directory/file
http://host[:port]/directory/file
You can also encode the username and password in the url.
ftp://username:password@host[:port]/directory/file
http://username:password@host[:port]/directory/file
The username and password values can be configured on the device.
If the username and password values are not available, it will
attempt copying files from the network server, hoping that no
authentication is expected. Otherwise the copy command will fail.
If this variable is not specified, the default Flash device
will be assumed.”
::= { rsImageCopyEntry 4 }
rsImageCopyOpStatus OBJECT-TYPE
SYNTAX INTEGER {
copyOperationSuccess(1),
copyMiscFailure(2),
copyInProgress(3),
copyNoFreeSpace(4),
copyFileTransferError(5),
copyArchivingFailed(6),
copyPackingFailed(8),
copyImageVerificationFailed(11),
copyManagementUpgradeFailed(13),
copyUnableToRemountFlash(15),
copyUnableToRunLilo(17),
copyPeripheralUpgrdesAborted(19),
copyUnknownStatus(99)
}
ACCESS read-only
STATUS mandatory
DESCRIPTION
“The status of the specified copy operation.
For more details on the error conditions, see
the log files.
copyOperationSuccess :
specified operation is supported and
completed successfully.
copyMiscFailure :
miscellaneous failure, see log for details.
copyInProgress :
another copy operation is in progress.
only one copy operation allowed at a time.
copyNoFreeSpace :
no room on the local device for the image.
copyFileTransferError :
ftp file transfer was unsuccessfull; network failure;
invalid filename: see description for rsIMageCopyFileURLName variable.
copyArchivingFailed :
backup only: failure to collect all files for image.
copyPackingFailed :
backup only: failure to create image object.
copyImageVerificationFailed :
restore only: corrupted image; invalid checksum; not
a routescience image.
copyManagementUpgradeFailed :
restore only: upgrade of the management module failed.
copyUnableToRemountFlash :
restore only: unable to remount the flash file system
on the managment module.
copyUnableToRunLilo :
restore only: unable to run lilo which installs boot loader
on the managment module.
copyPeripheralUpgrdesAborted :
restore only: some or all of the peripheral upgrades were aborted.
copyUnknownStatus :
intial status when the row is created.
“
::= { rsImageCopyEntry 5 }
rsImageCopyEntryStatus OBJECT-TYPE
SYNTAX RowStatus
-- Rsyntax INTEGER {
-- active(1),
-- notInService(2),
-- notReady(3),
-- createAndGo(4),
-- createAndWait(5),
-- destroy(6)
-- }
ACCESS read-write
STATUS mandatory
DESCRIPTION
“The status of this table entry.”
::= { rsImageCopyEntry 6 }
--
-- Notifications
--
rsImageCopyCompletionTrap NOTIFICATION-TYPE
OBJECTS { rsImageCopyOpStatus }
STATUS current
DESCRIPTION
“Completion status of an image-copy operation. See the copy
command description in the CNA Command Reference.”
::= { rsImageCopyNotifications 1 }
END
|
|