synchronize

synchronize {slot slotid}

Description

The synchronize command replicates all saved images and configurations from the primary MSM/MM or node to the backup MSM/MM or target node on a switch or SummitStack.

Syntax Description

slotid On a SummitStack, the slotid specifies the target node that has to be synchronized with the Master node. If the slotid is omitted, the target is the backup node.
Note: This parameter is available only with SummitStack.

Default

N/A.

Usage Guidelines

This command:

  • Reboots the backup MSM/MM or target node to prepare it for synchronizing with the primary MSM/MM or node.
  • Performs a binary copy of the primary MSM/MM or node to the backup MSM/MM or target node, including the primary and secondary software images, all configurations and policies, and temporary files.
  • Reboots the backup MSM/MM or target node after replication is complete.

During a synchronization, half of the switch fabric is lost. When the primary MSM/MM or node finishes replicating its configurations and images to the backup MSM/MM or target node, the full switch fabric is restored.

To use this command, make sure your switch or SummitStack is running the following software:
  • BlackDiamond 8800 series switch with a mix of BlackDiamond 8000 c-, e-, and xl-series modules installed—Both MSMs are running ExtremeXOS 11.5 or later.
  • SummitStack—All nodes are running ExtremeXOS 12.0 or later.

When you install a backup MSM/MM, you are not prompted to synchronize the images and the configurations from the primary. If not synchronized, the backup uses its image and the primary‘s configuration. This image/configuration mismatch will likely cause the switch to operate differently after failover. Use the synchronize command to replicate all saved images and configurations from the primary to the backup.

If you have not saved your runtime configuration, you are prompted to save it when you use this command. A message similar to the following appears:

 Do you want to save configuration changes to primary.cfg? (y or n) 

Enter y to save the configuration and continue with synchronizing the MSMs/MMs. Enter n to cancel the operation. If you enter y, messages similar to the following appear:

 Saving configuration on primary MSM ...... done! Synchronizing configuration to backup MSM .. done! 

After the configuration has been saved and replicated to the backup MSM/MM, synchronization begins.

After the initial reboot, if the backup MSM/MM is not available or does not respond within 120 seconds, the synchronize operation fails.

Use the show switch {detail} command to verify that the backup MSM/MM is in sync with the primary MSM/MM.

BlackDiamond 8800 Series Switch Only

On a BlackDiamond 8800 series switch, the I/O ports on the backup MSM go down when you synchronize the MSMs. When the primary MSM finishes replicating its configurations and images to the backup MSM, the I/O ports on the backup MSM come back up.

SummitStack Only.

While using the command synchronize {slot slot-number} if the slot number is provided, that slot is the target of the synchronize operation. If the slot number is not provided, the Backup node is synchronized. This command can be executed only on the Master node.

The synchronize command preserves the following stacking configurations on the target node:
  • slot number
  • master-capable configuration
  • alternate IP address, subnetwork mask, and default gateway
  • priority
  • license restriction

Thus a synchronized node comes up in the same place in the active topology that it occupied before the synchronize command was issued.

If the synchronizing switch cannot determine the stacking support configuration on the target switch, the following message is displayed:

 Error: Information for the target switch is temporarily unavailable. Please retry the command. 

ExtremeXOS software does not allow a synchronize operation on a SummitStack between a Summit X460, X670 or X440 switch and a Summit X480 switch. If one is attempted, the following message is displayed:

 Error: the target slot's partitions are not compatible with the Master's for synchronize. 

Example

The following example assumes you have already saved your runtime configuration. Using synchronize replicates all saved images and configurations from the master MSM to the backup MSM.

After you enter the command, status messages similar to the following appear:

# synchronize
Synchronize will reboot the backup MSM, then overwrite all code images
and configs with a copy from the master MSM.
Synchronize currently requires ExtremeXOS version 11 or greater on
the backup MSM
DO NOT interrupt synchronize, the backup MSM may become unbootable!
OK to continue? (y/n) Yes
Rebooting Backup MSM...
NOTE: The command line is locked during synchronize
synchronizing...
synchronizing nvram...
synchronizing nvram...
synchronizing nvram...
synchronizing nvram...
synchronizing nvram...
synchronizing nvram...
synchronizing XOS...
[========================================] 100% XOS
Synchronize complete - rebooting backup MSM...
BD-8808.4 #

History

This command was first available in ExtremeXOS 11.0.

The slot parameter was added to support SummitStack in ExtremeXOS 12.0.

Platform Availability

This command is available only on modular switches and SummitStack.