This guide covers only installation of Omada Software Controller on Red Hat Enterprise Linux 8. Script was used to create amazon virtual machine on AWS. For how to create EC2 instance setup, you can follow quick guide how to install on amazon linux where you choose Red Hat instead of Amazon Linux. You can also simply look up in aws documentation.

 

If you are looking for other guides tested with Amazon AWS free tier:

• Amazon Linux
• Debian 11 "bullseye" (amd64)
• SUSE Linux Enterprise server 15
• Ubuntu 22.04 LTS (amd64) | Ubuntu 22.04 LTS (arm64)
• Debian10/Ubuntu20.04/CentOS8 with Docker

 

Other guides:

• Raspberry Pi OS (arm64)

 

At the time of creation of this guide Omada Software Controller for linux v5.4.6 is used.

 

For Red Hat Linux Enterprise 8 mongodb and jsvc are not available, mongodb repo can be used and jsvc has to be manually compiled that is why for this guide Java11 is used.

 

Script below works with free tier on amazon aws, but Red Hat Enterprise 8 requires additional ram, 1GB is not enough. For this guide we resolve it by creating swap file that is why it is first step in this guide.

 

Please copy and paste from script file in attachment of this post. If you decide to copy directly from here, then please be aware:

AS LONG AS URLS IN BOLD ARE NOT WHITELISTED FOR THIS FORUM, PLEASE DO NOT COPY AND PASTE ANYTHING FROM TEXT BELLOW WHICH IS IN BOLD AND SMALLER TEXT SIZE. I HAD TO USE CUSTOM FONT ON THOSE LINES FOR ABILITY TO POST AS THIS FORUMS SOFTWARE MARKS THEM AS ILLEGAL LINKS

 

# Set vars (If there is later release, edit OMADAURL variable, same is valid for JSVCURL)

OMADAURL="https://static.tp-link.com/upload/software/2022/202207/20220729/Omada_SDN_Controller_v5.4.6_Linux_x64.tar.gz"

# jsvc source URL from Apache Download Center
JSVCURL="𝐡𝐭𝐭𝐩𝐬://𝐝𝐥𝐜𝐝𝐧.𝐚𝐩𝐚𝐜𝐡𝐞.𝐨𝐫𝐠/𝐜𝐨𝐦𝐦𝐨𝐧𝐬/𝐝𝐚𝐞𝐦𝐨𝐧/𝐬𝐨𝐮𝐫𝐜𝐞/𝐜𝐨𝐦𝐦𝐨𝐧𝐬-𝐝𝐚𝐞𝐦𝐨𝐧-𝟏.𝟑.𝟏-𝐬𝐫𝐜.𝐭𝐚𝐫.𝐠𝐳"

# Folders where sources will be downloaded
OMADASOURCES="/opt/tplink-sources"
APACHESOURCES="/opt/𝐝𝐥𝐜𝐝𝐧.𝐚𝐩𝐚𝐜𝐡𝐞.𝐨𝐫𝐠"

SWAPSIZE="1G"

 

# do not edit following variables if you do not know what you do

OMADATARGZ=$(echo "${OMADAURL}" | awk '{split($0,a,"/"); print a[9]}') && echo "Omada installer filename set: ${OMADATARGZ}"
MYINSTALLERFOLDER=$(echo "${OMADATARGZ}" | sed 's/\.tar\.gz//') && echo "Omada install folder set: ${MYINSTALLERFOLDER}"
MYOMADAVERSION=$(echo "${OMADATARGZ}" | awk '{split($0,a,"_"); print a[4]}') && echo "Omada version: ${MYOMADAVERSION}"

 

# If you use any other instance type with higher ram or simply more than 1GB ram or you already have swap file, then you can skip first step for swap file creation below.

# 1. Create swap file
fallocate -l ${SWAPSIZE} /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
cat <<EOF_fstab | tee -a /etc/fstab
/swapfile     swap     swap     defaults     0     0
EOF_fstab
cat <<EOF_sysctl | tee -a /etc/sysctl.conf
vm.swappiness=10
EOF_sysctl

 

# 2. Add mongodb repo
cat <<"EOF" | tee /etc/yum.repos.d/mongodb-org-4.4.repo
[mongodb-org-4.4]
name=MongoDB 4.4 Repository
baseurl=https://repo.mongodb.org/yum/redhat/8/mongodb-org/4.4/x86_64
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-4.4.asc
EOF

 

# 3. upgrade system then install omada dependencies
yum update -y && yum install -y wget curl java-11-openjdk-devel.x86_64 mongodb-org autoconf make gcc

 

# 4. Compile and install jsvc

mkdir -p ${APACHESOURCES} && cd ${APACHESOURCES}
# download source
wget -c ${JSVCURL} -O - | tar -xz 
# configure and compile
cd commons-daemon-1.3.1-src/src/native/unix
sh support/buildconf.sh
# "/usr/lib/jvm/java-11-openjdk" is the default installation path of OpenJDK-11 on RHEL 8
./configure --with-java=/usr/lib/jvm/java-11-openjdk
make
# Create a soft link from your JSVC path
ln -s ${APACHESOURCES}/commons-daemon-1.3.1-src/src/native/unix/jsvc /usr/bin/

 

# 5. download and install omada installer
mkdir -p ${OMADASOURCES} && cd ${OMADASOURCES}
wget -c ${OMADAURL} -O - | tar -xz 
# Make scripts and binaries executable
chmod +x ${MYINSTALLERFOLDER}/*.sh
chmod +x ${MYINSTALLERFOLDER}/bin/*

 

# 6. Install omada controller
cd ${MYINSTALLERFOLDER}
./install.sh -y