Skip to content
Distributed platform for building autonomic network functions.
Branch: master
Clone or download
Cen Zhao and facebook-github-bot (easy) detect dual-support using hello packet, and report to lm and k…
…vstore

Summary:
add `hello-packet.supportDual` field to indicate is a node is running dual or not.
hello-packet.supportDual is set to true iff it has the latest code support AND enable-spt is True.

only peers who support dual will be used for flood optimization

Reviewed By: smaheshm, saifhhasan

Differential Revision: D14287384

fbshipit-source-id: b3e51b4e6dbc7010bad236ba17c74565e6d3a535
Latest commit c230097 Mar 22, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
build
examples clang format Jan 16, 2019
openr (easy) detect dual-support using hello packet, and report to lm and k… Mar 22, 2019
.travis.yml Update travis.yml to match FBCodeBuilder Aug 29, 2018
CHANGELOG.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE
LICENSE-examples Initial commit Nov 14, 2017
README.md

README.md

OpenR: Open Routing

Build Status

Open Routing, OpenR, is Facebook's internally designed and developed routing protocol/platform. Originally built for performing routing on the Terragraph network, its awesome design and flexibility have led to its adoption in other networks at Facebook including our new WAN network, Express Backbone.

Documentation


Please refer to openr/docs/Overview.md to get started with OpenR.

Library Examples


Please refer to the examples directory to see some useful ways to leverage the openr and fbzmq libraries to build software to run with OpenR.

Resources


Contribute


Take a look at openr/docs/DeveloperGuide.md and CONTRIBUTING.md to get started contributing. The Developer Guide outlines best practices for code contribution and testing. Any single change should be well tested for regressions and version compatibility.

Code of Conduct


The code of conduct is described in CODE_OF_CONDUCT.md

Requirements


We have tried OpenR on Ubuntu-14.04, Ubuntu-16.04 and CentOS-7. This should work on all Linux based platforms without any issues.

  • Compiler supporting C++14 or higher
  • libzmq-4.0.6 or greater

Build


Repo Directory Structure

At the top level of this repo are the build and openr directories. Under the former is a tool, fbcode_builder, that contains scripts for generating a docker context to build the project. The openr directory contains the source for the project.

Dependencies

If docker is not a good option for you, you can install these dependencies for your system and follow the traditional cmake build steps below.

  • cmake
  • gflags
  • gtest
  • libsodium
  • libzmq
  • zstd
  • folly
  • fbthrift
  • fbzmq
  • libnl

One Step Build - Ubuntu-16.04

We've provided a script, build/build_openr.sh, well tested on Ubuntu-16.04, to install all necessary dependencies, compile OpenR and install C++ binaries as well as python tools. Please modify the script as needed for your platform. Also, note that some library dependencies require a newer version than provided by the default package manager on the system and hence we are compiling them from source instead of installing via the package manager. Please see the script for those instances and the required versions.

libnl also requires custom patch, included herewith, for correct handling of add/remove multicast routes.

Build using Docker

Learn more here.

Build Steps

// Step into `build` directory
cd build

// Install dependencies and openr
sudo bash ./build_openr.sh

// Run tests (some tests requires sudo privileges)
sudo make test

If you make any changes you can run cmake ../openr and make from the build directory to build openr with your changes.

Installing

openr builds both static and dynamic libraries and the install step installs libraries and all header files to /usr/local/lib/ and /usr/local/include/ (under openr subdirectory) along with python modules in site-packages. Note: the build_openr.sh script will run this step for you.

sudo make install

Installing Python Libraries

You will need python setup-tools to build and install python modules. All library dependencies will be automatically installed except the fbthrift-python module which you will need to install manually using steps similar to those described below. This will install breeze, a cli tool to interact with OpenR.

cd openr/openr/py
python setup.py build
sudo python setup.py install

License


OpenR is MIT licensed.

You can’t perform that action at this time.