Environment commands

environment fan-speed

The environment fan-speed command determines the method of controlling the speed of the switch fans. The switch automatically controls the fan speed by default.

The switch normally controls the fan speed to maintain optimal operating temperatures. The fans can be configured to operate at a constant speed regardless of the switch temperature conditions.

The no environment fan-speed and default environment fan-speed commands restore the default action of automatic fan-speed control by removing the environment fan-speed override statement from running-config.

Note:

Overriding the system fan speed is unsupported and should only be done under the direction of an Arista Networks engineer. You can risk damaging hardware by setting the fan speed too low. Doing so without direction from Arista Networks can be grounds for voiding your warranty.

command Mode

Global Configuration

command Syntax

environment fan-speed ACTION

no environment fan-speed

default environment fan-speed

Parameters

  • ACTION Fan speed control method. Valid settings include:
    • auto Fan speed is controlled by the switch.
    This option restores the default setting by removing the environment fan-speed override command from running-config.
    • override percent Fan speed is set to the specified percentage of the maximum. Valid percent settings range from 30 to 100.

Examples:

  • This command overrides the automatic fan speed control and configures the fans to operate at 50% of maximum speed.
    switch(config)#environment fan-speed override 50
    ====================================================================
    WARNING: Overriding the system fan speed is unsupported and should only
    be done under the direction of an Arista Networks engineer.
    You can risk damaging hardware by setting the fan speed too low
    and doing so without direction from Arista Networks can be grounds
    for voiding your warranty.
    To set the fan speed back to automatic mode, use the
    'environment fan-speed auto' command
    ====================================================================
    switch(config)#
    
  • This command restores control of the fan speed to the switch.
    switch(config)#environment fan-speed auto
    switch(config)#

environment insufficient-fans action

The environment insufficient-fans command controls the switch response to the insufficient fan condition. By default, the switch initiates a shutdown procedure when it senses insufficient fans.

The switch operates normally when one fan is not operating. Non-functioning modules should not be removed from the switch unless they are immediately replaced; adequate switch cooling requires the installation of all components, including a non-functional fan.

Two non-operational fans trigger an insufficient fan shutdown condition. This condition normally initiates a power down procedure.

The no environment insufficient-fans and default environment insufficient-fans commands restore the default shutdown response to the insufficient-fans condition by removing the environment insufficient-fans action ignore statement from running-config.

Note:

Overriding the system shutdown behavior when the system has insufficient fans inserted is unsupported and should only be done under the direction of an Arista Networks engineer. You risk damaging hardware by not shutting down the system in this situation, and doing so without direction from Arista Networks can be grounds for voiding your warranty.

command Mode

Global Configuration

command Syntax

environment insufficient-fans action REMEDY

no environment insufficient-fans action

default environment insufficient-fans action

Parameters

  • REMEDY Configures action when switch senses an insufficient fan condition. Settings include:
    • ignore Switch continues operating when insufficient fans are operating.
    • shutdown Switch shuts power down when insufficient fans are operating.
    • The shutdown parameter restores default behavior by removing the environment insufficient-fans command from running-config.

Examples:

  • This command configures the switch to continue operating after it senses insufficient fan condition.
    switch(config)#environment insufficient-fans action ignore
    ====================================================================
    WARNING: Overriding the system shutdown behavior when the system
    has insufficient fans inserted is unsupported and should only be done under
    the direction of an Arista Networks engineer. You risk damaging
    hardware by not shutting down the system in this situation, and doing
    so without direction from Arista Networks can be grounds for voiding
    your warranty. To re-enable the shutdown-on-overheat behavior, use
    the 'environment insufficient-fans action shutdown' command.
    ====================================================================
  • This command configures the switch to shut down when it senses an insufficient fan condition.
    switch(config)#environment insufficient-fans action shutdown
    switch(config)#

environment overheat action

The environment overheat command controls the switch response to an overheat condition. By default, the switch shuts down when it senses an overheat condition.

Note:

Overriding the system shutdown behavior when the system is overheating is unsupported and should only be done under the direction of an Arista Networks engineer. You risk damaging hardware by not shutting down the system in this situation, and doing so without direction from Arista Networks can be grounds for voiding your warranty.

Arista switches include internal temperature sensors. The number and location of the sensors vary with each switch model. Each sensor is assigned temperature thresholds that denote alert and critical conditions. Temperatures that exceed the threshold trigger the following:

  • Alert Threshold: All fans run at maximum speed and a warning message is logged.
  • Critical Threshold: The component is shut down immediately and its Status LED flashes orange.

In modular systems, cards are shut down when their temperatures exceed the critical threshold. The switch normally shuts down if the temperature remains above the critical threshold for three minutes.

