diskimage-builder

History

Noam Angel 0e700b25dc Check and remove existing image interface configurations This change will remove any existing interface configurations in the image. They are not necessary and could interrupt with deployments. In any case they should not exist if we use dhcp-all-interfaces element. Change-Id: I35a4b5ea6e2315de3b0d9f8353ac2b6f4b995697		2021-02-16 08:46:32 +00:00
..
install.d	Check and remove existing image interface configurations	2021-02-16 08:46:32 +00:00
element-deps	Move elements & lib relative to diskimage_builder package	2016-11-01 17:27:41 -07:00
package-installs.yaml	Add IPv6 support in dhcp-all-interfaces	2019-11-13 09:31:01 +01:00
pkg-map	Install ndisc6 package in element script	2019-12-03 14:57:33 +01:00
README.rst	Set the dhclient timeout to match DIB_DHCP_TIMEOUT	2018-04-05 14:29:22 +01:00

README.rst

===================
dhcp-all-interfaces
===================
Autodetect network interfaces during boot and configure them for DHCP

The rationale for this is that we are likely to require multiple
network interfaces for use cases such as baremetal and there is no way
to know ahead of time which one is which, so we will simply run a
DHCP client on all interfaces with real MAC addresses (except lo) that
are visible on the first boot.

On non-Gentoo based distributions the script
/usr/local/sbin/dhcp-all-interfaces.sh will be called early in each
boot and will scan available network interfaces and ensure they are
configured properly before networking services are started.

On Gentoo based distributions we will install the dhcpcd package and
ensure the service starts at boot.  This service automatically sets
up all interfaces found via dhcp and/or dhcpv6 (or SLAAC).

Environment Variables
---------------------

DIB_DHCP_TIMEOUT
  :Required: No
  :Default: 30
  :Description: Amount of time in seconds that the systemd service(or dhclient)
   will wait to get an address. Should be increased in networks such as
   Infiniband.
  :Example: DIB_DHCP_TIMEOUT=300