Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

request system halt

Syntax

Syntax (EX Series Switches)

Syntax (PTX Series)

Syntax (MX Series Router)

Syntax (QFX Series)

Syntax (SRX Series)

Description

Stop the device software.

Note:

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.

Note:

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

none

Stop the router or switch software immediately.

all-members

(Optional) Halt all members of the Virtual Chassis configuration.

at time

(Optional) Time at which to stop the software, specified in one of the following ways:

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

backup-routing-engine

(Optional) Halt the backup Routing Engine. This command halts the backup Routing Engine, regardless from which Routing Engine the command is executed. For example, if you issue the command from the primary Routing Engine, the backup Routing Engine is halted. If you issue the command from the backup Routing Engine, the backup Routing Engine is halted.

both-routing-engines

(Optional) Halt both Routing Engines at the same time.

director-device director-device-id

(QFabric systems only) Halt a specific Director device.

local

(Optional) Halt the local Virtual Chassis member.

in minutes

(Optional) Number of minutes from now to stop the software. This option is an alias for the at +minutes option.

media (compact-flash | disk)

(Optional) Boot medium for the next boot.

media (external | internal)

(EX Series and QFX Series switches and MX Series routers only) (Optional) Halt the boot media:

  • external—Halt the external mass storage device.

  • internal—Halt the internal flash device.

media (compact-flash | disk | usb)

(SRX Series only) (Optional) Boot media for the next boot.

  • compact-flash— Standard boot from a flash device.

  • disk— Boot from a hard disk.

  • usb— Boot from a USB device.

member member-id

(Optional) Halt the specified member of the Virtual Chassis configuration. For an MX Series Virtual Chassis, member-id can only be 0 or 1.

message "text"

(Optional) Message to display to all system users before stopping the software.

other-routing-engine

(Optional) Halt the other Routing Engine from which the command is issued. For example, if you issue the command from the primary Routing Engine, the backup Routing Engine is halted. Similarly, if you issue the command from the backup Routing Engine, the primary Routing Engine is halted.

slice slice

(EX Series and QFX Series switches only) (Optional) Halt a partition on the boot media. This option has the following suboptions:

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

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 halt

request system halt (SRX Series)

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:

request system halt (Immediately)

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.

Release Information

Command introduced before Junos OS Release 7.4.

other-routing-engine option introduced in Junos OS Release 8.0.

director-device option introduced for QFabric systems in Junos OS Release 12.2.

backup-routing-engine option introduced in Junos OS Release 13.1.