TP-Link Omada Installation on Ubuntu 20.04

These instructions will detail how to install TP-Link Omada software controller onto Ubuntu 20.04. I am starting with a freshly built Ubuntu 20.04 instance that is fully up to date.

Install misc software

Install OpenSSH (optional, but necessary if you want to connect to the server remotely via SSH):

sudo apt update && sudo apt install openssh-server -y

You should now be able to connect to your Ubuntu server remotely via SSH. You can use the command ‘ip a’ to see your IP address if you do not know what it is.

Install dependencies (OpenJDK 8, curl, jsvc):

sudo apt update && sudo apt install openjdk-8-jre-headless jsvc curl -y

Install MongoDB

To install MongoDB, I followed the excellent instructions from Digital Ocean located here: https://www.digitalocean.com/community/tutorials/how-to-install-mongodb-on-ubuntu-20-04

curl -fsSL https://www.mongodb.org/static/pgp/server-4.4.asc | sudo apt-key add -
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
sudo apt update && sudo apt install mongodb-org

Start the MongoDB service:

sudo systemctl start mongod.service

Check MongoDB service status (optional):

sudo systemctl status mongod

You should see that the service is running.

Enable MongoDB on startup:

sudo systemctl enable mongod

Download and install latest TP-Link Omada software controller:

sudo wget https://static.tp-link.com/upload/software/2022/202203/20220322/Omada_SDN_Controller_v5.1.7_Linux_x64.tar.gz
tar zxvf Omada_SDN_Controller_v5.1.7_Linux_x64.tar.gz
cd Omada_SDN_Controller_v5.1.7_Linux_x64/
sudo bash ./install.sh

That’s it! Once the server has been installed, you can connect to your instance of Omada software controller by navigating to http://[server IP]:8088