Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
Update - 16 January 2024
Instructions below updated to most current Raspberry Pi OS, installed and tested on Raspberry Pi 5, with Omada SDN Controller v5.12.7. Confirmed that OpenJDK-17 work, which is installable through apt and for which the install instructions have been updated.
Update - 26 December 2023
Instructions below updated to most current Raspberry Pi OS, installed and tested on Raspberry Pi 5, with Omada SDN Controller v5.12.7. Note that the JAVA runtime installation instructions has been updated to OpenJDK-11.
Update - 3 June 2023
The links listed below for OpenJDK-8 no longer works. Omada SDN Controller will run on OpenJDK-11, but that requires JSVC 1.1.0 which is not in the official Raspberry Pi OS repos. It is possible to solve the dependecies to install JSVC 1.1.0, but I have not had time to update the instructions
Also see this FAQ with good info about installing the Omada SDN Controller on a number of Linux distros.
Update - 22 January 2023
Bare metal install on 64 bit Raspberry Pi OS - no Ubuntu server, no Docker. Tested with version 4 and now the latest version 5.7.4 of the Controller software. I have it running on a Model 3B+ with 1G RAM. Also running on Model 4 w/ 4G RAM.
Links have been updated and verified on most recent install
Instructions:
1. Download & install latest 64 bit LITE version of Raspberry pi OS to new sd card of your choice from the link below. Note - the legacy version of Raspberry Pi OS will not work
https://downloads.raspberrypi.org/raspios_lite_arm64/images/
This is not a guide to installing Raspberry Pi OS so I won't provide detailed instructions on that.
2. Download and install version 4.4.18 of MongoDB mongodb-server from https://www.mongodb.com/download-center/community/releases/archive
wget https://repo.mongodb.org/apt/ubuntu/dists/focal/mongodb-org/4.4/multiverse/binary-arm64/mongodb-org-server_4.4.18_arm64.deb
sudo apt install /home/<username>/mongodb-org-server_4.4.18_arm64.deb
Note this post explaining that MongoDB V4.4.19 will not work.
3. Mongodb server would normally be run as a service by doing the following commands
sudo systemctl daemon-reload
sudo systemctl enable mongod
sudo systemctl start mongod
In this case not required, as Omada controller starts the server as required.
4. Check that curl is installed
apt list curl
5. Download and install openjdk-17-jre
sudo apt install openjdk-17-jre-headless
6. Install jsvc
sudo apt install jsvc
7. If you have multiple versions of OpenJDK installed then you need to tell system which java to use
sudo update-alternatives --config java
Selection Path Priority Status
------------------------------------------------------------
0 /usr/lib/jvm/java-11-openjdk-arm64/bin/java 1111 auto mode
1 /usr/lib/jvm/java-11-openjdk-arm64/bin/java 1111 manual mode
* 2 /usr/lib/jvm/java-8-openjdk-arm64/jre/bin/java 1081 manual mode
Press <enter> to keep the current choice[*], or type selection number:
Now select the option pointing to the version of OpenJDK you want to use.
8. Download and install latest version Omada SDN controller
wget https://static.tp-link.com/upload/software/2023/202309/20230920/Omada_SDN_Controller_v5.12.7_Linux_x64.deb
sudo apt install /home/<username>/Omada_SDN_Controller_v5.12.7_Linux_x64.deb
If all went well the controller should start and you should get the following message
Install Omada Controller succeeded!
==========================
Omada Controller will start up with system boot. You can also control it by [/usr/bin/tpeap].
check omada
Starting Omada Controller. Please wait.........................................................................................................................
Started successfully.
You can visit http://localhost:8088 on this host to manage the wireless network.
========================
Now you can access the web interface of the Omada Controller by pointing you web browser from any PC on the same network to
http://<IP_address_of_Omada_Controller>:8088
- Copy Link
- Subscribe
- Bookmark
- Report Inappropriate Content
@Khaos Overall you should just be able to follow the standard installation instructions since they apply to Ubuntu.
https://www.tp-link.com/us/support/faq/3272/
The only thing I would suggest to adjust in them is once you get the Ubuntu image running, do a full system update. Then create a swap file and enable it (if you ever need to enlarge it you can do this more easily than enlarging a partition). Maybe consider RAM compression at this time too, zswap is one option, but there are more with different tricks and compression options. You should also learn about setting your "swappiness" threshold of your kernel parameters (yes that's the real name).
THEN work through the installation guide, this way you have the memory management benefits from the jump.
Hope that helps.
- Copy Link
- Report Inappropriate Content
@kilovar Thanks for this, I will try it out. I couldn't get it to work before. Do you know if the voucher system works on Raspberry pi ?
- Copy Link
- Report Inappropriate Content
EDIT
- Copy Link
- Report Inappropriate Content
Has anybody tried Running the Omada controller software on a "Rockchip"-based SBC? Like the FriendlyELEC NeoPi3 LTS, or those RockPi devices?
I see that these SBCs are compatible with "Ubuntu Core" and I suspect they can also run the other ubuntu versions.
Has anybody tried using a non-RPI SBC for this?
- Copy Link
- Report Inappropriate Content
- Copy Link
- Report Inappropriate Content
RNC1223 wrote
Has anybody tried Running the Omada controller software on a "Rockchip"-based SBC? Like the FriendlyELEC NeoPi3 LTS, or those RockPi devices?
I see that these SBCs are compatible with "Ubuntu Core" and I suspect they can also run the other ubuntu versions.
Has anybody tried using a non-RPI SBC for this?
@RNC1223 I have not tried Omada Controller on any other SBCs.
As far as Ubuntu is concerned, I ran Omada controller on Ubuntu on both Pi 3B+ and Pi4 for a long time and it worked fine - it is an option for you if Ubuntu runs on your SBC of choice.
Once the 64 bit version of Raspberry Pi OS was released I started this thread as a way to document my experiences with RaspPi OS and Pi 3B+ and Pi 4 - this is not a likely forum to find information on other boards like Rockchips and Ubuntu.
- Copy Link
- Report Inappropriate Content
Great tutorial but had to find java 8 on the RasPi Debian repo. The one listed is long gone. I also installed the newest version of MongoDB and not the one listed.
This was the only issue I had on my Pi 4B. Works great! Much better than running it my old Ubuntu Laptop.
Thank you!
- Copy Link
- Report Inappropriate Content
Thank you for this detailed installation guide - and the correction.
A few questions before i begin :-)
1. I have just installed controller on my windows 11 pc, but I would like to move it to my pi 4. Is there a way to transfer configuration (and not disturbing the router)?
2. I would like to use my WS to access controller. Is there a way to do that (using pi4 ip instead of localhost)? I assume I will need to autostart controller om reboot (preferably automatically).
They are both on the same internal network and I have no security concerns - but the controller may not know that :-)
Thnx Freddy
- Copy Link
- Report Inappropriate Content
1. Yes this is possible through the controller migration option in settings
2. I dont know what WS means and what you are asking
3. Note the links provided in the original post may not work directly. You may need to poke around at the links to find the correct files to download. I've given up trying to keep the links correct because the forum does not allow posting of links anymore
- Copy Link
- Report Inappropriate Content
#1 - I migrated from an Ubuntu laptop to my RasPi 4. It was a pretty simple task.
#2. - I can access my "RasPi Omada Controller" from the Android app and the web based shell by using the IP address of the RasPi 4. Of course I had to set-up the RasPi with a static IP and allow the Omada web ports on the RasPi firewall.
If you have a PoE switch with an open port, you should get a PoE hat for the PI!
- Copy Link
- Report Inappropriate Content
Information
Helpful: 8
Views: 76784
Replies: 122
Voters 3
