NameDateSize

..Today32

ChangeLog.mdH A D03-Apr-2022364

conflex.cH A D03-Apr-202239.6 KiB

confparse.cH A D03-Apr-2022131.1 KiB

data.cH A D03-Apr-202222.1 KiB

data.hH A D03-Apr-20229.4 KiB

dhctoken.hH A D03-Apr-20227.5 KiB

doc.txtH A D03-Aug-202018.7 KiB

eval.cH A D03-Apr-202258 KiB

json.cH A D03-Apr-20224.7 KiB

keama.8H A D03-Apr-20222.8 KiB

keama.cH A D03-Apr-20225.7 KiB

keama.hH A D03-Apr-202214.4 KiB

Makefile.amH A D03-Aug-2020266

Makefile.inH A D03-Apr-202222.9 KiB

options.cH A D03-Apr-202236.9 KiB

parse.cH A D03-Apr-2022152.2 KiB

print.cH A D03-Apr-202237.4 KiB

README.mdH A D03-Aug-20201.8 KiB

reduce.cH A D03-Apr-202227.1 KiB

tests/H04-Aug-2020409

README.md

1# KEA Migration Assistant Short Guide.
2
3The KEA Migration Assistant (aka _keama_) is an experimental tool
4which helps to translate ISC DHCP configurations to Kea.
5
6## How to get last sources
7
8From time to time the _keama_ is upgraded for bug fixes, support of
9new or not yet ISC DHCP features or more likely support of new KEA
10features.
11
12As now _keama_ is included in ISC DHCP the most recent code can be
13found with the most recent ISC DHCP code in the master branch of the
14gitlab repository.
15
16## How to build and install
17
18After the ISC DHCP build go to the keama directory and type:
19```console
20make
21```
22To install it:
23```console
24make install
25```
26
27## Known limitations
28
29_keama_ uses a subset of the ISC DHCP configuration file parser with a lot
30of sanaity checks removed so it does not know how to handle an incorrect
31ISC DHCP configuration file and eventually can even crash on it.
32
33ISC DHCP and KEA have different models for many things, for instance
34ISC DHCP supports the failover protocol when KEA supports High Availability.
35In some cases _keama_ tries to cope with that, for instance for host
36reservations which are global in ISC DHCP and by default per subnet in KEA.
37
38## How to use
39
40The manual explains how parameters guide _keama_ choices for lifetimes,
41name literals, host reservation scope, etc. Directives were added to
42the ISC DHCP syntax (they are valid but ignored) for options.
43
44Each time _keama_ finds a feature it can't translate it emits a comment
45with a reference to the feature description in a kea (not isc dhcp) gitlab
46issue in the "ISC DHCP Migration" milestone. The number of reports is
47returned by _keama_ when it exits.
48
49## How to help
50
51If you have configuration patterns you would like to see supported
52by Keama please feel free to reach out to us. We are always looking
53to improve the tool.
54