table of contents
other versions
- wheezy 2.3.8-3
- jessie 2.3.8-6
- jessie-backports 3.6.2-2~bpo8+1
- testing 3.6.2-2
- unstable 3.6.2-2
router.db(5) | File Formats Manual | router.db(5) |
NAME¶
router.db - rancid group configuration fileDESCRIPTION¶
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.
- <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).
- 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.
- 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.
- 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.
- 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).
- tnt
- A Lucent TNT.
- 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.:
- [comments]
- Freeform string to describe the current state of the router.
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)24 April 2011 |