bird looking glass

Go to file

Steffen Vogel a4830951b1 Merge pull request #1 from fduraffourg/master Fix AS path computation for bgpmap & Fix missing import		2015-12-20 02:15:32 +02:00
static	improved code formatting	2015-04-04 19:18:30 +02:00
templates	added ping command	2015-04-04 20:11:02 +02:00
.gitignore	Merge remote-tracking branch 'gh/dsx/master'	2015-04-04 15:48:30 +02:00
COPYING	README/COPYING Update	2012-03-28 15:18:01 +02:00
README.mkd	Merge remote-tracking branch 'gh/zorun/master'	2015-04-04 15:36:23 +02:00
bird.py	Add restrict command	2012-05-27 14:32:50 +02:00
gpl-3.0.txt	Add licence and readme	2011-12-16 11:06:15 +01:00
lg.cfg.example	Cleanup example config files (warning: some values have changed)	2014-12-15 20:43:00 +01:00
lg.py	Add missing import	2015-12-17 16:45:08 +01:00
lg.wsgi	use current file name	2012-08-21 11:55:16 +02:00
lgproxy.cfg.example	Allow to configure the location of Bird sockets	2015-02-11 23:41:15 +01:00
lgproxy.py	Merge branch 'master' of github.com:stv0g/bird-lg	2015-04-04 20:19:48 +02:00
lgproxy.wsgi	Change lg-proxy to lgproxy to easly import it in wsgi	2014-02-18 11:52:43 +01:00
toolbox.py	bugfix: removed superfluous import	2015-04-04 17:57:57 +02:00

README.mkd

BIRD-LG

This is a looking glass for the Internet Routing Daemon "Bird".

Software is split in two parts:

lgproxy.py:

It must be installed and started on all bird nodes. It act as a proxy to make traceroute and bird query on the node. Access restriction to this web service can be done in file "lgproxy.cfg" (only IP address based restriction for now).
lg.py:

This is the frontend, a web based UI that request informations to all lgproxy.py nodes. The domain and the list of all bird nodes can be done.



                                         ***************
                                    +--> * lgproxy.py *
                                    |    ***************
                                    |  
********       *******************  |    ***************
* USER * ----> * webserver/lg.py *--+--> * lgproxy.py *
********       *******************  |    ***************
                                    |  
                                    |    ***************
                                    +--> * lgproxy.py *
                                         ***************

Installation

apt-get install python-memcache python-flask python-pydot python-dnspython libapache2-mod-wsgi

bird-lg depends on :

python-flask >= 0.8
python-dnspython
python-pydot

Each services can be embedded in any webserver by following regular python-flask configuration.

You should copy the configuration files (lgproxy.cfg.example to lgproxy.cfg and lg.cfg.example to lg.cfg) and edit them.

Should work with most Bird versions (from 1.2.x, tested up to 1.4.5).

Source code is under GPL 3.0, powered by Flask, jQuery and Bootstrap.