收集Intel® Ethernet Fabric Suite問題的支援資訊
我該如何使用 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 ;相反地,代表性子集可能就足夠了。如需進一步資訊,請洽詢您的支援代表。 |