DELL Networking SONiC 如何生成和收集技术支持文件

Summary: 本文介绍如何在 Dell Networking SONiC 版本 4.0 及更高版本中生成和收集技术支持文件。

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

索引

什么是技术支持文件？
命令语法
如何在 Dell SONiC 中生成技术支持文件
如何跟踪技术支持文件生成状态
如何从交换机检索技术支持文件
      FTP
      HTTP
      USB
      SCP 客户端应用程序
技术支持文件名和格式
如何限制旧条目并减小技术支持文件的大小
删除旧的技术支持文件以节省空间

什么是技术支持文件

技术支持文件是一个压缩的归档文件，包含有关交换机状态的信息，如系统日志、数据库状态、核心转储等。戴尔技术支持工程师需要技术支持文件才能进行事件详细分析。

  • 技术支持文件是压缩文件，保存在 /var/dump 中。可以使用以下命令查看此文件夹的内容： 
    dir tech-support:/
  • 技术支持文件具有 .tar.gz 扩展名
  • 技术支持文件可能需要 15-30 分钟以上的时间来生成。
  • 文件大小会因日志样本的数据和时长而异。为了减小文件大小，我们可以使用“since”选项
  • 如果可能，尝试生成问题状态下的技术支持文件
提醒：对于较旧版本，请参阅 Dell Networking SONiC OS 如何在 3.X 版本中生成技术支持文件

命令语法

命令 说明
admin@sonic:~$ sonic-cli 进入 Dell Sonic
sonic# show tech-support 生成技术支持文件。
sonic# show tech-support status 显示技术支持文件生成状态
sonic# dir tech-support:/ 显示生成技术支持文件的 /var/dump 目录的内容。
sonic# copy tech-support://<filename> ftp/home/http/scp/usb://<filename> 使用 ftp、http、scp 协议或 usb 或主目录将技术支持文件复制到远程位置

可选

命令 说明
sonic# show tech-support since <date/time> 生成自某个日期和时间开始的技术支持文件。单击此处以获得更多信息。
sonic# delete tech-support:/ <filename> 删除旧的技术支持文件。这可以节省闪存空间。

如何在 Dell SONiC 中生成技术支持文件

使用“show tech-support”命令生成技术支持文件。

示例

admin@DELLSONiC:~$ sonic-cli
DELLSONiC# 
DELLSONiC# show tech-support 
%Info: Tech-support process started, please check "show tech-support status" for tech-support progress
DELLSONiC#

如何跟踪技术支持文件生成状态

使用“show tech-support status”命令跟踪技术支持文件生成的状态。当文件生成完成时，输出显示 Status: Completed。
使用“dir tech-support:/”命令查看 /var/tmp 文件夹的内容。技术支持文件在此文件夹中生成。

以下是“show tech-support status”和“dir tech-support:/”的输出示例

在技术支持文件生成期间：

DELLSONiC# show tech-support status 
Status: In Progress (Collecting Counters-1) Total items collected: 12
DELLSONiC# dir tech-support:/
-------------------------------------------------------------------------
Date(Last Modified)      Size(Bytes)    Type      Filename                        
-------------------------------------------------------------------------                
2023-04-15 20:21         4096           d         sonic_dump_DELLSONiC_20230415_202048
2023-04-15 20:22         11100160       -         sonic_dump_DELLSONiC_20230415_202048.tar

技术支持文件生成成功完成后。

DELLSONiC# show tech-support status
Status: Completed
File Name: /var/dump/sonic_dump_DELLSONiC_20230415_202048.tar.gz
DELLSONiC# dir tech-support:/ 
-------------------------------------------------------------------------
Date(Last Modified)      Size(Bytes)    Type      Filename                        
-------------------------------------------------------------------------                
2023-04-15 20:27         252932846      -         sonic_dump_DELLSONiC_20230415_202048.tar.gz

如何从交换机检索技术支持文件

使用“copy tech-support://<tech-support filename> <destination>//<filename>”命令将技术支持文件复制到主目录或 usb 或远程 ftp/http/scp 服务器。

