NAME

       ocf_heartbeat_LVM-activate - This agent activates/deactivates logical volumes.

SYNOPSIS

       LVM-activate [start | stop | monitor | meta-data | validate-all]

DESCRIPTION

       This agent manages LVM activation/deactivation work for a given volume group.

       It supports the following modes, controlled by the vg_access_mode parameter:

       * lvmlockd * system_id * clvmd * tagging

       Notes:

       1. There are two possible configuration combinations: lvmlockd+LVM-activate and
       clvm+LVM-activate. However, it is not possible to use both at the same time!

       2. Put all "lvmlockd"/"clvmd" volume groups into auto management by the agent if using the
       cluster to manage at least one of them. If you manage some manually, the stop action of
       the lvmlockd agent may fail and the node may get fenced, because some DLM lockspaces might
       be in use and cannot be closed automatically.

SUPPORTED PARAMETERS

       vgname
           The volume group name.

           (unique, required, string, no default)

       lvname
           If set, only the specified LV will be activated.

           (optional, string, no default)

       vg_access_mode
           This option decides which solution will be used to protect the volume group in cluster
           environment. Optional solutions are: lvmlockd, clvmd, system_id and tagging.

           (required, string, no default)

       activation_mode
           The activation mode decides the visibility of logical volumes in the cluster. There
           are two different modes: "shared" for cluster filesystem and "exclusive" for local
           filesystem. With "shared", an LV can be activated concurrently from multiple nodes.
           With "exclusive", an LV can be activated by one node at a time.

           This option only has effect on "lvmlockd"/"clvmd" vg_access_mode. For "system_id" and
           "tagging", they always mean exclusive activation.

           (optional, string, default "exclusive")

       tag
           The tag used for tagging activation mode.

           (optional, string, default "pacemaker")

SUPPORTED ACTIONS

       This resource agent supports the following actions (operations):

       start
           Starts the resource. Suggested minimum timeout: 90.

       stop
           Stops the resource. Suggested minimum timeout: 90.

       monitor
           Performs a detailed status check. Suggested minimum timeout: 90. Suggested interval:
           30.

       meta-data
           Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 10.

       validate-all
           Performs a validation of the resource configuration. Suggested minimum timeout: 20.

EXAMPLE CRM SHELL

       The following is an example configuration for a LVM-activate resource using the crm(8)
       shell:

           primitive p_LVM-activate ocf:heartbeat:LVM-activate \
             params \
               vgname=string \
               vg_access_mode=string \
             op monitor timeout="90" interval="30" depth="0"

EXAMPLE PCS

       The following is an example configuration for a LVM-activate resource using pcs(8)

           pcs resource create p_LVM-activate ocf:heartbeat:LVM-activate \
             vgname=string \
             vg_access_mode=string \
             op monitor timeout="90" interval="30" depth="0"

SEE ALSO

       http://clusterlabs.org/

AUTHOR

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