Configuration files are plain text files.
Note: replace LOCATION by location names of your own choice.
file name | owner:group | permission | content |
/srv/www/cgi-bin/cisco/locations.txt | cisco:www-run | -rw-r----- (640) | (mandatory) list of locations |
/home/cisco/access/cisco-global | cisco | -rw------- (600) | (optional) global Cisco device username and password information |
/home/cisco/access/cisco-routers-LOCATION | cisco | -rw------- (600) | list of Cisco routers with passwords for arplog |
/home/cisco/access/cisco-switches-LOCATION | cisco | -rw------- (600) | list of Cisco switches with passwords for maclog |
/srv/www/cgi-bin/cisco/LOCATION/portmaps.txt | cisco:www-run | -rw-r----- (640) | (mandatory) list of Cisco switch interconnections |
/srv/www/cgi-bin/cisco/LOCATION/ignorearp.txt | cisco:www-run | -rw-r----- (640) | (optional) list of ipblocks to be ignored by selected reports |
/srv/www/cgi-bin/cisco/LOCATION/ignoremac.txt | cisco:www-run | -rw-r----- (640) | (optional) list of mac addresses to be ignored by selected reports |
/srv/www/cgi-bin/cisco/LOCATION/ipblocks.txt | cisco | -rw-r----- (640) | (optional) list of ipblocks (/24) and descriptions |
Depending on your Linux distribution and apache version the group used for running apache may differ from "www-run" (e. g. "www"). Also the group used for the user "cisco" may differ (e. g. "cisco", "users", ...).
The format of the configuration files in documented in the configuration files or their templates.
###############################################################################
# locations.txt
###############################################################################
# list of locations (case sensitive!) and descriptions
# location-ids may not contain spaces
###############################################################################
data-center,data center in main building
This optional file contains default/global username and password information (e. g. if you use tacacs for authentication on all/many devices).
UNAME=username
PWORD=password
ENABLE=enable-password
SNMPCOMMUNITY=snmp-community
This file contains a list of routers with usernames, passwords and transport method (telnet, ssh or snmp2) for a given LOCATION.
################################################################################
# cisco-routers-LOCATION
################################################################################
# ipaddr user passwd transport # hostname
################################################################################
192.168.1.1 user passwd telnet # router-sample-1
username "-" (without the quotes) means no username is required (password only).
passwd "-" (without the quotes) can only be used if the username is also "-",
which means the authentication information from /home/cisco/access/cisco-global is used.
method can be either "snmp2", "ssh" or "telnet"
mode can be either "-", "disable" or "enable".
This file contains a list of switches with usernames, passwords and transport method (telnet, ssh or snmp2) for a given LOCATION.
################################################################################
# cisco-switches-LOCATION
################################################################################
# ipaddr user passwd method mode # hostname
################################################################################
192.168.1.41 - passwd telnet - # switch-sample-1 - no username
192.168.1.42 user passwd telnet - # switch-sample-2
192.168.1.43 - - ssh - # switch-sample-3 - global username and passwd
192.168.1.44 - - snmp2 - # switch-sample-4 - global snmp community
method can be either "snmp2", "ssh" or "telnet"
mode can be either "-", "disable" or "enable".