---
name: "ocf_heartbeat_openstack-cinder-volume"
section: "7"
platform: "linux"
package: "resource-agents"
version: "1:4.16.0-3+deb13u2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ocf_heartbeat_openstack-cinder-volume"
---

# ocf\_heartbeat\_openstack-cinder-volume(7)

Attach a cinder volume

## 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

**cloud**

Openstack cloud (from ~/.config/openstack/clouds.yaml or /etc/openstack/clouds.yaml).

(optional, string, no default)

**openrc**

Openstack credentials as openrc file from api\_access/openrc.

(optional, string, no default)

**auth\_url**

Keystone Auth URL

(optional, string, no default)

**username**

Username.

(optional, string, no default)

**password**

Password.

(optional, string, no default)

**project\_name**

Keystone Project.

(optional, string, no default)

**user\_domain\_name**

Keystone User Domain Name.

(optional, string, default "Default")

**project\_domain\_name**

Keystone Project Domain Name.

(optional, string, default "Default")

**openstackcli**

Path to command line tools for openstack.

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

**insecure**

Allow insecure connections

(optional, boolean, default false)

**volume\_local\_check**

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

(optional, boolean, default true)

**volume\_id**

Cinder volume identifier to use to attach the block 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: 180s. 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)](/crm/8.md) shell:

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

## EXAMPLE PCS

The following is an example configuration for a openstack-cinder-volume resource using [**pcs**(8)](/pcs/8.md)

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

## SEE ALSO

**http://clusterlabs.org/**

## AUTHOR

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