This page covers common configuration steps for RANCID deployments.
Edit /etc/rancid/rancid.conf:
# List of device groups
LIST_OF_GROUPS="core-network branch-offices datacenter"
# Email settings
MAILDOMAIN=example.com
MAILFROM=rancid@example.com
For each group, edit /var/lib/rancid/<group>/router.db:
# Format: hostname:vendor[:username:password]
router1.example.com:cisco:admin:password
switch1.example.com:cisco:admin:password
firewall1.example.com:pix:admin:password
juniper1.example.com:junos:admin:password
Create the group directory:
mkdir -p /var/lib/rancid/mygroup
Add group to LIST_OF_GROUPS in /etc/rancid/rancid.conf
Create router.db in the group directory:
touch /var/lib/rancid/mygroup/router.db
chmod 644 /var/lib/rancid/mygroup/router.db
chown rancid:rancid /var/lib/rancid/mygroup/router.db
Initialize Git repository:
cd /var/lib/rancid/mygroup
git init --bare configs.git
hostname:cisco:username:password
hostname:junos:username:password
hostname:paloalto:username:password
hostname:arista:username:password
Reload RANCID to apply configuration changes:
# Restart the service
systemctl restart rancid
# Or run collection manually
/usr/lib/rancid/bin/rancid-run
cd /var/lib/rancid/<group>/configs.git
git log --oneline
/var/log/rancid/