DAOS-3985 control: Add ControlInterface to server config

[mjmac]

By default, the control plane server binds to 0.0.0.0, which
means that it is listening to all addresses on all interfaces.
In some cases, the admin may prefer to specify a single interface
to be used for control plane traffic.

When control_iface is set in daos_server.yml, the server will
use the first IPv4 address on that interface as both the listen
address and the address recorded in the management database. If
the prometheus listener is configured, it will also use the first
address found for the control interface.

Features: control
Signed-off-by: Michael MacDonald github@macdonald.cx

[github-actions]

Ticket title is 'Allow Control Plane to bind to specific interfaces'
Status is 'In Progress'
Labels: 'triaged'
https://daosio.atlassian.net/browse/DAOS-3985

[Copilot]

Pull request overview

This pull request adds a control_interface configuration option to the DAOS server configuration, allowing administrators to bind the control plane listener to a specific network interface instead of the default behavior of listening on all interfaces (0.0.0.0). When configured, the server uses the first (lowest) IPv4 address from the specified interface for both the control plane listener and the Prometheus telemetry exporter.

Changes:

• Added control_interface configuration parameter with validation and error handling
• Modified control plane and Prometheus listener binding logic to use the configured interface
• Comprehensive test coverage including unit tests and functional tests

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
utils/config/daos_server.yml	Added documentation for the new control_interface configuration parameter
src/control/server/config/server.go	Added ControlInterface field to Server struct and WithControlInterface method
src/control/server/config/server_test.go	Updated test to include the new configuration option
src/control/server/config/faults.go	Added fault definitions for invalid control interface and address mismatch scenarios
src/control/fault/code/codes.go	Added fault codes for control interface errors
src/control/server/server.go	Modified initNetwork to look up and validate the control interface
src/control/server/server_utils.go	Implemented core logic including getFirstIPv4Addr and updated getControlAddr and createListener
src/control/server/server_utils_test.go	Comprehensive unit tests for the new functionality
src/control/server/telemetry.go	Updated Prometheus exporter to use the configured bind address
src/control/lib/telemetry/promexp/httpd.go	Added BindAddress field to ExporterConfig for binding to specific addresses
src/tests/ftest/util/server_utils_params.py	Added control_interface parameter to test infrastructure
src/tests/ftest/control/daos_server_config.yaml	Added test cases for control interface validation
src/tests/ftest/control/daos_server_config.py	Added functional test for control interface configuration

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[daosbuild3]

Test stage NLT on EL 8.8 completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net/job/daos-stack/job/daos/job/PR-17367/2/display/redirect

[daosbuild3]

Test stage Unit Test on EL 8.8 completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net/job/daos-stack/job/daos/job/PR-17367/2/display/redirect

[daosbuild3]

Test stage Functional Hardware Medium MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-17367/4/execution/node/1318/log

[daosbuild3]

Test stage Functional Hardware Large MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-17367/5/execution/node/1318/log

[daosbuild3]

Test stage Functional Hardware Medium MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-17367/5/execution/node/1308/log

[daosbuild3]

Test stage Functional Hardware Medium MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-17367/6/execution/node/427/log

[daosbuild3]

Test stage Functional Hardware Medium MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-17367/7/execution/node/1317/log

[daosbuild3]

Test stage Functional on EL 8.8 completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-17367/8/execution/node/1011/log

[daosbuild3]

Test stage Test RPMs on EL 8.6 completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-17367/8/execution/node/1086/log

[daosbuild3]

Test stage NLT on EL 8.8 completed with status UNSTABLE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net/job/daos-stack/job/daos//view/change-requests/job/PR-17367/9/testReport/

[daosbuild3]

Test stage Test RPMs on EL 8.6 completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-17367/9/execution/node/1014/log

[daosbuild3]

Test stage NLT on EL 8.8 completed with status UNSTABLE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net/job/daos-stack/job/daos//view/change-requests/job/PR-17367/11/testReport/

[daosbuild3]

Test stage Functional Hardware Medium Verbs Provider MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-17367/11/execution/node/1328/log