dfritzsche / basebox

A tiny OpenFlow controller for OF-DPA switches.

baseboxd

Installation

Fedora

Currently packages are built only for the latest supported releases. The packages can be installed using dnf:

dnf -y copr enable bisdn/rofl
dnf -y copr enable bisdn/baseboxd
dnf -y install baseboxd

RHEL

Copr repos are provided at https://copr.fedorainfracloud.org/coprs/bisdn/

Other distros

Currently only intallation from source is supported. To build baseboxd you need the following dependencies installed:

• libnl3 (>= 3.2.28)
• rofl-common (>= 0.11)
• rofl-ofdpa (>= 0.8)
• gflags
• glog (>= 0.3.3)

Then you can install baseboxd:

git clone https://github.com/bisdn/basebox.git
cd basebox
./autogen.sh
./configure
make install

Usage

bridge setup

ip link add type bridge
ip link set bridge0 vlan_filtering 1
ip link set bridge0 up

adding ports to a bridge

ip link set port1 master bridge0
ip link set port2 master bridge0

remove ports from a bridge

ip link set port1 nomaster
ip link set port2 nomaster

adding vlans to bridge port

bridge vlan add vid 2 dev port1
bridge vlan add vid 2-4 dev port2

remove vlans from bridge port

bridge vlan del vid 2 dev port1
bridge vlan del vid 2-4 dev port2

adding a specific mac address to a bridge port

bridge fdb add 68:05:ca:30:63:69 dev port1 master vlan 1

remove a specific mac address from a bridge port

bridge fdb del 68:05:ca:30:63:69 dev port1 master vlan 1

High level architecture

.------------------.
|     netlink      |
'------------------'
.------------------.
| adaptation layer |
'------------------'
.------------------.
|     OpenFlow     |
'------------------'

License

baseboxd is licensed under the Mozilla Public License Version 2.0. A local copy can be found here

Notes

If you are looking for older versions of basebox(d) for controlling ovs and xdpd, you find those in the swx branch on github [1].

[1] https://github.com/bisdn/basebox/tree/swx