System
nv show system
Shows information about the switch, such as the hostname, Cumulus Linux version, the switch uptime, and the time zone.
Version History
Introduced in Cumulus Linux 5.2.0
Example
cumulus@switch:~$ nv show system
operational applied
-------- ------------------- -------
hostname leaf01 leaf01
build Cumulus Linux 5.5.0
uptime 3 days, 18:40:31
timezone Etc/UTC
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 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/sda5 5.4G 3.0G 2.2G 58%
/dev udev 2.0G 0 2.0G 0%
/dev/shm tmpfs 2.1G 61M 2.0G 3%
/run tmpfs 411M 38M 374M 10%
/run/lock tmpfs 5.0M 0 5.0M 0%
/tmp tmpfs 2.1G 12K 2.1G 1%
/vagrant vagrant 4.3T 3.1T 1.3T 72%
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
nv show system maintenance
Show the current system maintenance mode.
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