Skip to content

Configuring up the Controller

Roberto Riggio edited this page Oct 13, 2019 · 10 revisions

Table of Contents

  1. Web GUI
  2. Adding the WTPs/VBSes
  3. Creating a new project
  4. Access control (only for Wi-Fi networks)

Web GUI

The controller web interface can be reached at: http://127.0.0.1:8888/

5G-EmPOWER Web GUI

The first time the controller is initialized, three accounts are automatically created:

Username Password Type
root root Administrator
foo foo User
bar bar User

The first account has administrator privileges, while the other two are user accounts.

Adding the WTPs/VBSes

Log in as root and click on the Device menu entry and then on WTPs or VBSes.

Adding a WTP Main Menu

Click on the (+) icon and specify the MAC address of the device that is authorized to connect to this controller. Notice how you can also add a human-readable description of the device, e.g. "First Floor, Meeting Room"

Adding a WTP

After all devices have been added and if the controller is reachable by the devices on the IP address specified in their configuration files then you should see an output like this in the controller terminal:

2019-08-24 20:54:11,829 - empower.services.ranmanager.lvapp.lvappmanager - INFO - Incoming connection from ('192.168.1.9', 40898)
2019-08-24 20:54:11,833 - empower.core.wtp - INFO - Device 00:0D:B9:30:3E:18 mode disconnected->connected
2019-08-24 20:54:11,837 - empower.core.wtp - INFO - Device 00:0D:B9:30:3E:18 mode connected->online

The same procedure applies also for adding VBSes.

The device identifiers are the following

  • WTPs: the MAC address of the OpenVSwitch bridge (br-ovs).
  • VBSes: the eNodeB id represented as a MAC address, for example, if the eNodeB id is 0xe21 then its MAC address representation will be 00:00:00:00:0E:21.

Creating a new project

The 5G-EmPOWER Controller can run multiple virtual networks on top of the same physical infrastructure. Each virtual network is called Project in 5G-EmPOWER terminology.

Projects can be created and deleted only by administrators.

Log in as root and click on the Admin menu entry and then on Projects.

List of virtual projects

Click on the (+) icon and specify a human-readable description of this project and select the owner of this project from the drop-down list. In the Wi-Fi properties section specify the SSID and the BSSID type set to "Unique". Then click on the button "Save".

Create a new Project

Notice how from this form you can also specify a PLMN id. This is necessary if you plan to use LTE features of the platform. Otherwise, this field can be left empty. If specified the PLMN id must be the same as the one specified in the EPC configuration.

Access control (only for Wi-Fi networks)

The open-source version of 5G-EmPOWER does not support WPA authentication, so you must specify the list of MAC addresses that can connect to each of the projects (by default nobody can associate). To do so click on the "ACL" tab of the project and specify the clients MAC addresses that are allowed to use the network.

Access control

At this point, any of the clients that are allowed to use the network should see the new SSID and should be able to associate to it and to reach the public Internet (if the wireless APs have a backhaul that is connected to the Internet).

Notice how the ACL for a specific project can also be modified later by the Project owner.

Clone this wiki locally