The FlowManager is a RYU controller application that gives the user manual control over the flow tables in an OpenFlow network. The user can create, modify, or delete flows directly from the application. The user can also monitor the OpenFlow switches and view statistics. The FlowManager is ideal for learning OpenFlow in a lab environment, or in conjunction with other applications to tweak the behaviour of network flows in a test environment.
- Add/modify/delete flow entries in flow tables.
- Add/modify/delete group tables and meters.
- Backup/restore switch tables to/from local drive.
- View flow tables, group tables, and meters.
- View switch statistics.
- View network topology.
- Track flow entries.
- Upgraded jquery to v3.7.1
- Upgraded jquery to v3.5.0
- Fixed a bug tracking flow entries.
- Editing Python code style closer to PEP-8 (more work is needed).
- Spliting Python code into four modules for easier management.
- Reorganized folders.
FlowManager is a RYU Controller application, so make sure that the controller is installed properly before you proceed. Also, if you intend to use FlowManager with Mininet, you will need to install that too.
To install Ryu,
$ pip install ryu
Note: The application, ryu-manager, which you will need to run the FlowManager is known to have issues with Python3.10 and eventlet module. The FlowMananager has been recently tested in Ubuntu 20.04 with Python v3.8.10 and eventlet v0.30.1.
To downgrade eventlet:
$ pip uninstall eventlet
$ pip install eventlet==0.30.1
Install FlowManager using the following steps:
$ git clone https://github.com/martimy/flowmanager
Run the FlowManager alone:
$ ryu-manager ~/flowmanager/flowmanager.py
or with another RYU application:
$ ryu-manager ~/flowmanager/flowmanager.py ryu.app.simple_switch_13
and to display the topology:
$ ryu-manager --observe-links ~/flowmanager/flowmanager.py ryu.app.simple_switch_13
Use a web broswer to launch the site http://localhost:8080/home/index.html
Use a Docker image to run Ryu Controller with the FlowManager.
docker pull martimy/ryu-flowmanager
docker run -d -p 6633:6633 -p 8080:8080 martimy/ryu-flowmanager
To run the controller with another Ryu app:
docker run -d -p 6633:6633 -p 8080:8080 martimy/ryu-flowmanager:latest ryu.app.simple_switch_13
docker run -d -p 6633:6633 -p 8080:8080 martimy/ryu-flowmanager:latest flowmanager/flowmanager.py ryu.app.simple_switch_13
To bypass the entry point:
docker run -it --entrypoint bash martimy/ryu-flowmanager
You can find some useful documention in here, but it is still a work-in-progress.
- Python - A programming language ideal for SDN applications.
- jQuery - A JavaScript library for event handling, animation.
- D3.js - A JavaScript library for data visulization.
- Maen Artimy - Profile
FlowManager is licensed under the Apache 2 License - see the LICENSE file for details