.. _example_service_dhcp-client_fallback:

########
Fallback
########

Test suite to validate DHCP client IP fallback functionality.

When DHCP fails to obtain an IP address, the client can be configured
with a fallback static IP address that will be used temporarily until
DHCP becomes available again.

This test suite verifies that:
- Fallback IP is applied when DHCP server is unreachable
- Fallback IP is removed when DHCP succeeds
- Fallback works with VRF
- Fallback works with VLAN interfaces

*******************************
Test DHCP Fallback to Static IP
*******************************

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

This scenario checks that when DHCP server is unavailable,
the client applies the configured fallback IP address.
This ensures the interface has connectivity even without DHCP.
This is a single-DUT test (DUT0 only) - no server needed.

Scenario
========

.. include:: fallback/testdhcpfallbacktostaticip

.. raw:: html

  <hr>

***************************
Test DHCP Fallback with VRF
***************************

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

This scenario checks that DHCP fallback works correctly when
the interface is in a VRF (Virtual Routing and Forwarding) context.
This is a single-DUT test (DUT0 only) - no server needed.

Scenario
========

.. include:: fallback/testdhcpfallbackwithvrf

.. raw:: html

  <hr>

****************************
Test DHCP Fallback with VLAN
****************************

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

This scenario checks that DHCP fallback works correctly on
VLAN sub-interfaces (VIF).
This is a single-DUT test (DUT0 only) - no server needed.

Scenario
========

.. include:: fallback/testdhcpfallbackwithvlan

.. raw:: html

  <hr>

*******************************************
Test DHCP No Fallback When Server Available
*******************************************

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

This scenario checks that fallback IP is NOT applied when
DHCP server is available from the beginning.
We verify that DHCP IP is obtained successfully.
NOTE: There may be a race condition where fallback briefly appears
before DHCP completes - this test focuses on DHCP success.

Scenario
========

.. include:: fallback/testdhcpnofallbackwhenserveravailable

.. raw:: html

  <hr>