blob: 799c433202133693c39dc87300b33300a802b816 (
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
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
|
DHCPv6 server
-------------
VyOS provides DHCPv6 server functionality which is described in this section.
In order to use the DHCPv6 server it has to be enabled first:
.. code-block:: console
set service dhcpv6-server
To restart the DHCPv6 server (operational mode):
.. code-block:: console
restart dhcpv6 server
To show the current status of the DHCPv6 server use:
.. code-block:: console
show dhcpv6 server status
Show statuses of all assigned leases:
.. code-block:: console
show dhcpv6 server leases
DHCPv6 server options
^^^^^^^^^^^^^^^^^^^^^
DHCPv6 server preference value
******************************
Clients receiving advertise messages from multiple servers choose the server
with the highest preference value. The range for this value is `0...255`. Set
a preference value for the DHCPv6 server:
.. code-block:: console
set service dhcpv6-server preference <preference value>
Delete a preference:
.. code-block:: console
set service dhcpv6-server preference
Show current preference:
.. code-block:: console
show service dhcpv6-server preference
Specify address lease time
**************************
The default lease time for DHCPv6 leases is 24 hours. This can be changed by
supplying a `default-time`, `maximum-time` and `minimum-time` (all values in
seconds):
.. code-block:: console
set service dhcpv6-server shared-network-name <name> subnet <ipv6net> lease-time {default <default-time> | maximum <maximum-time> | minimum <minimum-time>}
Reset the custom lease times:
.. code-block:: console
delete service dhcpv6-server shared-network-name <name> subnet <ipv6net> lease-time {default | maximum | minimum}
Show the current configuration:
.. code-block:: console
show service dhcpv6-server shared-network-name <name> subnet <ipv6net> lease-time {default | maximum | minimum}
Specify NIS domain
******************
A Network Information (NIS) domain can be set to be used for DHCPv6 clients:
.. code-block:: console
set service dhcpv6-server shared-network-name <name> subnet <ipv6net> nis-domain <nis-domain-name>
To Delete the NIS domain:
.. code-block:: console
delete service dhcpv6-server shared-network-name <name> subnet <ipv6net> nis-domain <nis-domain-name>
Show a configured NIS domain:
.. code-block:: console
show service dhcpv6-server shared-network-name <name> subnet <ipv6net> nis-domain <nis-domain-name>
Specify NIS+ domain
*******************
The procedure to specify a Network Information Service Plus (NIS+) domain is
similar to the NIS domain one:
.. code-block:: console
set service dhcpv6-server shared-network-name <name> subnet <ipv6net> nisplus-domain <nisplus-domain-name>
To Delete the NIS+ domain:
.. code-block:: console
delete service dhcpv6-server shared-network-name <name> subnet <ipv6net> nisplus-domain <nisplus-domain-name>
Show a configured NIS domain:
# show service dhcpv6-server shared-network-name <name> subnet <ipv6net> nisplus-domain <nisplus-domain-name>
Specify NIS server address
**************************
To specify a NIS server address for DHCPv6 clients:
.. code-block:: console
set service dhcpv6-server shared-network-name <name> subnet <ipv6net> nis-server <IPv6 address>
Delete a specified NIS server address:
.. code-block:: console
delete service dhcpv6-server shared-network-name <name> subnet <ipv6net> nis-server <IPv6 address>
Show specified NIS server addresses:
.. code-block:: console
show service dhcpv6-server shared-network-name <name> subnet <ipv6net> nis-server
Specify NIS+ server address
***************************
To specify a NIS+ server address for DHCPv6 clients:
.. code-block:: console
set service dhcpv6-server shared-network-name <name> subnet <ipv6net> nisplus-server <IPv6 address>
Delete a specified NIS+ server address:
.. code-block:: console
delete service dhcpv6-server shared-network-name <name> subnet <ipv6net> nisplus-server <IPv6 address>
Show specified NIS+ server addresses:
.. code-block:: console
show service dhcpv6-server shared-network-name <name> subnet <ipv6net> nisplus-server
Specify a SIP server address for DHCPv6 clients
***********************************************
By IPv6 address
###############
A Session Initiation Protocol (SIP) server address can be specified
for DHCPv6 clients:
.. code-block:: console
set service dhcpv6-server shared-network-name <name> subnet <ipv6net> sip-server-address <IPv6 address>
Delete a specified SIP server address:
.. code-block:: console
delete service dhcpv6-server shared-network-name <name> subnet <ipv6net> sip-server-address <IPv6 address>
Show specified SIP server addresses:
.. code-block:: console
show service dhcpv6-server shared-network-name <name> subnet <ipv6net> sip-server-address
By FQDN
#######
A name for SIP server can be specified:
.. code-block:: console
set service dhcpv6-server shared-network-name <name> subnet <ipv6net> sip-server-name <sip-server-name>
Delete a specified SIP server name:
.. code-block:: console
delete service dhcpv6-server shared-network-name <name> subnet <ipv6net> sip-server-name <sip-server-name>
Show specified SIP server names:
.. code-block:: console
show service dhcpv6-server shared-network-name <name> subnet <ipv6net> sip-server-name
Simple Network Time Protocol (SNTP) server address for DHCPv6 clients
*********************************************************************
A SNTP server address can be specified for DHCPv6 clients:
.. code-block:: console
set service dhcpv6-server shared-network-name <name> subnet <ipv6net> sntp-server-address <IPv6 address>
Delete a specified SNTP server address:
.. code-block:: console
delete service dhcpv6-server shared-network-name <name> subnet <ipv6net> sntp-server-address <IPv6 address>
Show specified SNTP server addresses:
.. code-block:: console
show service dhcpv6-server shared-network-name <name> subnet <ipv6net> sntp-server-address
DHCPv6 address pools
^^^^^^^^^^^^^^^^^^^^
DHCPv6 address pools must be configured for the system to act as a DHCPv6
server. The following example describes a common scenario.
Example 1: DHCPv6 address pool
******************************
A shared network named `NET1` serves subnet `2001:db8:100::/64` which is
connected to `eth1`, a DNS server at `2001:db8:111::111` is used for name
services. The range of the address pool shall be `::100` through `::199`. The
lease time will be left at the default value which is 24 hours.
.. code-block:: console
set service dhcpv6-server shared-network-name NET1 subnet 2001:db8:100::/64 address-range start 2001:db8:100::100 stop 2001:db8:100::199
set service dhcpv6-server shared-network-name NET1 subnet 2001:db8:100::/64 name-server 2001:db8:111::111
Commit the changes and show the configuration:
.. code-block:: console
commit
show service dhcpv6-server
shared-network-name NET1 {
subnet 2001:db8:100::/64 {
address-range {
start 2001:db8:100::100 {
stop 2001:db8:100::199
}
}
name-server 2001:db8:111::111
}
}
Static mappings
^^^^^^^^^^^^^^^
In order to map specific IPv6 addresses to specific hosts static mappings can
be created. The following example explains the process.
Example 1: Static IPv6 MAC-based mapping
****************************************
IPv6 address `2001:db8:100::101` shall be statically mapped to a device with
MAC address `00:15:c5:b7:5e:23`, this host-specific mapping shall be named
`client1`.
.. note:: The MAC address identifier is defined by the last 4 byte of the
MAC address.
.. code-block:: console
set service dhcpv6-server shared-network-name NET1 subnet 2001:db8:100::/64 static-mapping client1 ipv6-address 2001:db8:100::101
set service dhcpv6-server shared-network-name NET1 subnet 2001:db8:100::/64 static-mapping client1 identifier c5b75e23
Commit the changes and show the configuration:
.. code-block:: console
show service dhcp-server shared-network-name NET1
shared-network-name NET1 {
subnet 2001:db8:100::/64 {
name-server 2001:db8:111::111
address-range {
start 2001:db8:100::100 {
stop 2001:db8:100::199 {
}
}
static-mapping client1 {
ipv6-address 2001:db8:100::101
identifier c5b75e23
}
}
}
|
