Section 7 · Overviews and conventions

ocf_heartbeat_storage-mon.7

Package: resource-agents

OCF_HEARTBEAT_STORAG

NAME
SYNOPSIS
DESCRIPTION
SUPPORTED PARAMETERS
SUPPORTED ACTIONS
EXAMPLE CRM SHELL
EXAMPLE PCS
SEE ALSO
AUTHOR

NAME

ocf_heartbeat_storage-mon − storage I/O health status

SYNOPSIS


	storage−mon [start \| stop \| monitor \| meta−data \| validate−all]

DESCRIPTION

System health agent that checks the storage I/O status of the given drives and updates the #health−storage attribute. Usage is highly recommended in combination with the HealthSMART monitoring agent. The agent currently support a maximum of 25 devices per instance.

SUPPORTED PARAMETERS

state_file

Location to store the resource state in.

(unique, optional, string, default “/run/resource−agents/storage−mon−RESOURCE_ID.state”)

drives

The drive(s) to check as a SPACE separated list. Enter the full path to the device, e.g. “/dev/sda”.

(unique, required, string, no default)

io_timeout

Specify disk I/O timeout in seconds. Minimum 1, recommended 10 (default).

(optional, integer, default 10)

check_interval

Specify interval between I/O checks in seconds.(Only supported with the damonize option.)

(optional, integer, default 30)

inject_errors

Used only for testing! Specify % of I/O errors to simulate drives failures.

(optional, integer, no default)

daemonize

Specifies to start storage−mon as a daemon and check for devices.

(optional, boolean, default false)

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

monitor

Performs a detailed status check. Suggested minimum timeout: 120s. Suggested interval: 30s.

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 storage−mon resource using the crm(8) shell:

primitive p_storage−mon ocf:heartbeat:storage−mon \
params \
drives=string \
op monitor timeout=“120s” interval=”30s” start−delay=“0s”

EXAMPLE PCS

The following is an example configuration for a storage−mon resource using pcs(8)

pcs resource create p_storage−mon ocf:heartbeat:storage−mon \
drives=string \
op monitor timeout=“120s” interval=”30s” start−delay=“0s”

AUTHOR

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