Redd is a management plain for the Linux vxlan module. The Linux vxlan module can use multicast to auto-discover peers, and send broadcast packets (like arp requests). Many datacenters don't handle multicast traffic very well when hosts are on different network segments. The other method is to seed the forwarding database with the location to find the IPs. This doesn't work very well if you want to have IPs switch between machines. Redd is a compromise between the two. Redd listens for multicast packets and sends a copy of it out to each node in a list allowing hosts that can't multicast to each other to talk to each other. This allows arp requests and other broadcast packets to be delivered to each host that needs them.

Usage: red [/path/to/red.conf] [options]
       red - (read config from stdin)
       red -v or --version
       red -h or --help
Examples:
       red (run the server with default conf)
       red /etc/red/4000.conf
       red --port 7777
       red /etc/myred.conf --loglevel verbose

The following things can be set in the redd configuration file:

• pidfile
• daemonize
• loglevel
• logfile
• syslog-enabled
• syslog-ident
• syslog-facility
• port
• bind
• timeout
• routing-enabled
• udp-listen-address
• udp-recv-buf
• udp-send-buf
• save-path
• vxlan-name
• vxlan-vni
• vxlan-group
• vxlan-port
• vxlan-interface

Path to file where a pidfile is stored. Defaults to "/var/run/red.pid".

Start up as a daemonized background process. Options are "yes" and "no". Defaults to "no".

How much output to the log file. Options are "debug", "verbose", "notice", and "warning". Defaults to "notice".

Path to file where to output logs. Outputs to stdout if empty. Defaults to stdout.

Send logs to syslog. Options are "yes" and "no". Defaults to "no".

Identifier string for syslog. Defaults to "red".

Syslog facility to use. Options are "USER", "LOCAL0", "LOCAL1", "LOCAL2", "LOCAL3", "LOCAL4", "LOCAL5", "LOCAL6", and "LOCAL7". Defaults to "LOCAL0".

Port for the API to listen to. Defaults to "4470".

IP address for the API to bind to. Defaults to "0.0.0.0".

API timeout. Defaults to infinite.

Enable the routing of packets. Options are "yes" and "no". Defaults to "yes".

IP address for unicast packets to send / receive from. Defaults to "localhost".

Receive buffer size. Defaults to "114688".

Send buffer size. Defaults to "114688".

Path to directory to save data for IPs and host nodes. Defaults to "/var/db/red/".

Name of the vxlan interface. Defaults to "vxlan0".

Virtual network identifier for the vxlan interface. Defaults to "1".

Multicast address for the vxlan interface. Defaults to "239.0.0.1".

Port to configure the vxlan driver to use. Defaults to "8472".

Physical interface to send vxlan traffic over. Defaults to "eth0".