Platform


nv show platform

Shows a list of all the software and hardware components on the switch.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show platform
               operational                            applied  pending
-------------  -------------------------------------  -------  -------
software                                                              
  [installed]  acpi                                                   
  [installed]  acpi-support-base                                      
  [installed]  acpid                                                  
  [installed]  adduser                                                
  [installed]  apt                                                    
  [installed]  arping                                                 
  [installed]  arptables                                              
  [installed]  atftp                                                  
  [installed]  atftpd                                                 
  [installed]  audisp-tacplus                                         
  [installed]  auditd                                                 
  [installed]  babeltrace                                             
  [installed]  base-files                                             
  [installed]  base-passwd                                            
  [installed]  bash                                                   
  [installed]  bash-completion                                        
  [installed]  bind9-host                                             
  [installed]  binutils                                               
  [installed]  binutils-common                                        
  [installed]  binutils-x86-64-linux-gnu                              
  [installed]  bridge-utils                                           
  [installed]  bsdmainutils                                           
  [installed]  bsdutils                                               
  [installed]  busybox                                                
  [installed]  bwm-ng                                                 
  [installed]  bzip2
...

nv show platform capabilities

Shows the platform capabilities of the switch.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show platform capabilities
                     operational  applied  pending
-------------------  -----------  -------  -------
single-vxlan-device  on

nv show platform environment

Shows a list of sensors, fans, LEDs, and PSUs on the switch.

Version History

Introduced in Cumulus Linux 5.0.0

In Cumulus Linux 5.6 and later, the command output shows the state of each item.

Example

cumulus@switch:~$ nv show platform environment
[TYPE] Name         State
------------------  -----
[FAN] FAN1          ok   
[FAN] FAN2          ok   
[FAN] FAN3          ok   
[FAN] FAN4          ok   
[FAN] FAN5          ok   
[FAN] FAN6          ok   
[FAN] PSU1FAN1      ok   
[FAN] PSU2FAN1      ok   
[LED] FAN           ok   
[LED] POWER         ok   
[LED] SYSTEM        ok   
[PSU] PSU1          ok   
[PSU] PSU2          ok   
[SENSOR] PSU1TEMP1  ok   
[SENSOR] PSU2TEMP1  ok   
[SENSOR] TEMP1      ok   
[SENSOR] TEMP2      ok   
[SENSOR] TEMP3      ok   
[SENSOR] TEMP4      ok   
[SENSOR] TEMP5      ok   

nv show platform environment fan

Shows information about the fans on the switch, such as the minimum, maximum and current speed, the fan state.

In Cumulus 5.6, the nv show platform environment fan command also shows the fan direction. If the airflow for all fans is not in the same direction (front to back or back to front), cooling is suboptimal for the switch, rack, and even the entire data center.

Version History

Introduced in Cumulus Linux 5.0.0

Example

Cumulus Linux 5.5 and earlier:

cumulus@switch:~$ nv show platform environment fan
Name      Limit variance  Max Speed  Min Speed  Current Speed (RPM)  Fan State
--------  --------------  ---------  ---------  -------------------  ---------
Fan1                      29000      2500       6000                 ok       
Fan2                      29000      2500       6000                 ok       
Fan3                      29000      2500       6000                 ok       
Fan4                      29000      2500       6000                 ok       
Fan5                      29000      2500       6000                 ok       
Fan6                      29000      2500       6000                 ok       
PSU1Fan1                  29000      2500       6000                 ok       
PSU2Fan1                  29000      2500       6000                 ok

Cumulus Linux 5.6 and later (includes the fan direction):

cumulus@switch:~$ nv show platform environment fan
Name      Fan Direction  Limit variance  Max Speed  Min Speed  Current Speed (RPM)  Fan State
--------  -------------  --------------  ---------  ---------  -------------------  ---------
Fan1      F2B            15              29000      2500       6000                 ok       
Fan2      F2B            15              29000      2500       6000                 ok       
Fan3      F2B            15              29000      2500       6000                 ok       
Fan4      F2B            15              29000      2500       6000                 ok       
Fan5      F2B            15              29000      2500       6000                 ok       
Fan6      F2B            15              29000      2500       6000                 ok       
PSU1Fan1  F2B            15              29000      2500       6000                 ok       
PSU2Fan1  F2B            15              29000      2500       6000                 ok    

nv show platform environment fan <fan-id>

Shows information about the specified fan on the switch.

Command Syntax

SyntaxDescription
<fan-id>The physical fan identifier.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show platform environment fan Fan2
           operational  applied  pending
---------  -----------  -------  -------
max-speed  29000                        
min-speed  2500                         
speed      6000                         
state      ok

In Cumulus Linux 5.6 and later, the command output also shows the limit variance.


nv show platform environment led

Shows information about the LEDs on the switch.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show platform environment led
LED Name  LED Color
--------  ---------
Fan       green    
Power     green    
System    green

nv show platform environment led <led-id>

Shows information about the specified LED.

