SYNOPSIS
- dnsupdate [start | stop | status | monitor | meta-data | validate-all]
DESCRIPTION
SUPPORTED PARAMETERS
hostname
-
The 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):
start
- Starts 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"
AUTHOR
Linux-HA contributors (see the resource agent source for information about individual authors)