System Power and Switch Reboot
Cumulus Linux provides commands to:
Switch Reboot
Cumulus Linux provides these reboot modes:
-
cold restarts the system and resets all the hardware devices on the switch (including the switching ASIC). This is the default restart mode on the switch.
-
fast restarts the system more efficiently with minimal impact to traffic by reloading the kernel and software stack without a hard reset of the hardware. During a fast restart, the system decouples from the network to the extent possible using existing protocol extensions before recovering to the operational mode of the system. The switch restarts the kernel and software stack without touching the forwarding entries or the switching ASIC; therefore, the data plane is not affected as the software stack restarts. Traffic outage is much lower in this mode as there is a momentary interruption after reboot, while the system reinitializes.
-
warm restarts the switch with no interruption to traffic for existing route entries and without a hardware reset of the switch ASIC. While this process does not affect the data plane, the control plane is absent during restart and is unable to process routing updates. Warm reboot mode reduces all the available forwarding table entries on the switch by half to accommodate traffic forwarding during a reboot.
When you restart the switch in warm reboot mode, BGP only performs a graceful restart if the BGP graceful restart option is set to
full
. To set BGP graceful restart to full, run thenv set router bgp graceful-restart mode full
command, then apply the configuration withnv config apply
. For more information about BGP graceful restart, refer to Optional BGP Configuration.In an eBGP multihop configuration with warm reboot mode, you must set the BGP graceful restart timer to 180 seconds or more.
Cumulus Linux supports warm reboot mode with:
- 802.1X, layer 2 forwarding, layer 3 forwarding with BGP, static routing, and VXLAN routing with EVPN. Cumulus Linux does not support warm boot with EVPN MLAG or EVPN multihoming.
- Optimized image (two partition) upgrade and package upgrade (the switch must be in warm reboot mode before you start the upgrade).
NVIDIA recommends you use NVUE commands to configure reboot mode and reboot the system. If you prefer to use csmgrctl
commands, you must stop NVUE from managing the /etc/cumulus/csmgrd.conf
file before you set reboot mode.
-
Run the following NVUE commands:
cumulus@switch:~$ nv set system config apply ignore /etc/cumulus/csmgrd.conf cumulus@switch:~$ nv config apply
-
Edit the
/etc/cumulus/csmgrd.conf
file and set thecsmgrctl_override
option totrue
:cumulus@switch:~$ sudo nano /etc/cumulus/csmgrd.conf csmgrctl_override=true ...
-
Save the configuration:
cumulus@switch:~$ nv config save
The following commands configure the switch to restart in cold mode:
cumulus@switch:~$ nv set system reboot mode cold
cumulus@switch:~$ nv config apply
cumulus@switch:~$ nv action reboot system no-confirm
cumulus@switch:~$ sudo csmgrctl -c
cumulus@switch:~$ sudo reboot
The following command configures the switch to restart in fast mode:
cumulus@switch:~$ nv set system reboot mode fast
cumulus@switch:~$ nv config apply
cumulus@switch:~$ nv action reboot system no-confirm
cumulus@switch:~$ sudo csmgrctl -f
cumulus@switch:~$ sudo reboot
The following command configures the switch to restart in warm mode.
cumulus@switch:~$ nv set system reboot mode warm
cumulus@switch:~$ nv config apply
Reboot the switch:
cumulus@switch:~$ nv action reboot system no-confirm
You must specify no-confirm
at the end of the command.
cumulus@switch:~$ sudo csmgrctl -w
cumulus@switch:~$ sudo reboot
After you change the reboot mode on the switch with NVUE or csmgrctl
commands, you must reboot the switch to activate the mode change.
Show Reboot Mode
You can confirm the current operational reboot mode active on the switch with the nv show system reboot
command. The command also shows reboot information, such as the reboot date and time, and reason:
cumulus@switch:~$ nv show system reboot
operational applied
--------- -------------------------------- -------
reason
reason Unknown
gentime 2025-05-16T16:08:27.798068+00:00
user system/root
mode warm warm
required no
Power Off
In certain situations, you might need to power off the switch instead of rebooting. To power off the switch, run the cl-poweroff
command, which shuts down the switch.
cumulus@switch:~$ sudo cl-poweroff
You can also run the Linux poweroff
command, which gracefully shuts down the switch (the switch LEDs stay on). On certain switches, such as the NVIDIA SN2201, SN2010, SN2100, SN2100B, SN3420, SN3700, SN3700C, SN4410, SN4600C, SN4600, SN4700, SN5400, or SN5600, the switch reboots instead of powering off.
cumulus@switch:~$ sudo poweroff
Power Cycle
NVUE provides the nv action power-cycle system
command so that you can power cycle the switch remotely to recover from certain conditions, such as a thermal ASIC shutdown due to high temperatures.
When you run the nv action power-cycle system
command, the switch prompts you for confirmation before power cycling.
cumulus@switch:~$ nv action power-cycle system
The operation will Power Cycle the switch.
Type [y] to power cycle.
Type [N] to abort.
Do you want to continue? [y/N]
Action executing ...
Action succeeded
To power cycle the switch without prompts for confirmation, run the nv action power-cycle system force
command:
cumulus@switch:~$ nv action power-cycle system force
Action executing ...
Action succeeded