Skip to content

Configuring up the Controller

Roberto Riggio edited this page Nov 9, 2019 · 10 revisions

Table of Contents

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

Introduction

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

5G-EmPOWER Web GUI Login Page

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. Notice how there is only one administrator account in the controller.

Login as root and you will be presented the following page:

5G-EmPOWER Web GUI

Adding the WTPs/VBSes

Click on the Devices menu entry and then on WTPs or VBSes.

Adding a WTP Main Menu

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

Adding a WTP Modal

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

You can follow the same procedure to add the VBSes. The only difference is that in this case you need to convert the eNodeB ID into 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 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 Create Project icon and specify a human-readable description of the project and then select the owner of this project from the drop-down list.

In the Wi-Fi properties section you can specify the SSID. In the LTE properties section you can instead specify the network MCC and MNC. Make sure to use the same values as the ones specified in your EPC configuration.

Notice how you do not need to specify the MCC/MNC if you want to use only the Wi-Fi features and, conversely, you do not need to specify the SSID if you want to use only the LTE features.

Finally, click on the button Create.

Create a new Project

Access control (only for Wi-Fi networks)

The open-source version of the controller 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). The ACL for a specific project can only be modified by the Project owner.

Login as a normal user, e.g. foo, and select a project by clicking on the Select icon in the dashboard. The name of your project will appear on the menu on the left.

5G-EmPOWER Web GUI

Click on the name of the project and then scroll down to the ACL section. Then click on the Add Station icon and specify the MAC address of the client together with a short human-readable description, e.g. "Foo's iPhone".

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).