Installing TP-Link Omada SDN Controller on a Debian-based LXC

From Da Nerd Mage Wiki
Jump to navigation Jump to search
Proven on:
Logo Debian.png
12 (bookworm) 4 cores, 4GB RAM, 8GB storage

Start with the prerequisites:

  • sudo apt update && sudo apt install openjdk-17-jre-headless jsvc curl gnupg -y
    • wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1-1ubuntu2.1~18.04.23_amd64.deb
    • sudo dpkg -i libssl1.1_1.1.1-1ubuntu2.1~18.04.23_amd64.deb
  • 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
  • sudo systemctl start mongod.service
  • sudo systemctl status mongod
  • sudo systemctl enable mongod

Install SDN:

NOTE: The download page (to check current versions etc...) fails to show the Linux versions if you let it redirect to country-local versions. Actua, functional download page is here.

  • sudo wget wget https://static.tp-link.com/upload/software/2024/202402/20240227/Omada_SDN_Controller_v5.13.30.8_linux_x64.tar.gz
  • tar zxvf Omada_SDN_Controller_v5.12.7_linux_x64.tar.gz
  • cd Omada_SDN_Controller_v5.12.7_linux_x64
  • sudo bash ./install.sh

or (Tho this seems to fail weirdly whenever they update the version while the tar.gz version doesn't):

  • wget https://static.tp-link.com/upload/software/2024/202402/20240227/Omada_SDN_Controller_v5.13.30.8_linux_x64.deb
  • sudo dpkg -i ./Omada_SDN_Controller_v5.13.22_Linux_x64.deb

Upon install, Omada Controller will start up. Eventually. It does seem to take a VERY long time for it's first start...

https://SERVERADDRESS:8043/

CERTS!!!

You'll need to have your proper certs downloaded & then mess with making a .PFX file from them...

(Really, just Part B, Step 1 at that link.)

  • openssl pkcs12 -export -out YOURFQDN.pfx -inkey YOURKEY.key -in YOURCERT.crt -certfile YOURCERT.crt

Where:

  • YOURFQDN
    • is the name of your Omada server
  • YOURKEY.key
    • Is your key file
  • YOURCERT.crt
    • is your certificate file

Then install/update via the UI & fully reboot the server/VM/LXC to activate it... :(