收集Intel® Ethernet Fabric Suite問題的支援資訊

文件

疑難排解

000088354

2021 年 11 月 16 日

我該如何使用 ethcapture 指令?

ethcapture 指令將關鍵系統資訊擷取到壓縮焦油檔案中。產生的 tar 檔案應傳送至客戶支援,以及關於此系統的任何 Intel® 乙太網路 Fabric 問題報告。

注意

產生的主機擷取檔案在主機上可能需要大量的空間。實際大小有所不同,但大小可能為數百萬百萬位元組。Intel 建議確保主機系統上有足夠的磁碟空間。

語法: ethcapture [-d detail] output_tgz_file

選項:

--help:產生完整的解說文字。

-d detail:擷取詳細程度:

1 (本機):從主機取得本機資訊。如果沒有輸入選項,這是預設值。

2 (Fabric):除了 Local 外,還透過對 SM 和網狀架構錯誤分析的查詢,使用 ethreport 取得基本的網狀架構資訊。

3 (分析):除了 Fabric 外,還可獲得 etphaanalysis 結果。如果 ethallanalysis 尚未執行,它會作為擷取的一部分執行。

注意

當網狀架構出現作業問題時,可使用詳細等級 2–3。如果問題出在節點特定,則第 1 級的細節應該已經足夠了。詳細等級 2–3 需要可操作的 Fabric。通常,您的支援代表會要求特定詳細等級。如果特定細節層級耗時過長或無法收集,請嘗試更低的細節層級。對於詳細等級 2–3,其他資訊僅在安裝了 Intel® Ethernet Fabric Suite FastFabric Toolset 的節點上提供。

output_tgz_file:指定由ethcapture 建立的檔案名稱。如果已經存在,指定的檔案名會被覆寫。Intel 建議在提供的檔案名稱中使用 .tgz 尾碼。如果給定的檔案名稱沒有 .tgz 尾碼,則會新增.tgz 尾碼。

例子:

ethcapture mycapture.tgz
ethcapture -d 3 030127capture.tgz

 

我該如何使用 ethpacaptureall 指令?

ethcaptureall 指令會從所有主機擷取問題報告的支援資訊並上傳至此系統。

執行主機 ethcaptureall 時,執行 ethcapture 以在每個主機的 ~root 內建立指定的擷取檔案(根據需要新增 .tgz 尾碼)。這些檔案會在本機系統的 upload_dir/hostname/ 內上傳並拆包成一個相符的目錄名稱。預設檔案名稱為 hostcapture

上傳的擷取會結合到.tgz 檔案中,並隨附指定的檔案名,並新增尾碼.all.tgz

選項:

--help:產生完整的解說文字。

-p:在所有主機同時執行擷取上傳。

-f hostfile:在叢集中指定具有主機的檔案。預設值為 /etc/ethtools/hosts 檔。

-h hosts:指定執行擷取的主機清單。

-d upload_dir:指定目錄上傳至。預設值為 uploads。如果沒有具體說明,會使用環境變數 UPLOADS_DIR

-D detail_level:指定擷取的細節等級傳遞給主機ethcapture

1 (本機):從每個主機取得本機資訊。

2 (Fabric):除了 Local 外,還透過對網狀架構和網狀架構錯誤分析的查詢,使用 ethreport 取得基本的網狀架構資訊。

3 (分析):除了 Fabric,還能取得 ethallanalysis 結果。如果 ethallanalysis 尚未執行,它會作為擷取的一部分執行。

注意

如需詳細等級 2-3,其他資訊僅在執行 ethcaptureall 指令的節點上收集。

file:指定擷取檔案的名稱。如果名稱中未指定尾碼,則會附加尾碼 .tgz

例子:

ethcaptureall
# Creates a hostcapture directory in upload_dir/hostname/ for each host in
/etc/eth-tools/hosts file, then creates hostcapture.all.tgz.

ethcaptureall mycapture
# Creates a mycapture directory in upload_dir/hostname/ for each host in
/etc/eth-tools/hosts file, then creates mycapture.all.tgz.

ethcaptureall -h 'arwen elrond' 030127capture
# Gets the list of hosts from arwen elrond file and creates
030127capture.tgz file.

環境變數

此命令也使用下列環境變數:

  • HOSTS:如果未提供 -h 選項,請使用主機清單。
  • HOSTS_FILE:檔案包含主機清單,在沒有 -f-h 的情況下使用。
  • UPLOADS_DIR:在沒有 -d 的情況下上傳至的目錄。
  • FF_MAX_PARALLEL:使用-p 選項時,會執行最大平行作業。

更多資訊

當對主機執行 ethcaptureall 時,會使用內部 SSH。命令 ethcaptureall 要求在執行的主機Intel® Ethernet Fabric Suite FastFabric Toolset 和主機之間設定無密碼的 SSH,ethcaptureall 正在執行。 ethsetupssh 指令可協助設定無密碼的 SSH。

注意

產生的主機擷取檔案可能需要大量的空間在 Intel® Ethernet Fabric Suite FastFabric Toolset 主機上。實際大小有所不同,但每個主機的大小可能為 200 萬位元組。Intel 建議您確保在 Intel® Ethernet Fabric Suite FastFabric Toolset 系統上有足夠的空間。在許多情況下,可能不需要對所有主機執行 ethcaptureall ;相反地,代表性子集可能就足夠了。如需進一步資訊,請洽詢您的支援代表。