bgp/README.md

BGP Stream

www | github | bgpstream-info@caida.org

Overview

• BGP Stream: A framework for BGP analysis (pdf)

Install BGP Stream

You can visit the official install page to see if there is a different approach you want to take. There is also a docker image.

The follow outlines compiling it from source for simplicity across distros.

Requirements

• libcurl
• wandio 4.2.4-1 (wandio 4.2.5 was released recently, but not sure if it will break bgpstream)

Compiling wandio

1. Install the required packages: build-essential curl zlib1g-dev libbz2-dev libcurl4-openssl-dev librdkafka-dev automake1.11 libtool
2. Grab the source: curl -LO https://github.com/LibtraceTeam/wandio/archive/refs/tags/4.2.4-1.tar.gz
3. Extract the archive & then compile with ./configure && make && sudo make install
4. Lastly, run sudo ldconfig

Compiling libbgpstream

1. Install required packages: sudo apt-get install -y curl apt-transport-https ssl-cert ca-certificates gnupg lsb-release
2. Grab the source: curl -LO https://github.com/CAIDA/libbgpstream/releases/download/v2.2.0/libbgpstream-2.2.0.tar.gz
3. Extract the archive & then compile with ./configure && make && sudo make install
4. Lastly, run sudo ldconfig

This will create /usr/local/bin/bgpreader (documentation)

Lastly, for Python support, pip install pybgpstream (documentation) (pypi)

NOTE: sudo apt-get install python3-pybgpstream

NOTE: The Broker HTTP API may come to use...