CiscoTools Configuration Files

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.

/srv/www/cgi-bin/cisco/locations.txt

###############################################################################
# locations.txt
###############################################################################
# list of locations (case sensitive!) and descriptions
# location-ids may not contain spaces
###############################################################################

data-center,data center in main building

/home/cisco/access/cisco-global

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

/home/cisco/access/cisco-routers-LOCATION

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".

/home/cisco/access/cisco-switches-LOCATION

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".