There are 6 settings files which are referenced within the python scripts, this post provides information on these files
1. settings.ini – static information e.g. SNMP password and File Locations
2. BuildingGroup – associated IP subnets to Buildings
3. DeviceGroupByMac – groups devices together by MAC address
4. DeviceGroupByType – group devices types together into device groups
5. IPtoMAC – output from the DHCP server providing a list of IP addresses and registered MAC addresses
6. MACtoDevice – list of devices manually configured in the system
Settings.ini
# SNMP community and port
snmp-password=
snmp-port=161
# Starts from 0.5, step is 0.5
snmp-timeout=2.0
snmp-retries=1
# <enter oid here e.g. 1.3.6.1.2.1.1.1.0>
snmp-system-name-oid=
snmp-system-type-oid=
# PING settings
ping-timeout=2
ping-retries=0
use-system-ping=false
# File location settings
cfg-directory=/home/ggadminuser/snmp-v2/cfg
mrtg-output=/var/www/html
mrtg-executable=/usr/local/mrtg-2/bin/mrtg
BuildingGroup
# File formated to group subnets together based on building
# One line per building
# format Building Name,grp2_subnet1, grp2_subnetN
# e.g. Building1,grp2_all172.16.1.x.ini,grp2_all10.0.0.x.ini
DeviceGroupByMac
# File formated to group devices together by MAC address
# One line per Device Group
# format Device Group,MAC Address + Wildcard
# e.g. VirtualDevicesGroup,fa16XXXXXXXX
DeviceGroupByType
# File formated to group devices types together
# One line per Device Group
# format Device Group,Device Type1, Device TypeN
# e.g. All_Laptops,Dell_laptop,HP_Laptop
# e.g. All_Desktops,Dell_desktop,HP_Desktop
IPtoMAC
# output from the DHCP server providing a list of IP addresses and registered MAC addresses
# format IP Address, MAC address
# e.g. 192.168.133.1,00:50:56:c0:00:08MACtoDevice
# manual list of devices configured in the system
# format MACAddress,Device,Location,PowerUtilisation,Group
# e.g. fa163eb54d1f,Server,Site2,3,Server1_NoSNMP
# e.g fa16.3ed7.dafb,Router,Site1,2,Router1_SNMP