NAME

       router.db - rancid group configuration file

DESCRIPTION

       router.db  contains  information  for  devices  which  are  members  of  a  rancid  group.
       control_rancid(1) reads this file to compile a list of devices which it should collect.

SYNTAX

       One device is listed per-line, where the syntax is:

                 <device_name>;<device_type>;<state>[;comments]

       For example:
                 scooby.shrubbery.net;cisco;up

       The fields are as follows:

       <device_name>
              The name of the device, which must resolve via gethostbyname, used as the  argument
              to  telnet(1),  rsh(1),  or  ssh(1),  to  connect to the device.  Once converted to
              lower-case, this also becomes the name of the file used to store the  configuration
              under $BASEDIR/<group>/configs.

              Experience  has  shown  that  using the device's FQDN (Fully Qualified Domain Name)
              works best, as in the example above.

       <device_type>
              The type of device from the set:

               agm    A Cisco Anomaly Guard Module (aka Riverhead).  Suspect that at  some  point
                      the UI will become more cisco-like and it can be merged with the IOS rancid
                      module.

               alteon An Alteon WebOS switches.

               arista An Arista Networks device.

               avocent
                      An Avocent Cyclades console server.

               baynet A Bay Networks router.

               cat5   A Cisco catalyst series 5000 and 4000 switches (i.e.: running the  catalyst
                      OS, not IOS).

               ciena-ws
                      A Ciena Waveserver.

               cisco  A  Cisco  router, PIX, or switch such as the 3500XL or 6000 running IOS (or
                      IOS-like) OS, but not IOS-XR.

               cisco-nx
                      A Cisco Nexus switch/router.

               cisco-xr
                      A Cisco device running IOS-XR.

               cisco-wlc
                      A Cisco Wireless Controller.

               css    A Cisco content services switch.

               enterasys
                      An enterasys NAS.  This is currently an alias  for  the  riverstone  device
                      type.

               erx    A Juniper E-series edge router.

               dell   A  Dell  switch.   Known working models are DES-3010F, DES-3052P, DES-3526,
                      and DES-3550.  Note that Dell OEMs some equipment and  has  purchased  some
                      companies,  so  a Dell product may not work with the dell rancid module but
                      may work with smc or force10.

               extreme
                      An Extreme switch.

               ezt3   An ADC-Kentrox EZ-T3 mux.

               f5     A F5 BigIP switch.

               force10
                      A Force10 router.

               fortigate
                      A Fortinet firewall.

               foundry
                      A Foundry router, switch, or  router-switch.   This  includes  HP  Procurve
                      switches that are OEMs of Foundry products, such as the HP9304M.

               hitachi
                      A Hitachi router.

               hp     A  HP Procurve switch such as the 2524 or 4108 procurve switches.  Also see
                      the foundry type.

               juniper
                      A Juniper router.

               mikrotik
                      A Mikrotik router.

               mrtd   A host running the (Merit) MRTd daemon.

               netscalar
                      A Netscalar load balancer.

               netscreen
                      A Netscreen firewall.

               paloalto
                      A Palo Alto Networks device.

               procket
                      A Procket router.

               redback
                      A Redback router, NAS, etc.

               riverstone
                      A Riverstone NAS or Cabletron (starting with version ~9.0.3) router.

               smc    A SMC switch (some Dell OEMs).

               ciscowlc
                      A Cisco WLC.

               xirrus A Xirrus array.

               zebra  Zebra routing software.

       <state>
              The state is either "up", or some other  arbitrary  value,  e.g.  "down".   If  the
              device  is not marked "up" the device's configuration will not be collected.  It is
              highly recommended that comments are made for any router not listed as up, so as to
              indicate the reason a router is not to be polled, e.g.:

              dial1.paris;cisco;up;
              core1.paris;cisco;down;in testing until 5/5/2001.
              core2.paris;cisco;ticketed;Ticket 6054234, 5/3/2001
              border1.paris;juniper;up;

              The  script  "downreport"  in  util/  can be used to produce a report of routers in
              router.db that are not marked "up".

       [comments]
              Freeform string to describe the current state of the router.

       A ``#'' at the beginning of a line is a comment; the entire line is ignored.

       If a device is deleted from the router.db file, then rancid will clean up by removing  the
       device's  config  file from $BASEDIR/<group>/configs.  The device will be removed from the
       revision control system.  It is possible, in most cases, to resurrect or check-out  copies
       of deleted device configurations.

FILES

       $BASEDIR/<group>/router.db
              Configuration  file described here, where <group> is a device group name defined in
              the variable LIST_OF_GROUPS within $BASEDIR/etc/rancid.conf.

SEE ALSO

       control_rancid(1), rancid(1), rancid.conf(5)

HISTORY

       In RANCID releases prior to 3.0, router.db used colons (:) as its field  separator.   This
       was changed to allow IPv6 addresses to be used in router.db.

                                         15 January 2016                             router.db(5)