Handling external changes with Kea - User Guide - Micetro - 26.1.0

Micetro Admin Guide

ft:locale
en-US
Product name
Micetro
Version
26.1.0
Warning: You should always edit a Kea DHCP server’s configuration file through Micetro to ensure that the synchronization between Micetro and the server is instantaneous. Any modifications are immediately updated in the database and reflected in the Web Application.

Micetro uses the in-memory configuration of the Kea server. If changes must be made to a Kea DHCP server’s configuration file outside of Micetro, the changes to the configuration file will not be processed by the server until it's forced to parse the file to its in-memory structure, so that Micetro can be made aware of these changes.

If the server is the primary server in a High Availability setup, all changes made to the configuration file through Micetro will be automatically and instantly propagated to the secondary servers in the failover relationship.

However, if you make changes to the Kea DHCP server's configuration outside of Micetro, a call must be made to the DHCP Agent, Kea Control Agent (if applicable), or the socket that Kea uses in order to force the server to process those changes.

Here's an example of the call to the Control Agent:

curl -X POST -H "Content-Type: application/json" -d '{ "command": "config-reload", "service": [ "dhcp4" ] }' localhost:8000

If successful, the result looks like this:

[{"result":0,"text":"Configuration successful."}]
After the changes to the configuration file have been accepted and parsed into the Kea DHCP server's memory structure, you can use the Edit configuration action to view them in Micetro.
The Raw configuration tab of the Edit configuration dialog displays any changes you have made to the configuration file outside of Micetro.

External changes and Kea High Availability

For information about making changes to a Kea server in a High Availability setup outside of Micetro, refer to Making external changes to Kea servers in High Availability.