Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

request system software delete (Junos OS)

Syntax

Syntax (TX Matrix Router)

Description

Use this command to remove a software package or bundle from the device.

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 device.

Options

software-package

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

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).

reboot

As 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

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:

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.

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.

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