Which ports do Omada Controller and EAP Discovery Utility use?

Programs use specific ports to send or receive data via a network. An Omada software controller or EAP Discovery Utility uses the ports on the host, while an Omada hardware controller uses the ports on its own hardware.

Ports fall into two groups: TCP (Transmission Control Protocol) ports and UDP (User Datagram Protocol) ports. Port numbers are limited, ranging from 1 to 65535 among each group. Such fact gives rise to a port collision when a program tries to use a certain port on a host, only to find the very port is occupied by another program.

From this article, you can learn which ports an Omada controller and an EAP Discovery Utility use, and how to troubleshoot a port-related problem when it happens.

An overview of the default ports

The ports which Omada Controller and EAP Discovery Utility used by default are listed in the following table.                                                                                               

Note: UDP 27001 and TCP 27002 are used during initialization check only for Controller Software V3.2.4 and earlier. For Controller Software V3.2.5 or above, an Omada controller initializes without checking other controllers in the LAN.

Examples of Omada Controller using ports

In this section, we take two examples to explain how Omada Controller uses ports.

• Initialization Check (Only for Controller Software V3.2.4 and earlier) 

When an Omada controller initializes, it should confirm that no other controller is running in the LAN. Otherwise, it stops initializing and launches the web page of the running controller instead. A conversation takes place as shown in the following figure and table.

Note: UDP 27001 and TCP 27002 are used during initialization check only for Controller Software V3.2.4 and earlier. For Controller Software V3.2.5 or above, an Omada controller initializes without checking other controllers in the LAN.

• When the Omada controller discovers an EAP

When an EAP is powered on, and Omada controller in the LAN can discover it. A conversation takes place as shown in the following figure and table.

How to change the port used by Omada Software Controller

You can change the part of the ports used by the Omada Software Controller if necessary, for example, some programs on your PC use the same ports as the Omada Controller, which causes the Controller cannot work properly.

• For Controller v3.x

Search the path where you install the software controller. Enter its properties subfolder, find the configuration files and items where the required ports are set according to the following table.

Note:

1. TCP 27217 is used to access the built-in database for Controller Software V3.0.0 or above. Before Controller Software V3.0.0, TCP 27017 was used instead.

2. If you change http.connector.port 8088 or https.connector.port 8043, the port used in the portal authentication process also changes accordingly.

3. For Omada Software Controller V3.2.4 and earlier, If you want to use multiple Omada Controllers in a LAN, try changing the controller.discovery.port 27001.

4. Port 29810, 29811, and 29812 are required for EAP discovery, adoption, and management. As Omada devices are supposed to work with these ports, don’t change them.

• For Controller above v4.x

Omada Software Controller supports changing the port numbers used for web management and portal on its web interface.

Go to Settings -> Controller -> Access Config, there are three ports you can change: HTTPS Port for the Controller, HTTPS Port for Portal, and HTTP Port for Portal. The modification of the port number will take effect after you restart the Controller.

In addition, you could also change the HTTP Port for the Controller and the Port for accessing the built-in database (8088 and 27217 by default).

Search the path where you install the software controller. Enter its properties subfolder, you can change these two ports in the file omada.properities,

manage.http.port=8088

eap.mongod.port=27217