openstack/diskimage-builder
Code Issues Proposed changes
1aee4a8a6d
diskimage-builder/diskimage_builder/elements/dhcp-all-interfaces
History
Steve Baker eb395ec558 Remove EOLed CentOS 7 and RHEL 7 
CentOS 7 reached EOL on 30th June 2024[1] and RHEL 7 ended its
maintenance support 2 phase[2] the same date.

This change removes the ablity to build images derived from these base
images.

The centos and centos-minimal elements now default to a DIB_RELEASE
value of 9-stream.

[1] https://www.redhat.com/en/topics/linux/centos-linux-eol
[2] https://www.redhat.com/en/technologies/linux-platforms/enterprise-linux/rhel-7-end-of-maintenance

Change-Id: Ic50e08d9f84bbd319129be236d799eade5f40be8
2024-07-05 09:53:29 +12:00
..
install.d Use internal dhcp client for centos 9-stream and beyond 2022-06-28 11:02:03 -07: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 fix ifupdown pkg map for dhcp-all-interfaces of redhat family 2023-04-05 09:44:40 +00:00
README.rst Remove EOLed CentOS 7 and RHEL 7 2024-07-05 09:53:29 +12: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

DIB_DHCP_NETWORK_MANAGER_AUTO
Required

No

Default

false

Description

When NetworkManager is detected, and this is set to true the dhcp-all-interfaces service will not be installed. Only the NetworkManager configuration will be added. NetworkManager is quite capable to do automatic interface configuration. NetworkManager will by default try to auto-configure any interface with no configuration, it will use DHCP for IPv4 and Router Advertisements to decide how to initialize IPv6.

Example

DIB_DHCP_NETWORK_MANAGER_AUTO=true

DIB_DHCP_CLIENT
Required

no

Default

internal

Description

When NetworkManager is in use, this setting conveys which DHCP client is in use for acquiring a DHCP address for the node. In some specific cases, where known that dhclient is the tested or most compatible default, specifically for Centos 8, and 8-Stream, as well as derived distributions. Otherwise, the "internal" dhcp client is the default.

Example

DIB_DHCP_CLIENT