Guide to Installing Omada Software Controller on Raspberry Pi OS - V5

Guide to Installing Omada Software Controller on Raspberry Pi OS - V5

Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-01-30 18:35:03 - last edited 2022-09-01 08:57:09
Hardware Version:
Firmware Version:

Bare metal install on 64 bit Raspberry Pi OS - no Ubuntu server, no Docker.  Tested with version 4 and now the latest version 5 of the Controller software. I have it running on a Model 3B+. but with 1G ram likely not a great production machine.  Will definitely be better on Model 4 w/ 4G ram.

 

Instructions:

 

1. Download & install latest 64 bit version of Raspberry pi OS to new sd card of your choice from the link below. 
    https://downloads.raspberrypi.org/raspios_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.11 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.11_arm64.deb
   sudo apt install /home/pi/mongodb-org-server_4.4.11_arm64.deb

 

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-8-jre
   wget http://security.debian.org/debian-security/pool/updates/main/o/openjdk-8/openjdk-8-jre-headless_8u312-b07-1~deb9u1_arm64.deb
   sudo apt install /home/pi/openjdk-8-jre-headless_8u312-b07-1~deb9u1_arm64.deb

 

6. Install jsvc
   sudo apt install jsvc
   
6. If you install JSVC before OpenJDK-8-JRE then JSVC by default installs openjdk-11-jre, which does not work with Omada controller.

7. If you have both OpenJDK-8-JRE and OpenJDK-11-JRE 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 Option 2 pointing to java-8

 

8. Download and install latest version Omada SDN controller
   wget https://static.tp-link.com/upload/software/2022/202201/20220120/Omada_SDN_Controller_v5.0.30_linux_x64.deb
   sudo apt install /home/pi/Omada_SDN_Controller_v5.0.30_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.
========================

  4      
  4      
#1
Options
1 Accepted Solution
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5-Solution
2022-04-26 05:59:28 - last edited 2022-04-30 20:06:38

  @kilovar 

For the newer versions I was getting the error:
 

 omadac : Depends: mongodb-server (< 1:4.0.0) but it is not installable or
                   mongodb-10gen (< 4.0.0) but it is not installable or
                   mongodb-org-server (< 4.0.0) but 4.4.13 is installed
 

 

It worked using instead:
dpkg -i --ignore-depends=jsvc,mongodb-server Omada_SDN_Controller_v5.1.7_Linux_x64.deb
Recommended Solution
  4  
  4  
#3
Options
17 Reply
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS (For Controller v5)
2022-02-08 08:28:54

Dear @kilovar

 

Thank you for your sharing on the community!

 

This guide is applied to Omada Controller v5, I'd suggest you add it in the subject title of this post. Cheers!

2022 TP-Link Wi-Fi 7 Product Launch Event | Watch the Replay at https://www.tp-link.com/us/wifi7/event/.
  0  
  0  
#2
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5-Solution
2022-04-26 05:59:28 - last edited 2022-04-30 20:06:38

  @kilovar 

For the newer versions I was getting the error:
 

 omadac : Depends: mongodb-server (< 1:4.0.0) but it is not installable or
                   mongodb-10gen (< 4.0.0) but it is not installable or
                   mongodb-org-server (< 4.0.0) but 4.4.13 is installed
 

 

It worked using instead:
dpkg -i --ignore-depends=jsvc,mongodb-server Omada_SDN_Controller_v5.1.7_Linux_x64.deb
Recommended Solution
  4  
  4  
#3
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-05-03 00:20:13

  @kilovar The java 8 package doesn't seem to be available anymore. I have found the same version for ubuntu, but I am too much of a noob to know if it is the same thing or if it will not work on this version of linux or not.

 

Do you have an updated link?

 

I will experiment and see what happens. I was hoping to not have to go back and forth on this too much though.

 

Thank you for the guide though!

  0  
  0  
#4
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-05-03 01:13:40

  @VinGGR 

 

Can you please tell me how to apply this. I am a linux noob and still learning. 

  0  
  0  
#5
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-05-03 02:07:51

Dbert wrote

  @kilovar The java 8 package doesn't seem to be available anymore. I have found the same version for ubuntu, but I am too much of a noob to know if it is the same thing or if it will not work on this version of linux or not.

 

Do you have an updated link?

 

I will experiment and see what happens. I was hoping to not have to go back and forth on this too much though.

 

Thank you for the guide though!

 @Dbert It is still available at the same location, but the name of the file changed to a newer version - openjdk-8-jre-headless_8u322-b06-1~deb9u1_arm64

 

Unfortunately there are new rules on this site that does not allow me to post links anymore, so follow the link to the directory holding the files posted previously and there you will find the fill name I posted above

  0  
  0  
#6
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-06-23 14:16:20

  @kilovar I'm running Omana Software Controller on a RPi 3B (1GB RAM) for years now. And Version4 was running really well.

But since the upgrade to Omada Version 5, which needed a clean install, my RPi runs out of RAM very fast and then isn't responsive at all, no SSH, nothing... (no screen connected, so I don't know what would be there).

 

What RPi do you use to run Omana Software Controller 5?

 

Do you know any configs to size the down the controllers resources? I used htop to inspect the process and it eats up all the RAM. 

 

I just run a very small network with 2 EAPs and a Portal for guest to login

  0  
  0  
#7
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-06-23 15:27:36
@Khaos I was able to get V5 to install on RPi 3B but I've never tried running it as a production system. Just watching the memory usage was enough indication to know that it would not work. I currently run Omada SDN V5 on a RPi 4B w/ 4GB RAM and it runs flawless with 4 EAPs and Omada router. Looking at the total memory use it seems to max out around 2GB, so I think you'll be able to run it fine on a 2GB RPi 4B. But since the RPi3B is only available in 1GB version I just dont see it working
  0  
  0  
#8
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-06-23 17:05:09

  @kilovar I see. Thank you for the fast answer

  0  
  0  
#9
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-07-01 18:49:57

@Khaos I fear that you are getting a bit of inaccurate information.  A raspberry pi 3B should have no issue running an install of Omada .... especially on a Raspberry Pi OS Lite install.  I suspect what has happened with your install is that you have not enabled RAM compression or a swap file/partition.  I currently run Omada v5 on a Raspberry Pi 3B with an Ubuntu server install and it runs flawlessly, has been for a few months straight (aside from the reboots needed due to some software updates).  It will need to be able to swap out pages on occassion but this is certainly no reason to go run down a new Pi4, especially in today's market.  Swap partitions/files are tried and true methods of dealing with infrequent paging needs.  Add something like RAM compression and lessen the need for paging even more. As you can see, there is PLENTY of CPU cycles available to handle a little memory compression.  I suspect that, compared to Ubuntu Server, there is even less overhead in a Raspberry Pi OS Lite install, though I haven't tested that personally.  Give it a try, might save you the sticker shock of a Pi4 and the frustration of locating one, you certainly have nothing to lose.

 

  0  
  0  
#10
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-07-01 19:06:52

  @jomiller48 that sounds wonderful!

I also use Ubuntu server. I'll try to find a tutorial for that matter and have a try :)

  0  
  0  
#11
Options