table of contents
other versions
- jessie-backports 1:4.0.0~rc1-4~bpo8+1
- stretch 1:4.0.0~rc1-4
- testing 1:4.2.0-1
- unstable 1:4.2.0-2
OCF_HEARTBEAT_DNSUPD(7) | OCF resource agents | OCF_HEARTBEAT_DNSUPD(7) |
NAME¶
ocf_heartbeat_dnsupdate - IP take-over via dynamic DNS updateSYNOPSIS¶
dnsupdate [start | stop | status | monitor | meta-data |
validate-all]
DESCRIPTION¶
This resource agent manages IP take-over via dynamic DNS updates.SUPPORTED PARAMETERS¶
hostnameThe hostname whose IP address will need to be updated.
(unique, required, string, no default)
ip
IP address to set.
(required, string, no default)
ttl
Time to live, in seconds, for the DNS record. This
affects how soon DNS updates propagate. It should be a reasonable compromise
between update speed and DNS server load.
If using booth, the ticket timeout is a good start.
(optional, integer, default 300)
keyfile
The file containing the shared secret needed to update
the DNS record. Please see the nsupdate man page for the exact syntax.
(optional, string, no default)
server
Which DNS server to send these updates for. When no
server is provided, this defaults to the master server for the correct zone.
(optional, string, no default)
serverport
Port number on the DNS server.
Note: due to a limitation in the nsupdate command, this option will only take
effect if you also specify the DNS server!
(optional, integer, default 53)
nsupdate_opts
Additional options to be passed to nsupdate.
(optional, string, no default)
unregister_on_stop
Whether or not to actively remove records on stop. This
is not needed for normal operation, since the site taking over the IP address
will delete all previous records.
(optional, boolean, default false)
SUPPORTED ACTIONS¶
This resource agent supports the following actions (operations): startStarts the resource. Suggested minimum timeout: 30.
stop
Stops the resource. Suggested minimum timeout: 30.
status
Performs a status check. Suggested minimum timeout: 30.
Suggested interval: 10.
monitor
Performs a detailed status check. Suggested minimum
timeout: 30. Suggested interval: 10.
meta-data
Retrieves resource agent metadata (internal use only).
Suggested minimum timeout: 5.
validate-all
Performs a validation of the resource configuration.
Suggested minimum timeout: 5.
EXAMPLE CRM SHELL¶
The following is an example configuration for a dnsupdate resource using the crm(8) shell:primitive p_dnsupdate ocf:heartbeat:dnsupdate \ params \ hostname= string \ ip= string \ op monitor depth="0" timeout="30" interval="10"
EXAMPLE PCS¶
The following is an example configuration for a dnsupdate resource using pcs(8)pcs resource create p_dnsupdate ocf:heartbeat:dnsupdate \ hostname= string \ ip= string \ op monitor depth="0" timeout="30" interval="10"
SEE ALSO¶
http://clusterlabs.org/AUTHOR¶
ClusterLabs contributors (see the resource agent source for information about individual authors)06/07/2017 | resource-agents 4.0.0~rc1-4~bp |