GERTY
=====
a proper way of doing things that RANCID does... and much more

Project status: preparing for a release.


Originally GERTY was a robot character in the film "Moon" (2009) by
Duncan Jones, with Kevin Spacey's voice.


Gerty is the automation tool for network operation tasks, like:
* Collecting status and configuration data
* Executing remote commands
* Parallel, massive execution

Various management access interfaces are available:
* Telnet/SSH command line
* SNMP
* NETCONF
* TL/1


Usage examples
--------------

* Device configuration backup

* VPLS MAC counts on Juniper MX platform: per-instance and per-VLAN
  counts for every routing instance, stored in SQL DB

* 15-minute HDSL line quality statistics (ES, SES, CRCA, LOSWS, UAS)
  collected every few hours and stored in SQL DB

* Chassis hardware types, serial numbers, IOS versions for Cisco
  devices, stored in SQL, with change history

* Port status, CDP neighbours, UDLD status for Cisco devices, stored in
  SQL, with change history





DOCUMENTATION
-------------

See the Wiki for a short concept overview:
https://github.com/ssinyagin/gerty/wiki


User guide:
https://github.com/ssinyagin/gerty/blob/master/doc/gerty_userguide.markdown


Architecture and design:
https://github.com/ssinyagin/gerty/blob/master/doc/gerty_architecture.markdown


Software documentation:
https://github.com/ssinyagin/gerty/blob/master/doc/gerty_job_configuration.markdown
https://github.com/ssinyagin/gerty/blob/master/doc/gerty_siteconfig_configuration.markdown
https://github.com/ssinyagin/gerty/blob/master/doc/gerty_devclass_configuration.markdown
https://github.com/ssinyagin/gerty/blob/master/doc/gerty_device_attributes.markdown


Installing from sources:
------------------------

Pre-requisites: autoconf, automake, and a number of Perl modules

  git clone https://github.com/ssinyagin/gerty.git
  cd gerty
  autoreconf
  ./configure --prefix=/opt/gerty
  make
  make install

later on, "git pull" would refresh your copy with the latest updates



Ubuntu and Debian pre-requisites:
---------------------------------

apt-get install make libtool autoconf git-core \
  libconfig-tiny-perl libconfig-any-perl  \
  liblog-handler-perl libexpect-perl \
  libxml-libxml-perl libnet-snmp-perl \
  libdbi-perl



Mailing list
------------

https://chilli.nosignal.org/mailman/listinfo/gerty-users
(thanks to Andy Davidson)


TO DO
-----

* replace external SSH and Telnet programs with Net::SSH2 and Net::Telnet
* write a man page
* automate backup for Cisco files, like "vlan.dat"
   (suggested by Viktor Steinmann <[email protected]>)
* write "Gerty Developer Guide"
* update documentation on Netconf, SNMP, TL1
* update documentation on DBLink and action postprocessing





Author:
-------

Stanislav Sinyagin
CCIE #5478
[email protected]
+41 79 407 0224