1KEA-CTRL-AGENT(8) Kea KEA-CTRL-AGENT(8)
2
3
4
6 kea-ctrl-agent - Control Agent process in Kea
7
9 kea-ctrl-agent [-v] [-V] [-W] [-d] [-c config-file] [-t config-file]
10
12 The kea-ctrl-agent provides a REST service for controlling Kea ser‐
13 vices. The received HTTP requests are decapsulated and forwarded to the
14 respective Kea services in JSON format. Received JSON responses are
15 encapsulated within HTTP responses and returned to the controlling
16 entity. Some commands may be handled by the Control Agent directly, and
17 not forwarded to any Kea service.
18
20 The arguments are as follows:
21
22 -v Displays the version.
23
24 -V Displays the extended version.
25
26 -W Displays the configuration report.
27
28 -d Sets the logging level to debug with extra verbosity. This is
29 primarily for development purposes in stand-alone mode.
30
31 -c config-file
32 Specifies the file with the configuration for the Control Agent
33 server. It may also contain configuration entries for other Kea
34 services.
35
36 -t config-file
37 Checks the syntax of the configuration file and reports the
38 first error, if any. Note that not all parameters are completely
39 checked; in particular, service and client sockets are not
40 opened, and hook libraries are not loaded.
41
43 Kea comes with an extensive Kea Administrator Reference Manual that
44 covers all aspects of running the Kea software - compilation, installa‐
45 tion, configuration, configuration examples, and much more. Kea also
46 features a Kea Messages Manual, which lists all possible messages Kea
47 can print with a brief description for each of them. Both documents are
48 available in various formats (.txt, .html, .pdf) with the Kea distribu‐
49 tion. The Kea documentation is available at
50 https://kb.isc.org/docs/kea-administrator-reference-manual .
51
52 Kea source code is documented in the Kea Developer's Guide. Its online
53 version is available at https://jenkins.isc.org/job/Kea_doc/doxygen/.
54
55 The Kea project website is available at https://kea.isc.org.
56
58 There are two public mailing lists available for the Kea project.
59 kea-users (kea-users at lists.isc.org) is intended for Kea users, while
60 kea-dev (kea-dev at lists.isc.org) is intended for Kea developers,
61 prospective contributors, and other advanced users. Both lists are
62 available at https://lists.isc.org. The community provides best-effort
63 support on both of those lists.
64
65 ISC provides professional support for Kea services. See
66 https://www.isc.org/kea/ for details.
67
69 The kea-ctrl-agent was first coded in December 2016 by Marcin Siodel‐
70 ski.
71
73 kea-dhcp4(8), kea-dhcp6(8), kea-dhcp-ddns(8), kea-admin(8), keactrl(8),
74 perfdhcp(8), kea-lfc(8), Kea Administrator Reference Manual.
75
77 Internet Systems Consortium
78
80 2020, Internet Systems Consortium
81
82
83
84
851.6.0 Jan 29, 2020 KEA-CTRL-AGENT(8)