1. Manuals
  2. Tumbleweed
  3. resource-agents
  4. ocf_heartbeat_azure-events-az(7)

Scroll to navigation

OCF_HEARTBEAT_AZURE() OCF_HEARTBEAT_AZURE()

NAME

ocf_heartbeat_azure-events-az - Microsoft Azure Scheduled Events monitoring agent

SYNOPSIS

azure-events-az [start | stop | monitor | meta-data | validate-all]

DESCRIPTION

This resource agent implements a monitor for scheduled (maintenance) events for a Microsoft Azure VM.

If any relevant events are found, it moves all Pacemaker resources away from the affected node to allow for a graceful shutdown.

Deployment:

Set property and location constraint: crm configure property node-health-strategy=custom crm configure location loc_azure_health /'!health-.*'/ rule '#health-azure': defined '#uname'

Set #health-azure attribute to 0 (healthy) for every node in the cluster (example of node1 only): crm_attribute --node node1 --name '#health-azure' --update 0 Configure the RA: crm configure primitive health-azure-events ocf:heartbeat:azure-events-az params eventTypes="Reboot,Redeploy" verbose=false retry_count=3 retry_wait=20 request_timeout=15 op start start-delay=60s op monitor interval=10s meta failure-timeout=120s crm configure clone health-azure-events-cln health-azure-events meta allow-unhealthy-nodes=true

For further information on Microsoft Azure Scheduled Events, please refer to the following documentation: https://docs.microsoft.com/en-us/azure/virtual-machines/linux/scheduled-events

SUPPORTED PARAMETERS

eventTypes

A comma-separated list of event types that will be handled by this resource agent. (Possible values: Freeze,Reboot,Redeploy)

(optional, string, default "Reboot,Redeploy")

verbose

Set to true to enable verbose logging

(optional, boolean, default false)

retry_count

Set to any number bigger than zero to enable retry count

(optional, integer, default 3)

retry_wait

Set retry wait time in seconds

(optional, integer, default 20)

request_timeout

Set request timeout in seconds

(optional, integer, default 15)

SUPPORTED ACTIONS

This resource agent supports the following actions (operations):

start

Starts the resource. Suggested minimum timeout: 10s.

stop

Stops the resource. Suggested minimum timeout: 10s.

validate-all

Performs a validation of the resource configuration. Suggested minimum timeout: 20s.

monitor

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

meta-data

Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 10s.

EXAMPLE CRM SHELL

The following is an example configuration for a azure-events-az resource using the crm(8) shell:

primitive p_azure-events-az ocf:heartbeat:azure-events-az \


  op monitor timeout="240s" interval="10s"

EXAMPLE PCS

The following is an example configuration for a azure-events-az resource using pcs(8)

pcs resource create p_azure-events-az ocf:heartbeat:azure-events-az \


  op monitor timeout="240s" interval="10s"

SEE ALSO

http://clusterlabs.org/

AUTHOR

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