Changeset c320d40 for server/major
- Timestamp:
- 12/04/2023 03:07:13 PM (10 months ago)
- Branches:
- 12.1, 12.2, gimp3, ken/TL2024, lazarus, plabs/newcss, python3.11, rahul/power-profiles-daemon, trunk, xry111/for-12.3, xry111/llvm18, xry111/spidermonkey128
- Children:
- d1d8cc44
- Parents:
- 64b92e43
- git-author:
- Pierre Labastie <pierre.labastie@…> (12/03/2023 09:35:34 PM)
- git-committer:
- Pierre Labastie <pierre.labastie@…> (12/04/2023 03:07:13 PM)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
server/major/kea.xml
r64b92e43 rc320d40 170 170 <title>Configuring ISC Kea DHCP Server</title> 171 171 172 <para>The support of IPv4, IPv6 and DDNS has been split into 173 separate servers which runs independently from each other. Each 174 of them has its own configuration file. Additional configuration 175 files come from the keactrl agent which is uses to control the 176 servers in an easy way.</para> 177 178 <para>Consult the 179 <ulink url="https://kea.readthedocs.io/en/kea-&kea-arm-vers;/">Kea Administrator Reference Manual</ulink> 180 for detailed information about the configuration of <application>ISC Kea</application> 181 as it is a quite capable system. The configuration shown a bare 182 minimum to get a DHCP server running but it already includes 183 configuration for DDNS (Dynamic DNS). That setup might be working 184 for small networks with a few clients and low traffic. For greater 185 installations with thousands of clients, <application>ISC Kea</application> 186 can be configured to use databases (mariadb or postgresql) to store 187 the leases and build a cluster with multiple nodes. It can 188 be integrated to <ulink url="https://www.isc.org/categories/stork/">ISC Stork</ulink> 189 which is a management dashboard to <application>ISC Kea</application>.</para> 172 <para> 173 The support of IPv4, IPv6 and DDNS has been split into 174 separate servers which runs independently from each other. Each 175 of them has its own configuration file.<phrase revision="sysv"> 176 Additional configuration files come from the keactrl agent which 177 is used to control the servers in an easy way.</phrase> 178 </para> 179 180 <para> 181 Consult the <ulink 182 url="https://kea.readthedocs.io/en/kea-&kea-arm-vers;/"> 183 Kea Administrator Reference Manual</ulink> 184 for detailed information about the configuration of 185 <application>ISC Kea</application> as it is a quite capable system. 186 The configuration shown below is a bare minimum to get a DHCP server 187 running but it already includes configuration for DDNS (Dynamic DNS). 188 That setup might be working for small networks with a few clients and 189 low traffic. For greater installations with thousands of clients, 190 <application>ISC Kea</application> can be configured to use databases 191 (mariadb or postgresql) to store the leases and build a cluster with 192 multiple nodes. It can be integrated to 193 <ulink url="https://www.isc.org/categories/stork/">ISC Stork</ulink> 194 which is a management dashboard to <application>ISC Kea</application>. 195 </para> 190 196 191 197 <para> … … 206 212 207 213 <para> 208 <filename>/etc/kea/keactrl.conf</filename>, 214 <phrase revision="sysv"> 215 <filename>/etc/kea/keactrl.conf</filename>, 216 </phrase> 209 217 <filename>/etc/kea/kea-ctrl-agent.conf</filename>, 210 218 <filename>/etc/kea/kea-dhcp4.conf</filename>, 211 <filename>/etc/kea/kea-dhcp6.conf</filename> and219 <filename>/etc/kea/kea-dhcp6.conf</filename>, and 212 220 <filename>/etc/kea/kea-dhcp-ddns.conf</filename> 213 221 </para> 214 222 215 <indexterm zone="kea keactrl-config" >223 <indexterm zone="kea keactrl-config" revision="sysv"> 216 224 <primary sortas="e-etc-kea-keactrl.conf">/etc/kea/keactrl.conf</primary> 217 225 </indexterm> … … 224 232 <primary sortas="e-etc-kea-dhcp4.conf">/etc/kea/kea-dhcp4.conf</primary> 225 233 </indexterm> 226 <!-- 234 227 235 <indexterm zone="kea kea-dhcp6-config"> 228 236 <primary sortas="e-etc-kea-dhcp6.conf">/etc/kea/kea-dhcp6.conf</primary> 229 237 </indexterm> 230 --> 238 231 239 <indexterm zone="kea kea-dhcp-ddns-config"> 232 240 <primary sortas="e-etc-kea-dhcp-ddns.conf">/etc/kea/kea-dhcp-ddns.conf</primary> … … 234 242 </sect3> 235 243 236 <sect3 id="keactrl-config" >244 <sect3 id="keactrl-config" revision="sysv"> 237 245 <title>Kea Control Configuration</title> 238 246 … … 279 287 </itemizedlist> 280 288 281 <para>The Netconf service is not installed because required 282 dependencies are not covered by the current BLFS book.</para> 283 284 <para>With the following command, Kea will be configured to 285 start the dhcp service for IPv4 and the 286 dynamic DNS update, while the control agent and 287 the dhcp service for IPv6 remains down. Tweak the command to 288 match your needs on started services and execute as the 289 <systemitem class="username">root</systemitem> user:</para> 289 <para> 290 The Netconf service is not installed because required 291 dependencies are not covered by the current BLFS book. 292 . </para> 293 294 <para> 295 With the following command, Kea will be configured to 296 start the dhcp service for IPv4 and the 297 dynamic DNS update, while the control agent and 298 the dhcp service for IPv6 remain down. Tweak the command to 299 match your needs on started services and execute as the 300 &root; user: 301 </para> 290 302 291 303 <screen role="root"><userinput>sed -e "s/^dhcp4=.*/dhcp4=yes/" \ … … 295 307 -i /etc/kea/keactrl.conf 296 308 </userinput></screen> 309 310 </sect3> 311 312 <sect3 id="kea-sysd-config" revision="systemd"> 313 <title>Kea Configuration Using Systemd Units</title> 314 315 <para> 316 Four service units are used to start various daemons 317 provided by Kea: 318 </para> 319 320 <itemizedlist> 321 <listitem> 322 <para>Control Agent</para> 323 <para> 324 The Control Agent is a daemon which allows the 325 (re)configuration of the Kea DHCP service via REST API. 326 Run <command>systemctl enable kea-ctrl-agent</command> 327 if this daemon is needed. 328 </para> 329 </listitem> 330 <listitem> 331 <para>IPv4 DHCP server</para> 332 <para> 333 This daemon handles requests for IPv4 addresses. 334 Run <command>systemctl enable kea-dhcp4-server</command> to 335 have it started by systemd. 336 </para> 337 </listitem> 338 <listitem> 339 <para>IPv6 DHCP server</para> 340 <para> 341 This daemon handles requests for IPv6 addresses. 342 Run <command>systemctl enable kea-dhcp6-server</command> to 343 have it started by systemd. 344 </para> 345 </listitem> 346 <listitem> 347 <para>Dynamic DNS</para> 348 <para> 349 This daemon is used to update a DNS server dynamically 350 when Kea assigns an IP address to a device. 351 Run <command>systemctl enable kea-ddns-server</command> to 352 have it started by systemd. 353 </para> 354 </listitem> 355 </itemizedlist> 356 357 <para>The Netconf service is not installed because required 358 dependencies are not covered by the current BLFS book.</para> 297 359 298 360 </sect3> … … 444 506 EOF</userinput></screen> 445 507 508 </sect3> 509 510 <sect3 id="kea-dhcp6-config"> 511 <title>IPv6 DHCP Server Configuration</title> 512 446 513 <para> 447 514 The configuration for IPv6 is similar to the configuration
Note:
See TracChangeset
for help on using the changeset viewer.