.. _example_service_dhcp-relay_relay:

#####
Relay
#####


.. sidebar:: Contents

  .. contents::
    :depth: 2
    :local:

This scenario shows how to configure ``service dhcp-relay``. The
relay agent must be used when the DHCP server and the DHCP
clients are not connected to the same layer 2 domain.

.. image:: toplogy.svg
  :width: 400

***************
Test DHCP Relay
***************

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

This example demonstrates how to configure a DHCP
relay instance in DUT0 to forward DHCP requests from
DUT2 to DUT1.

Scenario
========

.. include:: relay/testdhcprelay

.. raw:: html

  <hr>

***************************
Test DHCP Relay With Giaddr
***************************

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

This example demonstrates how to set the gateway IP
address (giaddr) in the IP address. This value must
be set in an IP address that the DHCP server
can reach.

Scenario
========

.. include:: relay/testdhcprelaywithgiaddr

.. raw:: html

  <hr>

*******************************
Test DHCP Relay With GRE Tunnel
*******************************

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

This example demonstrates how to configure a DHCP
relay that forwards DHCP requests to the DHCP server
through a GRE tunnel (upstream).

Scenario
========

.. include:: relay/testdhcprelaywithgretunnel

.. raw:: html

  <hr>

***************************************
Test DHCP Relay With Multiple Instances
***************************************

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

This example demonstrates how to configure multiple
DHCP relay instances.

Scenario
========

.. include:: relay/testdhcprelaywithmultipleinstances

.. raw:: html

  <hr>