.. _example_service_dhcp-client_bonding:

#######
Bonding
#######

Test suite to validate DHCP client operation on bonding interfaces.

This suite tests DHCP on bonding (link aggregation) interfaces, which are
commonly used in production for high availability and load balancing.

Bonding combines multiple physical interfaces into a single logical interface.
The bonding interface should be able to obtain an IP address via DHCP just
like any physical interface.

Key scenarios verified:
- Bonding interface in active-backup mode obtains IP via DHCP
- DHCP lease is maintained when active member changes (failover)
- Bonding interface appears correctly in DHCP lease list

This is critical for:
- High Availability (HA) deployments
- Network redundancy scenarios
- Data center server connections

*****************************************
Test Bonding Interface Obtains DHCP Lease
*****************************************

Description
===========

This scenario verifies that a bonding interface configured in
active-backup mode can successfully obtain an IP address via DHCP.

The bonding interface combines two physical interfaces (eth0 + eth1)
into a single logical interface (bond0). A VLAN (VIF) is configured
over the bonding interface to obtain DHCP in the test environment.

Configuration:
- Server: vif 100 with 192.168.50.1/24, DHCP pool 192.168.50.10-20
- Client: bond0 (active-backup) with eth0 + eth1, vif 100 with dhcp

Expected:
- bond0.100 obtains IP in range 192.168.50.10-20
- bond0.100 appears in DHCP lease list
- Connectivity to server works

Scenario
========

.. include:: bonding/testbondinginterfaceobtainsdhcplease

.. raw:: html

  <hr>

*****************************************
Test Bonding DHCP Lease Appears in Server
*****************************************

Description
===========

This scenario verifies that the DHCP server correctly records
the lease for a bonding interface client.

The server should show the lease with:
- The MAC address of the bonding interface
- The assigned IP from the pool

This confirms end-to-end DHCP functionality for bonding interfaces.

Scenario
========

.. include:: bonding/testbondingdhcpleaseappearsinserver

.. raw:: html

  <hr>

*************************************
Test Bonding DHCP with Default Router
*************************************

Description
===========

This scenario verifies that a bonding interface receives and
applies the default router option from DHCP.

The client should:
- Obtain IP via DHCP on bond0.100 (VIF over bonding)
- Install default route via the server gateway
- Have connectivity through the bonding interface

This is important for production scenarios where the bonding
interface is the primary network connection.

Scenario
========

.. include:: bonding/testbondingdhcpwithdefaultrouter

.. raw:: html

  <hr>