Module: RIVERSTONE-IMAGE-MIB
OID (symbolic): RIVERSTONE-IMAGE-MIB::rsImageMibActivateTransfer
OID (numeric): 1.3.6.1.4.1.5567.2.13.7
Node type: OBJECT-TYPE
Type: TruthValue
Access: read-write
Description: 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.
What is rsImageMibActivateTransfer?
This object triggers the configured rsImageMibAction to begin when set to True(1), or stops it when set to False(2), the default; admins then poll rsImageMibPrimaryCMOperationStatus and rsImageMibBackupCMOperationStatus to track progress. This object functions as the equivalent of issuing a CLI command like 'system image add' via SNMP, kicking off whatever action and parameters were previously configured. Setting this to True(1) after configuring an addImageToAgent action starts the actual TFTP transfer of the firmware image to the device.
Examples
Walk all instances (SNMPv2c):
snmpwalk -v2c -c public <target> 1.3.6.1.4.1.5567.2.13.7
snmpwalk -v2c -c public <target> RIVERSTONE-IMAGE-MIB::rsImageMibActivateTransfer
Get a specific instance (index 1):
snmpget -v2c -c public <target> 1.3.6.1.4.1.5567.2.13.7.1
snmpget -v2c -c public <target> RIVERSTONE-IMAGE-MIB::rsImageMibActivateTransfer.1
Set instance 1 (SNMPv2c):
snmpset -v2c -c private <target> 1.3.6.1.4.1.5567.2.13.7.1 s <value>
Start monitoring Riverstone Networks RS-series routers (system software image management on PCMCIA flash) with a free 30-day trial of IPNetwork Monitor. Create custom SNMP monitor using the RIVERSTONE-IMAGE-MIB::rsImageMibActivateTransfer OID value, configure state conditions and alerts, and monitor any Riverstone Networks RS-series routers (system software image management on PCMCIA flash) from a single console.
