How to Upgrade the Omada Software Controller

Configuration Guide
Updated 08-05-2024 23:06:10 PM FAQ view icon8673
This Article Applies to: 

 

Contents

Objective

Required Devices

Introduction

Configuration

Omada Software Controller for Windows

Omada Software Controller for Linux (Deb)

Omada Software Controller for Linux (tar.gz)

Verification

Conclusion

FAQ

Objective

 

This article provides configuration guidance for upgrading the Omada Software Controller installed on Windows and Linux systems.

Required Devices

 

  • Omada Software Controller V5

Introduction

 

This article describes how to upgrade the Omada Software Controller installed on Windows and Linux systems.

Configuration

Omada Software Controller for Windows

 

After a new software version 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. When a new version is detected, the upgrade pop-up window will automatically appear in the top right corner. 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.

 

Step 2. Close the Controller and unzip the software package.

Close the Controller, unzip the software package you obtained, and use the .exe file to perform the upgrade.

 

Note: Before upgrading, we strongly recommend backing up all data using the Backup function 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're going to upgrade, click Yes to start the upgrade; if you wish 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 software version 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. When a new version is detected, the upgrade pop-up window will automatically appear in the top right corner. 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.

 

 

 

 

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 backing up all data using the Backup function 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 software version 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. When a new version is detected, the upgrade pop-up window will automatically appear in the top right corner. 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.

 

 

 

Step 2. Unzip the software package.

After obtaining the latest software package version (.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 backing up all data using the Backup function 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.

 

Verification

 

Choose the 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 Controller's current version information. If it matches the version you upgraded to, 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.

 

 

Conclusion

 

You have now successfully upgraded your Omada Controller.

FAQ

 

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.

Recommend Products

Community

TP-Link Community

Still need help? Search for answers, ask questions, and get help from TP-Link experts and other users around the world.

Visit the Community >