NAME

dhcpd - A component for configuring the dhcpd service

DESCRIPTION

This component will build an /etc/dhcpd.conf file for the dhcp daemon based on information published by prospective DHCP clients to the spanning map specified by the cluster resource.

Each client must define a dhclient.mac resource; it should define a dhclient.hostname resource if its correct fully qualified domain name is not implied by its LCFG source profile name and the default DNS domain; and it may also define other dhcpd settings via dhclient resources, which then take precedence over the corresponding settings in force either globally or by subnet.

DHCP service for a client's Baseboard Management Controller (BMC) is also supported. Should this be required, the client must define both a dhclient.bmcmac resource and a dhclient.bmchostname resource.

As well as providing for fixed address allocation, this component allows a range of dynamic addresses to be defined per subnet.

RESOURCES

Resources relating to the dhcpd daemon in use on the server

dhcpdbin

The full pathname of the dhcpd binary in use on the DHCP server. The default is /usr/sbin/dhcpd.

dhcpdconfigfile

The full pathname of the dhcpd daemon's configuration file. The default is /etc/dhcpd.conf.

dhcpdinitscript

The full pathname of the `/etc/init.d' script used to stop and start the dhcpd daemon. The default is /etc/rc.d/init.d/dhcpd.

pidfile

The full pathname of the file containing the PID of the running dhcpd daemon. The default is /var/run/dhcpd.pid.

leasesdbdir

The full pathname of the directory in which the dhcpd daemon's leases database file is stored. The default is /var/lib/dhcpd.

Resources controlling configure-time behaviour of this component

interfaces

A list of the interfaces on the server for which DHCP service is to be configured.

dhcpdadmin

An email address for admin emails from the component.

Resources determined by the spanning map

cluster

The name of the spanning map to which this component should subscribe in order to receive configuration information published by each prospective client. The default is dhcp/all.

hosts

A tag list of hosts produced by the spanning map subscription. Each host is a prospective DHCP client. The spanning map then makes the following resources available per client:

hostname_client

The hostname to set for the client.

mac_client

The MAC address of the client, in the format six groups of two hexadecimal digits, separated by either colons or hyphens (eg 01:23:45:67:89:AB).

hostbootmenu_client

The name of the grub menu file to be downloaded by the client.

hostfilename_client

The name of bootable file to be tftp'ed by the client.

bmchostname_client

The fully qualified hostname to set for the client's BMC, should this also require DHCP configuration.

bmcmac_client

The MAC address of the client's BMC, should this also require DHCP configuration, in the format six groups of two hexadecimal digits, separated by either colons or hyphens (eg 01:23:45:67:89:AB).

Resources controlling settings in the /etc/dhcpd.conf file to be built by this component

authoritative

If defined to any non-null value, configures the DHCP server as authoritative.

dnsdomain

The default dns domain.

nisdomain

The default nisdomain.

smtpservers

A space separated list of mailservers.

ntpservers

A space separated list of ntp servers.

netbios-node-type

The NetBIOS node type option allows NetBIOS over TCP/IP clients which are configurable to be configured as described in RFC 1001/1002.

netbios-name-servers

The NetBIOS name server (NBNS) option specifies a list of RFC 1001/1002 NBNS name servers listed in order of preference. NetBIOS Name Service is currently more commonly referred to as WINS. WINS servers can be specified using the netbios-name-servers option.

rdisc

Set to on (the default) for router discovery.

bootp

Set to yes to allow the dhcpd server to answer bootp requests. The default is no.

ddns_update_style

The convention used to pass dynamic dns updates to the dns server. The default is `none'.

PXE_mtftp_ip

The multicast tftpd server address for PXE booting.

useroption

A tag list of user defined options. (For further information on such options, see the `Defining New Options' section of dhcpd-options(5).)

uoptname_useroption

The name of the option.

uoptcode_useroption

The bootp/dhcp option code the option refers to.

uopttype_useroption

The type (text, ipaddr etc) the option has.

uoptvalue_useroption

The value of this option.

spaces

A list of user defined option spaces.

subnets

A tag list of the subnets for which DHCP service is to be provided.

There is a corresponding list of resources which can be set on a by subnet basis, some of which override global settings of the same name listed above. Inspection of this component's schema file, along with the dhcpd.conf(5), man page is recommended.

BUGS

The component is currently fairly messy, and needs to be expanded to cope with additional options.

Currently unsupported features (note that this list is unlikely to be either definitive or accurate):

SEE ALSO

dhcpd.conf(5), dhcpd-options(5), dhcpd(8)

PLATFORMS

Fedora5, Fedora6, Scientific5

AUTHOR

Iain Rae <iainr@inf.ed.ac.uk>, Ian Durkacz <idurkacz@inf.ed.ac.uk>