The failover-state object is the object that tracks the state of the failover protocol as it is being managed for a given failover peer. The failover object has the following attributes (please see
dhcpd.conf (5) for explanations about what these attributes mean):
name data examine
Indicates the name of the failover peer relationship, as described in the server's dhcpd.conf file.
partner-address data examine
Indicates the failover partner's IP address.
local-address data examine
Indicates the IP address that is being used by the DHCP server for this failover pair.
partner-port data examine
Indicates the TCP port on which the failover partner is listening for failover protocol connections.
local-port data examine
Indicates the TCP port on which the DHCP server is listening for failover protocol connections for this failover pair.
max-outstanding-updates integer examine
Indicates the number of updates that can be outstanding and unacknowledged at any given time, in this failover relationship.
mclt integer examine
Indicates the maximum client lead time in this failover relationship.
load-balance-max-secs integer examine
Indicates the maximum value for the secs field in a client request before load balancing is bypassed.
load-balance-hba data examine
Indicates the load balancing hash bucket array for this failover relationship.
local-state integer examine, modify
Indicates the present state of the DHCP server in this failover relationship. Possible values for state are:
1 - partner down
2 - normal
3 - communications interrupted
4 - resolution interrupted
5 - potential conflict
6 - recover
7 - recover done
8 - shutdown
9 - paused
10 - startup
11 - recover wait
In general it is not a good idea to make changes to this state. However, in the case that the failover partner is known to be down, it can be useful to set the DHCP server's failover state to partner down. At this point the DHCP server will take over service of the failover partner's leases as soon as possible, and will give out normal leases, not leases that are restricted by MCLT. If you do put the DHCP server into the partner-down when the other DHCP server is not in the partner-down state, but is not reachable, IP address assignment conflicts are possible, even likely. Once a server has been put into partner-down mode, its failover partner must not be brought back online until communication is possible between the two servers.
partner-state integer examine
Indicates the present state of the failover partner.
local-stos integer examine
Indicates the time at which the DHCP server entered its present state in this failover relationship.
partner-stos integer examine
Indicates the time at which the failover partner entered its present state.
hierarchy integer examine
Indicates whether the DHCP server is primary (0) or secondary (1) in this failover relationship.
last-packet-sent integer examine
Indicates the time at which the most recent failover packet was sent by this DHCP server to its failover partner.
last-timestamp-received integer examine
Indicates the timestamp that was on the failover message most recently received from the failover partner.
skew integer examine
Indicates the skew between the failover partner's clock and this DHCP server's clock
max-response-delay integer examine
Indicates the time in seconds after which, if no message is received from the failover partner, the partner is assumed to be out of communication.
cur-unacked-updates integer examine
Indicates the number of update messages that have been received from the failover partner but not yet processed.