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"

SEE ALSO

       http://clusterlabs.org/

AUTHOR

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

resource-agents 4.16.0-2ubuntu                     02/19/2025                            OCF_HEARTBEAT_STORAG(7)