---
name: "ocf_heartbeat_dhcpd"
section: "7"
platform: "linux"
package: "resource-agents"
version: "1:4.16.0-3+deb13u2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ocf_heartbeat_dhcpd"
---

# ocf\_heartbeat\_dhcpd(7)

Chrooted ISC DHCP server resource agent.

## 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)](/crm/8.md) 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/8.md)

```
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)**