OCF_HEARTBEAT_DHCPD(7)

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" depth="0"

SEE ALSO

http://clusterlabs.org/

AUTHOR

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