2-83
Cisco MGX 8850 Routing Switch Command Reference
Release 2.0, Part Number 78-10467-04 Rev C0, October 2001
Chapter 2
Shelf Management Commands
runrev
runrev
Run Revision
Causes a new firmware version to start running. In a redundant card pair, runrev first causes the standby
card to become the active card. The runrev command is the second of the required commands in a
graceful upgrade. It runs on the PXXM45 but can target either a service module or the PXM45.
The order of commands in a graceful upgrade, including the option of aborting the upgrade, appears in
the following list. For clarification of the states in a graceful upgrade, see
Table 2-12
and
Table 2-13
.
1.
loadrev loads a firmware version from the hard disk to a card’s memory. In a non-redundant card
setup, loadrev does not cause the system to reset the CARD.
2.
runrev causes the primary card to start running the new version. For a redundant pair of cards, the
standby becomes the active card then starts running the new version.
3.
If an unacceptable problem occurs, the optional abortrev command restores the previous version of
firmware as well as the previous database contents.
4.
commitrev declares the new primary version to be acceptable and removes the old primary from
main memory (but not the hard disk).
The sequence of commands for a graceful revision change appear in the following list. See
Table 2-10
and
Table 2-11
for a clarification of the various states within this sequence.
1.
loadrev loads a firmware version from the hard disk to a card’s memory. In a non-redundant card
setup, loadrev does not cause the system to reset the card.
2.
runrev causes the primary card to start running the new version. For a redundant pair of cards, the
standby becomes the active card then starts running the new version.
3.
If an unacceptable problem occurs, the optional abortrev command restores the previous version of
firmware as well as the previous database contents.
4.
commitrev declares the new primary version to be acceptable and removes the old primary from
main memory (but not the hard disk).
A graceful upgrade takes a single card or a redundant card pair through different stages. Also, if you
must execute abortrev on a redundant pair, the card (or possibly both cards in a redundant pair) are reset.
The stages of a graceful upgrade and the reset actions appear in
Table 2-10
for a single-card upgrade and
Table 2-11
for a redundant-pair upgrade.
The tables start by showing that, initially, the primary and secondary versions of firmware are 2.x, so
the only possible operational version is 2.x. The loadrev command loads a generic version called 2.y,
and the upgrade sequence progressively changes the primary and secondary firmware versions.
Table 2-12 Single-Card Upgrade From 2.x to 2.y
Firmware
Status
Initial Version
After loadrev
After runrev
After
commitrev
Primary
2.x
2.x
2.y
2.y
Secondary
2.x
2.y
2.x
2.y
Operational
2.x
2.x
2.y
2.y
After abortrev,
the card is reset.
