0395353c4b
It was discovered today that the 'config-reference' directory was supposed to have been renamed to 'configuration'. The doc team was expecting it to be at that location so that they could automatically link to it from contributor/index.html . This patch just moves the directory. I am going to be submitting a subsequent patch that properly sets out the framework for the additional directories so that we don't have addition problems in the future. Change-Id: I6729aaf4593a0b089277f6d7d0aa50fee3ca340f
57 lines
1.8 KiB
ReStructuredText
57 lines
1.8 KiB
ReStructuredText
==================
|
|
Ceph backup driver
|
|
==================
|
|
|
|
The Ceph backup driver backs up volumes of any type to a Ceph back-end
|
|
store. The driver can also detect whether the volume to be backed up is
|
|
a Ceph RBD volume, and if so, it tries to perform incremental and
|
|
differential backups.
|
|
|
|
For source Ceph RBD volumes, you can perform backups within the same
|
|
Ceph pool (not recommended). You can also perform backups between
|
|
different Ceph pools and between different Ceph clusters.
|
|
|
|
At the time of writing, differential backup support in Ceph/librbd was
|
|
quite new. This driver attempts a differential backup in the first
|
|
instance. If the differential backup fails, the driver falls back to
|
|
full backup/copy.
|
|
|
|
If incremental backups are used, multiple backups of the same volume are
|
|
stored as snapshots so that minimal space is consumed in the backup
|
|
store. It takes far less time to restore a volume than to take a full
|
|
copy.
|
|
|
|
.. note::
|
|
|
|
Block Storage enables you to:
|
|
|
|
- Restore to a new volume, which is the default and recommended
|
|
action.
|
|
|
|
- Restore to the original volume from which the backup was taken.
|
|
The restore action takes a full copy because this is the safest
|
|
action.
|
|
|
|
To enable the Ceph backup driver, include the following option in the
|
|
``cinder.conf`` file:
|
|
|
|
.. code-block:: ini
|
|
|
|
backup_driver = cinder.backup.drivers.ceph
|
|
|
|
The following configuration options are available for the Ceph backup
|
|
driver.
|
|
|
|
.. include:: ../../tables/cinder-backups_ceph.rst
|
|
|
|
This example shows the default options for the Ceph backup driver.
|
|
|
|
.. code-block:: ini
|
|
|
|
backup_ceph_conf=/etc/ceph/ceph.conf
|
|
backup_ceph_user = cinder-backup
|
|
backup_ceph_chunk_size = 134217728
|
|
backup_ceph_pool = backups
|
|
backup_ceph_stripe_unit = 0
|
|
backup_ceph_stripe_count = 0
|