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.
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.
|
N/A.
This command:
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.
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.
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.
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.
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.
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 #
This command was first available in ExtremeXOS 11.0.
The slot parameter was added to support SummitStack in ExtremeXOS 12.0.
This command is available only on modular switches and SummitStack.