Command Syntax

SyntaxDescription
<led-id>The physical LED identifier.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show platform environment led Fan
       operational  applied
-----  -----------  -------
color  green

nv show platform environment psu

Shows information about the PSUs on the switch.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show platform environment psu
Name  PSU State
----  ---------
PSU1  ok       
PSU2  ok

nv show platform environment psu <psu-id>

Shows information about the specified PSU on the switch.

Command Syntax

SyntaxDescription
<psu-id>The physical PSU identifier.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show platform environment psu PSU1
       operational  applied
-----  -----------  -------
state  ok

nv show platform environment sensor

Shows information about the physical sensors on the switch.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show platform environment sensor
Sensor Name                         Critical Temp  Max Temp  Min Temp  Sensor State  Current Temp (°C)
----------------------------------  -------------  --------  --------  ------------  ----------------
Board Sensor Near Virtual Switch    85.0           80.0      5         ok            25.0                    
Board Sensor at Front Left Corner   85.0           80.0      5         ok            25.0                    
Board Sensor at Front Right Corner  85.0           80.0      5         ok            25.0                    
Board Sensor near CPU               85.0           80.0      5         ok            25.0                    
Board Sensor near Fan               85.0           80.0      5         ok            25.0                    
PSU1 Temp Sensor                    85.0           80.0      5         ok            25.0                    
PSU2 Temp Sensor                    85.0           80.0      5         ok            25.0

nv show platform environment sensor <sensor-id>

Shows information about the specified physical sensor on the switch.

Command Syntax

SyntaxDescription
<sensor-id>The physical sensor identifier.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show platform environment sensor Temp

nv show platform hardware

Shows platform hardware information on the switch, such as the base MAC address, model and manufacturer, memory, Cumulus Linux release, serial number and system MAC address.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show platform hardware
               operational        applied  pending
-------------  -----------------  -------  -------
base-mac       44:38:39:22:01:7A                  
manufacturer   Cumulus                            
memory         1.69 GB                            
model          VX                                 
part-number    5.5.0                              
product-name   VX                                 
serial-number  44:38:39:22:01:7a                  
system-mac     44:38:39:22:01:b1

nv show platform hardware component

Shows the hardware components on the switch.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show platform hardware component
        Model  Serial  State  Type  
------  -----  ------  -----  ------
device  vx                    switch

nv show platform hardware component <component-id>

Shows information about the specified platform component.

Command Syntax

SyntaxDescription
<component-id>The component name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show platform hardware component device
       operational  applied  pending
-----  -----------  -------  -------
model  vx                           
type   switch

nv show platform software

Shows the software installed on the switch.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show platform software
Installed Software
=====================
    Installed software          description                 package                      version                     
    -------------------------…  -------------------------   --------------------------    -----------------------
    acpi                        displays information on     acpi                         1.7-1.1                     
                                ACPI devices                                                                         
    acpi-support-base           scripts for handling base   acpi-support-base            0.142-8                     
                                ACPI events such as the                                                              
                                power button                                                                         
    acpid                       Advanced Configuration and  acpid                        1:2.0.31-1                  
                                Power Interface event                                                                
                                daemon                                                                               
    adduser                     add and remove users and    adduser                      3.118                       
                                groups                                                                               
    apt                         commandline package         apt                          1.8.2.3                     
                                manager                                                                              
    arping                      sends IP and/or ARP pings   arping                       2.19-6                      
                                (to the MAC address)                                                                 
    arptables                   ARP table administration    arptables                    0.0.4+snapshot20181021-4    
    atftp                       advanced TFTP client        atftp                        0.7.git20120829-3.2~deb10u3 
    atftpd                      advanced TFTP server        atftpd                       0.7.git20120829-3.2~deb
...

nv show platform software installed

Shows a list of the installed software packages on the switch.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show platform software installed
Installed software          description                 package                      version                     
-------------------------…  -------------------------…  --------------------------…  ---------------------------…
acpi                        displays information on     acpi                         1.7-1.1                     
                            ACPI devices                                                                         
acpi-support-base           scripts for handling base   acpi-support-base            0.142-8                     
                            ACPI events such as the                                                              
                            power button                                                                         
acpid                       Advanced Configuration and  acpid                        1:2.0.31-1                  
                            Power Interface event                                                                
                            daemon                                                                               
adduser                     add and remove users and    adduser                      3.118                       
                            groups                                                                               
apt                         commandline package         apt                          1.8.2.3                     
                            manager                                                                              
arping                      sends IP and/or ARP pings   arping                       2.19-6  
...

nv show platform software installed <installed-id>

Shows information about the specified installed package, such as the package description and version number.

Command Syntax

SyntaxDescription
<installed-id>The package name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show platform software installed what-just-happened
            operational                                                      applied  pending
-----------  ---------------------------------------------------------------  -------  -------
description  Package containing what-just-happened feature for Cumulus Linux                  
package      what-just-happened                                                               
version      2.3.0-cl5.6.0u3