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