本文適用於 Omada Controller v4。
有關 Omada SDN Controller v5.0.29 及更高版本，請參閱常見問題 3272。
有關 Omada Controller v3 及以下版本，請參閱 常見問題 2609。
Omada SDN Controller 是一款用於管理支援 SDN 平台的 TP-Link 裝置的軟體，這些裝置包括 EAP、交換器和閘道器。它同時支援 Windows 和 Linux 系統。本文將介紹如何在 Linux 系統上安裝軟體。
如果您是首次安裝 Omada Controller，則可以跳過此步驟。如果您正在使用 Omada Controller 並想要升級控制器，請先備份您的配置。
您可以按照使用者指南中的「備份與還原」部分備份配置，並在升級後進行還原。以下連結包含不同版本控制器的使用者指南。
https://www.tp-link.com/en/support/download/omada-software-controller/
備份舊控制器的配置。
恢復 Omada SDN 控制器上的配置。
備份配置後，即可卸載舊的 Omada 控制器。以下是卸載命令。
sudo bash /opt/tplink/EAPController/uninstall.sh
在卸載過程中，您可以根據需要選擇是否備份原始資料。
筆記：
Omada SDN 控制器僅支援復原 3.1.4 以上版本的配置。由於版本變更，部分功能需要重新配置。您可以參考升級指南。
Omada SDN 控制器支援以下 Linux 系統。請確保您的系統屬於其中之一。
Ubuntu 14.04、16.04、18.04
CentOS 6.x、7.x
Debian 8、9
接下來，我們將以 Ubuntu 和 CentOS 7 為例，展示 Omada SDN 控制器的安裝過程。
要成功安裝並執行控制器，您需要在安裝控制器之前安裝所需的依賴項。控制器需要 Java 8 和 MongoDB 3.x 版本才能運作。但是安裝包中沒有內建 JRE 和 MongoDB，因此您需要自行安裝它們。此外，運行控制器 還需要安裝jsvc和curl 。
安裝 Java 8
您可以使用以下命令安裝 Java 8。
sudo apt-get install –y openjdk-8-jre-headless
您也可以參考以下連結了解其他安裝方式。
https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html
安裝 MongoDB
Omada SDN 控制器支援MongoDB 版本 3.x。您可以使用指令「apt list mongodb-org」來檢查 MongoDB 來源的預設版本或您是否已安裝 MongoDB。
如果您尚未安裝 MongoDB，且預設版本不相容，您可以按照以下步驟安裝合適的 MongoDB 版本。這裡我們以安裝 3.4 版本為例來說明。
使用下列指令導入 MongoDB 公用 GPG 金鑰。
wget -qO - https://www.mongodb.org/static/pgp/server-3.4.asc | sudo apt-key add -
建立/etc/apt/sources.list.d/mongodb-org-3.4.list 文件，並新增對應版本的指令。
Ubuntu 14.04
echo "deb [ arch=amd64 ] http://repo.mongodb.org/apt/ubuntu trusty/mongodb-org/3.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.4.list
Ubuntu 16.04
echo "deb [ arch=amd64,arm64 ] http://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.4.list
Ubuntu 18.04
echo "deb https://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.4.list
請執行以下命令重新載入本機軟體包資料庫：
sudo apt-get update
使用以下命令安裝 MongoDB：
sudo apt-get install -y mongodb-org
您也可以按照下面的 MongoDB 官方教學安裝不同版本。
https://docs.mongodb.com/v3.4/tutorial/install-mongodb-on-ubuntu/
安裝 jsvc
sudo apt-get install jsvc
安裝 curl
sudo apt-get install curl
安裝 Omada SDN 控制器
請前往 TP-Link官方網站 下載Omada Controller，然後使用以下指令安裝控制器。您可能需要將目錄變更為儲存安裝包的資料夾。
sudo dpkg –i Omada_SDN_Controller_V4.x.x_linux_x64.deb
CentOS 不支援 deb 安裝套件。請使用 tar.gz 軟體包進行安裝。
我們還需要安裝一些依賴項，包括 Java 8、MongoDB、jsvc 和 curl。
安裝 Java 8
檢查 Java 8 的可用安裝包。
sudo yum list java-1.8*
選擇適合您系統的版本並安裝 Java 8。
sudo yum install –y java-1.8.0-openjdk.x86_64
您也可以參考以下連結了解其他安裝方式。
https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html
安裝 MongoDB
這裡我們以安裝 3.4 版本為例。
下載 MongoDB 的 rpm 安裝套件。
sudo wget https://repo.mongodb.org/yum/redhat/7/mongodb-org/3.4/x86_64/RPMS/mongodb-org-server-3.4.24-1.el7.x86_64.rpm
使用rpm指令安裝MongoDB。
sudo rpm -ivh mongodb-org-server-3.4.24-1.el7.x86_64.rpm
安裝 jsvc
sudo yum install –y jsvc
安裝 curl
sudo yum install –y curl
安裝 Omada SDN 控制器
請前往 TP-Link官方網站 下載Omada Controller。下載完成後，打開終端機並切換到安裝包所在的資料夾。使用以下命令解壓縮安裝包。
tar zxvf Omada_Controller_v4.1.5_linux_x64.tar.gz
使用以下命令進入解壓縮後的資料夾。
cd Omada_Controller_v4.1.5_linux_x64
使用以下命令安裝 Controller。
sudo bash install.sh
以下是一些可以幫助您檢查/更改 Omada 控制器狀態的命令。
- tpeap 狀態 -- 顯示 Controller 的狀態；
- tpeap start -- 啟動 Omada 控制器；
- tpeap stop --停止運作 Omada 控制器。
啟動 Omada Controller 後，您可以瀏覽 URL http://localhost:8088 或https://localhost:8043 造訪 Controller 的 Web 管理頁面。
尖端：
- 如果您的 Linux 系統已安裝的 MongoDB 版本低於 3.0.15，您可以按照上述步驟進行安裝，MongoDB 將在安裝過程中自動升級。如果您的系統已安裝的 MongoDB 版本高於4.x或更高版本，則需要自行將 MongoDB 降級到適當的版本。
- 如果您的 Linux 系統已安裝低於 Java 8 的 Java 版本，您可以按照上述步驟進行安裝，舊版本將被 Java 8 覆蓋。如果您的系統已安裝高於 Java 8 的 Java 版本，則需要自行降級至 Java 8。
- 備份資料庫僅用於在需要降級使用舊版控制器時進行還原。不建議在安裝控制器期間匯入備份資料庫。
如果遇到類似以下的依賴問題，可以使用指令「sudo apt-get -f -y install」或「apt --fix-all」來修正問題。修復依賴問題後，系統將自動完成控制器的安裝。
Related Documents
當 Omada 軟體控制器 (V4) 無法發現裝置時，我該怎麼辦？
07-23-2024
15454首次運行 EAP 控制器時應注意什麼？
08-03-202110407如何管理不同地點的EAP
06-24-202212456當 Omada 軟體控制器（V3 或更低版本）無法發現 EAP 時，我該怎麼辦？
07-23-202413290