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