Skip to main content
Cisco Meraki

Enhanced Staged Upgrades

Overview 

Enhanced Staged Upgrades (ESU) allows administrators to divide a network of switches into smaller groups which can have firmware upgraded at separate times.

With ESU, administrators can schedule, pause, and rollback firmware upgrades in stages, allowing for more flexibility the upgrade process.

ESU was released in private preview in June 2022. Please reach out to your Meraki SE if you would like to try ESU in your network, if you have any questions, or encounter any issues. Meraki support is unable to assist with ESU while it is in the private preview stage. 

 

Platform Support Minimum Firmware Required
All MS switches N/A

Use Case 

The use cases for staged upgrades are typically one of two situations:

  • The network has too many switches to upgrade in a single maintenance window
  • More frequent maintenance windows are available for some devices than others. For instance, it may be reasonable to upgrade access-layer switches that connect end-user devices each night, but the data center switching that supports critical e-commerce services can only be upgraded once a month.

Terms

Staged Upgrade Group A group of switches that will be upgraded at the same time, which can also be referred to as a "stage"
Default Staged Upgrade Group An upgrade group that includes any switches that have not been assigned to any other group.
Staged Upgrade Sequence The sequence is a list of all of the groups in a network in the order that they will be upgraded.
Staged Upgrade A scheduled firmware upgrade using Enhanced Staged Upgrades. A staged upgrade includes the time and dates for each group to be upgraded.
Network Upgrade The non-staged, firmware upgrade feature used to upgrade all of the devices in a Dashboard network at the same time. 

 Scheduling a Firmware Upgrade with ESU 

Scheduling a staged upgrade begins in the same way as scheduling a typical network upgrade. The entire process of managing groups and the sequence are included in a wizard-type walkthrough accessed from the Organization > Firmware Upgrades Page. 

Navigate to the Organization > Firmware Upgrades menu, and select the "All networks" tab:

SCR-20220607-grr.png

Select the switch network to schedule a staged upgrade for, and click the blue "Schedule upgrades" button. On the next page, choose the appropriate target firmware version to upgrade to, review the change log if required, and click "Next":

SCR-20220607-h5d.png

Choose only a single switch network to schedule a staged upgrade. If more than one network is selected then the Staged Upgrades option will not be available.

Firmware downgrades can be scheduled in the same manner; by selecting a previous firmware version from the available options in the "Target firmware version"

Choose "Schedule staged upgrade", and click "Next":

SCR-20220607-h96.png

Review the summary, and click "Schedule change for 1 network" in order to proceed to configure the groups, sequence, and schedule:

SCR-20220607-hhy.png

Clicking "Schedule change for 1 network" will automatically redirect to the Enhanced Staged Upgrade wizard. This allows you to configure Staged Upgrade Groups and the Upgrade Sequence before proceeding to schedule the Staged Upgrade Event.

The following sections detail those steps further.

Configuring ESU Staged Upgrade Groups

If you've already configured your groups, you can click "Next" to configure the Staged Upgrade Sequence. 

By default, there is a single "Default Group" defined for the network, and all switches that are a part of the network belong to this group. On this page, you can create new groups and assign switches to them as needed. 

You can also create and modify staged upgrade groups without scheduling a firmware upgrade by navigating to Switch > Enhanced Staged Upgrades, and choosing the "Groups" tab.

SCR-20220607-hr0.png

  • To create a new group, click on the "Create a group" tile.
  • To modify or delete an existing group, click on the three dots (...) for the group tile and choose the appropriate option.

On the group create/edit view, give the group a name (and optionally a description), and add or remove the appropriate switches to the group as needed. When you're finished, click the "Update" or "Create" button as appropriate to return to the groups screen. 

SCR-20220607-hyt.png

Switch Stacks

Switch stacks are treated as a single device when it comes to upgrades. That is, every switch in a particular switch stack must belong to the same upgrade group. Therefore, you assign the stack to the group rather than each switch. 

Switch stacks can be expanded in the group member list to see details about the switches that belong to that stack.

The Default Group

One upgrade group must always exist in a network and that group will contain any switches that an administrator has not otherwise assigned to a group. You can edit the default group in the same manner as any other group, and you can also assign a different group as the default group.

When an administrator assigns a switch to any group (default group or other), that switch is explicitly assigned. When explicitly assigned, a switch will remain assigned to that group unless an administrator assigns it to a different group or deletes the group that the switch is currently assigned to. 