The no environment overheat action and default environment overheat action commands restore the default shutdown response to the environment overheat condition by removing the environment overheat action ignore statement from running-config.

command Mode

Global Configuration

command Syntax

environment overheat action REMEDY

no environment overheat action

default environment overheat action

Parameters

  • REMEDY Reaction to an overheat condition. Default value is shutdown.
    • shutdown Switch shuts power down by an overheat condition.
    • ignore Switch continues operating during an overheat condition.

Examples:

  • This command configures the switch to continue operating after it senses an overheat condition.
    switch(config)#environment overheat action ignore
    ====================================================================
    WARNING: Overriding the system shutdown behavior when the system
    is overheating is unsupported and should only be done under
    the direction of an Arista Networks engineer. You risk damaging
    hardware by not shutting down the system in this situation, and doing
    so without direction from Arista Networks can be grounds for voiding
    your warranty. To re-enable the shutdown-on-overheat behavior, use
    the 'environment overheat action shutdown' command.
    ====================================================================
    switch(config)#
  • This command configures the switch to shut down when it senses an overheat condition.
    switch(config)#environment overheat action shutdown
    switch(config)#

locator-led

When a component requires service, the locator-led command activates a locator to assist a technician in finding the component. The command causes the status LED on the specified component to flash, and also displays a “service requested” message on the LCD panel of modular switches or lights the blue locator light on the front of fixed switches. The available locators vary by platform; to see a list of the locator LEDs available on the switch, use the locator-led ? command. To disable the locator LED, use the no locator-led command.

command Mode

Privileged EXEC

command Syntax

locator-led {fantray tray_num | interface interface | module module_num | powersupply supply_num}

no locator-led {fantray tray_num | interface interface | module module_num | powersupply supply_num}

Parameters

  • fantray tray_num Activates locator on specified fan tray.
  • interface interface Activates locator on specified interface.
  • module module_num Activates locator on specified module.
  • powersupply supply_num Activates locator on specified power supply.

Examples:

  • This command enables the locator LED on fan tray 3.
    switch#locator-led fantray 3
    Enabling locator led for FanTray3
    switch#
  • This command disables the locator LED on fan tray 3.
    switch#no locator-led fantray 3
    Disabling locator led for FanTray3
    switch#
  • This command displays the locator LEDs available on the switch.
    switch#locator-led ?
    fantrayFan tray LED
    interfaceinterface LED
    module Module LED
    powersupplyPower supply LED
    switch#

show environment power

The show environment power command displays the status of all power supplies in the switch.

command Mode

EXEC

command Syntax

show environment power [ INFO_LEVEL ]

Parameters

  • INFO_LEVEL Specifies level of detail that the command displays. Options include:
    • <no parameter> Displays current and power levels for each supply.
    • detail Also includes status codes that can report error conditions.

Example:

This command displays the status of power supplies on the switch.
switch>show environment power
PowerInputOutput Output
SupplyModelCapacityCurrentCurrentPowerStatus
------- ---------- --------- -------- -------- -------- -------
1 PWR-760AC760W 0.81A11.00A 132.8W Ok
2 PWR-760AC760W 0.00A0.00A0.0W ACLoss
switch>

show environment temperature

The show environment temperature command displays the operating temperature of all sensors on the switch.

command Mode

EXEC

command Syntax

show environment temperature [MODULE_NAME] [INFO_LEVEL]

Parameters

  • MODULE_NAME Specifies modules for which data is displayed. This parameter is only available on modular switches. Options include:
    • <no parameter> All modules (identical to all option).
    • fabric fab_num Specified fabric module. Number range varies with switch model.
    • linecard line_num line card module. Number range varies with switch model.
    • supervisor super_num Supervisor module. Number range varies with switch model.
    • mod_num Supervisor (1 to 2) or line card (3 to 18) module.
    • all All modules.
  • INFO_LEVEL Specifies level of detail that the command displays. Options include:

    • <no parameter> Displays table that lists the temperature and thresholds of each sensor.
    • detail Displays data block for each sensor listing the current temperature and historic data.
Display Values
  • System temperature status is the first line that the command displays. Values report the following:
    • Ok All sensors report temperatures below the alert threshold.
    • Overheating At least one sensor reports a temperature above its alert threshold.
    • Critical At least one sensor reports a temperature above its critical threshold.
    • Unknown The switch is initializing.
    • Sensor Failed At least one sensor is not functioning.

