Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

TechLibrary
Navigation

request system halt

Syntax

request system halt<at time> <backup-routing-engine><both-routing-engines><other-routing-engine><in minutes><media (compact-flash | disk | removable-compact-flash | usb)> <message "text">

Syntax (EX Series Switches)

request system halt <all-members><at time> <backup-routing-engine><both-routing-engines><in minutes><local><media (external | internal)><member member-id><message "text"><other-routing-engine><slice slice>

Syntax (PTX Series)

request system halt <at time> <backup-routing-engine><both-routing-engines><other-routing-engine><in minutes><media (compact-flash | disk)> <message "text">

Syntax (TX Matrix Router)

request system halt <all-lcc | lcc number | scc> <at time> <backup-routing-engine><both-routing-engines><other-routing-engine><in minutes><media (compact-flash | disk)> <message "text">

Syntax (TX Matrix Plus Router)

request system halt <all-chassis | all-lcc | lcc number | sfc number> <at time> <backup-routing-engine><both-routing-engines><other-routing-engine><in minutes><media (compact-flash | disk)> <message "text">

Syntax (MX Series Router)

request system halt <all-members><at time> <backup-routing-engine><both-routing-engines><in minutes><local><media (external | internal)><member member-id><message "text"><other-routing-engine>

Syntax (QFX Series)

request system halt<all-members><at time> <director-device director-device-id><in minutes><local><media > <member member-id><message "text"> <slice slice>

Release Information

Command introduced before Junos OS Release 7.4.

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

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

sfc option 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.

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.

Note: When you issue this command on an individual component 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, use the member option from the Node group CLI. You cannot issue this command from the QFabric CLI.

Options

none
—

Stop the router or switch software immediately.

all-chassis
—

(TX Matrix routers and TX Matrix Plus routers only) (Optional) Halt all chassis.

all-lcc
—

(TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix router, halt all T640 routers (or line-card chassis) connected to the TX Matrix router. On a TX Matrix Plus router, halt all T1600 or T4000 routers connected to the TX Matrix Plus router.

all-members
—

(EX4200 switches and MX Series routers only) (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 master 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.

lcc number
—

(TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix router, halt a specific T640 router that is connected to the TX Matrix router. On a TX Matrix Plus router, halt 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.
local
—

(EX4200 switches and MX Series routers only) (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 | removable-compact-flash | usb)
—

(Optional) Boot medium for the next boot. (The options removable-compact-flash and usb pertain to J Series routers only.)

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.
member member-id
—

(EX4200 switches and MX Series routers only) (Optional) Halt the specified member of the Virtual Chassis configuration. For EX4200 switches, replace member-id with a value from 0 through 9. For an MX Series Virtual Chassis, replace member-id with a value of 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 master Routing Engine, the backup Routing Engine is halted. Similarly, if you issue the command from the backup Routing Engine, the master Routing Engine is halted.

scc
—

(TX Matrix routers only) (Optional) Halt the TX Matrix router (or switch-card chassis).

sfc number
—

(TX Matrix Plus routers only) (Optional) Halt the TX Matrix Plus router (or switch-fabric chassis). Replace number with 0.

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.

On a TX Matrix router and TX Matrix Plus router if you issue the request system halt command on the master Routing Engine, all the master 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.

Note: 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 master 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 halt
request 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 +120user@host> request system halt in 120user@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

Published: 2013-08-15

Previous Page Next Page