History

Zuul bbf69a90f3 Merge "Fix /etc/network/interfaces file contents"		2018-07-10 07:46:56 +00:00
..
install.d	Merge "Fix /etc/network/interfaces file contents"	2018-07-10 07:46:56 +00:00
README.rst	Set the dhclient timeout to match DIB_DHCP_TIMEOUT	2018-04-05 14:29:22 +01:00
element-deps	Move elements & lib relative to diskimage_builder package	2016-11-01 17:27:41 -07:00
package-installs.yaml	Release 1.27.0	2017-02-03 11:49:45 +11:00
pkg-map	Release 1.27.0	2017-02-03 11:49:45 +11: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