ISC-DHCP to KEA Migration Tool for IPv4/IPv6 Static Mappings

Started by Sheridan Computers, Today at 03:50:49 PM

Previous topic - Next topic
Today at 03:50:49 PM Last Edit: Today at 03:52:36 PM by Sheridan Computers Reason: Added version tested with
I recently a small CLI tool I wrote for a client migration to help move ISC DHCP static mappings to Kea reservations using the OPNsense config.xml, as there's currently no way to export IPv6 static mappings via web interface.

I've open sourced it on github (should have releases for Linux, Windows, Mac).

It supports both IPv4 and IPv6 static mappings (including DUID, hostname, domain search, description). I originally wrote it mainly to handle DHCPv6 static reservations, since there isn't currently a GUI export/import path for those.

It's safe by default (reads the input config and writes to a new output file so you can review before importing) and only migrates static reservations, not pools or options.

This is very much a v1 community tool, so please test (pref in a lab) first and take a backup/snapshot before importing. If anyone wants to try it and provide feedback or edge cases, I'd really appreciate it.

See the Github README for command line usage.

  • Leave kea disabled for now
  • Create the relevant IPv4 and IPv6 subnets in kea
  • Download the config (from system settings in GUI)
  • Use scan option first to see what will change
  • Use the convert option to create a new xml config
  • Restore the new config from OPNsense gui
  • Check the kea settings everything imported
  • Disable isc and enable kea

Tested with 25.7.11:
ISC-DHCP to Kea Migration Tool
--
Need to hire an OPNsense professional?
sheridancomputers.co.uk