-Dynamic IPAM is configured by specifying the `networks` dictionary in
-the cluster chart. At least two entries must be included, the
-`baremetal` and `provisioning` networks. Under each entry, provide the
-predictable network interface name as the value of `interface` key.
-
+Dynamic IPAM is configured by specifying IP pools containing the
+address ranges to assign and the interface and network mapping to the
+pools. The IP pools are specified with the `ipPools` dictionary in
+the cluster chart. From the chart example values:
+
+ ipPools:
+ baremetal:
+ # start is the beginning of the address range in the pool.
+ start: 192.168.151.10
+ # end is the end of the address range in the pool.
+ end: 192.168.151.20
+ # prefix is the network prefix of addresses in the range.
+ prefix: 24
+ # gateway is optional.
+ #gateway: 192.168.151.1
+ # preAllocations are optional. Note that if the pool overlaps
+ # with the gateway, then a pre-allocation is required.
+ #preAllocations:
+ # controlPlane: 192.168.151.254
+
+The interface and network mapping is specified with the `networkData`
+dictionary in the cluster chart. From the chart example values:
+
+ networkData:
+ links:
+ ethernets:
+ baremetal:
+ interface: ens6
+ provisioning:
+ interface: ens5
+ networks:
+ ipv4DHCP:
+ provisioning: {}
+ ipv4:
+ baremetal:
+ # link is optional and defaults to the network name.
+ #link: baremetal
+ fromIPPool: baremetal
+ services:
+ dns:
+ - 8.8.8.8
+
+At least two entries must be included, the `baremetal` and
+`provisioning` networks and the provisioning network must always be
+type `ipv4DHCP`. Under each entry, provide the predictable network
+interface name as the value of `interface` key.
+