RIVERSTONE-IMAGE-MIB
AI MIB Summary
The RIVERSTONE-IMAGE-MIB enables SNMP-based management of system image files on Riverstone routers, specifically providing read-write access to add, list, select, and delete firmware images stored on PCMCIA flashcards. This module facilitates critical device maintenance operations by allowing administrators to remotely control the boot image selection and storage state of the router's persistent memory.
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.
Main OID:
rsImageMib.1.3.6.1.4.1.5567.2.13
29
Objects
Active
Status
4
Dependencies
Imported Objects
Objects
29 total| Object Name |
|---|
rsImageMibThis 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 .1.3.6.1.4.1.5567.2.13 |
rsImageMibActionThe 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.rw Enumeration .1.3.6.1.4.1.5567.2.13.1 |
rsImageMibTftpServerAddressThe 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.rw IpAddress .1.3.6.1.4.1.5567.2.13.2 |
rsImageMibHostNameThe 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.rw DisplayString .1.3.6.1.4.1.5567.2.13.3 |
rsImageMibTftpUrlThe 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/ssr3000rw DisplayString .1.3.6.1.4.1.5567.2.13.4 |
rsImageMibImageNameThe 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.rw DisplayString .1.3.6.1.4.1.5567.2.13.5 |
rsImageMibDestinationWhich 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.rw Enumeration .1.3.6.1.4.1.5567.2.13.6 |
rsImageMibActivateTransferActivate 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://<host_name_of_tftp_server>/qa/ssr3000 system image add <host_name_of_tftp_server> qa/ssr3000 system image add <host_name_of_tftp_server> qa/ssr3000 primary-cm system image add <host_name_of_tftp_server> qa/ssr3000 primary-cm slot0 system image add <host_name_of_tftp_server> qa/ssr3000 primary-cm slot1 system image add <host_name_of_tftp_server> qa/ssr3000 backup-cm system image add <host_name_of_tftp_server> qa/ssr3000 backup-cm slot0 system image add <host_name_of_tftp_server> 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 <ip_address> rsImageMibAction.0 2 setany -v1 <ip_address> rsImageMibDestination.0 -i 2 setany -v1 <ip_address> rsImageMibImageName.0 -o qa/ssr3000 setany -v1 <ip_address> rsImageMibTftpServerAddress.0 -a 100.50.6.9 setany -v1 -d <ip_address> 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 <ip_address> rsImageMibAction.0 4 rsImageMibImageName must be set as in: setany -v1 <ip_address> rsImageMibImageName.0 -o rs30 rsImageMibDestination can be set as an option as in: setany -v1 <ip_address> rsImageMibDestination.0 -i 2 Finally, rsImageMibActivateTransfer.0 must be set as in: setany -v1 -d <ip_address> 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 <ip_address> rsImageMibAction.0 3 rsImageMibImageName must be set as in: setany -v1 <ip_address> rsImageMibImageName.0 -o rs30 rsImageMibDestination can be set as an option as in: setany -v1 <ip_address> rsImageMibDestination.0 -i 2 Finally, rsImageMibActivateTransfer.0 must be set as in: setany -v1 -d <ip_address> 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.rw TruthValue (SNMPv2-TC) .1.3.6.1.4.1.5567.2.13.7 |
rsImageMibPrimaryCMOperationStatusThe 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.ro Enumeration .1.3.6.1.4.1.5567.2.13.8 |
rsImageMibBackupCMOperationStatusThe 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.ro Enumeration .1.3.6.1.4.1.5567.2.13.9 |
rsImageMibPrimaryCMLastErrorA numeric code for the reason why the last action failed on the Primary CM. Default value is noInfo.ro RsImageMibErrorCode .1.3.6.1.4.1.5567.2.13.10 |
rsImageMibBackupCMLastErrorA numeric code for the reason why the last action failed on the Backup CM. Default value is noInfo.ro RsImageMibErrorCode .1.3.6.1.4.1.5567.2.13.11 |
rsImageMibPrimaryCMLastErrorStringA string description of rsImageMibPrimaryCMLastError. Default value is blank.ro DisplayString .1.3.6.1.4.1.5567.2.13.12 |
rsImageMibBackupCMLastErrorStringA string description of rsImageMibBackupCMLastError. Default value is blank.ro DisplayString .1.3.6.1.4.1.5567.2.13.13 |
rsImageMibListTableListing 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. SEQUENCE OF RsImageMibListEntry .1.3.6.1.4.1.5567.2.13.14 |
rsImageMibListEntryEach table entry contains certain information about a specific image that is present on a flashcard. RsImageMibListEntry .1.3.6.1.4.1.5567.2.13.14.1 |
rsImageMibControlModuleIndexA 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. RsImageMibControlModuleIndex .1.3.6.1.4.1.5567.2.13.14.1.1 |
rsImageMibSlotIndexA 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. RsImageMibSlotIndex .1.3.6.1.4.1.5567.2.13.14.1.2 |
rsImageMibImageIndexA 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. RsImageMibImageIndex .1.3.6.1.4.1.5567.2.13.14.1.3 |
rsImageMibListImageNameThe name of the image on the flashcard. Length of image name must not exceed 255 alpha-numeric characters, no spaces in imagename.ro DisplayString .1.3.6.1.4.1.5567.2.13.14.1.4 |
rsImageMibVersionThe version of the firmware image.ro DisplayString .1.3.6.1.4.1.5567.2.13.14.1.5 |
rsImageMibChosenA 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?ro RsImageMibChosen .1.3.6.1.4.1.5567.2.13.14.1.6 |
rsImageMibConformance OBJECT IDENTIFIER .1.3.6.1.4.1.5567.2.13.15 |
rsImageMibGroups OBJECT IDENTIFIER .1.3.6.1.4.1.5567.2.13.15.1 |
rsImageMibAddDeleteChooseGroupThe 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. Unknown .1.3.6.1.4.1.5567.2.13.15.1.1 |
rsImageMibListGroupThe objects for listing firmware images on the Primary and/or Backup Control Module flashcards. Unknown .1.3.6.1.4.1.5567.2.13.15.1.2 |
rsImageMibStatusAndErrorGroupThe objects for monitoring errors.. Unknown .1.3.6.1.4.1.5567.2.13.15.1.3 |
rsImageMibCompliance OBJECT IDENTIFIER .1.3.6.1.4.1.5567.2.13.15.2 |
rsImageMibBasicComplianceV1The 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. Unknown .1.3.6.1.4.1.5567.2.13.15.2.1 |