1KEA-CTRL-AGENT(8)                     Kea                    KEA-CTRL-AGENT(8)
2
3
4

NAME

6       kea-ctrl-agent - Control Agent process in Kea
7

SYNOPSIS

9       kea-ctrl-agent [-v] [-V] [-W] [-d] [-c config-file] [-t config-file]
10

DESCRIPTION

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 en‐
15       capsulated within HTTP responses and returned to  the  controlling  en‐
16       tity.  Some  commands may be handled by the Control Agent directly, and
17       not forwarded to any Kea service.
18

ARGUMENTS

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

DOCUMENTATION

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

MAILING LISTS AND SUPPORT

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

HISTORY

69       The kea-ctrl-agent was first coded in December 2016 by  Marcin  Siodel‐
70       ski.
71

SEE ALSO

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

AUTHOR

77       Internet Systems Consortium
78

80       2019-2021, Internet Systems Consortium
81
82
83
84
851.9.8                            Aug 06, 2021                KEA-CTRL-AGENT(8)
Impressum