routing_switch's Introduction

Routing Switch

This is a layer 2 switch application with virtual slicing function. The slicing function allows us to create multiple layer 2 domains. This is similar to MAC-based VLAN but there is no limitation on VLAN ID space.

Prerequisites

Ruby 2.0.0 or higher (RVM).
Open vSwitch (apt-get install openvswitch-switch).

Install

git clone https://github.com/trema/routing_switch.git
cd routing_switch
bundle install --binstubs

Play

To run without virtual slicing, run lib/routing_switch.rb as follows:

./bin/trema run lib/routing_switch.rb -c trema.conf

To run with virtual slicing support, run lib/routing_switch.rb with -- --slicing options as follows:

./bin/trema run lib/routing_switch.rb -c trema.conf -- --slicing

In another terminal, you can create virtual slices with the following command:

./bin/slice add foo

Then add hosts to the slice with the following command:

./bin/slice add_host --mac 11:11:11:11:11:11 --port 0x1:1 --slice foo

REST API

To start the REST API server:

./bin/rackup

Supported APIs

Read this for details.

Description	Method	URI
Create a slice	POST	`/slices`
Delete a slice	DELETE	`/slices`
List slices	GET	`/slices`
Shows a slice	GET	`/slices/:slice_id`
Add a port to a slice	POST	`/slices/:slice_id/ports`
Delete a port from a slice	DELETE	`/slices/:slice_id/ports`
List ports	GET	`/slices/:slice_id/ports`
Shows a port	GET	`/slices/:slice_id/ports/:port_id`
Adds a host to a slice	POST	`/slices/:slice_id/ports/:port_id/mac_addresses`
Deletes a host from a slice	DELETE	`/slices/:slice_id/ports/:port_id/mac_addresses`
List MAC addresses	GET	`/slices/:slice_id/ports/:port_id/mac_addresses`
Shows a MAC address	GET	`/slices/:slice_id/ports/:port_id/mac_addresses/:mac_address`

Recommend Projects