Troubleshoot the QFX5240 Switch

To troubleshoot a QFX5240 problem, you can use:

• Junos Evolved OS CLI

  The CLI is the primary tool for controlling and troubleshooting hardware, Junos OS Evolved, routing protocols, and network connectivity. CLI commands display information from routing tables, information specific to routing protocols, and information about network connectivity derived from the ping and traceroute utilities. For information about using the CLI to troubleshoot Junos OS Evolved, see the appropriate Junos OS Evolved configuration guide.

• Alarms and LEDs on the network ports, management panel, and components

  When the Routing Engine detects an alarm condition, it lights the red or yellow alarm LED on the management panel as appropriate. In addition, you can also use component LEDs and network port LEDs to troubleshoot the QFX5240 switch. For more information, see QFX5240 Management Panel.

• 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 here, contact JTAC.

• Knowledge Base articles–Knowledge Base.

When a QFX5240 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, issue 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:

You can also calculate the percentage of fan RPM, or duty cycle. Use the following command as root:

In this example, the system returned the hexadecimal value 0x07. If you convert that value to decimal, you get 7. Then use this formula to calculate the duty cycle:

In this example, duty cycle = (7 +1)*6.25 = 50%

Chassis alarms indicate a failure on the device or one of its components. Chassis alarms are preset and cannot be modified.

Chassis alarms on QFX5240 switches have two severity levels:

• Major (red)—Indicates a critical situation on the device that has resulted from one of the conditions described in Table 1. A red alarm condition requires immediate action.

• Minor (yellow)—Indicates a noncritical condition on the device that, if left unchecked, might cause an interruption in service or degradation in performance. A yellow alarm condition requires monitoring or maintenance.

Table 1 describes the chassis alarm messages on a QFX5240.

Junos OS Evolved systems, such as QFX5240, are based on a new alarm infrastructure, which does not support all power supplies and fan alarms. Table 1 shows these alarms.

Table 1: Chassis Alarm Messages for QFX5240

Component	Alarm Type	CLI Message	Recommended Action
Fans	Red (major)	Fan Tray fan-tray-number Absent	Install fan modules in the slots where they are absent.
		Fan Tray fan-tray-number Failure	Remove and check the fan module for obstructions. Reinsert the fan module. If the problem persists, replace the fan module.
		sensor-location Temp Sensor Too Hot	Check the 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.
	Yellow (minor)	FAN fan-number Fan Sensor Fail	Remove and check the fan module for obstructions. Reinsert the fan module. If the problem persists, check the system log for the message related to the sensor and report the message to customer service.
		sensor-location Temp Sensor Too Warm	Check the 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.
Power Supplies	Red (major)	PEM pem-number Not Powered	Install a power supply into the empty slot and ensure the power supply is powered.
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 the following error message and 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.