blob: c6bccb22e15e00ecd67fe40ccf61fcd136067a48 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
DHCP Relay
----------
If you want your router to forward DHCP requests to an external DHCP server
you can configure the system to act as a DHCP relay agent. The DHCP relay
agent works with IPv4 and IPv6 addresses.
All interfaces used for the DHCP relay must be configured. See
https://wiki.vyos.net/wiki/Network_address_setup.
DHCP relay example
^^^^^^^^^^^^^^^^^^
.. figure:: /_static/images/service_dhcp-relay01.png
:scale: 80 %
:alt: DHCP relay example
DHCP relay example
In this example the interfaces used for the DHCP relay are eth1 and eth2. The
router receives DHCP client requests on eth1 and relays them through eth2 to
the DHCP server at 10.0.1.4.
Configuration
^^^^^^^^^^^^^
Enable DHCP relay for eth1 and eth2:
.. code-block:: sh
set service dhcp-relay interface eth1
set service dhcp-relay interface eth2
Set the IP address of the DHCP server:
.. code-block:: sh
set service dhcp-relay server 10.0.1.4
The router should discard DHCP packages already containing relay agent
information to ensure that only requests from DHCP clients are forwarded:
.. code-block:: sh
set service dhcp-relay relay-options relay-agents-packets discard
Commit the changes and show the results:
.. code-block:: sh
commit
show service dhcp-relay
interface eth1
interface eth2
server 10.0.1.4
relay-options {
relay-agents-packets discard
}
The DHCP relay agent can be restarted with:
.. code-block:: sh
restart dhcp relay-agent
DHCPv6 relay example
^^^^^^^^^^^^^^^^^^^^
.. figure:: /_static/images/service_dhcpv6-relay01.png
:scale: 80 %
:alt: DHCPv6 relay example
DHCPv6 relay example
In this example DHCPv6 requests are received by the router on eth1
(`listening interface`) and forwarded through eth2 (`upstream interface`) to
the external DHCPv6 server at 2001:db8:100::4.
Configuration
*************
Set eth1 to be the listening interface for the DHCPv6 relay:
.. code-block:: sh
set service dhcpv6-relay listen-interface eth1
Set eth2 to be the upstream interface and specify the IPv6 address of
the DHCPv6 server:
.. code-block:: sh
set service dhcpv6-relay upstream-interface eth2 address 2001:db8:100::4
Commit the changes and show results:
.. code-block:: sh
commit
show service dhcpv6-relay
listen-interface eth1 {
}
upstream-interface eth2 {
address 2001:db8:100::4
}
Show the current status of the DHCPv6 relay agent:
.. code-block:: sh
show dhcpv6 relay-agent status
The DHCPv6 relay agent can be restarted with:
.. code-block:: sh
restart dhcpv6 relay-agent
Additional parameters
^^^^^^^^^^^^^^^^^^^^^
DHCP relay agent options
************************
Set the maximum hop count before packets are discarded. Range 0...255,
default 10.
* :code:`set service dhcp-relay relay-options hop-count 'count'`
Set maximum size of DHCP packets including relay agent information. If a
DHCP packet size surpasses this value it will be forwarded without appending
relay agent information. Range 64...1400, default 576.
* :code:`set service dhcp-relay relay-options max-size 'size'`
Four policies for reforwarding DHCP packets exist:
* **append:** The relay agent is allowed to append its own relay information
to a received DHCP packet, disregarding relay information already present in
the packet.
* **discard:** Received packets which already contain relay information will
be discarded.
* **forward:** All packets are forwarded, relay information already present
will be ignored.
* **replace:** Relay information already present in a packet is stripped and
replaced with the router's own relay information set.
* :code:`set service dhcp-relay relay-options relay-agents-packet 'policy'`
DHCPv6 relay agent options
**************************
Set maximum hop count before packets are discarded. Default: 10.
* :code:`set service dhcpv6-relay max-hop-count 'count'`
If this is set the relay agent will insert the interface ID. This option is
set automatically if more than one listening interfaces are in use.
* :code:`set service dhcpv6-relay use-interface-id-option`
|
