如何在 Linux 作業系統安裝 Omada 軟體控制器？

目的

本文將介紹如何在 Linux 平台安裝 Omada 軟體控制器。

需求

• Omada SDN 控制器安裝包
• Ubuntu 16.04, 18.04, 20.04, 22.04, 24.04 (v5.15.20以上)
• Debian 8, 9, 10, 11,12

介紹

Omada 軟體控制器依您的需求可支援安裝於 Windows 和 Linux 作業系統。在此我們主要介紹 Linux 的安裝方法。我們將以 Ubuntu 22.04 和為例提供 Omada SDN 控制器的安裝流程(在 Debian 的安裝方法與 Ubuntu 相同)。

安裝於 Ubuntu 22.04

在安裝 Omada 軟體控制器之前，需要先安裝 OpenJDK、MongoDB、JSVC 和其他套件。在此以 Ubuntu 22.04 為例於 Linux 安裝這些套件。

執行 command line

在 Ubuntu / Debian 環境中：按下鍵盤的 Ctrl + Alt + T 叫出 Command Line 視窗。輸入以下指令安裝 Omada 軟體控制器。

安裝 OpenJDK

Omada 軟體控制器（Linux 版本 5.15.20 及以上）需要 64 位元的 Java 17 或更高版本。以下步驟為在系統上安裝 OpenJDK 17。

• OpenJDK 17，這裡將安裝 OpenJDK 17 和 OpenJDK17 的 JSVC。

步驟 1. 更新 apt 來源

sudo apt update

步驟 2. 輸入指令安裝openJDK-17

sudo apt install -y openjdk-17-jre-headless

步驟 3. 安裝後檢查Java版本

java -version

步驟 4. 安裝 JSVC

sudo apt install -y jsvc

步驟 5. 安裝後檢查 JSVC 版本 (建議使用 v1.0.15)

jsvc -version

• 對於 OpenJDK 8，以下為安裝 OpenJDK 8 和 OpenJDK8 的 JSVC

步驟 1.使用指令安裝 OpenJDK-8 

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

步驟 2.使用指令為 OpenJDK 8 安裝 JSVC

sudo apt install jsvc

• OpenJDK 11，以下為安裝 OpenJDK 11 和 JSVC。

步驟 1. 輸入以下指令安裝 OpenJDK-11。

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

步驟 2. 安裝 JSVC 所需的套件

sudo apt install autoconf make gcc

步驟 3. 從官網下載 source codes(以 JSVC 1.2.4 為例)

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

tar zxvf commons-daemon-x.y.z-src.tar.gz

cd commons-daemon-x.y.z-src/src/native/unix

步驟 4. 編譯及安裝

sh support/buildconf.sh./configure --with-java=/usr/lib/jvm/java-11-openjdk-amd64 (OpenJDK-11-JDK 預設路徑)

make

步驟 5. 從您的 JSVC 路徑建立一軟連結：

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

備註：您可以參考以下的連結下載最新的 JSVC(1.1.0 或以上版本)：

https://archive.apache.org/dist/commons/daemon/source/

安裝 MongoDB

對於版本 v5.14.20 之前，支援 MongoDB v3.4 或 v4.4
對於版本 v5.14.20 之後，支援最高至 MongoDB v7
對於版本 v5.15.20 及以上，支援最高至 MongoDB v8

這裡以 MongoDB v4.4、v7 和 v8 為例，在系統上安裝 MongoDB。

• MongoDB v4.4安裝

步驟 1. 下載 Libssl dependency

Libssl 是在Ubuntu22.04上，下載 MongoDB 所需的必要套件，若是使用 Ubuntu22.04 前的版本，可略過步驟 1 & 2。

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

步驟2.安裝libssl

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

備註：下載連結會不定時更新，您可參考以下的連結選擇最新的下載連結：http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/

步驟 3. 匯入 public key。

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

步驟 4. 以指令建立 /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

步驟 5. 重新讀取本地封包資料庫

sudo apt update

步驟 6. 安裝 MongoDB

sudo apt install -y mongodb-org

備註：您也可以依照 MongoDB 官方指引安裝 MongoDB：https://www.mongodb.com/docs/v4.4/tutorial/install-mongodb-on-ubuntu/

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

• MongoDB v7，在此安裝 MongoDB v7。

步驟 1. 使用封包管理系統匯入 public key。如果尚未安裝 gnupg 和 curl，可透過 terminal 進行安裝：

sudo apt-get install gnupg curl

步驟 2. 匯入 MongoDB public GPG key

curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | \

sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \

--dearmor

步驟 3. 建立 Ubuntu 系統的 list 檔 /etc/apt/sources.list.d/mongodb-org-7.0.list：

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

步驟 4. 重新讀取本地封包資料庫：

sudo apt-get update

步驟 5. 安裝 MongoDB v7.0.7 套件：

sudo apt-get install -y mongodb-org=7.0.7 mongodb-org-database=7.0.7 mongodb-org-server=7.0.7 mongodb-mongosh=7.0.7 mongodb-org-mongos=7.0.7 mongodb-org-tools=7.0.7

備註：您也可以依照以下 MongoDB 官方指引安裝 MongoDB v7：

https://www.mongodb.com/docs/manual/tutorial/install-mongodb-on-ubuntu/

針對MongoDB v8，以下為安裝步驟(控制器 v5.15.20 及以上)

步驟 1. 匯入套件管理系統所使用的 public key，若系統尚未安裝 gnupg 和 curl，請在terminal中執行以下指令：

sudo apt-get install gnupg curl

步驟 2. 匯入 MongoDB public GPG key,  執行下列指令：

curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | \

sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \

--dearmor

步驟 3. 建立清單檔案，依Ubuntu 版本建立 /etc/apt/sources.list.d/mongodb-org-8.0.list

• 建立 Ubuntu 20.04（Focal）的清單檔案

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

• 建立Ubuntu 22.04 (Jammy)的清單檔案：

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

• 建立 Ubuntu 24.04 (Noble)的清單檔案：

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

步驟 4. 重新載入套件資料庫，請執行以下指令以重新載入本機套件資料庫：

sudo apt-get update

步驟 5. 安裝 MongoDB Community Server，可選擇安裝 latest stable版本，或是指定安裝 specific版本 的 MongoDB。

• 如要安裝latest stable 版本，參考下列指令：

sudo apt-get install -y mongodb-org

• 若要安裝 specific，，您必須為每個組件套件單獨指定版本號，如以下範例所示：

sudo apt-get install -y \

mongodb-org=8.0.12 \

mongodb-org-database=8.0.12 \

mongodb-org-server=8.0.12 \

mongodb-mongosh \

mongodb-org-shell=8.0.12 \

mongodb-org-mongos=8.0.12 \

mongodb-org-tools=8.0.12 \

mongodb-org-database-tools-extra=8.0.12

如果只安裝 mongodb-org=8.0.12，而未包含各個組件套件，則每個 MongoDB 套件仍會安裝 llatest(最新)版本，不會依指定的版本安裝。

備註：也可以參考以下 MongoDB 官方文件 來安裝 MongoDB v8：

Install MongoDB Community Edition - Database Manual - MongoDB Docs

安裝 Omada 軟體控制器

請至 官網，下載 Omada SDN 控制器安裝包，並依以下指令進行安裝。

sudo dpkg –i Omada_SDN_Controller_v5.x.y.z_Linux_x64.deb

備註：如您使用 OpenJDK-11 或更高的版本，JSVC 1.1.0 或更高的版本，請依以下指令進行安裝。

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

安裝 Chromium 瀏覽器 (選用)

Chromium 瀏覽器為控制器所需的選用套件。如您不需要匯出 PDF 格式的報告，可忽略此步驟。

Note:

1. 可以參考以下，選擇與系統版本相對應的 Chromium 下載連結：: https://www.linuxmint.com/download_all.php 以及原始套件資料庫： http://packages.linuxmint.com/pool/upstream/c/chromium/

2. 不同版本的控制器支援的 Chromium 版本 也不同。

步驟 1. 從 Linuxmint 下載 Chromium debian 安裝包。

wget http://packages.linuxmint.com/pool/upstream/c/chromium/chromium_x.y.z~linuxmint1+xxx_amd64.deb

步驟 2. 安裝 chromium

sudo dpkg -i chromium_x.y.z~linuxmint1+xxx_amd64.deb

步驟 3. 確認透過 returning version 安裝

chromium –version

驗證

以下有 3 個指令可協助您確認/變更 Omada 軟體控制器的狀態。

步驟 1. 啟動 Omada 控制器

tpeap start

步驟 2. 顯示控制器狀態

tpeap status

步驟 3. 停止執行 Omada 控制器

tpeap stop

結果

現在您已成功在 Linux 平台安裝 Omada SDN 控制器。

如需取得相關更多的功能及設定說明資訊，請參考 下載中心 下載您的產品手冊。