DOKK / manpages / debian 12 / resource-agents / ocf_heartbeat_Dummy.7.en
OCF_HEARTBEAT_DUMMY(7) OCF resource agents OCF_HEARTBEAT_DUMMY(7)

ocf_heartbeat_Dummy - Example stateless resource agent

Dummy [start | stop | monitor | migrate_to | migrate_from | meta-data | validate-all]

This is a Dummy Resource Agent. It does absolutely nothing except keep track of whether its running or not. Its purpose in life is for testing and to serve as a template for RA writers.

NB: Please pay attention to the timeouts specified in the actions section below. They should be meaningful for the kind of resource the agent manages. They should be the minimum advised timeouts, but they shouldn't/cannot cover _all_ possible resource instances. So, try to be neither overly generous nor too stingy, but moderate. The minimum timeouts should never be below 10 seconds.

This resource agent may be configured for native migration if available in the cluster manager. For Pacemaker, the allow-migrate="true" meta attribute enables native migration.

state

Location to store the resource state in.

(unique, optional, string, default "/run/resource-agents/Dummy-RESOURCE_ID.state")

fake

Fake attribute that can be changed to cause a reload

(optional, string, default "dummy")

This resource agent supports the following actions (operations):

start

Starts the resource. Suggested minimum timeout: 20s.

stop

Stops the resource. Suggested minimum timeout: 20s.

monitor

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

reload

Suggested minimum timeout: 20s.

migrate_to

Executes steps necessary for migrating the resource to the node. Suggested minimum timeout: 20s.

migrate_from

Executes steps necessary for migrating the resource away from the node. Suggested minimum timeout: 20s.

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

The following is an example configuration for a Dummy resource using the crm(8) shell:

primitive p_Dummy ocf:heartbeat:Dummy \

meta allow-migrate="true" \
op monitor timeout="20s" interval="10s" depth="0"

The following is an example configuration for a Dummy resource using pcs(8)

pcs resource create p_Dummy ocf:heartbeat:Dummy \

op monitor timeout="20s" interval="10s" OCF_CHECK_LEVEL="0"

http://clusterlabs.org/

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

04/13/2023 resource-agents 4.12.0-2