request system halt

Syntax

Syntax (TX Matrix Router)

Syntax (TX Matrix Plus Router)

Release Information

Command introduced before JUNOS Release 7.4.

other-routing-engine option introduced in JUNOS Release 8.0.

sfc option introduced for the TX Matrix Plus router in JUNOS Release 9.6.

Description

Stop the router software.

Options

none — Stop the router software immediately.

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

all-lcc — (TX Matrix 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 routers (or line-card chassis) connected to the TX Matrix Plus router.

lcc number — (TX Matrix 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 T1600 router that is connected to the TX Matrix Plus router. Replace number with a value from 0 through 3.

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.

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.

both-routing-engines — (Optional) Halt both Routing Engines at the same time.

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.

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 next boot. (The options removable-compact-flash and usb pertain to the J Series routing platform only.)

message "text" — (Optional) Message to display to all system users before stopping the software.

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 or 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. If you issue the request system halt both-routing-engines command on the TX Matrix or TX Matrix Plus router, all the Routing Engines on the routing matrix are halted.

Note: If you have a router with two Routing Engines and you want to shut the power off to the router or remove a Routing Engine, you must first halt the backup Routing Engine (if it has been upgraded), 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

List of Sample Output

Output Fields

When you enter this command, you are provided feedback on the status of your request.

Sample Output

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 at 120
Halt the system at 120? [yes,no] (no) yes