Parameters Optimization of Omada SDN Controller for a Better Performance under Large-Scale Network (V5.4.6 or above)

Omada 軟體控制器從 5.4.6 開始可以管理高達 10,000 台設備。考慮電腦規格和網路效能，我們將 Omada 控制器管理的最大數量預設設為 3000，可滿足大多數使用場景。

若有需要透過一台控制器管理 3000 以上的設備，此頁將協助您透過修改某些參數調整設備管理上限，透過限制伺服器規格優化系統效能。

注意:

• INSTALLATION_FOLDER 為安裝 Omada SDN 控制器的資料夾，Windows 上的預設路徑為 “C:\Users\YOURACCOUNTNAME\Omada Controller”，而 YOURACCOUNTNAME 為系統帳號名稱；Linux 上的路徑為 “/opt/tplink/EAPController”。
• Omada 伺服器表示安裝並執行 Omada SDN 控制器程式的電腦或伺服器。

修改前，請先備份檔案。登入控制器頁面，前往系統 – 備份 & 還原並儲存備份檔。另外，請在修改下方檔案前先備份來源檔。

更新軟體將覆寫先前修改的設定。建議記錄修改的設定項目，接著在更新後修改這些設定。請勿備份先前的設定檔並在更新後直接替換檔案。

1. 想透過一台控制器管理 3000 台以上設備嗎？

若要增加管理的設備數量，請使用文字編輯工具開啟 “INSTALLATION_FOLDER\properties\omada.properties” 檔，並修改 “max.device=3000” 參數。

舉例來說，若您想要將上限修改為 10000，參數需修改為 “max.device=10000”。

管理更多設備需要更強大的伺服器。請參考FAQ#2967選擇建議的伺服器規格。

上述操作將幫助增加上限，但對系統負載的要求也會大幅提升。以下為當遭遇到類似問題時，優化系統效能的一些建議。

2. 當 CPU 長期過載時怎麼辦？

一般來說，慢性 CPU 過載是由於 heap memory 容量有限導致，heap memory 可被理解為分配給控制器運作專用的 RAM。控制器的 heap memory 預設為伺服器 RAM 的一半。

若您的 Omada 伺服器專用於執行控制器軟體，且分配更多的 heap memory 容量不會影響系統運作，您可以設定以下擴展伺服器的 RAM 容量:

使用文字編輯工具開啟 “INSTALLATION_FOLDER\bin\start.bat” 檔 (Windows) 或 “INSTALLATION_FOLDER/bin/control.sh” 檔 (Linux) 並新增兩項參數設定 heap memory，“-Xms” 和 -Xmx”。

舉例來說，“java -Xms20480m -Xmx20480m -XX:MaxHeapFreeRatio=60 -XX:MinHeapFreeRatio=30 -XX:+HeapDumpOnOutOfMemoryError” 表示為控制器程式分配 20 GB heap memory。

注意: 在 Windows 修改 “start.bat” 檔後，您需要雙擊以開啟控制器，而非雙擊桌面上的捷徑，透過捷徑開啟將不會讓修改生效。在 Linux 上，您仍可以透過 “tpeap start” 指令開啟。

3. 為 Linux 優化參數。

若您在 Linux 上使用 Omada 控制器管理大規模網路，您會發現當設備數量超過特定值時(例如：1000)，會遇到設備經常重新納管和網頁載入過慢的體驗問題。這可能與 Linux 系統的某些限制有關，建議您按照下列設定優化效能。

開啟檔案的最大數量。預設每個 Linux 使用者可開啟最多 1024 個檔案，將限制 Omada 控制器的運作效能。

若您發現在 running log (/INSTALLATION_FOLDER/log/server.log) 中發現有“太多開啟的檔案”日誌，接著您需要修改參數。建議您在安裝或執行控制器前先修改參數以避免效能限制。

編輯 “/etc/security/limits.conf”，新增下列參數，儲存檔案後登出並重新登入讓修改生效。

* soft nofile 65535

* hard nofile 65535