Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

request system software rollback

 

List of Syntax

Syntax

Syntax (EX Series Switches)

Syntax (TX Matrix Router)

Syntax (TX Matrix Plus Router)

Syntax (MX Series Router)

Syntax (Junos OS Evolved)

Syntax

Syntax (EX Series Switches)

Syntax (TX Matrix Router)

Syntax (TX Matrix Plus Router)

Syntax (MX Series Router)

Syntax (Junos OS Evolved)

Release Information

Command introduced before Junos OS Release 7.4.

Command introduced in Junos OS Release 9.0 for EX Series switches.

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

Command introduced in Junos OS Release 11.1 for the QFX Series.

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.

Note

To determine which platforms run Junos OS with Upgraded FreeBSD, see the table listing the platforms currently running Junos OS with upgraded FreeBSD in Release Information for Junos OS with Upgraded FreeBSD.

validate and no-validate options introduced for Junos OS Evolved Release 18.3R1.

package-name version option introduced for Junos OS Evolved Release 18.3R1.

with-old-snapshot-config option introduced for Junos OS Evolved Release 18.3R1.

Description

This command reverts 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 devices 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.

  • On Junos OS Evolved, the reboot command is required in order to complete the rollback.

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.
no-validate | validate(Only for Junos OS Evolved) Check compatibility with current configuration, yes or no.
noneFor 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.
package-name version(Junos OS Evolved only) Select any installed version for the rollback. The request system software rollback command uses the version instead of the package-name. you can see the available versions by using the show system software list command. If a version is not specified, the system rolls back to the default rollback version (the one with the '<' before it on the show system software list command output). You can specify any previous Junos OS Evolved release as long as it is not the one that is currently running or the rollback version.
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.
validate | no-validate(Junos OS Evolved only).
with-old-snapshot-config(Optional) (Junos OS Evolved only) Rolls back system to the specified version with the old snapshot of the configuration used in that version. Otherwise, the rollback, by default, takes the current configuration.

Required Privilege Level

maintenance

List of Sample Output

request system software rollback

Output Fields

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

Sample Output

request system software rollback

user@host> request system software rollback