RANCID is a network configuration backup utility that stores away old configurations for (predominantly) routers and switches. It can also email out those differences, so that people know what has been changed when. This patch-set, started by Matthew Walster (myself) in January 2009 adds git-scm support and utilised colored HTML in the mailouts.
git patch taken from git tree at: git://fedorapeople.org/home/fedora/jcollie/public_git/rancid.git and applied to rancid-2.3.2a9 - mostly kept the same when merging in versions up to including rancid-2.3.4
"rancid" taken from original source at shrubbery.net/rancid
Additional coding as logged.
FOR GOD'S SAKE, do not use this fork if you have never installed RANCID before. It is currently being merged with the upstream version and there are likely to be changes and breakages during this period. It should be safe to upgrade to if you currently use the fork... But consider migrating to upstream at some point!
build-essential (for configure/make in debian build environments)
An MTA, such as [ exim4 | postfix | qmail | sendmail | ssmtp ]
For Debian users that are feeling adventurous, try running:
git clone git://github.com/dotwaffle/rancid-git
dpkg-buildpackage -uc -us -rfakeroot
dpkg -i rancid*.deb
There is an rpm specfile, but I haven't had too much experience with RedHat packaging, so YMMV!
adduser --home=/home/rancid rancid
autoreconf (or aclocal && autoconf)
sudo checkinstall (or make && make install)
sudo chown -R rancid:rancid /home/rancid
I'm writing documentation at the moment, which should hopefully be better than that supplied upstream. However, to get started, let's give you a couple of pointers!
$EDITOR /etc/rancid/rancid.conf (edit, make sure to set LIST_OF_GROUPS)
sudo -u rancid bin/rancid-cvs
Create a .cloginrc and $group/router.db
sudo -u rancid rancid-run
Read the logs in /var/lib/rancid/logs/ to find out what you did wrong ;)
Matthew Walster (email@example.com)
However, please think before you email -- if you want to raise an issue or add some code, please use the Github Issue Tracker, or raise a Pull Request.
I'm not able to provide support for RANCID installs, if you have a question please direct it to rancid-discuss, though they're only likely to provide help for people using the mainline install and not this patchset.
You can also clone the project with Git by running:
$ git clone git://github.com/dotwaffle/rancid-git