README 1.77 KB
Newer Older
1
ULG version 0.9
2 3 4 5 6
- development started in June 2012
- sponsored by CZ.NIC (http://www.nic.cz)
- intention is to create a versatile Looking Glass for various routers
- genshi and cherrypy was used in the beginning
- cherrypy was later dropped and simple CGI was used instead
7
- the CGI scripts currently do not support mod_python nor mod_wsgi
8 9 10

Basic instalation procedure is:

11
1) install prerequisites: Python 2.6 or 2.7, Genshi, Python CGI module, urllib,
12
   pexpect and pygraph and GraphViz
13
2) deploy files in src directory to some place in WWW tree
14
3) mkdir /etc/ulg; cp config.py.example /etc/ulg/config.py
15
4) edit config.py to set up routers and credentials
16
5) edit defaults.py to set up correct paths toward bins
17
6) create .htaccess file with following contents:
18 19 20 21 22 23 24 25 26 27

<FilesMatch "(.pyc|.*~)">
  Deny from all
</FilesMatch>

Options +ExecCGI
AddHandler cgi-script .py

(Or use corresponding config of your web server.)

28
7) access http://yourserver/path-to-ulg/ulg.py via browser
29
8) change strings and templates in defaults.py and templates/*.html .
30

31
Procedure for Debian Squeeze/Wheezy and Linux Mint 14 (nadia):
32
1)
33
apt-get install python python-pexpect python-pygraph python-genshi libgv-python whois
34 35 36

All other steps are the same as in generic case.

37

38 39
Contacts:

40 41
* Author: tmshlvck@gmail.com or tomas.hlavacek@nic.cz
* GIT hub https://github.com/tmshlvck/ulg
42
* CZ.NIC Git: git://git.nic.cz/ulg.git
43 44 45 46 47 48


Future plans:

This "pre-release" is only a preview and "technology demonstrator". Requests and contributions are welcomed. I indend to support BIRD (http://bird.network.cz) and Cisco routers and switches and support typical BGP-related commands and also IGP and L2 management commands in order to make LG more useful for ordinary NOC staff especially for information aquisition during outages and problems.