NAME¶
rancid - Cisco configuration filter
SYNOPSIS¶
rancid [
-dlV] (
-f filename | hostname)
DESCRIPTION¶
rancid is a
perl(1) script which uses 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
on.
rancid's product is a file with the name of it's last argument plus
the suffix .new. For example,
hostname.new.
There are complementary scripts for other platforms and/or manufacturers that
are supported by
rancid(1). Briefly, these are:
- agmrancid
- Cisco Anomaly Guard Module (AGM)
- arancid
- Alteon WebOS switches
- arrancid
- Arista Networks devices
- brancid
- Bay Networks (nortel)
- cat5rancid
- Cisco catalyst switches
- cssrancid
- Cisco content services switches
- erancid
- ADC-kentrox EZ-T3 mux
- f10rancid
- Force10
- f5rancid
- F5 BigIPs
- fnrancid
- Fortinet Firewalls
- francid
- Foundry and HP procurve OEMs of Foundry
- hrancid
- HP Procurve Switches
- htranicd
- Hitachi Routers
- jerancid
- Juniper Networks E-series
- jrancid
- Juniper Networks
- mrancid
- MRTd
- mrvrancid
- MRV optical switches
- mtrancid
- Mikrotik routesrs
- nrancid
- Netscreen firewalls
- nsrancid
- Netscaler
- nxrancid
- Cisco Nexus boxes
- prancid
- Procket Networks
- rivrancid
- Riverstone
- rrancid
- Redback
- srancid
- SMC switch (some Dell OEMs)
- trancid
- Netopia sDSL/T1 routers
- tntrancid
- Lucent TNT
- xrancid
- Extreme switches
- xrrancid
- Cisco IOS-XR boxes
- zrancid
- Zebra routing software
The command-line options are as follows:
- -V
- Prints package name and version strings.
- -d
- Display debugging information.
- -l
- Display somewhat less debugging information.
- -f
- rancid should interpret the next argument as a
filename which contains the output it would normally collect from the
device ( hostname) with clogin(1).
SEE ALSO¶
control_rancid(1),
clogin(1),
rancid.conf(5)
CAVEATS¶
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.