Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
OCF_HEARTBEAT_DNSUPD(7)	      OCF resource agents      OCF_HEARTBEAT_DNSUPD(7)

NAME
       ocf_heartbeat_dnsupdate - IP take-over via dynamic DNS update

SYNOPSIS
       dnsupdate [start	| stop | status	| monitor | meta-data |	validate-all]

DESCRIPTION
       This resource agent manages IP take-over	via dynamic DNS	updates.

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: 30s.

       stop
	   Stops the resource. Suggested minimum timeout: 30s.

       status
	   Performs a status check. Suggested minimum timeout: 30s. Suggested
	   interval: 10s.

       monitor
	   Performs a detailed status check. Suggested minimum timeout:	30s.
	   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: 5s.

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="30s"	interval="10s"

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	OCF_CHECK_LEVEL="0" timeout="30s" interval="10s"

SEE ALSO
       http://clusterlabs.org/

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

resource-agents	4.8.0		  09/21/2021	       OCF_HEARTBEAT_DNSUPD(7)

NAME | SYNOPSIS | DESCRIPTION | SUPPORTED PARAMETERS | SUPPORTED ACTIONS | EXAMPLE CRM SHELL | EXAMPLE PCS | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ocf_heartbeat_dnsupdate&sektion=7&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help