# 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.14 and earlier, this command is `nv show system time`.

### Version History

Introduced in Cumulus Linux 5.15.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 docker

Shows Docker information on the switch.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv show system docker
           operational  applied
    -----  -----------  -------
    vrf    mgmt         mgmt
    state  enabled      enabled

    Docker Containers
    ====================
        Container Name      Image                            Container ID  Status               Ports  Summary
        ------------------  -------------------------------  ------------  -------------------  -----  -------
        repo                cumulus-linux-apt-mirror:5.15.0  a941e1e51c3e  Up 6 days (healthy)
        what-just-happened  docker-wjh:latest                f834edf7fd3c  Up 7 days

## nv show system docker image

Shows Docker images present on the switch.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv show system docker image
    Image Id      Image Name                Tag     Size    Date                           Summary
    ------------  ------------------------  ------  ------  -----------------------------  -------
    283e2bf92e80  docker-wjh                latest  716MB   2025-10-29 21:47:09 -0400 EDT
    d839322a5483  cumulus-linux-apt-mirror  5.15.0  3.47GB  2025-10-30 02:35:30 -0400 EDT

## nv show system docker container

Shows all containers and their status, including stopped containers.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv show system docker container
    Container Name      Image                            Container ID  Status               Ports  Summary
    ------------------  -------------------------------  ------------  -------------------  -----  -------
    repo                cumulus-linux-apt-mirror:5.15.0  a941e1e51c3e  Up 6 days (healthy)
    what-just-happened  docker-wjh:latest                f834edf7fd3c  Up 7 days

## nv show system docker container stats

Shows all container statistics.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv show system docker container stats
    Container Name      CPU%   MEM USAGE  MEM LIMIT  MEM%   NET I/O  BLOCK I/O       PIDS
    ------------------  -----  ---------  ---------  -----  -------  --------------  ----
    repo                0.00%  8.102MiB   15.02GiB   0.05%  0B / 0B  160kB / 41kB    9
    what-just-happened  0.05%  81.96MiB   15.02GiB   0.53%  0B / 0B  496kB / 16.4kB  9

## nv show system docker engine

Shows Docker engine configuration.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv show system docker engine
                    operational
    --------------  -----------------------------------------------------------------------------------------------
    client
      name          Docker Engine - Community
      version       28.5.1
      context       default
    server
      containers    2
      running       2
      paused        0
      stopped       0
    plugins
      volume        ['local']
      network       ['bridge', 'host', 'ipvlan', 'macvlan', 'null', 'overlay']
      log           ['awslogs', 'fluentd', 'gcplogs', 'gelf', 'journald', 'json-file', 'local', 'splunk', 'syslog']
    images          2
    server-version  28.5.1
    id              ae4be5b9-6806-435d-80cb-5e4548a9c11a
    init-binary     docker-init
    data-root       /docker
    debug-mode      False
    log-level       json-file

## 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 health history

Shows system health history. Press q to exit the history.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv show system health history
    [2025-11-01T15:45:49.265284] INFO: Fan1 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.291928] INFO: Fan2 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.293223] INFO: Fan3 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.294401] INFO: Fan4 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.295561] INFO: Fan5 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.297519] INFO: Fan6 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.298587] INFO: PSU1Fan1 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.302107] INFO: PSU2Fan1 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.303410] INFO: Temp1 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.304783] INFO: Temp2 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.306142] INFO: Temp3 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.307599] INFO: Temp4 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.308990] INFO: Temp5 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.310387] INFO: PSU1Temp1 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.311783] INFO: PSU2Temp1 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.313159] INFO: PSU1 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.314894] INFO: PSU2 initialized to OK: Value: N/A
    [2025-11-01T15:45:49.616534] INFO: ThermalAlarm initialized to OK
    [2025-11-01T15:45:49.629542] INFO: CpuStatus initialized to OK
    [2025-11-01T15:45:49.636946] INFO: MemoryStatus initialized to OK: Memory usage: 49%
    ...

## nv show system health history files

Shows a list of the health history report files on the switch and their location.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv show system health history files
    Health history file report  File path                  Summary
    --------------------------  -------------------------  -------
    health_history              /var/log/health_history
    health_history.1            /var/log/health_history.1
    health_history.2            /var/log/health_history.2
    health_history.3            /var/log/health_history.3

## nv show system health history files <file-name>

Shows the health history report in the specified file.

### Command Syntax

Syntax | Description
--- | ---
`<file-name>` | The name of the health report file you want to see.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv show system health history files health_history
    [2025-11-01T15:45:49.648197] INFO: ASIC initial state is Not OK: ASIC state: Not OK
    [2025-11-01T16:44:51.539021] ERROR: MemoryStatus changed from OK to BAD: Memory usage: 91%
    [2025-11-01T16:45:21.830564] Cleared: MemoryStatus changed from BAD to OK: Memory usage: 90%
    [2025-11-01T16:47:02.825350] ERROR: MemoryStatus changed from OK to BAD: Memory usage: 91%
    [2025-11-01T16:52:05.538832] Cleared: MemoryStatus changed from BAD to OK: Memory usage: 84%
    [2025-11-03T15:05:02.640429] ERROR: MemoryStatus changed from OK to BAD: Memory usage: 92%

## 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 serial-console

Shows serial console configuration.

### Version History

Introduced in Cumulus Linux 5.15.0

### Example

    cumulus@switch:~$ nv show system serial-console
                        operational  applied
    ------------------  -----------  --------
    sysrq-capabilities  disabled     disabled

## 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