Instructions for fan configuration


=== Configuration of the fan ===

Install ubuntu-fan package

Edit /etc/default/ubuntu-fan, set FAN_OVERLAY to desired overlay

Other parameters in /etc/default/ubuntu-fan may be specified as necessary
for the environment, but only FAN_OVERLAY requires selecting a value.
By default, FAN_OVERLAY is unset, which will not configure a fan overlay
network.

The remaining parameters do not require modification, and may be left
with their default values.


=== docker setup for use with fan ===

After configuring the fan as described above, install the docker packages,
then edit /etc/default/docker, adding:

    DOCKER_OPTS="-d -b fanbr0 --mtu=1480 --iptables=false"

where the text “fanbr0” must match the setting of FAN_BRIDGE as
specified in /etc/default/ubuntu-fan.  This is “fanbr0” by default.

After configuration changes are complete, [ restart services ]

At this point, a docker instance started via, e.g., 

    docker run -it ubuntu:latest 

will be run within the fan overlay network.


=== lxc setup for use with fan ===

After configuring the fan as described above, install the lxc packages.

Edit /etc/default/lxc-net, set USE_LXC_BRIDGE=”false”

Edit /etc/lxc/default.conf:

First, change lxc.network.link to specify the setting for FAN_BRIDGE in
/etc/default/ubuntu-fan, which is fanbr0 by default:

    lxc.network.link = fanbr0

Second, add a line specifying the container mtu, as follows:

    lxc.network.mtu = 1480

At this point, new containers will be created using the fan overlay
network.  Existing containers may have their configuration file edited
as described above to use the fan; the configuration file for a container
is found in /var/lib/lxc/[container name]/config.