以下是可用的目标位置选项及其用法。

  • ftp：复制到远程 FTP 服务器 (ftp://userid:passwd@hostip/filepath)
  • home：复制到主目录 (home://filename)
  • http：复制到远程 HTTP 服务器 (http://hostip/filepath)
  • scp：复制到远程 SCP 服务器 (scp://userid:passwd@hostip/filepath)
  • usb：复制到 USB 介质目录 (usb://filename)
提醒：“copy”命令中的“tech-support://”不会自动填写。因此，请手动键入完整路径。

我们将通过一个示例来解释这些选项。

FTP
要将文件复制到远程 FTP 服务器，请使用以下语法。

copy techsupport://<techsupport file.tag.gz> ftp://userid:passwd@hostip/filepath

假设我们要将技术支持文件复制到 IP 为 10.0.0.1 的 FTP 服务器，用户名：TEST，密码：PASS

示例输出

DELLSONiC# copy tech-support://sonic_dump_DELLSONiC_20230415_202048.tar.gz ftp://TEST:PASS@10.0.0.1/sonic_dump_DELLSONiC_20230415_202048.tar.gz

HTTP
要将文件复制到远程 HTTP 服务器，请使用以下语法。

copy techsupport://<techsupport file.tag.gz> http://hostip/filepath

假设我们要将技术支持文件复制到 IP 为 10.0.0.1 的 HTTP 服务器。

示例输出

DELLSONiC# copy tech-support://sonic_dump_DELLSONiC_20230415_202048.tar.gz http://10.0.0.1/sonic_dump_DELLSONiC_20230415_202048.tar.gz

USB
要在 Networking 交换机中的 DELL SONiC 上使用 USB，我们必须确保已配置 usb enable 命令。默认情况下，USB 处于禁用状态。
将 USB 插入交换机后，运行 usb mount 命令。

Dell Networking SONiC 如何装载和卸载 USB

示例输出

sonic#
sonic# configure terminal
sonic(config)# usb enable
sonic(config)# exit
sonic# usb mount
DELLSONiC# copy tech-support://sonic_dump_DELLSONiC_20230415_202048.tar.gz usb://sonic_dump_DELLSONiC_20230415_202048.tar.gz

SCP 客户端应用程序
您可以使用任何 SCP 客户端应用程序在交换机中提取技术支持文件。
在 SCP 客户端应用程序中使用交换机登录凭据登录交换机。技术支持文件位于目录 /var/dump/. 中。
某些 SCP 客户端应用程序具有图形界面，可以更轻松地将文件从交换机 /var/dump/ 复制到本地计算机中的某个位置。

技术支持文件名和格式

技术支持文件的名称格式为“sonic_dump_<Hostname>_ _YYYYMMDD_HHMMSS.tar.gz”
*YYYYMMDD_HHMMSS 是年月日_小时分秒。这是技术支持文件的生成时间。

例如，“sonic_dump_DELLSONiC_20230415_202048.tar.gz”是生成的技术支持文件。在这里，YYYYMMDD_HHMMSS 是 20230415_202048，DELLSONiC 是交换机的主机名。

如何限制旧条目并减小技术支持文件的大小

取决于交换机的正常运行时间，技术支持文件有可能会很大。在 Dell SONiC 中，我们可以通过限制日志记录时长来减小技术支持文件的大小。

使用“show tech-support since <date/time>”命令获取从特定时间开始的技术支持文件。

示例输出

DELLSONiC# show tech-support since "2023-04-14T12:30:30Z"
%Info: Tech-support process started, please check "show tech-support status" for tech-support progress

建议从前一天的零点开始捕获数据，以获得事件前的任何抢占式操作的信息。

示例输出

DELLSONiC# show tech-support since "2023-04-14T00:00:00Z"
%Info: Tech-support process started, please check "show tech-support status" for tech-support progress

命令语法

命令 说明
sonic# show tech-support since <date/time> 以下是日期/时间的格式。

 “YYYY-MM-DDTHH:MM:SS[.ddd…]Z”或
 “YYYY-MM-DDTHH:MM:SS[.ddd…]+hh:mm”或
 “YYYY-MM-DDTHH:MM:SS[.ddd…]-hh:mm”，其中：

 YYYY = 年，MM = 月，DD = 日，
 T（必须位于时间之前）
 HH = 小时，MM = 分，SS = 秒，
 （可选）.ddd… = 秒的小数部分（例如“.323”）
 Z 表示与本地时间零偏移。
 +/- hh:mm 表示与当地时间的小时:分钟偏移。

删除旧的技术支持文件以节省空间

从交换机提取文件后，我们可以放心地删除转储文件夹中的技术支持文件。

使用命令“delete tech-support:/ <techsupport file.tar.gz>”删除技术支持文件。

示例输出

DELLSONiC# delete tech-support:/ sonic_dump_DELLSONiC_20230415_202048.tar.gz
Proceed to delete tech-support:/sonic_dump_DELLSONiC_20230415_202048.tar.gz? [y/N]:y

使用命令“dir tech-support:/”验证文件是否已删除。

示例输出

DELLSONiC# dir tech-support:/ 
-------------------------------------------------------------------------
Date(Last Modified)      Size(Bytes)    Type      Filename                        
-------------------------------------------------------------------------

 

Affected Products

Enterprise SONiC Distribution, PowerSwitch E3200-ON Series, Dell EMC Networking N3200-ON, PowerSwitch S5212F-ON, PowerSwitch S5224F-ON, PowerSwitch S5232F-ON, PowerSwitch S5248F-ON, PowerSwitch S5296F-ON, PowerSwitch Z9100-ON, PowerSwitch Z9264F-ON , PowerSwitch Z9332F-ON, PowerSwitch Z9432F-ON ...
Article Properties
Article Number: 000212428
Article Type: How To
Last Modified: 25 Feb 2025
Version:  5
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.