Typical SSH commands for Omada AP troubleshooting

內容

目標

要求

介紹

用於故障排除的常見 SSH 指令

iwconfig

iperf

restart / cliclientd reset

cliclientd wltool sta

cliclientd wltool scan

結論

目標

本文介紹如何使用 SSH 指令解決 Omada AP 的一些常見問題。

要求

• Omada AP
• SSH 用戶端

介紹

當用戶端設備在使用 Omada AP 時遇到無線網路問題，例如網路速度慢、訊號品質不佳、無法取得 IP 位址或在 AP 之間無法漫遊，請嘗試透過不同的方法排除無線網路故障。例如，在獨立管理模式下修改 Omada 控制器或 AP 網頁 UI 上的相關設定，來確保用戶端正常的網路體驗。在一些複雜的場景下，可以使用 Wireshark 等等工具來擷取用戶端與 AP 或其他網路設備之間的封包，來進行故障排除。在此，本文使用 EAP650-Outdoor v1 為範例，介紹如何透過 SSH 指令解決一些常見的無線網路問題。

說明：某些指令的使用會因型號而有差異。請參閱 Omada AP SSH 指令指南 了解 Omada AP 所有支援的 SSH 指令。

用於故障排除的常見 SSH 指令

iwconfig

• 它可以用來做什麼

使用此指令可以查看 AP 所有無線介面的工作資訊，包括工作狀態、協商速率、無線運作模式、運作頻段、Tx 功率等等。

• 範例

當為 AP 建立了多個 SSID，並且在控制器的站點中的 設定 > 無線網路 > WLAN 中啟用了 SSID 廣播，但一些用戶端裝置仍然無法偵測到 SSID 時，可能是該 SSID 對應的無線介面尚未完全建立。此時，可以在 SSH用戶端終端使用 iwconfig 指令來查看介面的相關資訊。如果 Bit Rate 顯示為 0kb/s，如下圖所示，說明介面尚未完全建立。此延遲可能是由於設定廣播較慢或 5G 廣播在切換到 DFS 頻道之前需要等待 CAC（頻道可用性檢查時間）造成的。CAC 的時間在不同國家/地區的 DFS 頻道中有所不同，通常會持續最多 10 分鐘。

iperf

• 它可以用來做什麼

Omada AP 內建了一個網路效能測試工具 - iPerf，可以用來測試網路頻寬和品質，提供網路延遲、丟包率等等的統計資訊，評估當前無線網路效能，辨識網路瓶頸並解決問題。

• 範例

當用戶遇到網路速度緩慢時，我們可以使用此工具來查找網路問題，尤其是在 Mesh 網路中。這裡以一個常見的拓樸為範例，如下圖所示。使用 iperf 指令依序測試無線用戶端與 Mesh AP2、Mesh AP2 與 Mesh AP1、Mesh AP1 與 Root AP、Root AP 與交換器、交換器與路由器之間的速度，以便準確找到問題所在。該指令的具體使用方法請參閱 Omada AP SSH 指令指南。

說明：使用 iPerf 進行速度測試時，請確保測試的兩個端點使用相同的版本。目前，所有 Omada AP 都安裝了 iPerf2。不同版本的 iPerf2，例如 v2.0.5 和 v2.0.13，可以一起使用，但 iPerf2 和 iPerf3 之間是不相容的。因此，如果速度測試的一端是無線客戶端，另一端是 Omada AP，請確保客戶端已安裝 iPerf2。您可以從 iPerf - Download下載所需的版本。

restart / cliclientd reset

• 它可以用來做什麼

restart 指令用於重啟設備，相當於重新開啟電源；cliclientd reset 指令用於將設備重置為原廠設定，相當於物理按住重置按鈕。

• 範例

在某些情況下，裝置因異常或其他原因需要重新啟動或重置，但我們無法存取其網頁 UI，且該裝置不容易存取或未安裝在附近，例如像是當我們在旅行或離設備位置較遠時。對於此類情況，請提前在路由器上設定通訊埠轉發或其他 VPN 等方式後，與 AP 建立 SSH 連接，然後手動輸入 restart 或 cliclientd reset 指令重新啟動或重置設備。

cliclientd wltool sta

• 它可以用來做什麼

這個指令用來查看所有與目前 AP 連接的無線用戶端統計資訊，相較於網頁 UI 或控制器上顯示的資訊，提供更全面和即時的數據。

• 範例

對於大流量、行動用戶端較多的中大型網路，由於用戶端在 AP 之間頻繁漫遊，控制器用戶端頁面的統計資料可能會出現延遲更新。對於斷開連線的用戶端，系統可能僅在設定的時間（通常超過 5 分鐘）後才將改為離線。這種延遲意味著並非所有資訊都會即時顯示。但是，cliclientd wltool sta 指令可以提供用戶端連線狀態和統計資料的即時更新。

cliclientd wltool scan

• 它可以用來做什麼

使用這個指令，AP 會主動掃描所有支援的頻道，來偵測目前網路上每個無線頻道的 BSS（Basic Service Set），包括每個頻道上的 BSS 總數、每個頻道上偵測到的 BSS 最大和最小 RSSI 值，以及每個頻道的 Rx 使用率。

• 範例

如果目前無線網路中的所有無線用戶端存取網際網路和本地資源時出現明顯延遲情況，排除 ISP 頻寬不足、網路線規格較低、距離太遠、連接的用戶端過多等等因素，請檢查看看是否發生延遲是因為無線環境較差所導致的。如果 AP 由 Omada 控制器管理，請啟用控制器上的 RF 掃描 功能來掃描所有頻道上的干擾，手動將其調整到更乾淨/干擾更少的頻道，並為其設定適當的功率等級。另一種更有效的方法是進行 WLAN 優化來實現自動網路佈署。但請注意，Mesh 網路中的 AP 無法執行 RF 掃描和 WLAN 優化。在這種情況下，可以透過 SSH 指令存取設備：執行 cliclientd wltool scan 指令來快速掃描 AP 支援的每個頻道，然後將 AP 調整到 total BSS 最低、"maximum RSSI of BSS" 最低，以及 Rx 使用率最低的頻道。

說明：此指令僅適用於對目前無線環境進行大概的評估，並未考慮進去微波爐、藍牙裝置等非無線設備的干擾。如果可能，建議使用 Omada 控制器上的 RF 掃描 和 WLAN 優化 功能來最佳化您的無線網路。

結論

本文僅介紹一些簡單使用 SSH 指令排除網路故障的常見場景。除了這些命令之外，還可以嘗試 Omada AP SSH 指令指南 指南中的更多指令，並使用其他故障排除方式找到問題並尋求適當的解決方案，來獲得更好的網路體驗。

了解每個功能和設定的更多詳細資訊，請前往 檔案下載 下載您的產品手冊。