c3b842a990
Since iI3ada2dee1857074746b1893b82dd5f6641c6e579 is merged we must use class name for backup driver configuration instead of module name. Change-Id: Ia1388866107f79e31512fa2afd0ece0c2b279026
60 lines
1.8 KiB
ReStructuredText
60 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.CephBackupDriver
|
|
|
|
The following configuration options are available for the Ceph backup
|
|
driver.
|
|
|
|
.. config-table::
|
|
:config-target: Ceph backup driver
|
|
|
|
cinder.backup.drivers.ceph
|
|
|
|
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
|