For any switches that have not been explicitly assigned to a group, they are implicitly assigned to the default group, whichever group that is. In the groups tab, the default group is marked with a Default tag and has a blue highlight on the card. 

A default group named "Default Group" is created by ... well by default; but the name is separate from actually being the default group. In the screenshot below, the default group is named "Unassigned Switches Here" and the original default group named "Default group" remains. 

If you change the default group assignment, it is recommended to rename or delete the original "Default Group" to avoid confusion.

SCR-20220624-n2t.png

Switches (or switch stacks) that are implicitly assigned to the default group are grayed out in the member list, while switches that are explicitly assigned use regular text:

SCR-20220624-muc2.png

Implicit and Explicit group assignment examples:
  • If you assign a switch to any group, it is explicitly assigned and remains in that group unless:
    • You explicitly assign the switch to a different group
    • You delete the group which implicitly re-assigns the switches in that group to the current default group
  • If you have not assigned a switch to a group, it is implicitly assigned to the current default group unless:
    • You change which group is marked as default which reassigns that switch to the new default group
    • You explicitly assign the switch to a group. 
  • If a new switch is added to the network, it is assigned to the current default group

To change which group is marked as default, edit the group you want to make default. Click the "Default group" box, review the alert message, and click the "Update" button to save:

SCR-20220607-iac.png

Configuring the ESU Staged Upgrade Sequence

Once you've finished configuring Upgrade Groups, click the "Next" button to configure the Sequence. Drag each group into the desired order and click "Next" when finished:

You can also modify the staged upgrade sequence without scheduling a firmware upgrade by navigating to Switch > Enhanced Staged Upgrades, and choosing the "Sequence" tab.

SCR-20220624-k0n.png

All Staged Upgrade Groups must be included in the Staged Upgrade Sequence. This includes any empty upgrade groups. We recommend deleting any empty groups from the network to remove them from the Staged Upgrade Sequence. 

Scheduling the Enhanced Staged Upgrade

Assign a time for each staged upgrade group to perform the firmware upgrade by choosing a time and date in the "Scheduled for" field: 

SCR-20220624-k39.png

Start times must be scheduled in the same order as the sequence (you cannot schedule a group for a start time earlier than another group which is higher up in the sequence. 

SCR-20220624-k96.png

When times have been entered for each group, click "Next" to review the upgrade configuration and proceed to schedule the upgrade:

During the initial release, there is no review screen. Clicking "Next" on the Scheduling page will immediately schedule the upgrade. 

Monitoring Enhanced Staged Upgrades

Once the upgrade is scheduled, Dashboard will load the monitoring page. Here you can monitor the upgrade status of each group as well as reschedule, rollback or cancel, and pause the staged upgrade.

 

SCR-20220606-l3i (1).png

As each group starts their upgrade stage, the status will update to reflect the group upgrade status:

  • Pending: The staged upgrade group has not yet started the upgrade
  • Started: This status is triggered once the scheduled start time for the upgrade group in question has arrived
  • Completed: This status is triggered once all of the switches in the upgrade group have reconnected to Dashboard running the configured firmware version

Managing Enhanced Staged Upgrades

There are three options to manage scheduled staged upgrades:

  • Reschedule - This option allows you to change the scheduled times for any groups that have not yet started the upgrade. Staged Upgrade Groups that have already started or complete an upgrade cannot be rescheduled.
  • Rollback / Cancel - This option allows you to abort an upgrade. For groups have already started or completed, a scheduled time must be entered to rollback to the pre-upgrade firmware. For groups that are pending (those that have not started), the upgrade is cancelled. 
  • Pause: This option will reschedule any groups that have not started by adding 1 week to the currently configured time for that upgrade group.

Note that firmware upgrades in general can be scheduled at most 1 month ahead of the current time. Therefore the maximum amount of time any upgrade group can be paused is one month away from when the pause option is used. This can result in multiple upgrade groups being scheduled for the same time (one month from the current time) when adding 1 week would exceed the 1 month limit.

It is always advised to carefully review the scheduled times to ensure they meet the requirements of the situation.

 

API

Enhanced staged upgrades can be created and managed via the Meraki API as well as Dashboard. For information regarding the API endpoints and usage, consult the Dashboard API documentation by navigating to the Help > API Docs menu in Dashboard, and search for "Staged Upgrade" in the API V1 documentation.

  • Was this article helpful?