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"

AUTHOR

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