Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

TechLibrary
Navigation

request system software delete

Syntax

request system software delete software-package <force><reboot><set [package-name package-name]>

Syntax (TX Matrix Router)

request system software delete software-package <force><lcc number | scc><reboot><set [package-name package-name]>

Syntax (TX Matrix Plus Router)

request system software delete software-package <force><lcc number | sfc number><reboot><set [package-name package-name]>

Release Information

Command introduced before Junos OS Release 7.4.

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

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

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

Option set [package-name package-name] added in Junos OS Release 12.2 for M Series, MX Series, T Series routers, and Branch SRX Services Gateways.

Option reboot introduced in Junos OS Release 12.3.

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

software-package
—

Software package or bundle name. 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) On a TX Matrix router, remove an extension or upgrade package from a specific T640 router (line-card chassis) that is connected to the TX Matrix router. On a TX Matrix Plus router, remove an extension or upgrade package from a specific router 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.
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, T Series routers, and Branch SRX Series Services Gateways 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.

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

 

Related Documentation

 

List of Sample Output

request system software delete jdocs

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 
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> request system software delete jdocs 
Removing package 'jdocs' ...
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]

...

Published: 2013-08-15

Previous Page Next Page