ENODEBD

eNodeB daemon is an Automatic Configuration Server (ACS) which forks from Facebook Magma project. It currently tested with Sercomm eNodeB P27-SCE4255W small cell.

Install & Run

# The all command will create a virtual environment, install protoc and compile the proto files
make all
# Enter the virtual environment
. venv/bin/activate

# Run enodebd
python main.py

Configuration

We have these configuration files for configuring eNodeBD service.

1. override_configs/gateway.mconfig

The enodebd will generate the empty configuration to config service, and it will load override_configs/gateway.mconfig to fill in the empty configuration.

2. magma_configs/acs_common.yml

The acs_common.yml will hold the default value for all eNodeBs, like as the PLMN may be a shared value among all eNodeBs.

3. magma_configs/serial_numbers/2009CW5000019.yml

The serial_number.yml will have the customized value for each configurable parameters. The value in serial_number.yml will override the value defines in gateway.mconfig and acs_common.yml when corresponding eNodeB connects (base on the serial number provided by eNodeB).

Prometheus Support

The following example configuration can start a Prometheus container for monitoring data sent by enodebd. The enodebd will start prometheus server on port 8000 by default.

# prometheus configuration - prometheus.yml
global:
  scrape_interval: 15s
  external_labels:
    monitor: 'codelab-monitor'

scrape_configs:
  - job_name: 'prometheus'
    scrape_interval: 5s
    static_configs:
      # The 8000 is the default port of prometheus client of enodebd
      - targets: ['172.17.0.1:8000']

... and start prometheus container with docker command.

$ docker run -p 9090:9090 -v /home/ubuntu/magma-enodebd-new/prometheus.yml:/etc/prometheus/prometheus.yml prom/prometheus

License

This project is under 3-Clause BSD license.