https://github.com/timothy-liuxf/bgp_platform
bgp_platform - BGP outage detection experimental platform
https://github.com/timothy-liuxf/bgp_platform
autotools bgp-monitor cpp cpp17 m4 outage-analytics
Last synced: about 2 months ago
JSON representation
bgp_platform - BGP outage detection experimental platform
- Host: GitHub
- URL: https://github.com/timothy-liuxf/bgp_platform
- Owner: Timothy-Liuxf
- License: mit
- Created: 2022-12-20T12:27:00.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-09-21T04:15:36.000Z (9 months ago)
- Last Synced: 2025-03-27T11:44:10.716Z (2 months ago)
- Topics: autotools, bgp-monitor, cpp, cpp17, m4, outage-analytics
- Language: C++
- Homepage:
- Size: 174 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Security: SECURITY.md
Awesome Lists containing this project
README
# bgp_platform
bgp_platform - BGP outage detection experimental platform
Origin Repo:
## How to Build
### Prerequisites
+ Linux operating system
+ C++ compiler which supports C++17
+ GNU Autoconf and GNU Automake
+ `libpq` and `libpqxx-6.4`
+ `bgpdump`
+ Python 3 with PyTorch
or
+ Docker
### Clone this repository
```bash
$ git clone --recursive https://github.com/Timothy-Liuxf/bgp_platform.git
$ cd bgp_platform
```
or
```bash
$ git clone https://github.com/Timothy-Liuxf/bgp_platform.git
$ cd bgp_platform
$ git submodule update --init --recursive
```
### Build with Docker (Recommended)
#### Build base image
```bash
$ docker build . -f Dockerfile.base -t
```
#### Build target image
1. Open `Dockerfile`:
```Dockerfile
FROM timothyliuxf/bgp_platform_base AS builder
```
Then change `timothyliuxf/bgp_platform_base` to `` you set in the previous step.
2. Build the target image:
```bash
$ docker build . -t
```
### Build on a local machine
#### Configure build system
```bash
# Requires GNU Autoconf and GNU Automake
$ autoreconf -i
$ [ENV=VAL] ./configure
```
The `ENV` and `VAL` can be:
+ `BUILD_CONFIG`: Choose configuration.
+ `Debug` / `debug`: Debug configuration.
+ `Release` / `release` (default): Release configuration.
+ `CXX`: The C++ compiler to use. The default value is `g++`.
#### Build the target
```bash
$ make -j$(nproc)
```
## How to Run
### Setup Database
Setup a [PostgreSQL](https://www.postgresql.org/) server.
### Configuration
Write configurations in `config/config.json`. Take [`config/examples/config.json`](config/examples/config.json) for an example.
### Run the program
#### Run with docker
+ Mount the directory where the `config.json` is located to `/app/config`.
+ Mount the directory where the initalization information files are located to `/app/info`.
+ Mount the directory where the data files are located to `/app/data`.
Take [`scripts/launch_docker.sh`](scripts/launch_docker.sh) for an example.
#### Run on a local machine
```bash
$ ./build/bin/bgp_platform [options]
```