switch over from ISC DHCP to Kea DHCP

SteveITS

@pulsartiger re: updates:
https://www.netgate.com/blog/improvements-to-kea-dhcp

Gertjan

@SteveITS said in switch over from ISC DHCP to Kea DHCP:

@pulsartiger re: updates:
https://www.netgate.com/blog/improvements-to-kea-dhcp

Yep. That info is still hiding in plain site.

( Just an idea : put the RSS at the top, and you stat auto-informed )

kuchenmann

After I tried to switch to KEA, no ip address for my pc over LAN and WLAN.
For some reason my laptop still worked, so I could take a look into my pfsense.
No leases shown under "status - DHCP leases".
After switching back to ISC everything works fine again.
DO NOT USE KEA!

WN1X

@kuchenmann I have been using Kea since it was added to pfSense 24.03 without any issues at all on my 4200. YMMV.

kuchenmann

@kuchenmann

problem is, that if ISC is configured with NTP-servers using names,
KEA fails to start, because it only accepts IP-addresses as NTP-servers.
WTF?
Never heard about pool.ntp.org?

johnpoz

@kuchenmann dhcp has never accepted fqdn for ntp.. Before pfsense would resolve that to put the IP into the dhcp server.

Pretty sure that is one of the things added in the 24.11 release.

WN1X

@kuchenmann The NTP servers provided via DHCP option 42 must be IP addresses, per RFC2132.

WN1X

@kuchenmann Why don't you set pfSense to use pool.ntp.org and set DHCP to provide the IP address of your LAN as the NTP server?

RyanM

