2. EL 7
  3. resource-agents
  4. ocf_heartbeat_Dummy(7)

Scroll to navigation

OCF_HEARTBEAT_DUMMY(7) OCF resource agents OCF_HEARTBEAT_DUMMY(7)

NAME

ocf_heartbeat_Dummy - Example stateless resource agent

SYNOPSIS

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

DESCRIPTION

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.

SUPPORTED PARAMETERS

state

Location to store the resource state in.

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

fake

Fake attribute that can be changed to cause a reload

(optional, string, default "dummy")

SUPPORTED ACTIONS

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.

EXAMPLE CRM SHELL

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"

EXAMPLE PCS

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" depth="0"

SEE ALSO

http://clusterlabs.org/

AUTHOR

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

03/19/2024 resource-agents UNKNOWN