This guide covers installation of TP-Link’s Omada Software Controller on Debian 11.

At the time of writing, Omada Controller version is 5.9.31.

Update and Upgrade system

1
apt update && apt upgrade -y

Install omada dependencies

1
apt install -y openjdk-11-jdk-headless curl autoconf make gcc

Install MongoDB

Go to Mongo DB’s repository and select an appropriate server version. I’m using MongoDb Server 4.4.16

1
2
wget https://repo.mongodb.org/apt/debian/dists/buster/mongodb-org/4.4/main/binary-amd64/mongodb-org-server_4.4.16_amd64.deb
apt install -y ./mongodb-org-server_4.4.16_amd64.deb

Compile and install jsvc

Go to Apache Commons Daemon repo and select an appropriate commons version. As of writing, the latest version is 1.3.3 so that’s what I’ll use.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
mkdir -p /opt/tplink-sources && cd /opt/tplink-sources

wget -c https://dlcdn.apache.org/commons/daemon/source/commons-daemon-1.3.3-src.tar.gz -O - | tar -xz

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

sh support/buildconf.sh

./configure --with-java=/usr/lib/jvm/java-11-openjdk-amd64

make

ln -s /opt/tplink-sources/commons-daemon-1.3.3-src/src/native/unix/jsvc /usr/bin/

Download and install Omada Controller

1
2
3
cd /opt/tplink-sources
wget https://static.tp-link.com/upload/software/2023/202303/20230321/Omada_SDN_Controller_v5.9.31_Linux_x64.deb
dpkg --ignore-depends=jsvc -i ./Omada_SDN_Controller_v5.9.31_Linux_x64.deb