Package: gogather
Go Forth and GatherGather - The Ultimate Source of Truth. Gather everything you ever wanted to know about your IT infrastructure into one simple searchable file, the GatherDB.
Gather is a tool that creates a comprehensive Source of Truth (SOT) for your IT infrastructure. The GatherDB contains an unlimited amount of configuration
management data as well as configuration state data.One of the prime features of Gather is its speed. Gather allows you to get a deep understanding of the configuration and state of an infrastructure in
a few minutes. In addition, Gather allows you to run ad hoc commands such as "show running-config" on a large campus environment in a few seconds.GATHERThree files are required. A target file, a command file, and an output file (does not need to exist before running script).The target file is a list of network devices. One device per line.The command file is a list of SHOW commands you want to issue to each one of the the devices in the target file. One command per line.The output file is a file that you want to output the text DB to. This is file does not need to exist prior to running the script.INSTALLATIONFirst make sure you are running the latest version of pip3 by upgrading your version of pip using the following command."pip3 install --upgrade pip" OR "python3 -m pip install --upgrade pip"After uprading pip to the latest version, install gather using the following command:"pip3 install gogather" OR "pip install gogather" if you only running python3 on your deviceUSAGE:gather -husage: gather [-h] [-c COMMANDFILE] [-sc SINGLECOMMAND] [-o OUTFILE] [-u USERNAME] [-t TARGETFILE] [-st SINGLETARGET] [-p PASSWD] [-notag]optional arguments:-h, --help         show this help message and exit-c COMMANDFILE     Enter Command File - One Per Line-sc SINGLECOMMAND  Enter A Single Command Enclosed in Quotes - Example "show version"-o OUTFILE         Enter Output Log File Name - If not specified default is GatherDB...-u USERNAME        Username-t TARGETFILE      Host File - One Per Line-st SINGLETARGET   Enter One Target Host Only-p PASSWD          Enter Password-notag             NO TAG places untagged output into seperate filesCLI Examples:gather -u  -p  -t <target_file> -c <command_file> -o <output_file>gather -u  -p  -st  -sc "command" <--- Output file will be defaulted to GatherDBgather -u  -p  -st  -sc "command" -o <output_file>gather -u  -p  -st  -sc "command" -o <output_file> -notag <--- -notag places untagged output into seperate filesOR run gather in interactive mode:VIRTUALENV % gatherUsername? usernamePassword: password (not visible on terminal)command file? command_filetarget file? target_fileoutput filename? output_fileGather logs in via SSH and issues the commands placed in the command file. Additionally, Gather tags the output flowing to output file with the target name as well as the command issued. I suggest placing every device in your data center in the target file.HOWTO and DEMONSTRATION VIDEOSSuggested Command File:SEE:commands.txtshow versionshow running-configshow running-config section bgpshow interface statusshow vlanshow ip int briefshow running-config section ospfshow lldp neighborAny other command that is relevant to your specific equipmentA commands.txt sample file is included in this repo.CapabilitiesGather tags every line of the output with the name of device and the name of the command, every line is searchable. Unix text search and
manipulation tools such as: AWK, SED, GREP (-v, -i), uniq, uniq -c, wc -l (count number of lines), allow you to easily search your entire infrastructure
at once for permanent and semi permanent data.SEE:SAMPLE_QUERIES.mdfile for examplesExamples of GatherDB searchGather all the serial numbers of every device and module.Sort and count things, such as compile and count the number and type of wireless access points installedDrill down searches to level of specificity required. Example: Once all types of wireless access points are discovered list all the instances and locations of a particular type of AP.During an outage, you can query and trouble shoot the device as if it was still operating.Run a complete configuration backup on all of your campus devices in a few seconds.Find all unused ports on all torsVerify the consistent mlag configs on all devicesDisplay all VLANS defined on all TORS and Spines.Display all unique version of code running and then identify devices that are not running the standard