ocf_heartbeat_azure-events-az - Man Page
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
Author
ClusterLabs contributors (see the resource agent source for information about individual authors)