Skip to content

Latest commit

 

History

History
60 lines (54 loc) · 2.51 KB

DPDK_README.md

File metadata and controls

60 lines (54 loc) · 2.51 KB

Agora is compatable with and accelerated by the DPDK library.

  • Agora has been tested with dpdk version 21.11.1lts with both Intel 40 GbE and Mellanox 100 GbE NICs

DPDK installation

  • DPDK version 21.11.1 lts Intel 40 GbE and Mellanox 100 GbE NICs in Agora.

  • It is required you enable hugepage support and run agora under sudo permissions (LD_LIBRARY_PATH=${LD_LIBRARY_PATH}).

    $ sudo sh -c "echo 4 > /sys/devices/system/node/node0/hugepages/hugepages-1048576kB/nr_hugepages"
$ sudo sh -c "echo 4 > /sys/devices/system/node/node1/hugepages/hugepages-1048576kB/nr_hugepages"

    Make memory available for dpdk

    $ mkdir /mnt/huge
$ mount -t hugetlbfs nodev /mnt/huge

    Check hugepage usage

    $ cat /proc/meminfo

    [Building] https://doc.dpdk.org/guides/linux_gsg/sys_reqs.html#building-dpdk-applications

  • Mellanox's DPDK support depends on libibverbs / libmlx5 / ibverbs-utils.

  • Intel NICs may require the user to bring down the interface and load a DPDK compatible driver (vfio / pci_generic)

  • To install version 21.11.1, run

    $ meson build && cd build && ninja
$ sudo ninja install
$ sudo ldconfig

    the MLX poll mode driver will be autodetected and installed if required

Building and running Agora and emulated RRU with DPDK

  • Build Agora and emulated RRU with DPDK enabled.

     $ cd Agora
 $ mkdir build
 $ cd build
 $ cmake -DUSE_DPDK=true ..
 $ make -j

  • Run Agora with emulated RRU traffic with DPDK

    • NOTE: For DPDK test, we run Agora and the emulated RRU on two different machines. Most DPDK installations will require you to run under sudo permissions.
    • To generate data file, first return to the base directory (cd ..), then run
    $ ./build/data_generator --conf_file files/config/ci/tddconfig-sim-ul.json
    • To start Agora with uplink configuration, on one machine, run
    $ sudo LD_LIBRARY_PATH=${LD_LIBRARY_PATH} ./build/agora --conf_file files/config/ci/tddconfig-sim-ul.json
    • To start the emulated RRU with uplink configuration, on another machine, run
    $ sudo LD_LIBRARY_PATH=${LD_LIBRARY_PATH} ./build/sender --num_threads=2 --core_offset=1 --enable_slow_start=1 --conf_file=files/config/ci/tddconfig-sim-ul.json --server_mac_addr=FF:FF:FF:FF:FF:FF

    Change the MAC address in --server_mac_addr= to the MAC address of the NIC used by Agora.