本文適用於 Omada SDN 控制器 v5.0.29 以上版本。

對於 Omada SDN 控制器 v4，請參閱 FAQ 2917。

有關 Omada Controller v3 及以下版本，請參閱 FAQ 2609。

 

本文將介紹如何在 Linux 平台上安裝 Omada SDN 控制器。 | Ubuntu 16.04、18.04、20.04、22.04 | CentOS 6、7 | Debian 8、9、10、11

 

1. 備份設定

如果這是您首次安裝 Omada 控制器，您可以跳過這個步驟。

 

如果您需要升級您的控制器，我們強烈建議您先備份配置資料。

您可以按照 備份與復原 使用者指南部分來備份您的設定。以下連結包含不同版本 Omada 控制器的使用者指南： https://www.tp-link.com/support/download/omada-software-controller/

 

2. 支援的 Linux 發行版

Linux 平台上的 Omada 軟體控制器支援以下發行版。建議您使用已下發行版其中之一作為選擇。

Ubuntu 16.04, 18.04, 20.04, 22.04

CentOS 6, 7

Debian 8, 9, 10, 11

 

3. Ubuntu 和 CentOS 系統上的安裝方式

我們以 Ubuntu 22.04 和 CentOS 7 為例展示 Omada SDN 控制器的安裝過程。

 

3.1 在 Ubuntu 22.04 上安裝 deb 套件

Omada SDN 控制器需要以下的相容性：

• OpenJDK 8 and above
• MongoDB v3 or v4
• JSVC
• CURL
• Libssl(Only for Ubuntu 22.04)

 

安裝 OpenJDK

您可以使用以下指令來安裝 Java 8。

sudo apt install –y openjdk-8-jre-headless

 

Java 官方指南可以參考以下連結： https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html

您也可以使用以下指令安裝 OpenJDK-11。

sudo apt install –y openjdk-11-jre-headless

 

說明 : 如果您安裝了 OpenJDK-11 或更高版本，則您下載的 JSVC 版本應該是 1.1.0 或更高版本。就我們所知，官方的 Debian 或 Ubuntu 軟體庫提供 JSVC 1.0.5，你可以參考。 5.How to compile and install JSVC 1.1.0 or higher.

 

安裝 MongoDB

 

Omada SDN 控制器支援 MongoDB 的 3 和 4 版本。在這裡，我們將示範如何安裝 4.4 版本。

 

 

安裝 libssl（僅適用於 Ubuntu 22.04）。

libssl 是在 Ubuntu 22.04 上下載 MongoDB 所需的必要的相依套件。

如果你下載的是 22.04 之前的 Ubuntu 版本，你可以跳過這個步驟。

 

下載 libssl 相依套件。

wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1-1ubuntu2.1~18.04.23_amd64.deb

說明：下載連結將不定期更新，你可以參考以下連結選擇最新的下載連結：

http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/

 

安裝 libssl。

sudo dpkg -i libssl1.1_1.1.1-1ubuntu2.1~18.04.23_amd64.deb

 

匯入公鑰。

wget -qO - https://www.mongodb.org/static/pgp/server-4.4.asc | sudo apt-key add –

 

使用正確對應的指令建立 /etc/apt/sources.list.d/mongodb-org-4.4.list 檔案。

Ubuntu 16.04

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list

Ubuntu 18.04

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list

Ubuntu 20.04

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list

Ubuntu 22.04

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list

 

 

重新載入本地套件資料庫：

sudo apt update

 

安裝 MongoDB：

sudo apt install -y mongodb-org

 

你也可以依照下方 MongoDB 官方指南來安裝不同的版本。

For MongoDB v4.4: https://docs.mongodb.com/v4.4/tutorial/install-mongodb-on-ubuntu/

For MongoDB v3.4: https://docs.mongodb.com/v3.4/tutorial/install-mongodb-on-ubuntu/

 

安裝 jsvc

sudo apt install jsvc

 

 

如果你已經安裝了 OpenJDK-11 或更高的版本，你必須安裝 JSVC 版本 1.1.0 或更高的版本，有些 Linux 發行版可能不提供此版本。你可以參考以下資料： 5. 如何編譯和安裝 JSVC 1.1.0 或更高版本？.

 

