Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Troubleshoot the QFX5250

This topic contains some common troubleshooting resources for the QFX5250 and a list of alarms and how to fix them.

Troubleshooting Resources for QFX5250

Use the front panel LEDs to identify alarm conditions and the Junos OS Evolved CLI to troubleshoot the device. You can also contact the Juniper Networks® Technical Assistance Center (JTAC) for support.

  • LEDs—When the device detects an alarm condition, the alarm LED on an interface glows red or yellow.

  • CLI—The CLI is the primary tool for controlling and troubleshooting hardware, Junos OS Evolved, and network connectivity. CLI command outputs display information about network connectivity, which Junos OS Evolved derives from the ping and traceroute utilities. You can use the CLI to see more information about alarm conditions.

    For information about using the CLI to troubleshoot Junos OS Evolved, see the appropriate Junos OS Evolved configuration guide.

  • JTAC—If you need assistance during troubleshooting, you can contact the Juniper Networks Technical Assistance Center (JTAC) by using the Web or by telephone. If you encounter software problems, or problems with hardware components not discussed in this guide, contact JTAC.

Alarm Types and Alarm Severity

Table 1: Alarm Terms
Term

Definition

Alarm

A signal alerting you to conditions that might prevent normal operation. On a device, the alarm signal is the red system LED that is lit on the front of the chassis.

Alarm condition

A failure event that triggers an alarm.

Alarm severity

The seriousness of the alarm. The level of severity can be either major or minor.

Alarm Types

Table 2: Alarm Types
Term Definition

Chassis alarms

A predefined alarm triggered by a physical condition in the device such as a power supply failure or excessive component temperature.

Interface alarms

An alarm that you configure to alert you when an interface link is down. The alarm applies to Ethernet, Fibre Channel, and management Ethernet interfaces. You can set the alarm as major or minor for a specific link-down condition or have the condition ignored.

System alarms

A predefined alarm that might be triggered by a missing rescue configuration, failure to install a license for a licensed software feature, or high disk usage. You can configure system alarms to appear automatically in the J-Web interface display or CLI display.

Leakage alarms

An alarm that is triggered when there is a coolant leakage in the QFX5250 switch. The LEAKAGE LED will be lit red (on steadily) once the leakage is detected.

Pressure alarms

An alarm that is triggered when the coolant pressure is outside the recommended range for the inlet and outlet UQDB06 ports in QFX5250 switch. For information on the minor and major pressure alarm conditions, see Table 3.

Table 3: Pressure Alarm and Fire Shutdown Specifications
Port Type Minor Alarm Major Alarm Fire Shutdown
  High Low High Low  
Pressure at inlet port (PSI) 42 20 45 15 47
Pressure at outlet port (PSI) 37 15 40 10 42

Alarm Severity

Table 4: Alarm Severity
Term Definition

Major (red)

Indicates a critical situation on the router that has resulted from one of the following conditions and that requires immediate action:

  • One or more hardware components have failed.

  • One or more hardware components have exceeded temperature thresholds.

  • An alarm condition configured on an interface has triggered a critical warning.

Minor (stable yellow)

Indicates a noncritical condition in the router that, if left unchecked, might cause an interruption in service or degradation in performance. A minor alarm condition requires monitoring or maintenance.

For example, a missing rescue configuration generates a minor system alarm.

QFX5250 Alarm Messages

When the QFX5250 switch detects an alarm condition, it lights the red or yellow alarm LED on the management panel as appropriate. To view a more detailed description of the alarm cause, run the show system alarms operational CLI command.

For thermal problems, the show chassis temperature-thresholds CLI command shows the cutoff temperatures for each level of alarm:

To display environmental information about the QFX5250 switch chassis, run the CLI command show chassis environment:

Troubleshoot Chassis and Interface Alarms on the QFX5250 Switch

Table 5 lists the chassis alarm messages on the QFX5250, their severity levels, and the actions you can take to respond to them.

Table 5: Chassis Alarm Messages for QFX5250 Switch

Component

Alarm Type

CLI Message

Recommended Action

Temperature sensors

Major (red)

FPC 0 Temperature Hot

Check environmental conditions and alarms on other devices. Ensure that environmental factors (such as hot air blowing around the equipment) do not affect the temperature sensor. If the condition persists, the device might shut down.

Minor (yellow)

FPC 0 Temperature Warm

Check environmental conditions and alarms on other devices. Ensure that environmental factors (such as hot air blowing around the equipment) do not affect the temperature sensor.

FPC 0 Temp Sensor Fail

Check the system log for an error message. Report the message to customer support.

Routing Engine

Major (red)

RE RE number /var partition is full

File storage is at capacity. Reduce unnecessary files to free space.

Minor (yellow)

RE RE number /var partition is high

File storage is reaching capacity. Reduce unnecessary files to free space.

Management Ethernet interface

Major (red)

Management interface management-interface-name down on node

Check whether a cable is connected to the management Ethernet interface, or whether the cable is defective. Replace the cable, if required.

Coolant leakage detection and reporting (Management Ethernet interface over Redfish)

Red Solid, On Steadily or no indication (applicable only for liquid-cooled model)

curl -sk -u root:0penBmc \
  "https://<BMC_IP>/redfish/v1/Chassis/Chassis_0/ThermalSubsystem/LeakDetection/LeakDetectors/LeakDetector_0"
Check `Status.State` in the response:
- `"Enabled"` — leak detection is active
- `"Disabled"` or `"UnavailableOffline"` — leak detection is suppressed
Check the current state of leak detection alarm

Red Solid, On Steadily or no indication (applicable only for liquid-cooled model)

curl -sk -X PATCH \
  -u root:0penBmc \
  -H "Content-Type: application/json" \
  -d '{"Enabled": true}' \
  "https://<BMC_IP>/redfish/v1/Chassis/Chassis_0/ThermalSubsystem/LeakDetection/LeakDetectors/LeakDetector_0"
Re-enable leak detection alarm

Red Solid, On Steadily or no indication (applicable only for liquid-cooled model)

curl -sk -X PATCH \
  -u root:0penBmc \
  -H "Content-Type: application/json" \
  -d '{"Enabled": false}' \
  "https://<BMC_IP>/redfish/v1/Chassis/Chassis_0/ThermalSubsystem/LeakDetection/LeakDetectors/LeakDetector_0”
Disable leak detection alarm