Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

request system software rollback (Junos OS)

Syntax

Syntax (EX Series Switches)

Syntax (MX Series Router)

Syntax (SRX Series Firewalls)

Syntax (TX Matrix Router)

Syntax (TX Matrix Plus Router)

Description

Use this command to revert to the last successfully installed package before the request system software (add | delete) command. It uses the copy stored in the /var/sw/pkg directory.

Additional Information

  • On Junos Fusion, the request system software rollback command can be used to roll back the version of satellite software associated with a satellite software upgrade group. Rolling back the version of satellite software associated with a satellite software upgrade group triggers a satellite software upgrade.

  • On M Series and T Series routers, if request system software add jinstall reboot was used for the previous installation, then request system software rollback has no effect. In this case, use jinstall to reinstall the required package.

  • On M Series and T Series routers, if request system software add sdk1 was used for the previous installation, then request system software rollback removes the last installed SDK package (sdk1 in this example).

  • On SRX Series Firewalls with dual root systems, when request system software rollback is run, the system switches to the alternate root. Each root can have a different version of Junos OS. Roll back takes each root back to the previously installed image.

  • On QFX3500 and QFX3600 devices in a mixed Virtual Chassis, when the request system software rollback command is issued, the system does not rollback to the image stored in the alternate partition.

  • On QFX5100 switches, the reboot option has been removed. To reboot the switch after a software rollback, issue the request system reboot command as a separate, secondary command.

Options

all-members

(EX4200 switches and MX Series routers only) (Optional) Attempt to roll back to the previous set of packages on all members of the Virtual Chassis configuration.
device-alias alias-name

(Junos Fusion only) (Optional) Rollback the satellite software package onto the specified satellite device using the satellite devices FPC slot identifier.
lcc number

(TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix router, attempt to roll back to the previous set of packages on a T640 router connected to the TX Matrix router. On a TX Matrix Plus router, attempt to roll back to the previous set of packages on a connected router connected to the TX Matrix Plus router.

Replace number with the following values depending on the LCC configuration:

  • 0 through 3, when T640 routers are connected to a TX Matrix router in a routing matrix.

  • 0 through 3, when T1600 routers are connected to a TX Matrix Plus router in a routing matrix.

  • 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with 3D SIBs in a routing matrix.

  • 0, 2, 4, or 6, when T4000 routers are connected to a TX Matrix Plus router with 3D SIBs in a routing matrix.
local

(EX4200 switches and MX Series routers only) (Optional) Attempt to roll back to the previous set of packages on the local Virtual Chassis member.
member member-id

(EX4200 switches and MX Series routers only) (Optional) Attempt to roll back to the previous set of packages on the specified member of the Virtual Chassis configuration. For EX4200 switches, replace member-id with a value from 0 through 9. For an MX Series Virtual Chassis, replace member-id with a value of 0 or 1.
node-id (SRX Series Firewalls only) Identification number of the chassis cluster node. It can be 0 or 1.
none

For all versions of Junos OS up to and including Junos OS 11.4, revert to the set of software as of the last successful request system software add. As of Junos OS 12.1 and later, revert to the last known good state before the most recent request system software (add | delete) command.
reboot

(Optional) For Junos OS 12.3 and later, the system reboots automatically to complete the rollback. However, for Junos OS Evolved, you must explicitly specify the reboot option to complete the rollback.
satellite slot-id

(Junos Fusion only) (Optional) Roll back the satellite software package onto the specified satellite device using the satellite devices FPC slot identifier.
scc

(TX Matrix routers only) (Optional) Attempt to roll back to the previous set of packages on the TX Matrix router (or switch-card chassis).
sfc number

(TX Matrix Plus routers only) (Optional) Attempt to roll back to the previous set of packages on the TX Matrix Plus router. Replace number with 0.
upgrade-group [ all |upgrade-group-name]

(Junos Fusion only) Roll back the satellite software image associated with the specified satellite software upgrade group, or for all satellite software upgrade groups in the Junos Fusion when all is entered.

Required Privilege Level

maintenance

Output Fields

When you enter this command, you are provided feedback on the status of your request.

Sample Output

request system software rollback

Release Information

Command introduced before Junos OS Release 7.4.

sfc option introduced in Junos OS Release 9.6 for the TX Matrix Plus router.

Command behavior changed in Junos OS Release 12.1.

reboot option introduced in Junos OS Release 12.3.

device-alias, satellite, and upgrade-group options introduced in Junos OS Release 14.2R3 for Junos Fusion.

force option deprecated in Junos OS Release 15.1 for Junos OS with Upgraded FreeBSD.

To find which platforms in which releases use Junos OS with upgraded FreeBSD, see Feature Explorer, enter freebsd, and select Junos kernel upgrade to FreeBSD 10+.

Related Documentation