Changes to Upgrade and Downgrade for Stacking from FastIron Release 08.0.90

The stacking port format is different beginning with FastIron 08.0.90. The change in format creates upgrade and downgrade issues.

Upgrading a Stack to FastIron Release 08.0.90 or Later from Earlier Releases

Upgrades from earlier releases to FastIron 08.0.90 or a later release are seamless. FastIron 08.0.90 and later releases recognize the old format and parse startup-config flash to convert the configuration to the new format. After upgrade, if you enter the write memory command to save the configuration, the new format is stored to startup-config flash.

In the following example, an ICX 7450 stack is upgraded to FastIron 08.0.90 from FastIron 08.0.80 startup-config flash. The user has not yet used the write memory command. Output for the show configuration command shows that the FastIron 08.0.80 startup-config flash remains in the old format. The command output for the show running-config command displays the runtime configuration in the new format.

ICX7450-48P Router# show configuration
!
Startup-config data location is flash memory
!
Startup configuration:
!
ver 08.0.80 <-- old 08.0.80 release startup-config flash
!
stack unit 1
module 1 icx7450-48p-poe-management-module
module 2 icx7400-xgf-4port-40g-module
module 3 icx7400-qsfp-1port-40g-module
module 4 icx7400-qsfp-1port-40g-module
priority 128
default-ports 1/2/1 1/2/3
stack-trunk 1/2/1 to 1/2/2
stack-trunk 1/2/3 to 1/2/4
stack-port 1/2/1 1/2/3
stack unit 2
module 1 icx7450-48p-poe-management-module
module 2 icx7400-xgf-4port-40g-module
module 3 icx7400-qsfp-1port-40g-module
module 4 icx7400-qsfp-1port-40g-module
priority 128
default-ports 2/2/1 2/2/3
stack-trunk 2/2/1 to 2/2/2
stack-port 2/2/1 2/2/3
stack enable
stack mac 609c.9f2a.97e0

ICX7450-48P Router# show running-config
Current configuration:
!
ver 08.0.90
!
stack unit 1
module 1 icx7450-48p-poe-management-module
module 2 icx7400-xgf-4port-40g-module
module 3 icx7400-qsfp-1port-40g-module
module 4 icx7400-qsfp-1port-40g-module
priority 128
stack-trunk 1/2/1 to 1/2/2
stack-trunk 1/2/3 to 1/2/4
stack unit 2
module 1 icx7450-48p-poe-management-module
module 2 icx7400-xgf-4port-40g-module
module 3 icx7400-qsfp-1port-40g-module
module 4 icx7400-qsfp-1port-40g-module
priority 128
stack-trunk 2/2/1 to 2/2/2
stack-port 2/2/3
stack enable
stack mac 609c.9f2a.97e0

Downgrading a Stack from FastIron 08.0.90 or 08.0.95 to a Pre-08.0.90 Release

A standalone or active controller parses the startup-config flash to read the stacking ports for the entire stack. A release prior to FastIron 08.0.90 does not understand startup-config flash content generated by FastIron 08.0.90 or later releases. As a result, if you try to downgrade from FastIron 08.0.90 or later to a pre-08.0.90 release, the stack may break. FastIron 08.0.90 attempts to overcome the need to downgrade by saving and recovering the original startup-config flash.

In FastIron 08.0.90, when the write memory command is used, the system renames the startup-config flash "pre-8090-startup-backup" if it has been generated from a pre-08.0.90 release. You can view the contents of the saved file using the show pre-8090-startup-backup command.

Note: When a stack downgrades to a pre-08.0.90 release from recovered pre-08.0.90 startup-config flash, it loses all configuration changes made under FastIron 08.0.90 or a later release.

Every unit, including a stack member, has a startup-config file, and every unit renames the startup-config as the backup file when the write memory command is used.

If you no longer need the pre-8090-startup-backup file, you can delete it using the erase pre-8090-startup-backup command. This command erases the pre-8090-startup-backup file in every unit in the stacking system. You may no longer need the older backup file if you are certain you will not have to downgrade the system or if you have made many configuration changes with the FastIron 08.0.90 or later release installed, making the backup file obsolete.

When a system running FastIron 08.0.90 or a later release detects that it is about to reload to a pre-08.0.90 release, the system tries to recover the backup file. A message is displayed asking for confirmation before recovering the file with a warning that all changes made with the current release will be lost.

ICX7450-48P Router# boot system flash secondary
Are you sure? (enter 'y' or 'n'): y
Warning! the startup-config is 8.0.90 or later, but you are reloading to a pre-8090 image. 
The system will use the pre-8090-startup-backup file to reload and lose all 8.0.90 changes. 
(You can type "show pre-8090-startup-backup" to see its content.)
Do you want to reload ? (enter 'y' or 'n'): y
Reload using pre-8090-startup-backup file.

Note: Beginning with FastIron release 9.0.10a, you are not prompted with a warning regarding saving the startup-config file. Only the following warning is displayed:
Running Config data has been changed. Do you want to continue  the reload without 
saving the running config? (enter 'y' or 'n'):
Note: In contrast, the reload yes and boot system flash secondary yes commands do not require confirmation. The following example shows the system response when the boot system flash secondary yes command is entered.

ICX7450-48P Router# boot system flash secondary yes
Reload using pre-8090-startup-backup file.
T=8m11.3: Halt and reboot

When a system is upgraded to FastIron 08.0.90 or later and then downgraded to a pre-08.0.90 release, the results of the downgrade differ, depending on the situation. The following cases describe specific situations and the expected results. The scenarios in the following tables apply to a standalone unit or a stack.

Stack Downgrade Scenarios

Situation Result
The user never uses a write memory command when running FastIron 08.0.90. The downgrade is seamless.
The user does not change any configuration but uses the write memory command when running FastIron 08.0.90. The downgrade is fine. The system recovers the backup file before reloading to a pre-08.0.90 release.
The user makes configuration changes while running FastIron 08.0.90 and uses the write memory command. The downgrade loses all configuration changes made under FastIron 08.0.90. The system recovers the backup file that does not contain the changes.

Switchover or failover does not affect these downgrade scenarios. For example, you may perform a switch-over to change the active controller and then reload. The recovery result is the same as a reload without changing the active controller.

There are a few cases where recovery does not work.

Scenarios where Stack Downgrades Cannot Be Performed

Situation Result
The user reloads the system by powering down. The system cannot recover the backup file before reloading.
The standalone or active controller does not have a startup-config flash file generated by any pre-08.0.90 release. Downgrade is not possible.
Note: It is recommended that you copy the running configuration to a file before downgrading. You can do this using the copy running-config command to copy the configuration to different locations such as a USB disk file or a tftp server, or you can simply enter the show running-config command and then copy the output and paste it into a computer file.
Note: If you don't have a pre-08090-startup-backup file (which can be checked with the show pre-8090-startup-backup command), or you have many configuration changes to the 08.0.90 release or a later release and you need to downgrade to a pre-08.0.90 release, you must manually edit the 08.0.90 configuration to create a pre-08.0.90 format.