netdisco-rancid-export - DEPRECATED!


Note! This script is now deprecated and no longer maintained. The replacement is built in to Netdisco core, so can be scheduled in the backend, and also has more powerful configuration. See App::Netdisco::Worker::Plugin::MakeRancidConf.


This script requires some configuration to be added to your Netdisco "~/environments/deployment.yml" file, for example:

   rancid_home:  /var/lib/rancid
   down_age:     '1 day'
   delimiter:    ':'
   by_ip:        [ other ]
   by_hostname:  [ other2 ]
     switch:     [ 'name:.*[Ss][Ww].*' ]
     rtr:        [ 'name:[rR]tr.*' ]
     ap:         [ 'name:[aA][pP].*' ]
     "dell":      force10
     "dell:2024": dellnseries

Note that netdisco-rancid-export is not part of the automatic scheduler built in to Netdisco. You should run this script via cron just after your periodic discoverall.


The location to write RANCID Group configuration files into. A subdirectory for each Group will be created.

Default: "/var/lib/rancid".


This should be the same or greater than the interval between regular discover jobs on your network. Devices which have not been discovered within this time will be marked as "down" to RANCID.

Default: "1 day".


RANCID version 3 uses a semicolon as delimiter. Set this to the delimiter character if needed to be different from the default.

Default: ":".


If the device Vendor in Netdisco is not the same as the RANCID vendor script, configure a mapping here. The left hand side (key) should be the Netdisco vendor, the right hand side (value) should be the RANCID vendor script name. You can also set the Netdisco vendor to be "vendor:model" for fine-grained control. See the synopsis for an example.


This dictionary maps RANCID Group names with configuration which will match devices in the Netdisco database. The configuration is the same as any of Netdisco's "*_only" settings, and accepts IP, prefix, device property.


List of RANCID Groups which will have Device IPs written to the RANCID configuration file, instead of DNS or SNMP host names.


List of RANCID Groups which will have Device Hostname written to the RANCID configuration file, instead of FQDN. This is done simply by stripping the domain_suffix configuration item from the FQDN.