How to upgrade the Omada Software Controller
Contents
Omada Software Controller for Windows
Omada Software Controller for Linux (Deb)
Omada Software Controller for Linux (tar.gz)
This article provides configuration guidance for upgrading the Omada Software Controller installed on Windows systems and Linux systems.
- Omada Software Controller V5
This article describes how to upgrade the Omada Software Controller installed on Windows systems and Linux systems.
Omada Software Controller for Windows
After a new version of the software is released on our official website, you can upgrade your Controller.
The upgrade steps below will use the Omada Software Controller installed on a Windows 10 system as an example.
Step 1. Obtain the latest version of the software package. Choose a method below:
- Via pop-up window: Connect the PC where the Controller is installed to the internet and log in to the Controller with a Main Administrator account. The upgrade pop-up window will automatically appear in the top right corner when a new version is detected. Click Download to download it.
- Check for Updates: Connect the PC where the Controller is installed to the internet and log in to the Controller with a Main Administrator account. Go to Settings > System Settings in the Global view (non-MSP mode) or MSP view (MSP mode), then click Check for Updates in the Controller Status section.
In the pop-up window with the Release Notes, click Download to obtain the latest software version.
- Manual Download: Visit Download for Omada Software Controller | TP-Link to obtain the latest software version.
Step 2. Close the Controller and unzip the software package.
Close the Controller, unzip the software package you obtained, and use the .exe file in it to perform the upgrade.
Note: Before upgrading, we strongly recommend that you use the Backup function to back up all data to avoid data loss.
Step 3. Upgrade the Controller.
In the upgrade window, click Next.
The program will detect the old version of the Controller and ask if you want to upgrade. If you want to upgrade, click Yes to start the upgrade; if you want to cancel the upgrade, click No.
Wait until the upgrade process is complete.
Click Finish, and the installer window will close.
Omada Software Controller for Linux (Deb)
After a new version of the software is released on our official website, you can upgrade your Controller.
The upgrade steps below will use the Omada Software Controller installed on an Ubuntu 20.04 system as an example.
Step 1. Obtain the latest version of the software package. Choose a method below:
- Via pop-up window: Connect the PC where the Controller is installed to the internet and log in to the Controller with a Main Administrator account. The upgrade pop-up window will automatically appear in the top right corner when a new version is detected. Click Download to download it.
- Check for Updates: Connect the PC where the Controller is installed to the internet and log in to the Controller with a Main Administrator account. Go to Settings > System Settings in the Global view (non-MSP mode) or MSP view (MSP mode), then click Check for Updates in the Controller Status section.
In the pop-up window with the Release Notes, click Download to obtain the latest software version.
- Manual Download: Visit Download for Omada Software Controller | TP-Link to obtain the latest software version.
Step 2. Installing the Deb file using dpkg.
After obtaining the latest version of the software package (.Deb file), use the following command to install the file.
sudo dpkg -i Omada_SDN_Controller_v5.x.y.z_Linux_x64.deb
After entering the command, if the Controller is still running, the installation program will automatically stop it. If the stop fails, please manually stop the Controller using the sudo tpeap stop command.
Note: Before upgrading, we strongly recommend that you use the Backup function to back up all data to avoid data loss.
Step 3. Upgrade the Controller.
After the Controller is successfully stopped, the installation program will display the upgrade confirmation window. Use the arrow keys to choose the options and press Enter to confirm. If you select Yes, the upgrade will continue.
Wait until the upgrade process is complete.
The Controller will automatically start up.
Omada Software Controller for Linux (tar.gz)
After a new version of the software is released on our official website, you can upgrade your Controller.
The upgrade steps below will use the Omada Software Controller installed on an Ubuntu 20.04 system as an example.
Step 1. Obtain the latest version of the software package. Choose a method below:
- Via pop-up window: Connect the PC where the Controller is installed to the internet and log in to the Controller with a Main Administrator account. The upgrade pop-up window will automatically appear in the top right corner when a new version is detected. Click Download to download it.
- Check for Updates: Connect the PC where the Controller is installed to the internet and log in to the Controller with a Main Administrator account. Go to Settings > System Settings in the Global view (non-MSP mode) or MSP view (MSP mode), then click Check for Updates in the Controller Status section.
In the pop-up window with the Release Notes, click Download to obtain the latest software version.
- Manual Download: Visit Download for Omada Software Controller | TP-Link to obtain the latest software version.
Step 2. Unzip the software package.
After obtaining the latest version of the software package (.tar.gz file), use the following command to unzip the file.
tar -zxvf Omada_Controller_v5.x.y.z_Linux_x64.tar.gz
Note: Before upgrading, we strongly recommend that you use the Backup function to back up all data to avoid data loss.
Step 3. Upgrade the Controller.
Enter the extracted folder.
cd Omada_Controller_v5.x.y.z_Linux_x64
Use the installation command to upgrade the Controller.
sudo ./install.sh
Enter y to confirm the installation. An upgrade confirmation prompt will appear. Enter Yes or y to confirm and continue the upgrade.
If the Controller is still running before the installation, the installation program will automatically stop the Controller. If the stop fails, please manually stop the Controller using the sudo tpeap stop command.
After the Controller is stopped, the upgrade will begin. After the upgrade is complete, the Controller will restart.
Choose a method below to confirm the upgrade.
- Method 1: Version Confirmation
Click the icon in the top right corner of the Controller.
Click About to view the current version information of the Controller. If it matches the version you upgraded, the upgrade is successful.
- Method 2: Upgrade Detection
Go to Settings > System Settings in the Global view (non-MSP mode) or MSP view (MSP mode), then click Check for Updates in the Controller Status section.
If the result shows that your Controller is up to date, the upgrade is successful.
You have now successfully upgraded your Omada Controller.
Get to know more details of each function and configuration please go to Download Center to download the manual of your product.
Why can't I detect the latest version on my Controller (with an internet connection) when the official website has released a new version?
Re: If your Controller is connected to the internet but cannot detect the latest version, it might be because the update has just been released and hasn't been pushed yet. For urgent use, you can download and upgrade manually.
Looking for More
Is this faq useful?
Your feedback helps improve this site.
What’s your concern with this article?
- Dissatisfied with product
- Too Complicated
- Confusing Title
- Does not apply to me
- Too Vague
- Other
We'd love to get your feedback, please let us know how we can improve this content.
Thank you
We appreciate your feedback.
Click here to contact TP-Link technical support.
Recommended Products
TP-Link Community
Still need help? Search for answers, ask questions, and get help from TP-Link experts and other users around the world.
This website uses cookies to improve website navigation, analyze online activities and have the best possible user experience on our website. You can object to the use of cookies at any time. You can find more information in our privacy policy . Don’t show again
This website uses cookies to improve website navigation, analyze online activities and have the best possible user experience on our website. You can object to the use of cookies at any time. You can find more information in our privacy policy . Don’t show again
Basic Cookies
These cookies are necessary for the website to function and cannot be deactivated in your systems.
TP-Link
SESSION, JSESSIONID, accepted_local_switcher, tp_privacy_base, tp_privacy_marketing, tp_smb-select-product_scence, tp_smb-select-product_scenceSimple, tp_smb-select-product_userChoice, tp_smb-select-product_userChoiceSimple, tp_smb-select-product_userInfo, tp_smb-select-product_userInfoSimple, tp_top-banner, tp_popup-bottom, tp_popup-center, tp_popup-right-middle, tp_popup-right-bottom, tp_productCategoryType
Youtube
id, VISITOR_INFO1_LIVE, LOGIN_INFO, SIDCC, SAPISID, APISID, SSID, SID, YSC, __Secure-1PSID, __Secure-1PAPISID, __Secure-1PSIDCC, __Secure-3PSID, __Secure-3PAPISID, __Secure-3PSIDCC, 1P_JAR, AEC, NID, OTZ
Zendesk
OptanonConsent, __cf_bm, __cfruid, _cfuvid, _help_center_session, _pendo___sg__.<container-id>, _pendo_meta.<container-id>, _pendo_visitorId.<container-id>, _zendesk_authenticated, _zendesk_cookie, _zendesk_session, _zendesk_shared_session, ajs_anonymous_id, cf_clearance
Analysis and Marketing Cookies
Analysis cookies enable us to analyze your activities on our website in order to improve and adapt the functionality of our website.
The marketing cookies can be set through our website by our advertising partners in order to create a profile of your interests and to show you relevant advertisements on other websites.
Google Analytics & Google Tag Manager
_gid, _ga_<container-id>, _ga, _gat_gtag_<container-id>
Google Ads & DoubleClick
test_cookie, _gcl_au