Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

request system software delete (Junos OS)

date_range 02-Aug-24

Syntax

content_copy zoom_out_map
request system software delete  software-package  
<force>
<re0 | re1>
<reboot>
<set [package-name package-name]>

Syntax (Junos Fusion)

content_copy zoom_out_map
request system software delete  
<upgrade-group [all |upgrade-group-name]>
<version version-string>

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.

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

Automatically reboot upon completing the request system software delete command.

set [package-name package-name]

(Optional) Install multiple software packages or software add-on packages at the same time.

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.

Devices that support Junos Fusion must be configured as part of a Junos Fusion deployment before you can use Junos Fusion commands. For platforms that support Junos Fusion, see Understanding Junos Fusion Enterprise Components.

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:

content_copy zoom_out_map
user@host> show system software  
Information for jbase:

Comment:
JUNOS Base OS Software Suite [7.2R1.7]


Information for jcrypto:

Comment:
JUNOS Crypto Software Suite [7.2R1.7]


Information for jdocs:

Comment:
JUNOS Online Documentation [7.2R1.7]


Information for jkernel:

Comment:
JUNOS Kernel Software Suite [7.2R1.7]

...


user@host> show system software  
Information for jbase:

Comment:
JUNOS Base OS Software Suite [7.2R1.7]


Information for jcrypto:

Comment:
JUNOS Crypto Software Suite [7.2R1.7]


Information for jkernel:

Comment:
JUNOS Kernel Software Suite [7.2R1.7]

...

Release Information

Command introduced before Junos OS Release 7.4.

set [package-name package-name] option added in Junos OS Release 12.2.

reboot option introduced in Junos OS Release 12.3.

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

footer-navigation