rancid-run

Collect and version-control network device configurations

TLDR

Run RANCID for all groups

$ rancid-run

Run for specific group

$ rancid-run [group_name]

Run with email notification

rancid-run executes RANCID (Really Awesome New Cisco confIg Differ) to collect and version-control network device configurations. It connects to routers, switches, and firewalls to backup their configs.

PARAMETERS

-m email

Send results to email.

-r device

Process single device.

-f

Force run.

EXAMPLES

$ # Run all groups
rancid-run

# Specific group
rancid-run routers

# Multiple groups
rancid-run routers switches firewalls

# With email
rancid-run -m [email protected] routers

CONFIGURATION

/etc/rancid/rancid.conf

Main configuration defining device groups, version control system, and working directory paths.

~/.cloginrc

Device login credentials file specifying usernames, passwords, and enable passwords for each network device.

router.db

Per-group device inventory listing hostnames, device types (cisco, juniper, etc.), and up/down status.

SETUP

$ # 1. Create group
/var/lib/rancid/bin/rancid-cvs groupname

# 2. Add devices to router.db
# /var/lib/rancid/groupname/router.db
router1.example.com:cisco:up

# 3. Configure credentials
# ~/.cloginrc
add user router1.example.com admin
add password router1.example.com {password}

# 4. Run
rancid-run groupname