vyos/vyos-documentation
1
0
Fork 0
mirror of https://github.com/vyos/vyos-documentation.git synced 2025-10-26 08:41:46 +01:00
Code Issues Packages Projects Releases Wiki Activity

T2408: dhcp relay interface: add docs for new listen-interface and upstream-interface commands

Browse Source
This commit is contained in:
Nicolas Fort 2023-02-06 12:08:32 -03:00
parent d39ce49e2f
commit 86422eef63
1 changed files with 29 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
docs/configuration/service/dhcp-relay.rst
View File

@ -20,8 +20,20 @@ Configuration
.. cfgcmd:: set service dhcp-relay interface <interface>
Interfaces that participate in the DHCP relay process, including the uplink
to the DHCP server.
Interfaces that participate in the DHCP relay process. If this command is
used, at least two entries of it are required: one for the interface that
captures the dhcp-requests, and one for the interface to forward such
requests. A warning message will be shown if this command is used, since
new implementations should use ``listen-interface`` and
``upstream-interface``.
.. cfgcmd:: set service dhcp-relay listen-interface <interface>
Interface for DHCP Relay Agent to listen for requests.
.. cfgcmd:: set service dhcp-relay upstream-interface <interface>
Interface for DHCP Relay Agent to forward requests out.
.. cfgcmd:: set service dhcp-relay server <server>
@ -70,8 +82,8 @@ Example
* Listen for DHCP requests on interface ``eth1``.
* DHCP server is located at IPv4 address 10.0.1.4 on ``eth2``.
* Router receives DHCP client requests on ``eth1`` and relays them to the server
at 10.0.1.4 on ``eth2``.
* Router receives DHCP client requests on ``eth1`` and relays them to the
server at 10.0.1.4 on ``eth2``.
.. figure:: /_static/images/service_dhcp-relay01.png
:scale: 80 %
@ -81,6 +93,19 @@ Example
The generated configuration will look like:
.. code-block:: none
show service dhcp-relay
listen-interface eth1
upstrem-interface eth2
server 10.0.1.4
relay-options {
relay-agents-packets discard
}
Also, for backwards compatibility this configuration, which uses generic
interface definition, is still valid:
.. code-block:: none
show service dhcp-relay