I know this is an old topic, but seems to be the most relevant. I use static DHCP leases and that they are registered in DNS (unbound). I know the original blog stated this was a known limitation, however, this blog post (https://www.netgate.com/blog/improvements-to-kea-dhcp) seems to indicate this may be present in 24.08?

Any idea when this will become available in CE? I am on CE 2.7.2, which has a build date of 2023. I see there is an RC for 2.8.0. Maybe I will look around at how stable that is and consider upgrading...

SteveITS

@RyanM see the Kea notes in section:
https://docs.netgate.com/pfsense/en/latest/releases/2-8-0.html#general

Patch

@RyanM said in switch over from ISC DHCP to Kea DHCP:

I use static DHCP leases and that they are registered in DNS (unbound). ... Any idea when this will become available in CE?

That's a good question. Or better again "Has pfsense Kea DHCP implementation reached feature parity with pfsense ISC DHCP implementation"?

The reason this is a good question is Netgate messaging on the subject has been atrocious in the past. Made worse as somehow they tried to argue miss leading messaging was OK because if you knew it was miss leading you could go to another source, read it carefully and excused them as they left a caveat there.

My reading of the release notes https://docs.netgate.com/pfsense/en/latest/releases/2-8-0.html#general suggests Netgate's pfsense Kea implementation has improved but I'm not sure if it has reached feature parity yet.

The warning

ISC DHCP has reached end-of-life and will be removed in a future version of pfSense.

Is relevant to Netgate internal Kea development prioritization but blatantly inappropriate IMO in an inbuilt pfsence warning without their Kea implementation reaching feature parity or at least including a link to a comparison table in the warning.

Hopefully they have reached feature parity now so this concern is no longer relevant.

HuskerDu

I've just upgraded from 2.7.2 to 2.8.0.

So far it has run smoothly, so that I've decided to give KEA a try. At first glance, it is fine, except from the DHCP option point of view.

I would imagine I'll have to dig in the JSON part to complete that point.

Gertjan

@HuskerDu said in switch over from ISC DHCP to Kea DHCP:

give KEA a try. At first glance, it is fine, except from the DHCP option point of view.

'kea' = (a) DHCP (server).
Can you detail your 'except ' ?

HuskerDu

@Gertjan said in [switch over from ISC DHCP to Kea DHCP]

Can you detail your 'except ' ?

I am pointing my Unifi devices towards their controller through DHCP Option 43. With KEA, it is no longer directly possible via the GUI, I'm assuming I would have to add it with JSON.

Gertjan

@HuskerDu said in switch over from ISC DHCP to Kea DHCP:

I am pointing my Unifi devices towards their controller through DHCP Option 43. With KEA, it is no longer directly possible via the GUI, I'm assuming I would have to add it with JSON.

Oh ... but I can help you with that.
I've a Cloud Gen 2 Plus whatever device, and a load of Unifi APs.

Easy solution - the one that works without the help of DHCP :
As per Unifi documentation :
Create a host override (bottom part of General config of the resolver) called 'unifi' and let it point to IPv4 of your controller.

I called it "a_unifi" so it gets sorted on top.
You should "unifi" of course.

Btw :

as "bhf.tld" is the domain of my pfSense.

as Unifi devices, if they didn't get the controller info with option 43 in the lease from a DHCP server, they will do a DNS request for "unifi" and use that IPv4 as the controller IPv4.

Using Kea and options :
It is possible - and I'm using that right now :

On the kea DHCP server settings page :

put this in place :

{
  "option-def": [
    {
      "name": "unifi",
      "code": 1,
      "space": "vendor-encapsulated-options-space",
      "type": "string"
    }
  ]
}

and on every LAN where you have unfi stuff, (APs cameras etc), put this :

{
  "option-data":  [
    {
      "name": "vendor-encapsulated-options"
    },
    {
      "name": "unifi",
      "space": "vendor-encapsulated-options-space",
      "csv-format": false,
      "data": "C0A80109" 
    }
  ]
}

Btw "C0A80109" = 192.168.1.9 because my controller uses 192.168.1.9 - adapt yours for your controller IPv4.

See also : [Adding Custom Configuration in Kea DHCP Server with pfSense+ 25.03](Adding Custom Configuration in Kea DHCP Server with pfSense+ 25.03)

More info : Kea DHCP Custom Configuration Support (IPv4 and IPv6)

Let's test :

Packet Capture :
On a LAN, using UDP, port 67 and 68, with juicy details - and Start.
Using my Unifi, I restart a AP.
After a moment : the DHCP lease request :

16:40:51.945823 0c:ea:14:44:4a:38 > ff:ff:ff:ff:ff:ff, ethertype IPv4 (0x0800), length 342: (tos 0x0, ttl 64, id 0, offset 0, flags [none], proto UDP (17), length 328)
    0.0.0.0.68 > 255.255.255.255.67: [udp sum ok] BOOTP/DHCP, Request from 0c:ea:14:44:4a:38, length 300, xid 0x76ea1f4d, secs 51401, Flags [none] (0x0000)
	  Client-Ethernet-Address 0c:ea:14:44:4a:38
	  Vendor-rfc1048 Extensions
	    Magic Cookie 0x63825363
	    DHCP-Message (53), length 1: Discover
	    Client-ID (61), length 7: ether 0c:ea:14:44:4a:38
	    MSZ (57), length 2: 576
	    Parameter-Request (55), length 8: 
	      Subnet-Mask (1), Default-Gateway (3), Domain-Name-Server (6), Hostname (12)
	      Domain-Name (15), BR (28), NTP (42), Vendor-Option (43)
	    Vendor-Class (60), length 4: "ubnt"
	    Hostname (12), length 11: "U6ProBureau"

You see the option 43 request ?

The kea dhcp server answer :

16:40:51.948326 90:ec:77:29:39:2c > 0c:ea:14:44:4a:38, ethertype IPv4 (0x0800), length 362: (tos 0x10, ttl 128, id 0, offset 0, flags [DF], proto UDP (17), length 348)
    192.168.1.1.67 > 192.168.1.253.68: [udp sum ok] BOOTP/DHCP, Reply, length 320, xid 0x76ea1f4d, Flags [none] (0x0000)
	  Your-IP 192.168.1.253
	  Client-Ethernet-Address 0c:ea:14:44:4a:38
	  Vendor-rfc1048 Extensions
	    Magic Cookie 0x63825363
	    DHCP-Message (53), length 1: Offer
	    Subnet-Mask (1), length 4: 255.255.255.0
	    Default-Gateway (3), length 4: 192.168.1.1
	    Domain-Name-Server (6), length 4: 192.168.1.1
	    Hostname (12), length 8: "ub6prob2"
	    Domain-Name (15), length 20: "bhf.tld"
	    NTP (42), length 4: 192.168.1.1
	    Vendor-Option (43), length 6: 1.4.192.168.1.9
	    Lease-Time (51), length 4: 21600
	    Server-ID (54), length 4: 192.168.1.1

and the AP got the controller IPv4 :

Vendor-Option (43), length 6: 1.4.192.168.1.9

so "192.168.1.9"

HuskerDu

@Gertjan Thanks, that was what I was looking for.

RyanM

@Gertjan Is this required if I have a Unifi controller? Or just for certain configurations w/ Unifi?

KOM

Hilarious that you have to hack up some JSON just to add common DHCP options. Truly, the future is here today!

bmeeks

@RyanM said in switch over from ISC DHCP to Kea DHCP:

@Gertjan Is this required if I have a Unifi controller? Or just for certain configurations w/ Unifi?

My understanding is "No", this DHCP option is not required. You can also simply put a DNS host override in DNS that points to the controller's IP. A user on the "other *Sense" forum posted with similar concerns about Kea on that platform and the lack of DHCP option 43. Turns out that Unifi devices will try several ways to find the controller, and a simple DNS lookup is one of them. Here is the relevant link: https://help.ui.com/hc/en-us/articles/204909754-Remote-Adoption-Layer-3.

And here is the DNS information:

You'll need to configure your DNS server to resolve unifi to your remote UniFi Network Application.

There are two methods of specifying the machine running the Network Application:

IP Address: http://ip-address:8080/inform
Fully Qualified Domain Name (FQDN): http://FQDN:8080/inform

Finger79

Just upgraded from 2.7.2 to 2.8.0. After the upgrade, switched the DHCP backend from the ISC DHCP to ISC Kea and also enabled both the "DNS Registration" and "Early DNS Registration" options. Finally!

The only thing missing is the ability to add Custom DHCP Options! With the legacy ISC DHCP web interface, we had:

Number:
Type:
Value:

That is no longer present in the WebUI. Looking through this thread, it seems the workaround is to figure out how to format all that in JSON?