run failover

run failover {force}


Causes a user-specified node failover.

Syntax Description


Force failover to occur.



Usage Guidelines

Use this command to cause the primary MSM/MM to failover to the backup MSM/MM on modular switches, or the Master node to failover to the Backup node in SummitStack.

Before you initiate failover, use the show switch {detail} command to confirm that the nodes are in sync and have identical software and switch configurations. If the output shows MASTER and BACKUP (InSync), the two MSMs/MMs or nodes are in sync.

If the MSM/MM‘s software and configuration are not in sync, and both MSMs/MMs are running ExtremeXOS 11.0 or later, or the master and backup SummitStack nodes software and configuration are not in sync and are running ExtremeXOS 12.0 or later, use the synchronize command to get the two MSMs/MMs or nodes in sync. This command ensures that the backup has the same software in flash as the master.



Both the backup and the master MSMs or nodes must be running ExtremeXOS 11.0 or later to use the synchronize command.

If the MSMs/MMs are not in sync, and one MSM/MM is running ExtremeXOS 10.1 or earlier, specify the force option of the run failover command. By specifying force, failover occurs regardless of the version of software running on the MSMs/MMs.


The following command causes a failover on a modular switch or SummitStack:

run failover


This command was first available in ExtremeXOS 12.0.

Platform Availability

This command is available only on modular switches and SummitStack.