Examples:

  • This command displays a table that lists the temperature measured by each sensor.
    switch>show environment temperature
    System temperature status is: Ok
    AlertCritical
    SensorDescriptionTemperatureThresholdThreshold
    ------- ------------------------ ------------ ---------- ----------
    1 Front-panel temp sensor 30.750C 65C75C
    2 Fan controller 1 sensor 32.000C 75C85C
    3 Fan controller 2 sensor 38.000C 75C85C
    4 Switch chip 1 sensor50.000C 105C 115C
    5 VRM 1 temp sensor 60.000C 105C 110C
    switch>
    
  • This command lists the temperature detected by each sensor, and includes the number of previous alerts, the time of the last alert, and the time of the last temperature change.
    switch>show environment temperature detail
    TempSensor1 - Front-panel temp sensor
     Current State CountLast Change
    Temperature30.750C
    Max Temperature35.000C4 days, 23:35:24 ago
    Alert False 0never
    
    TempSensor2 - Fan controller 1 sensor
     Current StateCountLast Change
    Temperature 32.000C
    Max Temperature 36.000C4 days, 23:32:46 ago
    AlertFalse 0never
    
    TempSensor3 - Fan controller 2 sensor
    Current StateCount Last Change
    Temperature38.000C
    Max Temperature41.000C 4 days, 23:37:56 ago
    AlertFalse0never
    
    TempSensor4 - Switch chip 1 sensor
     Current StateCountLast Change
    Temperature51.000C
    Max Temperature53.000C4 days, 23:35:16 ago
    AlertFalse0 never
    
    TempSensor5 - VRM 1 temp sensor
    Current State CountLast Change
    Temperature 60.000C
    Max Temperature 62.000C4 days, 22:54:51 ago
    Alert False 0never
    
    switch>

show locator-led

The show locator-led command displays the status of locator LEDs enabled on the switch.

command Mode

Privileged EXEC

command Syntax

show locator-led

Example:

This command displays all locator LEDs enabled on the switch.
switch#show locator-led
There are no locator LED enabled
switch#

show system environment all

The show system environment all command displays temperature, cooling, and power supply status.

command Mode

EXEC

command Syntax

show system environment all

Example:

This command displays the switch’s temperature, cooling, and power supply status
switch>show system environment all
System temperature status is: Ok
AlertCritical
SensorDescriptionTemperatureThresholdThreshold
------- ------------------------ ------------- ---------- ----------
1 Front-panel temp sensor 31.000C 65C75C
2 Fan controller 1 sensor 32.000C 75C85C
3 Fan controller 2 sensor 38.000C 75C85C
4 Switch chip 1 sensor50.000C 105C 115C
5 VRM 1 temp sensor 60.000C 105C 110C

System cooling status is: Ok
Ambient temperature: 31C
Airflow: port-side-intake
Fan TrayStatus Speed
--------- --------------- ------
1 Ok 52%
2 Ok 52%
3 Ok 52%
4 Ok 52%
5 Ok 52%

Power InputOutput Output
SupplyModel CapacityCurrentCurrentPowerStatus
------- ----------- --------- -------- -------- -------- -------
1 PWR-760AC760W 0.81A11.00A132.6WOk
2 PWR-760AC760W 0.00A 0.00A0.0WAC Loss

switch>

show system environment cooling

The show system environment cooling command displays fan status, air flow direction, and ambient temperature on the switch.

command Mode

EXEC

command Syntax

show system environment cooling [ INFO_LEVEL ]

Parameters

  • INFO_LEVEL Specifies level of detail that the command displays. Options include:
    • <no parameter> Displays the fan status, air flow direction, and ambient switch temperature.
    • detail Also displays actual and configured fan speed of each fan.

    Display Values

  • System cooling status:
    • Ok No more than one fan has failed or is not inserted.
    • Insufficient fans More than one fan has failed or is not inserted. This status is also displayed if fans with different airflow directions are installed. The switch shuts down if the error is not resolved.
    • Ambient temperature Temperature of the surrounding area.
    • Airflow Indicates the direction of the installed fans:
      • port-side-intake All fans flow air from the front (port side) to the rear of the chassis.
      • port-side-exhaust All fans flow air from the rear to the front (port side) of the chassis.
      • incompatible fans Fans with different airflow directions are inserted.
      • Unknown The switch is initializing.
  • Fan Tray Status table Displays the status and operating speed of each fan. Status values indicate the following conditions:
    • OK The fan is operating normally.
    • Failed The fan is not operating normally.
    • Unknown The system is initializing.
    • Not Inserted The system is unable to detect the specified fan.
    • Unsupported The system detects a fan that the current software version does not support.

Example:

This command displays the fan status, air flow direction, and ambient switch temperature.
switch>show system environment cooling
System cooling status is: Ok
Ambient temperature: 30C
Airflow: port-side-intake
Fan TrayStatus Speed
--------- --------------- ------
1 Ok 51%
2 Ok 51%
3 Ok 51%
4 Ok 51%
5 Ok 51%
switch>