How to install Omada Software Controller on Linux system

內容

目的

需求

介紹

安裝

安裝於 Ubuntu 22.04

安裝於 CentOS 7

確認

結果

目的

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

需求

• Omada SDN 控制器安裝包
• Ubuntu 16.04, 18.04, 20.04, 22.04
• CentOS 6, 7
• Debian 8, 9, 10, 11

介紹

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

安裝

我們將以 Ubuntu 22.04 和 CentOS 7 為例展示 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 的環境支援 Java-64bit version 8 或以上版本。在此我們將協助您在系統上安裝 OpenJDK 8 和 OpenJDK 11。您可依需求選擇要安裝的版本。

• OpenJDK 8，我們將協助您安裝 OpenJDK 8 和 JSVC。

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

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

步驟 2. 輸入以下指令安裝 JSVC for OpenJDK 8。

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

Omada 軟體控制器支援 MongoDB v3 和 v4。從 5.14.20 版本，Omada 軟體控制器最高可支援 MongoDB v7。在此我們以 MongoDB 4.4 和 v7 為例，協助您在系統中安裝 MongoDB。您可依需求選擇要安裝的版本。

• MongoDB v4.4。我們將協助您在系統中安裝 MongoDB v4.4。

步驟 1. 下載 Libssl 套件。

Libssl 在 Ubuntu22.04 中是下載 MongoDB 必要的相依套件。如您下載的 Ubuntu 版本在 22.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/

安裝 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

安裝於 CentOS 7

CentOS 不支援 deb 安裝封包。請下載 tar.gz 封包進行安裝。另外還需要安裝的套件包含 Java、MongoDB、JSVC 和 CURL。

執行 command line

點擊滑鼠右鍵後會跳出一跳出式選單，請點擊 Open Terminal 以開啟 Command Line 功能。接著請依照安裝指引輸入指令以安裝您的 Omada 軟體控制器。

安裝 OpenJDK

適用於 Linux 的 Omada 軟體控制器支援 Java-64bit version 8 及以上版本。在此協助您在系統安裝 OpenJDK 8 和 OpenJDK。請依您的需求選擇合適的版本進行安裝。

• Java 8，在此將協助您安裝 OpenJDK 8 和 OpenJDK 8 適用的 JSVC。

步驟 1. 檢查 OpenJDK 8 的可用安裝程式。

sudo yum list java-1*

步驟 2. 選擇適合您系統的版本並安裝 OpenJDK。在 x86_64 平台，我們使用以下的指令安裝 OpenJDK 8。

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

步驟 3. 為 OpenJDK 8 在您的系統安裝 JSVC。

sudo yum install –y jsvc

• Java 11，在此協助您安裝 OpenJDK 11 和 OpenJDK 11 適用的 JSVC。

步驟 1. 檢查 OpenJDK 8 的可用安裝程式。

sudo yum list java-1*

步驟 2. 選擇適合您系統的版本並安裝 OpenJDK。在 x86_64 平台，我們使用以下的指令安裝 OpenJDK 11。

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

步驟 3. 安裝 JSVC 所需套件。

sudo apt install autoconf make gcc

步驟 4. 從官網下載 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

步驟 5. 編譯及安裝

sh support/buildconf.sh./configure --with-java=/usr/lib/jvm/java-11-openjdk-amd64 (default path of OpenJDK-11-JDK)

make

步驟 6. 從您的 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

Omada 軟體控制器支援 MongoDB v3 和 v4。從 5.14.20 版本，Omada 軟體控制器可支援到至MongoDB v7。在此以 MongoDB v4.4 和 v7 為例協助您在系統安裝 MongoDB。您可依需求選擇合適的版本進行安裝。

• MongoDB v4.4。在此協助您在系統安裝 MongoDB v4.4。

步驟 1. 下載 MongoDB 的 rpm 安裝程式。

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

備註：下載連結會不定時更新，您可參考以下的連結選擇最新的 mongodb-org 下載連結：

https://repo.mongodb.org/yum/redhat/7/mongodb-org/4.4/x86_64/RPMS/

步驟 2. 使用 rpm 指令安裝 MongoDB。

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

備註：您也可以使用以下指令安裝 Java 11。

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

• MongoDB v7。在此將協助您在系統中安裝 MongoDB v7。

步驟 1. 建立 /etc/yum.repos.d/mongodb-org-7.0.repo 檔後您即可直接使用 yum 安裝 MongoDB，並輸入以下 repository 資訊：

[mongodb-org-7.0]

name=MongoDB Repository

baseurl=https://repo.mongodb.org/yum/redhat/7/mongodb-org/7.0/x86_64/

gpgcheck=1

enabled=1

gpgkey=https://pgp.mongodb.com/server-7.0.asc

步驟 2. 安裝 MongoDB v7.0.7 安裝包。

sudo yum 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

步驟 3. 確認安裝結果。

yum list | grep mongodb

備註：您也可依如下連結的 MongoDB 官網指引安裝 MongoDB v7：https://www.mongodb.com/docs/manual/tutorial/install-mongodb-on-red-hat/

安裝 Omada SDN 控制器

步驟 1. 請至 官網，下載 Omada SDN 控制器安裝包。開啟 Terminal 並將路徑變更至您儲存安裝包的路徑。解壓縮安裝包。

sudo yum install –y curl

tar zxvf Omada_Controller_v5.x.y.z_Linux_x64.tar.gz

步驟 2. 輸入解新縮資料夾。

cd Omada_Controller_v5.x.y.z_Linux_x64

步驟 3. 安裝控制器。

sudo ./install.sh

安裝 Chromium 瀏覽器 (選用)

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

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

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

備註：Y您可參考以下連結，選擇適用於您的系統版本的 Chromium：

https://www.linuxmint.com/download_all.php

軟體包 pool 如下連結：

http://packages.linuxmint.com/pool/upstream/c/chromium/

步驟 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 控制器。

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