How to customise DHCP

[billwear]

*Errors or typos? Topics missing? Hard to read? Let us know.

Enable MAAS DHCP (UI)

• Navigate to Subnets > VLAN > Configure DHCP.
• Choose rack controller or relay to another VLAN.
• Set a Reserved dynamic range (optional).
• Save changes.

Create an IP range (UI)

• Select Subnets, choose a subnet, and Reserve range (dynamic or static).
• Enter Start and End IP addresses, then Save.

Edit, delete, or extend IP Range (UI)

• Edit or Delete: Go to Menu > Edit/Delete reserved range.
• Extend: Select Reserve dynamic range.

Enable DHCP (CLI)

maas $PROFILE vlan update $FABRIC_ID $VLAN_TAG dhcp_on=True primary_rack=$PRIMARY_RACK_CONTROLLER

For high availability (HA):

maas $PROFILE vlan update $FABRIC_ID $VLAN_TAG dhcp_on=True primary_rack=$PRIMARY_RACK_CONTROLLER secondary_rack=$SECONDARY_RACK_CONTROLLER

Set a default gateway (CLI)

maas $PROFILE subnet update $SUBNET_CIDR gateway_ip=$MY_GATEWAY

Set up a DHCP relay (UI/CLI)

1. UI: Navigate to Subnets > Relay DHCP, set target VLAN, Save.
2. CLI:

maas $PROFILE vlan update $FABRIC_ID $VLAN_VID_SRC relay_vlan=$VLAN_ID_TARGET

Manage DHCP snippets (UI/CLI)

1. UI: Add, edit, or delete snippets via Settings > DHCP snippets.
2. CLI:

maas $PROFILE dhcpsnippets create name=$NAME value=$CONFIG
maas $PROFILE dhcpsnippets read

Create IP Ranges (CLI)

• Dynamic:

maas $PROFILE ipranges create type=dynamic start_ip=$START_IP end_ip=$END_IP

• Reserved:

maas $PROFILE ipranges create type=reserved start_ip=$START_IP end_ip=$END_IP

DNS Records (CLI)

• A/AAAA records:

maas $PROFILE dnsresources create fqdn=$HOSTNAME.$DOMAIN ip_addresses=$IPV4/6_ADDRESS

• CNAME:

maas $PROFILE dnsresource-records create fqdn=$HOSTNAME rrtype=cname rrdata=$ALIAS

Resolve common DHCP issues

1. Network unreachable: Check external DHCP setup, static IP config, and netplan settings.
2. DHCP service failures: Check logs, fix configs, restart MAAS services, clear proxy cache, verify settings, and repair the database.