KB 471688 - How to Collect InfiniBand Transceiver Temperature (Non-Root Method)

KB 471688 - How to Collect InfiniBand Transceiver Temperature (Non-Root Method)

1. Purpose

This document explains how to collect InfiniBand (IB) transceiver (QSFP module) temperature from servers using the Linux sysfs hwmon interface without requiring root privileges.

This method applies to systems using Mellanox / NVIDIA mlx5-based adapters (e.g., ConnectX series).


2. Scope

  • HGX Nodes

  • Management Nodes

  • Any server with mlx5_* IB devices

Works when:

  • Root access is not available

  • Only temperature verification is required


3. Prerequisites

  • SSH access to the server

  • IB driver loaded (mlx5_core)

  • /sys/class/infiniband/ available

Verify IB devices:

ls /sys/class/infiniband/

Expected output:

mlx5_0  mlx5_1  mlx5_2  ...


4. Collect Transceiver Temperature (Single Device)

Example for mlx5_0:

cat /sys/class/infiniband/mlx5_0/device/hwmon/hwmon*/temp*_label
cat /sys/class/infiniband/mlx5_0/device/hwmon/hwmon*/temp*_input

Sample Output

asic
Module0
65000
62000

Interpretation

  • asic → HCA chip temperature

  • Module0 / Module1 → Transceiver temperature

  • Values are in millidegree Celsius

Convert:

62000 = 62°C


5. Collect From All IB Interfaces with Timestamp

echo "===== IB Temperature Snapshot ====="
date
for i in /sys/class/infiniband/mlx5_*; do
  echo "===== $i ====="
  paste \
    <(cat $i/device/hwmon/hwmon*/temp*_label) \
    <(cat $i/device/hwmon/hwmon*/temp*_input 2>/dev/null)
  echo ""
done

To save to file:

(echo "===== IB Temperature Snapshot ====="
date
for i in /sys/class/infiniband/mlx5_*; do
  echo "===== $i ====="
  paste \
    <(cat $i/device/hwmon/hwmon*/temp*_label) \
    <(cat $i/device/hwmon/hwmon*/temp*_input 2>/dev/null)
  echo ""
done
) > <hostname>_ib_temp_$(date +%F_%H-%M-%S).log


7. Temperature Threshold Reference

ComponentNormalWarningCritical
ASIC45–75°C>85°C>95°C
Transceiver30–70°C>75°C>80–85°C

If transceiver temperature exceeds 75°C:

  • Check airflow

  • Check fan speed

  • Verify BMC sensor status

  • Escalate if persistent

8. Validation

Always cross-check:

  • BMC sensor readings

  • System event logs

  • dmesg for PCIe or thermal warnings

    • Recent Articles

    • Download Log from ASUSTOR NAS

      How to download Log from NAS Purpose: This article will helps support team to guide customer to download Log to share the evidence for component failure. Problem: Customer reports for Storage device not detected. Storage failure. / Storage not ...

    • TeamGroup Memory Warranty & RMA Process

      Purpose To provide a clear and simple process for handling Team Group Memory warranty and RMA claims. Warranty Verification Product model and serial number. Purchase invoice or proof of purchase. Warranty eligibility. Product condition and any signs ...

    • Common Reasons for RMA Rejection

      Purpose This article outlines the most common reasons why RMA requests are rejected. Understanding these reasons helps Technical Support teams reduce claim delays and improve first-time approval rates. Physical Damage RMA requests are rejected when ...

    • KB-630208 | How to use Find and Locate to search for files in Linux

      Purpose To provide Linux administrators and Field Engineers with guidance on using the find and locate utilities to efficiently search for files and directories within a Linux filesystem based on criteria such as name, type, size, timestamps, ...

    • KB-630164 | How to use rsync to Synchronize Files

      Purpose To provide a clear and practical procedure for using the rsync utility to synchronize files and directories between local systems and remote hosts, including push and pull operations, while preserving file attributes and optimizing data ...

    • Popular Articles

    • CP Plus Camera and NVR Configuration

      NVR Configuration The CP Plus Pro Series of NVRs have been meticulously designed for providing you with upgraded performance and higher recording quality in your IP video surveillance solution. The robust processor that has been inculcated in this ...

    • KB 775235 - Kerberos Authentication – Overview

      What is Kerberos? Kerberos is a secure authentication method used in our Active Directory (AD) environment (mbuzztech.com). It allows users to: Access multiple systems without re-entering passwords (Single Sign-On – SSO) Log in once Where We Use It ...

    • KB 935001 - AMD Ryzen AM4 Motherboard CPU Compatibility

      For the AM4 Platform, AMD has been very generous when it comes to motherboard compatibility. A CPU launched in 2022, like the Ryzen 7 5800X3D, will work with an almost 6-year-old motherboard, like the ASRock X370 Pro, which was launched in early ...

    • KB 532001 - Ubuntu Server 22.04 Installation Hangs on ASUS WRX80e-SAGE Series

      During the installation of Ubuntu Server 22.04 on ASUS WRX80E-SAGE series motherboards, the installation process hangs during the boot phase. The issue is associated with USB disk recognition errors, particularly with devices managed by the XHCI ...

    • KB 686001 - ASUS Server Stress Testing Guide for INTEL and AMD Platforms

      Creating a Bootable USB with Asus Test Tool Step 1: Download Required Files Download Asus Linux Image: Save the Linux image file provided by Asus. Download Memtest Tool: Open a browser, search for "Memtest," and download the free version from the ...