How to Collect Logs from NVIDIA Cumulus Linux Switch

How to Collect Logs from NVIDIA Cumulus Linux Switch

Purpose

This article describes how to collect diagnostic logs from a switch running NVIDIA Cumulus Linux. These logs are typically required by NVIDIA Networking Support for troubleshooting switch-level issues such as port flaps, routing problems, fabric instability, or software faults.

Scope

This procedure applies to:

  • NVIDIA switches running Cumulus Linux

  • Environments using CLI (SSH) access to the switch

  • Scenarios requiring system, networking, and hardware diagnostics

Prerequisites

  • SSH access to the Cumulus Linux switch

  • Administrative (sudo) privileges

Procedure

Step 1: Log in to the Cumulus Linux Switch

  1. Open a terminal.

  2. Connect to the switch using SSH:

ssh cumulus@<switch-management-ip>

  1. Elevate privileges if required:

sudo -i

Step 2: Verify Switch and OS Details (Optional but Recommended)

Collect basic system information:

hostname cat /etc/os-release uname -a

Step 3: Generate Cumulus Support Log Bundle

Cumulus Linux provides a built-in command to collect comprehensive logs.

Run the following command:

sudo cl-support

This command:

  • Collects system logs

  • Captures network configuration

  • Gathers hardware and interface information

  • Packages everything into a compressed archive

The output file is typically generated under:

/var/support/

Step 4: Verify Log File Creation

Confirm the file exists and is non-empty:

ls -lh /var/support/

Step 5: Download log file

We can download the log file using an FTP tool like MobaXterm:

  1. Log into the switch using MobaXterm

  2. From the left tab go to path /var/support/

  3. Locate the support file

  4. Right click → Download

  5. The support file will be downloaded into your system





Notes and Best Practices

  • Always run cl-support before rebooting the switch.

  • Do not modify the generated archive.

  • Ensure timestamps align with the reported incident.

  • Store log bundles securely, as they may contain sensitive configuration data.


    • Related Articles

    • Installing Cumulus VX on Proxmox VE

      This document describes how to deploy NVIDIA Cumulus VX (Cumulus Linux 5.x) on Proxmox VE using the QCOW2 disk image provided by NVIDIA. Cumulus VX allows you to simulate a Cumulus Linux switch using KVM. 1. Requirements Item Details Hypervisor ...

    • Collect Logs from NVIDIA QM9700 InfiniBand Switch (Sysdump) - Web GUI

      Purpose This article describes the procedure to collect diagnostic logs (sysdump) from an NVIDIA QM9700 InfiniBand switch. The sysdump file is typically requested by NVIDIA Networking Support for troubleshooting fabric, port, firmware, or stability ...

    • How to Collect Logs from NVIDIA UFM (UFM System Dump)

      Purpose This article explains how to collect diagnostic logs from NVIDIA Unified Fabric Manager (UFM) using the web-based GUI. The UFM system dump is typically required by NVIDIA Support for troubleshooting fabric health, host visibility, alerts, and ...

    • How to Collect NVIDIA Bug Report

      Purpose This article provides step-by-step instructions to collect an NVIDIA bug report from servers equipped with NVIDIA GPUs. The NVIDIA bug report is commonly required by NVIDIA Support for troubleshooting GPU driver, CUDA, NVLink, PCIe, and ...

    • SOS Report collection from NetApp OSS Servers

      Purpose This article details the process of generating and collecting SOS Reports from NetApp OSS Servers. These reports are often required by the NetApp Support Team for detailed analysis and troubleshooting. Scope Applicable to: NetApp OSS Servers ...