NAME

       ocf_heartbeat_openstack-cinder-volume - Attach a cinder volume

SYNOPSIS

       openstack-cinder-volume [start | stop | monitor | meta-data | validate-all]

DESCRIPTION

       Resource Agent to attach a cinder volume to an instance. It relies on attributes given by
       openstack-info resource agent (openstack_id attribute).

SUPPORTED PARAMETERS

       openstackcli
           Path to command line tools for openstack.

           (optional, string, default "/usr/bin/openstack")

       node_id_cache_file
           Path to Node ID cache file, used to avoid Openstack API calls: 1. Is the local file
           written? 2. Is openstack_id available as a node attribute? 3. Can we get it from the
           API?

           (optional, string, default "/run/resource-agents/node_id")

       volume_local_check
           This option allows the cluster to monitor the cinder volume presence without calling
           the API.

           (optional, boolean, default true)

       openrc
           Valid Openstack credentials as openrc file from api_access/openrc.

           (required, string, no default)

       volume_id
           Cinder volume identifier to use to attach the bloc storage.

           (required, string, no default)

SUPPORTED ACTIONS

       This resource agent supports the following actions (operations):

       start
           Starts the resource. Suggested minimum timeout: 180s.

       stop
           Stops the resource. Suggested minimum timeout: 180s.

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

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

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

EXAMPLE CRM SHELL

       The following is an example configuration for a openstack-cinder-volume resource using the
       crm(8) shell:

           primitive p_openstack-cinder-volume ocf:heartbeat:openstack-cinder-volume \
             params \
               openrc=string \
               volume_id=string \
             op monitor depth="0" timeout="30s" interval="60s"

EXAMPLE PCS

       The following is an example configuration for a openstack-cinder-volume resource using
       pcs(8)

           pcs resource create p_openstack-cinder-volume ocf:heartbeat:openstack-cinder-volume \
             openrc=string \
             volume_id=string \
             op monitor OCF_CHECK_LEVEL="0" timeout="30s" interval="60s"

SEE ALSO

       http://clusterlabs.org/

AUTHOR

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