RIVERSTONE-IMAGE-MIB
File:
RIVERSTONE-IMAGE-MIB.mib (22426 bytes)
Imported modules
Imported symbols
Defined Types
RsImageMibErrorCode |
|
A unique value, greater than zero defining the operation
completion status. |
TEXTUAL-CONVENTION |
|
|
|
|
INTEGER |
noInfo(1), successfullyCompleted(2), timeout(3), networkError(4), noSpace(5), invalidImage(6), commandCompleted(7), internalError(8), tftpServerError(9) |
|
RsImageMibControlModuleIndex |
|
The table in this MIB is indexed by
'rsImageMibControlModuleIndex', 'rsImageMibSlotIndex' and
'rsImageMibImageIndex'- not by 'ifIndex'.
Why is there a separate index?
Traditionally, ifIndex values are chosen by agents,
and are permitted to change across restarts. Using
ifIndex to index the tables could complicate
row creation and/or cause interoperability problems
(if each agent had special restrictions on ifIndex).
Having a separate index avoids these problems. |
TEXTUAL-CONVENTION |
|
|
|
|
INTEGER |
primaryCM(1), backupCM(2) |
|
RsImageMibSlotIndex |
|
The table in this MIB is indexed by
'rsImageMibControlModuleIndex', 'rsImageMibSlotIndex' and
'rsImageMibImageIndex'- not by 'ifIndex'. |
TEXTUAL-CONVENTION |
|
|
|
|
INTEGER |
slot0(1), slot1(2) |
|
RsImageMibImageIndex |
|
The table in this MIB is indexed by
'rsImageMibControlModuleIndex', 'rsImageMibSlotIndex' and
'rsImageMibImageIndex'- not by 'ifIndex'. |
TEXTUAL-CONVENTION |
|
|
|
|
INTEGER |
firstImage(1), secondImage(2), thirdImage(3) |
|
RsImageMibChosen |
|
A unique value, greater than zero, specifying whether
the firmware image is the chosen image or not.
Default value is noInfo(1). |
TEXTUAL-CONVENTION |
|
|
|
|
INTEGER |
noInfo(1), chosen(2), notChosen(3) |
|
RsImageMibListEntry |
|
SEQUENCE |
|
|
|
|
rsImageMibControlModuleIndex |
RsImageMibControlModuleIndex |
|
|
rsImageMibSlotIndex |
RsImageMibSlotIndex |
|
|
rsImageMibImageIndex |
RsImageMibImageIndex |
|
|
rsImageMibListImageName |
DisplayString |
|
|
rsImageMibVersion |
DisplayString |
|
|
rsImageMibChosen |
RsImageMibChosen |
|
Defined Values
rsImageMib |
1.3.6.1.4.1.5567.2.13 |
This mib module defines the objects to be used by SNMP to access
the 'system image' commands on the Riverstone router, i.e., to
add, list, choose and delete system images from PCMCIA flashcards. |
MODULE-IDENTITY |
|
|
|
rsImageMibAction |
1.3.6.1.4.1.5567.2.13.1 |
The action to be performed. For example,
addImageToAgent uses tftp to transfer the image from
a tftp server to the agent.
Default value is no operation, called noop. |
Status: current |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
INTEGER |
noop(1), addImageToAgent(2), deleteImageFromAgent(3), chooseImageOnAgent(4) |
|
rsImageMibTftpServerAddress |
1.3.6.1.4.1.5567.2.13.2 |
The IPv4 address of the tftp server to be used by the
agent when adding an image.
Default value is 0.0.0.0.
Address must be a unicast address that is reachable
from the agent and no firewalls/acls
preventing tftp datagrams from being transferred. |
Status: current |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
IpAddress |
|
|
rsImageMibHostName |
1.3.6.1.4.1.5567.2.13.3 |
The name of the host running the tftp server used
to add an image to the agent.
Default value is a blank string.
Length of image name must not exceed 255 alpha-numeric
characters, no spaces in imagename. |
Status: current |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
DisplayString |
Size(0..255) |
|
rsImageMibTftpUrl |
1.3.6.1.4.1.5567.2.13.4 |
The URL which gives the tftp server ip address and
image name to be added to the agent.
Default value is blank.
e.g. tftp://10.50.6.4/qa/ssr3000 |
Status: current |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
DisplayString |
Size(0..255) |
|
rsImageMibImageName |
1.3.6.1.4.1.5567.2.13.5 |
The image name that the action task is to involve.
For example, for adding an image to the agent,
rsImageMibImageName is the image to be added from the
tftp server at rsImageMibTftpServerAddres.
For example, for deleting an image from the agent,
rsImageMibImageName is the image to be deleted from the
agent.
For example, for choosing an image on the agent as the
active image for the next reboot, rsImageMibImageName
is the image to be chosen; if the imagename is 'none',
this means to choose no image as the active image for
the next reboot. 'none' is used to delete
a previously chosen image.
Default value is blank.
Length of image name must not exceed 255 alpha-numeric
characters, no spaces in imagename. |
Status: current |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
DisplayString |
Size(0..255) |
|
rsImageMibDestination |
1.3.6.1.4.1.5567.2.13.6 |
Which flashcard(s) to perform the
add, choose or delete operation on. The choices are:
1. first available flashcard in slot0 or slot1 of both
the Primary and Backup Control Modules.
For example, you may end up with slot0 of the
Primary CM and slot1 of the Backup CM.
2. first available flashcard in slot0 or slot1 of just
Primary CM;
3. first available flashcard in slot0 or slot1 of just
Backup CM;
4. flashcard in slot0 of Primary CM;
5. flashcard in slot1 of Primary CM;
6. flashcard in slot0 of Backup CM;
7. flashcard in slot1 of Backup CM;
Default is both cards. |
Status: current |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
INTEGER |
both(1), pCM(2), bCM(3), pCMslot0(4), pCMslot1(5), bCMslot0(6), bCMslot1(7) |
|
rsImageMibActivateTransfer |
1.3.6.1.4.1.5567.2.13.7 |
Activate the transfer operation (add, choose
or delete) with a value of
True(1) or stop it with False(2).
Default value is False(2).
Poll rsImageMibPrimaryCMOperationStatus for current
status of the Primary CM and poll
rsImageMibBackupCMOperationStatus for current status
of the Backup CM.
Default status is False.
This object is a trigger that starts the
rsImageMibAction, and therefore
is equivalent to one of several CLI commands,
such as these:
to add an image:
system image add 10.50.6.4 qa/ssr3000
system image add 10.50.6.4 qa/ssr3000 primary-cm
system image add 10.50.6.4 qa/ssr3000 primary-cm slot0
system image add 10.50.6.4 qa/ssr3000 primary-cm slot1
system image add 10.50.6.4 qa/ssr3000 backup-cm
system image add 10.50.6.4 qa/ssr3000 backup-cm slot0
system image add 10.50.6.4 qa/ssr3000 backup-cm slot1
system image add tftp://10.50.6.4/qa/ssr3000
system image add tftp:///qa/ssr3000
system image add qa/ssr3000
system image add qa/ssr3000 primary-cm
system image add qa/ssr3000 primary-cm slot0
system image add qa/ssr3000 primary-cm slot1
system image add qa/ssr3000 backup-cm
system image add qa/ssr3000 backup-cm slot0
system image add qa/ssr3000 backup-cm slot1
to choose an image, need:
system image choose ssr3000
system image choose ssr3000 primary-cm
system image choose ssr3000 primary-cm slot0
system image choose ssr3000 primary-cm slot1
system image choose ssr3000 backup-cm
system image choose ssr3000 backup-cm slot0
system image choose ssr3000 backup-cm slot1
system image choose none
system image choose none primary-cm
system image choose none primary-cm slot0
system image choose none primary-cm slot1
system image choose none backup-cm
system image choose none backup-cm slot0
system image choose none backup-cm slot1
to delete an image, need:
system image delete ssr3000
system image delete ssr3000 primary-cm
system image delete ssr3000 primary-cm slot0
system image delete ssr3000 primary-cm slot1
system image delete ssr3000 backup-cm
system image delete ssr3000 backup-cm slot0
system image delete ssr3000 backup-cm slot1
IMPORTANT:
ADD OPERATION: For adding an image to a flash card,
there are two basic ways to do so:
NOTE: both cases use rsImageMibAction set to 2.
case 1: use rsImageMibTftpServerAddress (or
rsImageMibHostName), rsImageMibImageName and
rsImageMibDestination.
case 2: use rsImageMibTftpUrl. Please note that the
image will automatically be added to both Primary
and Backup CMs if they are present, or to only the
Primary CM if it alone is present. (NOTE: One cannot
specify the destination for the image add operation
by using use rsImageMibTftpUrl)
In either case, the objects to be used must be
set before the final set of rsImageMibActivateTransfer. Please follow these procedures:
for case 1: rsImageMibTftpServerAddress (or
rsImageMibHostName), rsImageMibImageName and
rsImageMibDestination must be set. Do not set
rsImageMibTftpUrl after these objects are set.
example: //SNMP add to Primary CM:
setany -v1 rsImageMibAction.0 2
setany -v1 rsImageMibDestination.0 -i 2
setany -v1 rsImageMibImageName.0 -o qa/ssr3000
setany -v1 rsImageMibTftpServerAddress.0 -a 100.50.6.9
setany -v1 -d rsImageMibActivateTransfer.0 -i 1
for case 2: rsImageMibTftpUrl must be set. Do not set
rsImageMibTftpServerAddress, rsImageMibHostName,
rsImageMibImageName or rsImageMibDestination after this
objects is set.
You can check the required scalar objects to make
sure they have appropriate values before the final
set of rsImageMibActivateTransfer.
CHOOSE OPERATION:
For choosing an image as the active image for the
next reboot, follow this procedure:
The objects to be used must be set before the final
set of rsImageMibActivateTransfer:
rsImageMibAction must be set as in:
setany -v1 rsImageMibAction.0 4
rsImageMibImageName must be set as in:
setany -v1 rsImageMibImageName.0 -o rs30
rsImageMibDestination can be set as an option as in:
setany -v1 rsImageMibDestination.0 -i 2
Finally, rsImageMibActivateTransfer.0 must be set as in:
setany -v1 -d rsImageMibActivateTransfer.0 -i 1
Please note: rsImageMibTftpUrl is NOT used in a
choose. When the user wants to choose an image, and
the user sets rsImageMibDestination to dictate which
flash card(s) the image is to be chosen on, the
user cannot also use rsImageMibTftpUrl. Setting
rsImageMibDestination will set rsImageMibTftpUrl to
its default value of a blank string.
DELETE OPERATION:
For deleting an image from a flashcard, follow this
procedure:
The objects to be used must be set before the final
set of rsImageMibActivateTransfer:
rsImageMibAction must be set as in:
setany -v1 rsImageMibAction.0 3
rsImageMibImageName must be set as in:
setany -v1 rsImageMibImageName.0 -o rs30
rsImageMibDestination can be set as an option as in:
setany -v1 rsImageMibDestination.0 -i 2
Finally, rsImageMibActivateTransfer.0 must be set as in:
setany -v1 -d rsImageMibActivateTransfer.0 -i 1
Please note: rsImageMibTftpUrl is NOT used in a
delete. When the user wants to delete an image, and
the user sets rsImageMibDestination to dictate which
flash card(s) the image is to be deleted from, the
user cannot also use rsImageMibTftpUrl. Setting
rsImageMibDestination will set rsImageMibTftpUrl to
its default value of a blank string. |
Status: current |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
TruthValue |
|
|
rsImageMibPrimaryCMOperationStatus |
1.3.6.1.4.1.5567.2.13.8 |
The current status of the action task on the
Primary Control Module.
Default is idle.
Adding means an image is being added to a flashcard
of the Primary CM.
Choosing means an image is being chosen on a
flashcard of the Primary CM as the active image for
the next reboot.
Deleting means an image is being deleted from the
flashcards(s) of the Primary CM.
Error means the action failed.
See rsImageMibPrimaryCMLastError
for the reason why it failed. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
INTEGER |
idle(1), adding(2), deleting(3), choosing(4), actionComplete(5), error(6) |
|
rsImageMibBackupCMOperationStatus |
1.3.6.1.4.1.5567.2.13.9 |
The current status of the action task on the
Backup Control Module.
Default is idle.
Adding means an image is being added to a flashcard
of the Backup CM.
Choosing means an image is being chosen on a
flashcard of the Backup CM as the active image for
the next reboot.
Deleting means an image is being deleted from the
flashcards(s) of the Backup CM.
Error means the action failed.
See rsImageMibBackupCMLastError
for the reason why it failed. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
INTEGER |
idle(1), adding(2), deleting(3), choosing(4), actionComplete(5), error(6) |
|
rsImageMibListTable |
1.3.6.1.4.1.5567.2.13.14 |
Listing images is performed by snmp get and snmp getNext.
This table describes the images listed on the Primary and/or
Backup PCMCIA flashcards. Information for each image is
contained in a row of the table.
Cli commands for listing images on the PCMCIA flashcards
are NOT equivalent to how images are listed via snmp.
(In other words, one cannot set up a list operation for the
imageMib as one can for an add, delete or choose operation.
Thus, in order to list the images, one must do a get or
getnext or getmany on the object or objects desired)
The Cli commands are:
system image list
system image list all
system image list primary-cm
system image list backup-cm
In this Mib, the images can be listed either by snmp get or
snmp getNext. Snmp get gets the image information of the
image associated with the index that is passed to snmp get.
Snmp getNext gets the information of the next image relative
to the index that is passed to snmp getNext.
The images are specified in the get or getnext request by 3
(three) indeces which describe the control module, slot and
imagename. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
SEQUENCE OF |
|
|
|
|
RsImageMibListEntry |
|
rsImageMibListEntry |
1.3.6.1.4.1.5567.2.13.14.1 |
Each table entry contains certain information about a
specific image that is present on a flashcard. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
RsImageMibListEntry |
|
|
rsImageMibControlModuleIndex |
1.3.6.1.4.1.5567.2.13.14.1.1 |
A value which together with rsImageMibSlotIndex and
rsImageMibImageIndex forms an index which identifies an entry
in the table. On the device managed, there are 2 Control
Modules possible: Primary and Backup. Each can have
its own PCMCIA flashcard(s), which can hold images.
Information on these images is kept in the
rsImageMibListTable. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
RsImageMibControlModuleIndex |
|
|
rsImageMibSlotIndex |
1.3.6.1.4.1.5567.2.13.14.1.2 |
A value which together with rsImageMibControlModuleIndex
and rsImageMibImageIndex forms an index which identifies an
entry in the table. On the device managed, there are 2 slots
per Control Module, and each slot may have a PCMCIA flashcard
in it. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
RsImageMibSlotIndex |
|
|
rsImageMibImageIndex |
1.3.6.1.4.1.5567.2.13.14.1.3 |
A value which together with rsImageMibControlModuleIndex
and rsImageMibSlotIndex forms an index which identifies an
entry in the table. On the device managed, each
PCMCIA flashcard can hold currently up to three (3)
images. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
RsImageMibImageIndex |
|
|
rsImageMibListImageName |
1.3.6.1.4.1.5567.2.13.14.1.4 |
The name of the image on the flashcard.
Length of image name must not exceed 255 alpha-numeric
characters, no spaces in imagename. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
DisplayString |
Size(0..255) |
|
rsImageMibVersion |
1.3.6.1.4.1.5567.2.13.14.1.5 |
The version of the firmware image. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
DisplayString |
Size(0..255) |
|
rsImageMibChosen |
1.3.6.1.4.1.5567.2.13.14.1.6 |
A unique value, greater than zero, specifying whether
the firmware image is the chosen image or not.
That is, is the image the chosen image for the
next reboot? |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
RsImageMibChosen |
|
|
rsImageMibAddDeleteChooseGroup |
1.3.6.1.4.1.5567.2.13.15.1.1 |
The objects for adding, deleting, and choosing
firmware images on the Primary and/or Backup Control Module
flashcards. Table columnar objects which are table indexes
are not included. |
Status: current |
Access: read-only |
OBJECT-GROUP |
|
|
|
rsImageMibListGroup |
1.3.6.1.4.1.5567.2.13.15.1.2 |
The objects for listing
firmware images on the Primary and/or Backup Control Module
flashcards. |
Status: current |
Access: read-only |
OBJECT-GROUP |
|
|
|
rsImageMibBasicComplianceV1 |
1.3.6.1.4.1.5567.2.13.15.2.1 |
The basic implementation requirements for version 1.0 of the
RIVERSTONE-IMAGE-MIB. That is, the objects in these groups must be
implemented for V1 of this Mib. |
Status: current |
Access: read-only |
MODULE-COMPLIANCE |
|
|
|