Make sure you follow the instructions in "Deploying Orchestrator" for successful installation of Orchestrator and the instructions in "AGW Configuration" to provision and configure your Access Gateway (AGW).
Connect your eNodeB to the
eth1 interface of Magma gateway. Magma uses
as the default
S1 interface. If you have more than one eNodeB, use an L2
switch to connect all
S1 interfaces. For debugging purposes, you may find it
particularly useful to do the following:
- Configure a managed L2 switch (e.g. this NETGEAR) to mirror port X and port Y to port Z.
- Connect port X of that switch to the
eth1interface on your AGW.
- Connect the WAN interface on your enodeB to port Y on the switch.
- Connect your host to port Z on the switch.
This will allow you to do live packet captures with Wireshark from your host to debug the S1 interface between the enodeB and the AGW (filter for SCTP).
Magma officially supports auto-configuration of the following devices:
- Baicells Nova-243 Outdoor FDD/TDD eNodeB
- Firmware Version: BaiBS_RTS_3.1.6
- Firmware Version: BaiBS_RTSH_184.108.40.206
- Baicells mBS1100 LTE-TDD Base Station
- Firmware Version: BaiStation_V100R001C00B110SPC003
- Baicells Neutrino-244 ID FDD/TDD enodeB
Magma supports the following management protocols:
- TR-069 (CWMP)
Magma supports configuration of the following data models:
- TR-196 data model
- TR-181 data model
The Magma team plans to add support for more devices and management protocols.
To handle automatic configuration of eNodeB devices on your network, Magma
enodebd service. The
enodebd service is responsible for handling
the O&M interface between Magma and any connected eNodeB. The
can be disabled if you configure your eNodeB devices manually.
Use the enodeB's management interface to set the management server URL to
baiomc.cloudapp.net:48080. Magma uses DNS hijacking to point the eNodeB to
the configuration server being run by enodebd.
will point to
220.127.116.11, the IP address that the TR-069 ACS is
being hosted on.
Provisioning Your eNodeB on NMS
Get the serial number of your eNodeB, you'll need it to register the device. On the NMS, navigate to "eNodeB Devices" in the sidebar, and hit "Add EnodeB". Configure the RAN parameters as necessary. Note that fields left blank will be inherited from either the network or gateway LTE parameters:
Then, go back to the "Gateways" page and edit the LTE configuration of your AGW. Enter the serial number of the enodeB you just provisioned into the "Registered eNodeBs" field, then hit save.
After connecting your eNodeB(s) to the gateway through the
eth1 interface, you
may want to check a few things if auto-configuration is not working.
Magma will be running a DHCP server to assign an IP address to your connected
eNodeB. Check if an IP address gets assigned to your eNodeB by either checking
the eNodeB UI or monitoring the
journalctl -u magma@dnsd -f # Check for a similar log # DHCPDISCOVER(eth1) 48:bf:74:07:68:ee # DHCPOFFER(eth1) 10.0.2.246 48:bf:74:07:68:ee # DHCPREQUEST(eth1) 10.0.2.246 48:bf:74:07:68:ee # DHCPACK(eth1) 10.0.2.246 48:bf:74:07:68:ee
enodebd_cli.py tool to check basic status of eNodeB(s). It also allows
for querying the value of parameters, setting them, and sending reboot requests
to the eNodeB. The following example gets the status of all connected eNodeBs.
It may take time for the eNodeB to start transmitting because
reboot the eNodeB to apply new configurations. Monitor the progress of
using the following command
journalctl -u magma@enodebd -f # Check for a similar log # INFO:root:Successfully configured CPE parameters!
Manual configuration of connected eNodeB(s) is always possible. Magma was tested
with multiple Airspan eNodeB models configured through NetSpan management
When manually configuring eNodeBs, make sure the eNodeB configuration matches
that of the Magma cellular configuration. Pay special attention to the
When manually configuring your eNodeB, you can use the manufacturers tools or interfaces to monitor and troubleshoot the eNodeB configuration.
You can also listen to the
S1 interface traffic and validate a proper
setup and handshake. Below are the
SCTP packets exchanged between the eNodeB
Source Destination Protocol Length Info 10.0.2.246 10.0.2.1 SCTP 66 INIT 10.0.2.1 10.0.2.246 SCTP 298 INIT_ACK 10.0.2.246 10.0.2.1 SCTP 278 COOKIE_ECHO 10.0.2.1 10.0.2.246 SCTP 60 COOKIE_ACK 10.0.2.246 10.0.2.1 S1AP 106 S1SetupRequest 10.0.2.1 10.0.2.246 SCTP 62 SACK 10.0.2.1 10.0.2.246 S1AP 90 S1SetupResponse 10.0.2.246 10.0.2.1 SCTP 62 SACK 10.0.2.246 10.0.2.1 SCTP 66 HEARTBEAT 10.0.2.1 10.0.2.246 SCTP 66 HEARTBEAT_ACK
Connecting your first user
Once your eNodeB starts transmitting, UEs may attempt to attach to your network. Your AGW will reject these attach requests due to authentication failure until you add the corresponding IMSI to the subscriber database.
On the NMS, go to "Subscribers", then "Add Subscriber". The SIM secrets can be entered either in hex or base64-encoded binary:
Subscriber information will eventually propagate to the AGW. You can verify
using the CLI command
Validating UE connectivity
Validating UE connectivity can be done from the UE side, MME side, or by
listening to traffic on the
Below is a typical UE attach procedure as captured on the
Source Destination Protocol Info 10.0.2.246 10.0.2.1 S1AP/NAS-EPS InitialUEMessage, Attach request, PDN connectivity request 10.0.2.1 10.0.2.246 S1AP/NAS-EPS DownlinkNASTransport, Identity request 10.0.2.246 10.0.2.1 S1AP/NAS-EPS UplinkNASTransport, Identity response 10.0.2.1 10.0.2.246 S1AP/NAS-EPS DownlinkNASTransport, Authentication request 10.0.2.246 10.0.2.1 S1AP/NAS-EPS UplinkNASTransport, Authentication response 10.0.2.1 10.0.2.246 S1AP/NAS-EPS DownlinkNASTransport, Security mode command 10.0.2.246 10.0.2.1 S1AP/NAS-EPS UplinkNASTransport, Security mode complete 10.0.2.1 10.0.2.246 S1AP/NAS-EPS DownlinkNASTransport, ESM information request 10.0.2.246 10.0.2.1 S1AP/NAS-EPS UplinkNASTransport, ESM information response 10.0.2.1 10.0.2.246 S1AP/NAS-EPS InitialContextSetupRequest, Attach accept, Activate default EPS bearer context request 10.0.2.246 10.0.2.1 S1AP UECapabilityInfoIndication, UECapabilityInformation 10.0.2.246 10.0.2.1 S1AP InitialContextSetupResponse 10.0.2.246 10.0.2.1 S1AP/NAS-EPS UplinkNASTransport, Attach complete, Activate default EPS bearer context accept 10.0.2.1 10.0.2.246 S1AP/NAS-EPS DownlinkNASTransport, EMM information