Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
keyboard_arrow_right

request system software sync

date_range 19-Nov-23

Syntax

content_copy zoom_out_map
request system software sync (current | rollback | all-versions)

Description

Use this command on the primary Routing Engine of a system to synchronize the software and configurations from the primary Routing Engine to the other nodes and reboot the other nodes. The configurations are synchronized even if the images are identical. If specified on the backup Routing Engine, the command fails.

Note:

The request system software sync command is only supported on PTX Series and QFX Series devices that have two Routing Engines.

Options

current | rollback | all-versions

Specify which software version (current, rollback, or all versions) to sync to the other node:

  • For the current option, the system syncs the current version from the primary Routing Engine to the other node and reboots the other node with that version. If the current version on the primary Routing Engine of the system matches the version on the other node of the system, the command fails.

  • For the rollback option, the system synchronizes the rollback version to the other node. If the rollback version on the primary Routing Engine of the system matches the rollback version on the other node, the command fails.

  • For the all-versions option, the system synchronizes all software versions and configurations from the primary Routing Engine to the other node and reboots the other node if there's a mismatch between current versions.

Additional Information

For the all-versions option, the synchronization proceeds as follows:

  1. All versions are deleted on the other node, except for the current version.
  2. The current and rollback images and configurations are copied from the primary Routing Engine to the other node. Even if the software versions match, the configuration is copied and the software proceeds to the next image.
  3. Any other versions and configurations are copied from the primary Routing Engine to the other node.
  4. If the current version on the other node is not the same as current on the primary Routing Engine, then the other node is rebooted after warning the user.

The request system software sync all-versions command is successful if the first two steps of the synchronization are successful. If step 3 fails, a warning message is displayed. To make the versions match, you can delete the extra versions using the request system software delete operational mode command.

To see what the software versions are available on the device, use the show system software list command.

If an Routing Engine that has a different software version is inserted into the system, the Routing Engine is kept outside the system and a software mismatch alarm is generated, which specifies the Routing Engine name and the version of software on that Routing Engine, similar to the following: Software Version Mismatch on re1:junos-evo-install-ptx-x86-64-20.4R2.6-EVO. To clear this alarm, use the request system software sync all-versions command to synchronize the software. Once the new Routing Engine comes back up, it joins the system.

content_copy zoom_out_map
user@host-re0> show system alarms
2 alarms currently active
Alarm time               Class  Description
2021-04-19 16:02:26 PDT  Major  Re1 Node unreachable
2021-04-19 16:04:46 PDT  Major  Software Version Mismatch on re1:junos-evo-install-ptx-x86-64-20.4R2.6-EVO

For the current option, before you switch control to a newly-inserted Routing Engine, ensure all images are synchronized to the newly-inserted Routing Engine by using the output from the show system software list operational mode command to compare the images installed on both Routing Engines and make sure they are the same. You must make sure that the system has finished synchronizing all of the images in the background before you switch control to the newly- inserted Routing Engine to ensure that the newly-inserted Routing Engine does not remove any images from the existing Routing Engine.

Required Privilege Level

view

Sample Output

request system software sync current

content_copy zoom_out_map
user@host-re0> request system software sync current
warning: Erase software versions present on the other RE node and sync software versions from Master RE node
Erase software versions on the other RE and sync from Master RE? [yes,no] (no) yes

The current version on master RE - junos-evo-install-ptx-x86-64-20.4R2.14-EVO
The current version on other RE - junos-evo-install-ptx-x86-64-20.4R2.13-EVO
Transfer software version files for junos-evo-install-ptx-x86-64-20.4R2.14-EVO to node re1...
Sync in progress for /soft/junos-evo-install-ptx-x86-64-20.4R2.14-EVO...
/data/var/home/root
Sync in progress for /data/junos-evo-install-ptx-x86-64-20.4R2.14-EVO...
Sync in progress for /data/config/junos-evo-install-ptx-x86-64-20.4R2.14-EVO...
Sync in progress for /data/etc/junos-evo-install-ptx-x86-64-20.4R2.14-EVO...
Sync in progress for /data/var_db/junos-evo-install-ptx-x86-64-20.4R2.14-EVO...
Sync in progress for /data/usr_conf/junos-evo-install-ptx-x86-64-20.4R2.14-EVO...
Sync in progress for /data/usr_evo_share/junos-evo-install-ptx-x86-64-20.4R2.14-EVO...
Sync in progress for /data/var_pfe/junos-evo-install-ptx-x86-64-20.4R2.14-EVO...
Sync in progress for /data/var_etc/junos-evo-install-ptx-x86-64-20.4R2.14-EVO...
Setting up software version files for junos-evo-install-ptx-x86-64-20.4R2.14-EVO on re1
Sync in progress /data/var/home...
Software sync completed for junos-evo-install-ptx-x86-64-20.4R2.14-EVO
Warning: Rebooting re1
Please run 'show system software list' to see SW versions installed in all nodes

request system software sync rollback (Versions Are Already The Same)

content_copy zoom_out_map
user@host> request system software sync rollback
warning: Erase software versions present on the other RE node and sync software versions from Master RE node
Erase software versions on the other RE and sync from Master RE? [yes,no] (no) yes

The rollback version on master RE - junos-evo-install-ptx-x86-64-20.4R2.14-EVO
The rollback version on other RE - junos-evo-install-ptx-x86-64-20.4R2.14-EVO
Warning: The rollback version junos-evo-install-ptx-x86-64-20.4R2.14-EVO matches to rollback version on other-RE. Skipping software sync
Software sync completed for junos-evo-install-ptx-x86-64-20.4R2.14-EVO

Please run 'show system software list' to see SW versions installed in all nodes

request system software sync all-versions

content_copy zoom_out_map
user@host-re0 request system software sync all-versions
warning: Erase software versions present on the other RE node and sync software versions from Master RE node
Erase software versions on the other RE and sync from Master RE? [yes,no] (no) ...yes

Cleanup old software versions on re1
The current version on master RE - junos-evo-install-ptx-x86-64-20.4R2.14-EVO
The current version on other RE - junos-evo-install-ptx-x86-64-20.4R2.13-EVO
Sync in progress for /soft/junos-evo-install-ptx-x86-64-20.4R2.14-EVO...
The rollback version on master RE - junos-evo-install-ptx-x86-64-20.4R2.13-EVO
The rollback version on other RE - junos-evo-install-ptx-x86-64-20.4R2.14-EVO
Sync in progress for /soft/junos-evo-install-ptx-x86-64-20.4R2.13-EVO...
Software sync completed for all versions
Warning: Rebooting re1
Please run 'show system software list' to see SW versions installed in all nodes

Release Information

Command introduced in Junos OS Evolved Release 18.3R1.

external-footer-nav