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

FreeBSD Manual Pages

  
 
  

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

NAME
       ocf_heartbeat_symlink - Manages a symbolic link

SYNOPSIS

       symlink [start |	stop | monitor | meta-data | validate-all]

DESCRIPTION
       This resource agent that	manages	a symbolic link	(symlink).

       It is primarily intended	to manage configuration	files which should be
       enabled or disabled based on where the resource is running, such	as
       cron job	definitions and	the like.

SUPPORTED PARAMETERS
       link
	   Full	path of	the symbolic link to be	managed. This must obviously
	   be in a filesystem that supports symbolic links.

	   (required, string, no default)

       target
	   Full	path to	the link target	(the file or directory which the
	   symlink points to).

	   (required, string, no default)

       backup_suffix
	   A suffix to append to any files that	the resource agent moves out
	   of the way because they clash with "link".

	   If this is unset (the default), then	the resource agent will	simply
	   refuse to create a symlink if it clashes with an existing file.

	   (optional, string, no default)

SUPPORTED ACTIONS
       This resource agent supports the	following actions (operations):

       start
	   Starts the resource.	Suggested minimum timeout: 15s.

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

       monitor
	   Performs a detailed status check. Suggested minimum timeout:	15s.
	   Suggested interval: 60s.

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

EXAMPLE	CRM SHELL
       The following is	an example configuration for a symlink resource	using
       the crm(8) shell:

	   primitive p_symlink ocf:heartbeat:symlink \
	     params \
	       link=string \
	       target=string \
	     op	monitor	depth="0" timeout="15s"	interval="60s"

EXAMPLE	PCS
       The following is	an example configuration for a symlink resource	using
       pcs(8)

	   pcs resource	create p_symlink ocf:heartbeat:symlink \
	     link=string \
	     target=string \
	     op	monitor	OCF_CHECK_LEVEL="0" timeout="15s" interval="60s"

SEE ALSO
       http://clusterlabs.org/

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

resource-agents	4.13.0		  04/12/2025	       OCF_HEARTBEAT_SYMLIN(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ocf_heartbeat_symlink&sektion=7&manpath=FreeBSD+Ports+14.3.quarterly>

home | help