docs: fixed leases on the site's DHCP server
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
dbb0d93dc7
commit
c5688314b5
3 files changed
+56
No files matched your search
@@ -448,6 +448,57 @@ deploy/bootstrap.sh --iface eth1 --proxy-dhcp # the same at install ti
|
||||
Verified in the lab with a separate DHCP server on the provisioning network:
|
||||
commissioning and three deployments in a row through the proxy.
|
||||
|
||||
#### Fixed leases on the site's DHCP server (Kea, OpenWrt)
|
||||
|
||||
With a reservation driver, machines on proxy VLANs still get the addresses
|
||||
Rollcall plans: every such address becomes a fixed lease (the MAC of its
|
||||
interface, the address, the hostname) on the site's server. This is the
|
||||
counterpart of Infoblox's `fixedaddress`. Leases are reconciled on every
|
||||
address change and every `sync_interval`. Rollcall changes or deletes only
|
||||
its own leases; one held by someone else (same MAC or address) is reported
|
||||
as a conflict.
|
||||
|
||||
```json
|
||||
"dhcp_reservations": {
|
||||
"provider": "kea",
|
||||
"url": "http://kea.example:8000",
|
||||
"user": "rollcall",
|
||||
"password_file": "/etc/rollcall/kea.pw"
|
||||
}
|
||||
```
|
||||
|
||||
- **kea:** the control API with the `host_cmds` hook, open source since Kea
|
||||
3.0; Debian's Kea 2.6 lacks it and the driver says so.
|
||||
- Ownership goes in `user-context {"rollcall": machine}`.
|
||||
- With a hosts database the leases are kept there. Without one they go
|
||||
into the running configuration, and `config-write` saves them
|
||||
(`persist: false` turns that off).
|
||||
- **openwrt:** rpcd over HTTP (`url: http://router`). Fixed leases are
|
||||
`host` sections in `/etc/config/dhcp` with `option rollcall`, followed by
|
||||
`uci commit` and a dnsmasq reload. Give Rollcall its own rpcd login with
|
||||
only this:
|
||||
|
||||
```json
|
||||
/usr/share/rpcd/acl.d/rollcall.json
|
||||
{ "rollcall": { "description": "Rollcall fixed DHCP leases",
|
||||
"read": { "ubus": { "uci": ["get"] }, "uci": ["dhcp"] },
|
||||
"write": { "ubus": { "uci": ["add", "delete", "commit"], "rc": ["init"] }, "uci": ["dhcp"] } } }
|
||||
```
|
||||
|
||||
and a `config login` in `/etc/config/rpcd` (username, an MD5-crypt
|
||||
password, `list read/write 'rollcall'`).
|
||||
|
||||
```
|
||||
rollcall reservations # provider, last sync, conflicts
|
||||
rollcall reservations sync -dry
|
||||
```
|
||||
|
||||
IPv6 addresses are skipped: DHCPv6 reservations are keyed on DUIDs, not
|
||||
MACs. So are interfaces without a single MAC, such as bonds.
|
||||
|
||||
Verified in the lab against Kea 3.0.5 and OpenWrt 25.12.6: the machine got
|
||||
its planned address from the site's server and not from the pool.
|
||||
|
||||
## Certificate authority and TLS
|
||||
|
||||
The region is the installation's certificate authority, as the llmgw control
|
||||
|
||||
Reference in new issue
Block a user