How to install Omada SDN controller on Linux system (above Controller 5.0.29)

Install OpenJDK

You can use the following command to install OpenJDK 8. You can also refer to the Java official guide..

sudo apt install openjdk-8-jre-headless

You can also use the following command to install OpenJDK 11. Note that if you install OpenJDK 11 or higher, you need to install JSVC version 1.1.0 and above.

sudo apt install openjdk-11-jre-headless

Install MongoDB

Omada SDN Controller supports MongoDB v3 and v4. Here we will show how to install v4.4.

Import the public key.

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

Create /etc/apt/sources.list.d/mongodb-org-4.4.list with the appropriate version of command.

#For 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

#For 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

#For 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

Reload the local package database then install MongoDB.

sudo apt update
sudo apt install mongodb-org

You can also follow the MongoDB official guide below to install different versions.

For MongoDB v4.4: Install MongoDB v4.4 Community Edition on Ubuntu

For MongoDB v3.4: Install MongoDB v3.4 Community Edition on Ubuntu

Install JSVC

If you have OpenJDK 11 or higher installed, you must install JSVC version 1.1.0 or higher, which might not be provided by some Linux distributions. You may refer to How to compile and install JSVC.

sudo apt install jsvc

Install curl

sudo apt install curl

Install Omada SDN Controller

Go to TP-Link Official Website, download the installation package of Omada SDN Controller, and install it with the following command.

sudo dpkg –i Omada_SDN_Controller_v5.x.x_Linux_x64.deb

If you use OpenJDK 11 or higher, JSVC 1.1.0 or higher, please install it with the following command.

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

CentOS doesn’t support the deb installation package. Please download the tar.gz package for installation. We still need to install the dependencies including Java, MongoDB, JSVC, and CURL.

Install Java8

Check for available installers for Java 8.

sudo yum list java-1*

Then choose the suitable version for your system and install Java. Here for my x86_64 platform, I use the below command to install Java 8.

sudo yum install java-1.8.0-openjdk.x86_64

You can also use the below command to install Java 11.

sudo yum install java-11-openjdk.x86_64

Refer to the Java official guide.

Install MongoDB

Omada SDN Controller supports MongoDB v3 and v4. Here we will show how to install v4.4.

Download the rpm installer, and use rpm command to install MongoDB.

# For x86_64 platform
sudo wget https://repo.mongodb.org/yum/redhat/8/mongodb-org/4.4/x86_64/RPMS/mongodb-org-server-4.4.11-1.el8.x86_64.rpm

# For Aarch64 platform
sudo wget https://repo.mongodb.org/yum/redhat/8/mongodb-org/4.4/aarch64/RPMS/mongodb-org-server-4.4.11-1.el8.aarch64.rpm

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

Install JSVC

sudo yum install jsvc

If there is no JSVC installers provided by your yum repositories, please refer to How to compile and install JSVC.

Install curl

sudo yum install curl

Install Omada SDN Controller

Go to the official website, download the installation package of the Omada SDN Controller. Run the Terminal, change the directory to the folder where you save the installation package.

Unzip the installation package, enter the folder and install the controller.

tar zxvf Omada_SDN_Controller_v5.x.x_Linux_x64.tar.gz
cd Omada_SDN_Controller_v5.x.x_Linux_x64
sudo ./install.sh