request system halt
List of Syntax
SyntaxSyntax (EX Series Switches)
Syntax (PTX Series)
Syntax (TX Matrix Router)
Syntax (TX Matrix Plus Router)
Syntax (MX Series Router)
Syntax (QFX Series)
Syntax
Syntax (EX Series Switches)
Syntax (PTX Series)
Syntax (TX Matrix Router)
Syntax (TX Matrix Plus Router)
Syntax (MX Series Router)
Syntax (QFX Series)
Release Information
Command introduced before Junos OS Release 7.4.
other-routing-engine option introduced in Junos OS Release 8.0.
sfc option introduced for the TX Matrix Plus router in Junos OS Release 9.6.
director-device option introduced for QFabric systems in Junos OS Release 12.2.
backup-routing-engine option introduced in Junos OS Release 13.1.
Description
Stop the router or switch software.
When you issue this command on an individual component—for example, a Node device—in a QFabric system, you will receive a warning that says “Hardware-based members will halt, Virtual Junos Routing Engines will reboot.” If you want to halt only one member of a Node group, issue this command with the member option on the Node device CLI, because you cannot issue this command from the QFabric CLI. Also, issuing this command might cause traffic loss on an individual component.
When you issue this command on a QFX5100 switch, you are not prompted to reboot. You must power cycle the switch to reboot.
For the routers with the Routing Engines RE-S-2x00x6, RE-PTX-2x00x8, and RE-S-2x00x8, this command is deprecated and might be removed completely in a future release.
On these routers, this command is replaced with the request vmhost halt command which provides similar functionality.
Options
now—Stop the software immediately. This is the default.
+minutes—Number of minutes from now to stop the software.
yymmddhhmm—Absolute time at which to stop the software, specified as year, month, day, hour, and minute.
hh:mm—Absolute time on the current day at which to stop the software.
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.
external—Halt the external mass storage device.
internal—Halt the internal flash device.
1—Halt partition 1.
2—Halt partition 2.
alternate—Reboot from the alternate partition.
Additional Information
On the M7i router, the request system halt command does not immediately power down the Packet Forwarding Engine. The power-down process can take as long as 5 minutes.
On a TX Matrix router and TX Matrix Plus router if you issue the request system halt command on the primary Routing Engine, all the primary Routing Engines connected to the routing matrix are halted. If you issue this command on the backup Routing Engine, all the backup Routing Engines connected to the routing matrix are halted.
If you have a router or switch with two Routing Engines and you want to shut the power off to the router or switch or remove a Routing Engine, you must first halt the backup Routing Engine (if it has been upgraded), and then halt the primary Routing Engine. To halt a Routing Engine, issue the request system halt command. You can also halt both Routing Engines at the same time by issuing the request system halt both-routing-engines command.
Required Privilege Level
maintenance
Related Documentation
List of Sample Output
request system haltrequest system halt (In 2 Hours)
request system halt (Immediately)
request system halt (At 1:20 AM)
Output Fields
When you enter this command, you are provided feedback on the status of your request.
Sample Output
request system halt
user@host> request system halt
Halt the system ? [yes,no] (no) yes *** FINAL System shutdown message from root@section2 *** System going down IMMEDIATELY Terminated ... syncing disks... 11 8 done The operating system has halted. Please press any key to reboot.
request system halt (In 2 Hours)
The following example, which assumes that the time is 5 PM (1700), illustrates three different ways to request that the system stop 2 hours from now:
user@host> request system halt at +120
user@host> request system halt in 120
user@host> request system halt at 19:00
request system halt (Immediately)
user@host> request system halt at now
request system halt (At 1:20 AM)
To stop the system at 1:20 AM, enter the following command. Because 1:20 AM is the next day, you must specify the absolute time.
user@host> request system halt at yymmdd120
request system halt at 120 Halt the system at 120? [yes,no] (no) yes