Tip
This is the documentation for the 24.06 version. Looking for the documentation of the latest version? Have a look here.
Rebooting and Shutting Down the Device¶
On rare occasions, such as for upgrades or hardware maintenance, administrators may need to reboot or shut down the device running TNSR.
Reboot¶
The reboot
command, available in config
mode within the TNSR CLI,
initiates an operating system reboot. This is equivalent to using operating
system commands such as reboot
, shutdown -r
, or systemctl reboot
at
a shell prompt.
Warning
Before performing this action, ensure the running configuration has been copied to the startup configuration or any changes to the current running configuration will be lost when TNSR starts back up.
See Saving the Configuration for details.
Warning
This action will cause an outage until the device fully reboots.
The general form of the reboot
command is:
tnsr(config)# reboot (now|<minutes>) [force]
tnsr(config)# reboot cancel
The command has a few available options to control its behavior:
- now:
Prompts for confirmation and then immediately initiates a reboot.
- <minutes>:
Prompts for confirmation and then schedules a reboot for the given number of minutes in the future.
- force:
Modifies either the
now
or<minutes>
format commands to run without confirmation.- cancel:
Cancels a previously scheduled reboot.
Shut Down¶
The TNSR CLI does not have a command to shut down the device, but operating system commands can perform this action when necessary. On hardware which supports powering off, the shutdown process will also power off the device.
Warning
Before performing this action, ensure the running configuration has been copied to the startup configuration or any changes to the current running configuration will be lost when TNSR starts back up.
See Saving the Configuration for details.
Warning
This action will cause an outage until the device is powered back on and finishes booting.
From a shell, the shutdown process can be initiated by standard Linux shutdown
commands which behave equivalently: systemctl poweroff
, poweroff
,
halt
, shutdown now
, and others. These commands must be run using
sudo
or from a root
user shell.
For example, shutting down using the poweroff
command works as follows from
within the TNSR CLI:
tnsr# host shell sudo poweroff
Alternately, on most devices a single short press of the ACPI power button will trigger a shutdown event.