rancid

Langue: en

Version: 8 April 2010 (fedora - 01/12/10)

Section: 1 (Commandes utilisateur)

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
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.