Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions source/administration/storage/ceph_ds.rst
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,8 @@ Also the ``mon`` daemon must be defined in the ``ceph.conf`` for all the nodes,

Additionally each OpenNebula datastore is backed by a ceph pool, these pools must be created and configured in the Ceph cluster. The name of the pool by default is ``one`` but can be changed on a per-datastore basis (see below).

``ceph`` cluster admin must include a valid user to be used by ``one`` ``ceph`` datastore (see below).

This driver can work with either RBD Format 1 or RBD Format 2. To set the default you can specify this option in ``ceph.conf``:

.. code::
Expand Down Expand Up @@ -81,6 +83,8 @@ The first step to create a Ceph datastore is to set up a template file for it. I
+------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ``POOL_NAME`` | The OpenNebula Ceph pool name. Defaults to ``one``. **This pool must exist before using the drivers**. |
+------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ``CEPH_USER`` | The OpenNebula Ceph user name. If set it is used by RBD commands. **This ceph user must exist before using the drivers**. |
+------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ``STAGING_DIR`` | Default path for image operations in the OpenNebula Ceph frontend. |
+------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ``RESTRICTED_DIRS`` | Paths that can not be used to register images. A space separated list of paths. |
Expand Down Expand Up @@ -120,10 +124,13 @@ An example of datastore:
DS_MAD = ceph
TM_MAD = ceph

# the following line *must* be preset
# the following lines *must* be preset
DISK_TYPE = RBD

POOL_NAME = one

# CEPH_USER is optional
CEPH_USER = libvirt

BRIDGE_LIST = cephfrontend

> onedatastore create ds.conf
Expand Down
2 changes: 2 additions & 0 deletions source/integration/system_interfaces/api.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2357,6 +2357,8 @@ one.datastore.allocate
+------+------------+--------------------------------------------------------------------------------------------------------+
| IN | String | A string containing the template of the datastore. Syntax can be the usual ``attribute=value`` or XML. |
+------+------------+--------------------------------------------------------------------------------------------------------+
| IN | Int | The cluster ID. If it is -1, this datastore won't be added to any cluster. |
+------+------------+--------------------------------------------------------------------------------------------------------+
| OUT | Boolean | true or false whenever is successful or not |
+------+------------+--------------------------------------------------------------------------------------------------------+
| OUT | Int/String | The allocated resource ID / The error string. |
Expand Down