RIVERSTONE-IMAGE-MIB

File: RIVERSTONE-IMAGE-MIB.mib (22426 bytes)

Imported modules

SNMPv2-SMI SNMPv2-CONF SNMPv2-TC
RIVERSTONE-SMI-MIB

Imported symbols

MODULE-IDENTITY OBJECT-TYPE IpAddress
MODULE-COMPLIANCE OBJECT-GROUP TEXTUAL-CONVENTION
DisplayString TruthValue riverstoneMibs

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.
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.
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.
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
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.
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.
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.
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.
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.
OBJECT-TYPE    
  INTEGER idle(1), adding(2), deleting(3), choosing(4), actionComplete(5), error(6)  

rsImageMibPrimaryCMLastError 1.3.6.1.4.1.5567.2.13.10
A numeric code for the reason why the last action failed on the Primary CM. Default value is noInfo.
OBJECT-TYPE    
  RsImageMibErrorCode  

rsImageMibBackupCMLastError 1.3.6.1.4.1.5567.2.13.11
A numeric code for the reason why the last action failed on the Backup CM. Default value is noInfo.
OBJECT-TYPE    
  RsImageMibErrorCode  

rsImageMibPrimaryCMLastErrorString 1.3.6.1.4.1.5567.2.13.12
A string description of rsImageMibPrimaryCMLastError. Default value is blank.
OBJECT-TYPE    
  DisplayString Size(0..255)  

rsImageMibBackupCMLastErrorString 1.3.6.1.4.1.5567.2.13.13
A string description of rsImageMibBackupCMLastError. Default value is blank.
OBJECT-TYPE    
  DisplayString Size(0..255)  

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.
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.
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.
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.
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.
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.
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.
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?
OBJECT-TYPE    
  RsImageMibChosen  

rsImageMibConformance 1.3.6.1.4.1.5567.2.13.15
OBJECT IDENTIFIER    

rsImageMibGroups 1.3.6.1.4.1.5567.2.13.15.1
OBJECT IDENTIFIER    

rsImageMibCompliance 1.3.6.1.4.1.5567.2.13.15.2
OBJECT IDENTIFIER    

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.
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.
OBJECT-GROUP    

rsImageMibStatusAndErrorGroup 1.3.6.1.4.1.5567.2.13.15.1.3
The objects for monitoring errors..
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.
MODULE-COMPLIANCE