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 用戶端應用程式
技術支援檔案名稱和格式
如何限制舊項目並減少技術支援檔案的大小
刪除舊的技術支援檔案以節省空間。

什麼是技術支援檔案

技術支援檔案是壓縮的封存檔案，其中包含有關交換器狀態的資訊，例如 Syslog、資料庫狀態、核心傾印等。Dell 技術支援專員需要技術支援檔案來進行事件的詳細分析。

  • 技術支援檔案是壓縮檔案，儲存在 /var/dump 中。可以使用以下命令檢視此資料夾的內容： 
    dir tech-support:/
  • 技術支援檔案有副檔名 .tar.gz
  • 技術支援檔案可能需要超過 15-30 分鐘才能產生。
  • 檔案大小會因記錄範例的資料和持續時間而異。為了縮減大小，我們可以使用「自」選項
  • 如果可能，請嘗試產生處於問題狀態的技術支援檔案
注意：如需舊版，請參閱 Dell Networking SONiC 作業系統如何在 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」命令追蹤技術支援檔案產生的狀態。輸出顯示狀態：「已完成」(檔案產生完成後)。
使用「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
若要在網路交換器的 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

建議擷取至前一天的 0 小時，以取得事件發生前採取的任何可能的事前行動。

範例輸出

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 表示與當地時間的偏移為 hour:minute。

刪除舊的技術支援檔案以節省空間

從交換器解壓縮檔案後，我們可以安全地刪除傾印資料夾中的技術支援檔案。

使用命令「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.