## HSDN PHP Looking Glass PHP Version of BGP Looking Glass script, based on the Perl sources: https://github.com/Cougar/lg ### General Features - Supports the Telnet and SSH (through Putty/plink or sshpass) - Supports the Cisco, MikroTik v5 and v6, Quagga (Zebra) and JunOS routers - Supports the IPv4 and IPv6 protocols - Automatic conversion IPs to subnets using Merit RADb (for MikroTik) (http://www.ra.net/) - Drawing graph of BGP AS pathes using GraphViz toolkit - Works on php 5.2.0 and above ### System Requirements - php version 5.2.0 and above with Sockets and Filter (http://www.php.net/) - For the SSH connections require 'sshpass' or Putty 'plink' command (http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html) - GraphViz toolkit for drawing BGP pathes graph (http://www.graphviz.org/) - php pear package Image_GraphViz (http://pear.php.net/package/Image_GraphViz) ### Installation instructions 1. Copy *index.php* file to your web server directory. 2. Copy *lg_config.php.dist* file as *lg_config.php* to your web server directory. 3. Edit *lg_config.php* file (see parameters description below). ### Configuration parameters #### Branding configuration - `$_CONFIG['asn']` - Your AS number for display on the LG page. - `$_CONFIG['company']` - Your company for display on the LG page. - `$_CONFIG['logo']` - Your company logo for display on the LG page. - `$_CONFIG['color']` - Main color of design elements on the LG page. - `$_CONFIG['ipwhois']` - URL address of the IP whois service. - `$_CONFIG['aswhois']` - URL address of the AS whois service. #### Programs configuration - `$_CONFIG['sshcommand']` - Type of command to make a SSH connection (you can use *plink* or *sshpass* as value). - `$_CONFIG['plink']` - Path to **plink** command if you use it (for SSH connections). - `$_CONFIG['sshpass']` - Path to **sshpass** command if you use it (for SSH connections). #### Routers configuration Configuration of routers is specified as array in the parameter `$_CONFIG['routers']` with following format: ```php $_CONFIG['routers'] = array ( 'router1' = array ( // Router parameters ), 'router2' = array ( // Router parameters ), // etc. ); ``` ##### Router parameters: - `url` - URL address in format: **[ssh|telnet]://[login]:[password]@[host]:[port]**. - `pingtraceurl` - URL address for ping and traceroute tools for Quagga routers (or *FALSE*). - `description` - Router description. - `group` - Router group name - AS number (of *FALSE*). - `ipv6` - Router is supports IPv6 (*TRUE* or *FALSE*). - `os` - Router OS (*ios, mikrotik, quagga, junos, openbgpd, huawei*). ### Demonstration - http://dev.hsdn.org/lg/ - http://lg.apc.sg/ - http://lg.campus-rv.net/ - http://lg.lankabell.com/ #### Graph of BGP AS pathes demonstration - http://dev.hsdn.org/lg/?command=graph&protocol=ipv4&query=8.8.8.8&router=example1 - https://lg.apc.sg/?command=graph&protocol=ipv4&query=8.8.8.8&router=apchosting-br1 ### License HSDN Looking Glass Copyright (C) 2012-2018 Information Networks Ltd. Copyright (C) 2000-2002 Cougar Copyright (C) 2014 Regional Networks Ltd. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see .