Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

request system software delete

 

List of Syntax

Syntax

Syntax (TX Matrix Router)

Syntax (Junos OS Evolved )

Syntax

Syntax (TX Matrix 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.

set [package-name package-name] option added in Junos OS Release 12.2 for M Series, MX Series, and T Series routers.

reboot option introduced in Junos OS Release 12.3.

Command introduced in Junos OS Release 14.1X53-D20 for the OCX Series.

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

Description

Remove a software package or bundle from the router or switch.

Caution

Before removing a software package or bundle, make sure that you have already placed the new software package or bundle that you intend to load onto the router or switch.

Options

package-name(Only for Junos OS Evolved) Name of the Junos OS Evolved package running on the device. You can see this package name by using the request system software list command. Type the package-name explicitly and do not use the tab key to auto-complete the command.
software-package(Not available on Junos OS Evolved) Software package or bundle name. You can see this software package name by using the show system software command. Type the software package name explicitly and do not use the tab key to auto-complete the command.

You can delete any or all of the following software bundles or packages:

  • jbase—(Optional) Junos base software suite

  • jcrypto—(Optional, in domestic version only) Junos security software

  • jdocs—(Optional) Junos online documentation file

  • jkernel—(Optional) Junos kernel software suite

  • jpfe—(Optional) Junos Packet Forwarding Engine support

  • jroute—(Optional) Junos routing software suite

  • junos—(Optional) Junos base software

Note

On EX Series switches, some of the package names are different than those listed. To see the list of packages that you can delete on an EX Series switch, enter the command show system software.

force(Optional) Ignore warnings and force removal of the software.
lcc number(TX Matrix routers and TX Matrix Plus routers only) (Optional) In a routing matrix, delete a software package or bundle on a T640 router indicated by lcc number that is connected to the TX Matrix router. In a routing matrix, delete a software package or bundle on a router indicated by lcc number that is 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.

re0 | re1(Optional) On routers or switches that support dual or redundant Routing Engines, delete a software package or bundle on the Routing Engine in slot 0 (re0) or the Routing Engine in slot 1 (re1).
rebootAs of Junos OS 12.3 and greater, automatically reboot upon completing the request system software delete command.
scc(TX Matrix routers only) (Optional) Remove an extension or upgrade package from the TX Matrix router (or switch-card chassis).
set [package-name package-name](M Series, MX Series, and T Series routers only) (Optional) Install multiple software packages or software add-on packages at the same time.
sfc number(TX Matrix Plus routers only) (Optional) Remove an extension or upgrade package from the TX Matrix Plus router. Replace number with 0.
upgrade-group [ all |upgrade-group-name](Junos Fusion only) Delete the satellite software image association with the specified satellite software upgrade group.

A satellite software upgrade group is a group of satellite devices in the same Junos Fusion that are designated to upgrade to the same satellite software version using the same satellite software package.

version version-string(Junos Fusion only) (Optional) Delete a satellite software package association with a satellite software upgrade group by selecting the satellite software package’s version.

Additional Information

Before upgrading the software on the router or switch, when you have a known stable system, issue the request system snapshot command to back up the software, including the configuration, to the /altroot and /altconfig file systems (on routers) or the /, /altroot, /config, /var, and /var/tmp file systems (on switches). After you have upgraded the software on the router or switch and are satisfied that the new packages are successfully installed and running, issue the request system snapshot command again to back up the new software to the /altroot and /altconfig file systems (on routers) or the /, /altroot, /config, /var, and /var/tmp file systems (on switches). After you run the request system snapshot command, you cannot return to the previous version of the software, because the running and backup copies of the software are identical.

Required Privilege Level

maintenance

List of Sample Output

request system software delete jdocs

request system software delete (Junos OS Evolved)

Output Fields

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

Sample Output

request system software delete jdocs

The following example displays the system software packages before and after the jdocs package is deleted through the request system software delete command:

user@host> show system software
user@host> show system software

request system software delete (Junos OS Evolved)

user@host> request system software delete junos-evo-install-qfx-fixed-x86-64-18.3I20180911102422