rancid(1) | General Commands Manual | rancid(1) |
rancid - Cisco configuration filter
rancid [-dlCV] [-t device_type] (-f filename | hostname)
rancid [-dhlCV] -t device_type (-f filename | hostname)
rancid is a collection of perl(1) scripts which use the login scripts (see clogin(1)) to login to a device, execute commands to display the configuration, etc, then filters the output for formatting, security, and so forth. rancid's product is a file with the name of it's last argument plus the suffix .new. For example, hostname.new.
rancid is a perl(1) script that operates much like the vendor-specific rancid script of pre-3.0 releases, but is generic and will eventually obsolete the vendor-specific rancid scripts. It uses the device_type specified with the -t option to look-up a device description (see rancid.types.conf(5)) that defines what it does to collect and process device information.
There are scripts complementary to rancid for other platforms and/or manufacturers that are supported by rancid(1). Briefly, these are:
The command-line options are as follows:
control_rancid(1), clogin(1), rancid.conf(5), rancid.types.conf(5), rancid(3)
Cisco IOS offers a DHCP server that maintains a text database which can be stored remotely or on local storage. If stored locally, the file changes constantly and causes constant diffs from rancid. If this file's name ('ip dhcp database') matches the regex dhcp_[^[:space:].].txt, it will be filtered.
For Catalyst switches running CatOS, type cat5, the prompt must end with '>'. clogin(1) looks for '>' to determine when a login is successful. For example:
cat5k> cat5k> enable Password: cat5k> (enable)
rancid works on Cisco Catalyst 1900 series switches that are running Enterprise Edition software. This software provides a menu at connection time that allows a command line interface to be used by entering 'K' at the prompt.
22 January 2019 |