Ulg
Universal Looking Glass
Install / Use
/learn @tmshlvck/UlgREADME
Warning: The project is generally abandoned, it depends on obsolete libraries, Python 2.7 and has been tested only with rather old routers and their software.
ULG version 0.9
- 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
- the CGI scripts currently do not support mod_python nor mod_wsgi
Basic installation procedure is:
- install prerequisites: Python 2.6 or 2.7, Genshi, Python CGI module, urllib, pexpect and pygraph and GraphViz
- install additional router-specific prerequisities:
- JuniperRouterRemoteTelnet: Telnet
- CiscoRouter: OpenSSH client
- BirdRouterRemote: OpenSSH client (default)
- deploy files in src directory to some place in WWW tree
- mkdir /etc/ulg; cp config.py.example /etc/ulg/config.py
- edit config.py to set up routers and credentials
- edit defaults.py to set up correct paths toward bins
- create .htaccess file with following contents:
<FilesMatch "(.pyc|.*~)"> Deny from all </FilesMatch>
Options +ExecCGI AddHandler cgi-script .py
(Or use corresponding config of your web server.)
- access http://yourserver/path-to-ulg/ulg.py via browser
- change strings and templates in defaults.py and templates/*.html .
Procedure for Debian Squeeze/Wheezy and Linux Mint 14 (nadia):
- apt-get install python python-pexpect python-pygraph python-genshi libgv-python whois
All other steps are the same as in generic case.
Contacts:
- Author: tmshlvck@gmail.com or tomas.hlavacek@nic.cz
- GIT hub https://github.com/tmshlvck/ulg
- CZ.NIC Git: git://git.nic.cz/ulg.git
Future plans:
This "pre-release" is only a preview and "technology demonstrator". Requests and contributions are welcomed. I intend 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.
