1KEA-ADMIN(8) Kea KEA-ADMIN(8)
2
6 kea-admin - Shell script for managing Kea databases
7
9 kea-admin [command] [backend] [-u database username] [-p database pass‐
10 word] [-n database name] [-d scripts directory] [-4 | -6] [-o output
11 file] [-v]
12
14 kea-admin is a shell script which offers database maintenance. In par‐
15 ticular, it features database initialization, database version check‐
16 ing, and database schema upgrade.
17
19 command
20 Specifies the command to be issued to the servers. It can be one
21 of the following:
22 lease-init
24 Initializes a new lease database, which is useful during
25 the first Kea installation. The database is initialized
26 to the latest version supported by the version of the
27 software.
28 lease-version
30 Reports the lease database version. This is not necessar‐
31 ily the same as the Kea version, as each backend has its
32 own versioning scheme.
33 lease-upgrade
35 Conducts a lease database upgrade. This is useful when
36 migrating between old and new Kea versions.
37 lease-dump
39 Dumps the contents of the lease database (MySQL and Post‐
40 greSQL backends) to a text file. The content of the file
41 consists of comma-separated values (CSV) where each line
42 in the file contains all of the values for a single
43 lease. The first line of the file is a header line con‐
44 taining the column names.
45 backend
47 Specifies the backend type. Currently allowed backends are: mem‐
48 file, mysql, and pgsql.
49 -u|--user username
51 Specifies the username when connecting to a database. If not
52 specified, the default value of keatest is used.
53 -p|--password password
55 Specifies the password when connecting to a database. If not
56 specified, the default value of keatest is used.
57 -n|--name database-name
59 Specifies the name of the database to connect to. If not speci‐
60 fied, the default value of keatest is used.
61 -d|--directory script-directory
63 Specifies the override scripts directory. That script is used
64 during upgrades, database initialization, and possibly other
65 operations. If not specified, the default value of (pre‐
66 fix)/share/kea/scripts/ is used.
67 -o|--output output_file
69 Specifies the file to which the lease data will be dumped.
70 Required for lease-dump.
71 -v|--version
73 Prints the kea-admin version and quits.
74 -4 Directs kea-admin to lease-dump the DHCPv4 leases. Incompatible
76 with the -6 option.
77 -6 Directs kea-admin to lease-dump the DHCPv6 leases. Incompatible
79 with the -4 option.
80
82 Kea comes with an extensive Kea Administrator Reference Manual that
83 covers all aspects of running the Kea software - compilation, installa‐
84 tion, configuration, configuration examples, and much more. Kea also
85 features a Kea Messages Manual, which lists all possible messages Kea
86 can print with a brief description for each of them. Both documents are
87 available in various formats (.txt, .html, .pdf) with the Kea distribu‐
88 tion. The Kea documentation is available at
89 https://kb.isc.org/docs/kea-administrator-reference-manual .
90 Kea source code is documented in the Kea Developer's Guide. Its online
92 version is available at https://jenkins.isc.org/job/Kea_doc/doxygen/.
93 The Kea project website is available at https://kea.isc.org.
95
97 There are two public mailing lists available for the Kea project.
98 kea-users (kea-users at lists.isc.org) is intended for Kea users, while
99 kea-dev (kea-dev at lists.isc.org) is intended for Kea developers,
100 prospective contributors, and other advanced users. Both lists are
101 available at https://lists.isc.org. The community provides best-effort
102 support on both of those lists.
103 ISC provides professional support for Kea services. See
105 https://www.isc.org/kea/ for details.
106
108 kea-dhcp4(8), kea-dhcp6(8), kea-dhcp-ddns(8), kea-ctrl-agent(8), keac‐
109 trl(8), perfdhcp(8), kea-netconf(8), Kea Administrator Reference Man‐
110 ual.
111
113 Internet Systems Consortium
114
116 2020, Internet Systems Consortium
1171.6.0 Jan 29, 2020 KEA-ADMIN(8)