System
nv show maintenance
Show the current maintenance state of the switch.
Cumulus Linux 5.12 and earlier does not provide this command; run the nv show system maintenance command instead.
Version History
Introduced in Cumulus Linux 5.13.0
Example
cumulus@switch:~$ nv show maintenance
Maintenance Info
==============
Unit State
----------------------- ---------------
all-protocols maintenance
all-interfaces maintenance
nv show maintenance unit all-protocols
Shows the current maintenance state of the protocols.
Cumulus Linux 5.12 and earlier does not provide this command; run the nv show system maintenance unit all-protocols command instead.
Version History
Introduced in Cumulus Linux 5.13.0
Example
cumulus@switch:~$ nv show maintenance unit all-protocols
operational applied
---------- ----------- -----------
state maintenance maintenance
interfaces
protocols all
nv show system
Shows information about the switch, such as the hostname, version information, the switch uptime, time zone, memory, and health status.
Version History
Introduced in Cumulus Linux 5.2.0
Example
cumulus@switch:~$ nv show system
uptime 1 day, 1:52:24
hostname leaf01
product-name Cumulus Linux
platform N/A
system-memory 1.31 GB used / 363.36 MB free / 1.67 GB total
swap-memory 0 Bytes used / 0 Bytes free / 0 Bytes total
health-status Not OK
date-time 2025-04-18 12:48:46
status N/A
timezone Etc/UTC
version
onie N/A
kernel 6.1.0-cl-1-amd64
base-os Debian GNU/Linux 12.10
Cumulus Linux 5.12 and earlier also shows build and product-release fields. NVUE removed these fields in Cumulus Linux 5.13.
nv show system cli
Shows the current CLI settings. CLI settings include timeout and pager configuration.
Version History
Introduced in Cumulus Linux 5.9.0
Example
cumulus@switch:~$ nv show system cli
applied
---------------- -------
inactive-timeout 300
pagination
state enabled
pager more
nv show system cli pagination
Shows if the pager is enabled and the configured pager settings (more, less, or vim.)
Version History
Introduced in Cumulus Linux 5.9.0
Example
cumulus@switch:~$ nv show system cli pagination
applied
----- -------
state enabled
pager more
nv show system counter
Shows the polling interval for the switch counters for both the logical and physical interfaces.
Version History
Introduced in Cumulus Linux 5.3.0
Example
cumulus@switch:~$ nv show system counter
applied
-------------------- -------
polling-interval
logical-interface 0:00:05
physical-interface 0:00:02
nv show system counter rates
Shows the load interval for the switch counters for both the logical and physical interfaces.
Version History
Introduced in Cumulus Linux 5.12.0
Example
cumulus@switch:~$ nv show system counter rates
applied
------------- -------
load-interval 6
nv show system counter polling-interval
Shows the polling interval for the switch counters for both the logical and physical interfaces.
Version History
Introduced in Cumulus Linux 5.3.0
Example
cumulus@switch:~$ nv show system counter polling-interval
applied
------------------ -------
logical-interface 0:00:05
physical-interface 0:00:02
nv show system cpu
Shows information about the switch CPU, such as the core-count, the model, and the utilization percentage.
Version History
Introduced in Cumulus Linux 5.3.0
Example
cumulus@switch:~$ nv show system cpu
operational applied
----------- ----------------------------- -------
core-count 1
model QEMU Virtual CPU version 2.5+
utilization 100.0%
nv show system date-time
Shows the current date and time on the switch software clock.
In Cumulus Linux 5.7, 5.8, and 5.9, this command is nv show system time.
Version History
Introduced in Cumulus Linux 5.10.0
Example
cumulus@switch:~$ nv show system date-time
operational
------------------------- -----------------------------
local-time Wed 2023-11-22 11:22:54 EST
universal-time Wed 2023-11-22 16:22:54 UTC
rtc-time Wed 2023-11-22 16:22:54
time-zone America/New_York (EST, -0500)
system-clock-synchronized no
ntp-service inactive
rtc-in-local-tz no
unix-time 1700670174.4371066
nv show system disk usage
Shows disk utilization.
Version History
Introduced in Cumulus Linux 5.12.0
Example
cumulus@switch:~$ nv show system disk usage
Mount Point Filesystem Size Used Avail Use%
----------- ---------- ---- ---- ----- ----
/ /dev/vda5 5.4G 2.5G 2.7G 49%
/dev udev 847M 0 847M 0%
/dev/shm tmpfs 856M 31M 825M 4%
/run tmpfs 172M 1.4M 170M 1%
/run/lock tmpfs 5.0M 0 5.0M 0%
/tmp tmpfs 856M 8.0K 856M 1%
nv show system forwarding profile-option
Shows forwarding profile information.
Version History
Introduced in Cumulus Linux 5.3.0
Example
cumulus@switch:~$ nv show system forwarding profile-option
nv show system global
Shows global system configuration, such as the anycast ID, anycast MAC address, fabric ID, fabric MAC address, system MAC address, routing table, VLAN, and VNI information.
Version History
Introduced in Cumulus Linux 5.3.0
Example
cumulus@switch:~$ nv show system global
operational applied
--------------- ----------------- -----------------
anycast-id none none
anycast-mac 44:38:39:BE:EF:AA 44:38:39:BE:EF:AA
fabric-id 1 1
fabric-mac none none
system-mac 44:38:39:22:01:7a 44:38:39:22:01:7a
l3svd
enable off off
reserved
routing-table
pbr
begin 10000 10000
end 4294966272 4294966272
vlan
internal
range 3725-3999 3725-3999
l3-vni-vlan
begin 4000 4000
end 4064 4064
nv show system global reserved
Shows global reserved configuration information, such as the VLAN internal range.
Version History
Introduced in Cumulus Linux 5.3.0
Example
cumulus@switch:~$ nv show system global reserved
operational applied
------------- ----------- ----------
routing-table
pbr
begin 10000 10000
end 4294966272 4294966272
vlan
internal
range 3725-3999 3725-3999
l3-vni-vlan
begin 4000 4000
end 4064 4064
nv show system global reserved routing-table
Shows global reserved routing table information.
Version History
Introduced in Cumulus Linux 5.3.0
Example
cumulus@switch:~$ nv show system global reserved routing-table
operational applied
------- ----------- ----------
pbr
begin 10000 10000
end 4294966272 4294966272
nv show system global reserved vlan
Shows the reserved VLAN configuration settings.
Version History
Introduced in Cumulus Linux 5.3.0
Example
cumulus@switch:~$ nv show system global reserved vlan
operational applied
----------- ----------- ---------
internal
range 3725-3999 3725-3999
l3-vni-vlan
begin 4000 4000
end 4064 4064
nv show system global reserved vlan internal
Shows the reserved internal VLAN configuration settings.
Version History
Introduced in Cumulus Linux 5.3.0
Example
cumulus@switch:~$ nv show system global reserved vlan internal
operational applied
----- ----------- ---------
range 3725-3999 3725-3999
nv show system global reserved vlan l3-vni-vlan
Shows the reserved VLAN layer 3 VNI to VLAN mapping settings.
Version History
Introduced in Cumulus Linux 5.3.0
Example
cumulus@switch:~$ nv show system global reserved vlan l3-vni-vlan
operational applied
----- ----------- -------
begin 4000 4000
end 4064 4064
nv show system global
Shows if the svi-force-up option is set to on for all SVIs on the switch.
The first time you configure a switch, all southbound bridge ports are down; therefore, by default, all SVIs are also down. You can force all SVIs to always be UP with the nv set system global svi-force-up enable on option, which is beneficial if you want to perform connectivity testing.
Version History
Introduced in Cumulus Linux 5.8.0
Example
nv show system global svi-force-up
operational applied
------ ----------- -------
enable on on
nv show system health
Shows system health information.
Version History
Introduced in Cumulus Linux 5.10.0
Example
cumulus@switch:~$ nv show system health
operational applied
---------- ----------- -------
status OK
status-led green
Health issues
================
No Data
In 5.13 and later the nv show system health command output is:
nv show system health
operational applied
---------- ----------- -------
status Not OK
status-led amber
Health issues
================
Component Status information
------------------ -----------------------------------------------------------
ASIC Not OK
forwarding active (running) since Wed 2025-04-23 17:44:13 UTC; 12h ago
hw-management inactive
hw-management-sync inactive
hw-management-tc inactive
mft inactive
process Not OK
nv show system maintenance
Show the current system maintenance mode.
Cumulus Linux 5.12 and earlier provides this command. For Cumulus Linux 5.13 and later use the nv show maintenance command instead.
Version History
Introduced in Cumulus Linux 5.7.0
Example
cumulus@switch:~$ nv show system maintenance
operational
----- -----------
mode disabled
ports enabled
nv show system memory
Shows information about the switch memory, such as the total amount of memory, the amount of free and used memory, and the percent of memory utilized.
Version History
Introduced in Cumulus Linux 5.3.0
Example
cumulus@switch:~$ nv show system memory
Type Buffers Cache Free Total Used Utilization
-------- -------- --------- --------- ------- --------- -----------
Physical 36.32 MB 521.31 MB 236.07 MB 1.69 GB 935.82 MB 86.4%
Swap 0 Bytes 0 Bytes 0 Bytes 0.0%
nv show system message
Shows pre- and post-login messages.
Version History
Introduced in Cumulus Linux 5.2.0
Example
cumulus@switch:~$ nv show system message
nv show system reboot
Shows system reboot information, such as the time when the switch rebooted, the reason for the reboot, and the restart mode (fast, warm, cold).
Version History
Introduced in Cumulus Linux 5.2.0
Example
cumulus@switch:~$ nv show system reboot
operational applied
--------- -------------------------------- -------
reason
gentime 2023-04-26T15:47:34.033663+00:00
reason Unknown
user system/root
mode cold cold
nv show system reboot history
Shows the system reboot history.
Version History
Introduced in Cumulus Linux 5.0.0
Example
cumulus@switch:~$ nv show system reboot history
gentime reason user
-- -------------------------------- ------- -----------
1 2023-04-26T15:47:34.033663+00:00 Unknown system/root
2 2023-04-26T15:38:12.317900+00:00 Unknown system/root
3 2023-04-26T15:38:09.769047+00:00 Unknown system/root
4 2023-04-26T15:38:02.208193+00:00 Unknown system/root
5 2023-04-25T01:30:36.145781+00:00 Unknown system/root
6 2023-04-25T01:30:32.430332+00:00 Unknown system/root
7 2023-04-25T01:30:22.843263+00:00 Unknown system/root
8 2023-04-25T01:26:10.124076+00:00 Unknown system/root
9 2023-04-25T01:26:06.517457+00:00 Unknown system/root
10 2023-04-25T01:25:53.811710+00:00 Unknown system/root
nv show system reboot reason
Shows the reason why the switch rebooted.
Version History
Introduced in Cumulus Linux 5.0.0
Example
cumulus@switch:~$ nv show system reboot reason
operational applied
------- -------------------------------- -------
gentime 2023-04-26T15:47:34.033663+00:00
reason Unknown
user system/root
nv show system reboot required
Shows if you need to reboot the switch after upgrade.
Version History
Introduced in Cumulus Linux 5.9.0
Example
cumulus@switch:~$ nv show system reboot required
yes
nv show system version
Shows the version information, such as kernel version and the Cumulus Linux release number.
Version History
Introduced in Cumulus Linux 5.10.0
Example
cumulus@switch:~$ nv show system version
operational
---------- ----------------------------
kernel 6.1.0-cl-1-amd64
build-date Mon Jul 29 04:57:52 UTC 2024
image 5.10.0.0021
onie N/A