Introduction:
Omada Software Controller allows for centralised control over your TP-Link Omada network setup. The Software Controller is free to use, allowing users to manage up to 1500 devices. This guide will teach how to install the controller on an Ubuntu 20.04 server.
Prerequisites:
Before beginning the installation of the controller, there are dependencies that have to be installed in order for the controller to work. These Include:
- Java 8
- MongoDB
- JSVC
Begin with updating local packages:
1
sudo apt update
Next, install Java 8, MongoDB and JSVC:
1
2
3
sudo apt-get install openjdk-8-jre-headless -y
sudo apt-get install mongodb -y
sudo apt-get install jsvc -y
Start MongoDB and check that it is running:
1
2
3
sudo systemctl start mongodb
sudo systemctl enable mongodb
sudo systemctl status mongodb
If all is working the output should be as follows:
1
2
3
4
5
6
7
8
9
10
11
Output:
● mongodb.service - An object/document-oriented database
Loaded: loaded (/lib/systemd/system/mongodb.service; enabled; vendor preset: enabled)
Active: active (running) since Thu 2023-07-20 22:33:26 UTC; 1min 49s ago
Docs: man:mongod(1)
Main PID: 859 (mongod)
Tasks: 23 (limit: 2257)
Memory: 111.9M
CGroup: /system.slice/mongodb.service
└─859 /usr/bin/mongod --unixSocketPrefix=/run/mongodb --config /etc/mongodb.conf
Installation:
Visit the TP-Link Website for the newest installation of the Software Controller. As of the time of writing, the latest version is v5.9.31. So that is what I will be using today.
Scroll down on the Website till you find the Linux tar.gz then right click on the download button and copy the link.
After coping the link we will now use the wget command to download the file to our system.
1
wget https://static.tp-link.com/upload/software/2023/202303/20230321/Omada_SDN_Controller_v5.9.31_Linux_x64.tar.gz
Unzip the file:
1
tar zxvf Omada_SDN_Controller_v5.9.31_Linux_x64.tar.gz
The name of the file may differ depending on the version downloaded.
List the files:
1
ls
1
2
3
4
Output:
Omada_SDN_Controller_v5.9.31_Linux_x64
Omada_SDN_Controller_v5.9.31_Linux_x64.tar.gz
Enter the Directory
1
cd Omada_SDN_Controller_v5.9.31_Linux_x64
Finally run the install script:
1
sudo bash install.sh
Enter y to install the Omada Controller.
1
2
3
Output:
Omada Controller will be installed in [/opt/tplink/EAPController] (y/n): y
When the install is succesful you will be met with:
1
2
3
4
5
6
Install Omada Controller succeeded!
==========================
Omada Controller will start up with system boot. You can also control it by [/usr/bin/tpeap].
Starting Omada Controller. Please wait.............................
Started successfully.
You can visit http://localhost:8088 on this host to manage the wireless network.
Now go to http://server-ip:8088 to begin setup of the Omada Controller.
Conclusion:
With a successful installation of the Omada Controller, you will now be able to control your Omada Devices in a centralised environment for quick management within your Local Network.