Tenjin SDN

Software-defined networking with Rust.

Goals

To understand The software-defined networking well, I trying to create a simple SDN with Rust language to support Openflow 1.0 first and 1.3 later.

Installation

Install Rust

official webpage installation

or run this command below. (For macOS, Linux, or another Unix-like OS)

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Install Tenjin

cargo install tenjin_sdn

Run with command line

Run Controller by default (Controller13 with OpenFlow 1.3)

tenjin run

Run Controller10 with Openflow 1.0

tenjin run ctrl10

Run with specific port

tenjin run --port 6653

tenjin run --port 6653,6633

Show details of run command

tenjin run --help

Run only Controller

You can add tenjin to your project with command

cargo add tenjin

Or you can clone this source code into your workspace and modify the code.

this code below is the example for run only Controller. If you would like to modify Controller's code, it waiting for you at ./src/example/

Openflow 1.3

1. import Controller13 into main func.

use tenjin::{example, openflow::ofp13::ControllerFrame13};
extern crate byteorder;

fn main() {
    let controller = example::Controller13::new();
    controller.listener("127.0.0.1:6633");
}

2. run Tenjin

cargo run --release

Openflow 1.0

import Controller10 into main func.

use tenjin::{example, openflow::ofp10::ControllerFrame10};
extern crate byteorder;

fn main() {
    let controller = example::Controller10::new();
    controller.listener("127.0.0.1:6633");
}

run Tenjin

cargo run --release

Mininet

Mininet is a network emulator to create virtual networks for rapid prototyping of Software-Defined. Using mininet for testing this SDN Framework.

Run Mininet with Openflow 1.3

sudo mn --controller=remote,ip=127.0.0.1 --mac --switch=ovsk,protocols=OpenFlow13 --topo=tree,2

Run Mininet with Openflow 1.0

sudo mn --controller=remote,ip=127.0.0.1 --mac --switch=ovsk,protocols=OpenFlow10 --topo=tree,2

TODOs

• design structure of code and working.
• test case. (Read docs)
• write more description in README.
• handle needed messages.
• remove all unwarp.

Learning resources

• rust_ofp
• awesome-sdn
• ryu
• learn-sdn-with-ryu

Plan

Diagram

stateDiagram
con: Controller
conf10: Controller frame 10
conf13: Controller frame 13

ofp10: Openflow Manager 10
ofp13: Openflow Manager 13

ofpv10_h: openflow v1.0 header
ofpv10_e: openflow v1.0 Event

ofpv13_h: openflow v1.3 header
ofpv13_e: openflow v1.3 Event

[*] --> con
con --> conf10
conf10 --> ofp10
ofp10 --> ofpv10_h
ofp10 --> ofpv10_e

con --> conf13
conf13 --> ofp13
ofp13 --> ofpv13_h
ofp13 --> ofpv13_e

Loading