NAME

       ocf_heartbeat_dhcpd - Chrooted ISC DHCP server resource agent.

SYNOPSIS

       dhcpd [start | stop | monitor | meta-data | validate-all]

DESCRIPTION

       Manage an ISC DHCP server service in a chroot environment.

SUPPORTED PARAMETERS

       config
           The absolute path to the DHCP server configuration file.

           (unique, required, string, no default)

       chrooted
           Configure the dhcpd service to run in a chrooted or non-chrooted mode.

           (unique, optional, boolean, default true)

       chrooted_path
           The absolute path of the chrooted DHCP environment.

           (unique, optional, string, default "/var/lib/dhcp")

       binary
           The binary for the DHCP server process. An absolute path definition is not required,
           but can be used to override environment path.

           (optional, string, default "dhcpd")

       user
           The system user the DHCP server process will run as when it is chrooted.

           (optional, string, default "dhcpd")

       group
           The system group the DHCP server process will run as when it is chrooted.

           (optional, string, default "nogroup")

       interface
           The network interface(s) the DHCP server process will bind to. A blank value will bind
           the process to all interfaces.

           (optional, string, no default)

       includes
           This parameter provides a means to copy include files into the chrooted environment.
           If a dhcpd.conf file contains a line similar to this:

           include "/etc/named.keys";

           Then an admin also has to tell the dhcpd RA that this file should be pulled into the
           chrooted environment. This is a space delimited list.

           (optional, string, no default)

       leases
           The leases database file, relative to chrooted_path.

           (optional, string, default "/db/dhcpd.leases")

       pid
           The path and filename of the PID file. It is relative to chrooted_path.

           (optional, string, default "/var/run/dhcpd.pid")

SUPPORTED ACTIONS

       This resource agent supports the following actions (operations):

       start
           Starts the resource. Suggested minimum timeout: 20s.

       stop
           Stops the resource. Suggested minimum timeout: 20s.

       restart
           Suggested minimum timeout: 20s.

       monitor
           Performs a detailed status check. Suggested minimum timeout: 20s. Suggested interval:
           10s.

       meta-data
           Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s.

       validate-all
           Performs a validation of the resource configuration. Suggested minimum timeout: 20s.

EXAMPLE CRM SHELL

       The following is an example configuration for a dhcpd resource using the crm(8) shell:

           primitive p_dhcpd ocf:heartbeat:dhcpd \
             params \
               config=string \
             op monitor timeout="20s" interval="10s" depth="0"

EXAMPLE PCS

       The following is an example configuration for a dhcpd resource using pcs(8)

           pcs resource create p_dhcpd ocf:heartbeat:dhcpd \
             config=string \
             op monitor timeout="20s" interval="10s" OCF_CHECK_LEVEL="0"

SEE ALSO

       http://clusterlabs.org/

AUTHOR

       ClusterLabs contributors (see the resource agent source for information about individual
       authors)