安裝 curl

sudo apt install curl

 

安裝 Omada SDN 控制器

前往 官方網站下載 Omada SDN 控制器的安裝套件，然後使用以下指令進行安裝。

sudo dpkg –i Omada_SDN_Controller_v5.x.x_Linux_x64.deb

如果您使用 OpenJDK-11 或更高版本、JSVC 1.1.0 或更高版本，請使用以下指令安裝它。

sudo dpkg --ignore-depends=jsvc –i Omada_SDN_Controller_v5.x.x_Linux_x64.deb

 

3.2 在 CentOS 7 上安裝 tar.gz 套件

CentOS 不支援 deb 安裝套件。請下載 tar.gz 套件進行安裝。我們還需要安裝相依套件，包括 Java、MongoDB、JSVC 和 CURL。

 

安裝 Java 8

檢查是否有可用的 Java 8 安裝程式。

sudo yum list java-1*

 

 

 

選擇適合你系統的版本並安裝 Java。對於我的 x86_64 平台，我使用以下指令來安裝 Java 8。

sudo yum install –y java-1.8.0-openjdk.x86_64

您也可以使用以下命令來安裝 Java 11。

sudo yum install –y java-11-openjdk.x86_64

 

Java 官方指南請參考以下連結：

https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html

 

安裝 MongoDB

Omada SDN 控制器支援 MongoDB v3 和 v4 版本。這裡我們將示範如何安裝 v4.4 版本。

 

 

下載 MongoDB 的 rpm 安裝程式。

sudo wget https://repo.mongodb.org/yum/redhat/7/mongodb-org/4.4/x86_64/RPMS/mongodb-org-4.4.25-1.el7.x86_64.rpm

 

使用 rpm 指令來安裝 MongoDB。

sudo rpm -ivh mongodb-org-server-4.4.xx-1.elx.xxx.rpm

 

安裝 jsvc

sudo yum install –y jsvc

如果你的 yum 套件庫中沒有提供 JSVC 安裝程式，請參考以下連結： 5.How to compile and install JSVC 1.1.0 or higher?

 

安裝 curl

sudo yum install –y curl

 

安裝 Omada SDN 控制器

前往 官方網站，下載 Omada SDN 控制器安裝包。打開終端機，將目錄切換到你儲存安裝套件的資料夾。

解壓縮安裝套件。

tar zxvf Omada_Controller_v5.x.x_Linux_x64.tar.gz

 

進入解壓縮後的資料夾。

cd Omada_Controller_v5.x.x_Linux_x64

安裝控制器。

sudo ./install.sh

 

4. 執行 Omada 控制器

以下是一些指令，可以幫助你檢查/更改 Omada 控制器的狀態。

• tpeap status -- 顯示控制器的狀態；
• tpeap start -- 啟動 Omada 控制器；
• tpeap stop -- 停止執行 Omada 控制器。

 

 

在你啟動 Omada 控制器之後，你可以開啟瀏覽器輸入 http://localhost:8088 或 https://localhost:8043 以存取控制器的網頁管理頁面。

 

5. How to compile and install JSVC 1.1.0 or higher

確認你已經擁有這些相依套件：autoconf、make、gcc、JDK。如果還沒有，你可以按照對應的步驟來安裝缺少的相依套件。

sudo apt install autoconf make gcc

sudo apt install openjdk-11-jdk-headless

sudo apt remove jsvc （如果你之前有透過 apt 或 yum 安裝過）

 

 

從官方網站下載源代碼：

wget https://dlcdn.apache.org/commons/daemon/source/commons-daemon-1.2.4-src.tar.gz

tar zxvf commons-daemon-1.2.4-src.tar.gz

cd commons-daemon-1.2.4-src/src/native/unix

 

編譯並安裝：

sh support/buildconf.sh

./configure --with-java=/usr/lib/jvm/java-11-openjdk-amd64 （OpenJDK-11-JDK 的預設路徑）

make

 

從你的 JSVC 路徑建立一個符號連結：

ln –s /YOUR_ABSOLUTE_PATH/commons-daemon-1.2.4-src/src/native/unix/jsvc /usr/bin/