Performing a rolling upgrade

Prerequisites
  1. Ensure that there is a scheduled maintenance window. Do not change network configurations while the primary and secondary switches are at different versions.

    This procedure is NOT hitless, but it does aim to minimize the amount of traffic loss.

  2. Back up the current software to the secondary image bank. Run the show version command. If the Active Image is primary, copy the primary image to the secondary image bank:
    switch# copy primary secondary

    If the Active Image is the secondary image, you do not need to run the copy primary secondary command because the current software is already in the secondary image bank.

  3. Save the configuration manually by using one of the following methods:

    • To copy the running configuration into the startup configuration:

      switch# copy running-config startup-config

      If the startup configuration is already present, the command overwrites the pre-existing startup configuration.

    • To copy the running configuration into a checkpoint that has not been created yet:

      switch# copy running-config checkpoint <CHECKPOINT-NAME>	
  4. Check the status of the show vsx brief command and validate the ISL is in-sync and the keepalive is established.

  5. Check the output of the show lacp interfaces multi-chassis command and make note of which LACP interfaces are in a forwarding state of up.

Procedure
  1. Ensure that you are in a maintenance window. There will be some amount of network disruption even with the upgrade of a single switch.
  2. Copy the software from this release onto both switches by using TFTP, SFTP, or USB:
    switch# copy sftp://<USERNAME>@<IP>/<FILENAME> primary vrf mgmt
  3. If the upstream link is a point-to-point link, disable the Route Only Port (ROP) or change the routing cost on the upstream nodes to offload traffic of the link connected to the secondary switch.
  4. On the VSX LAG secondary switch, boot the switch to the 10.03 software release:
    switch# boot system primary

    While the secondary switch is being upgraded, the primary switch is still actively forwarding traffic with VSX LAGs from version 10.01 of the software. When you are prompted, save the configuration.

  5. Enter:
    switch# show vsx status 

    A software version mismatch is shown because only one switch has been upgraded.

    CAUTION:

    VSX synchronization has stopped on the updated secondary VSX switch. Do not change network configurations while the primary and secondary switches are at different versions. It is advised not to change the VSX configuration at this step. For example, if you create a VLAN at this time, VSX synchronization will not work for the new VLAN. Make sure that both switches are updated to the same version before they are used in a production environment.

  6. Verify that the ARP, MAC, and LACP states are fully synced:
    switch# show vsx status linkup-delay
  7. Verify that the VSX LAGs are up:
    switch# show lacp interfaces multi-chassis
  8. Enable any ROPs, SVIs, or layer 3 LAGs that were previously disabled to the uplinks. The VSX configuration is applied, the upgrade is complete, and the secondary switch is ready to forward network traffic.
  9. On the designated primary switch, boot the switch to the 10.03 software release:
    switch# boot system primary
  10. Save the configuration from the running configuration to the startup configuration by entering the write memory command.
  11. Run the show vsx brief command on both switches.

    Verify that the ISL state is In-Sync and the keepalive state is Keepalive-Established.

  12. Check the output of the show lacp interfaces command. Validate that the VSX LAGs have a forwarding state of up.
  13. Configure VSX-related features as needed. Consult this guide for additional information about the newest VSX features.
  14. Save the running configuration to the startup configuration:
    switch# write memory
    Success