francid1

Usage

Overview

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

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.