874a358eb9
Correct the values of backup_driver in the config reference. Also add some spaces to make samples more easily readable. Change-Id: I6f5d9fd40355c3a45b93cec2946257d505aef73f Partial-Bug: #1309137
65 lines
3.1 KiB
XML
65 lines
3.1 KiB
XML
<!DOCTYPE section [
|
|
<!-- Some useful entities borrowed from HTML -->
|
|
<!ENTITY ndash "–">
|
|
<!ENTITY mdash "—">
|
|
<!ENTITY hellip "…">
|
|
]>
|
|
<section xml:id="ceph-backup-driver"
|
|
xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
|
|
<title>Ceph backup driver</title>
|
|
<para>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.</para>
|
|
<para>For source Ceph RBD volumes, you can perform backups
|
|
within the same Ceph pool (not recommended) and
|
|
backups between different Ceph pools and between
|
|
different Ceph clusters.</para>
|
|
<para>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.</para>
|
|
<para>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.</para>
|
|
<note>
|
|
<para>Block Storage enables you to:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Restore to a new volume, which
|
|
is the default and recommended
|
|
action.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Restore to the original volume
|
|
from which the backup was taken.
|
|
The restore action takes a full
|
|
copy because this is the safest
|
|
action.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</note>
|
|
<para>To enable the Ceph backup driver, include the following
|
|
option in the <filename>cinder.conf</filename>
|
|
file:</para>
|
|
<programlisting>backup_driver = cinder.backup.drivers.ceph</programlisting>
|
|
<para>The following configuration options are available for
|
|
the Ceph backup driver.</para>
|
|
<xi:include
|
|
href="../../../common/tables/cinder-backups_ceph.xml"/>
|
|
<para>This example shows the default options for the Ceph
|
|
backup driver.</para>
|
|
<programlisting>backup_ceph_conf=/etc/ceph/ceph.conf
|
|
backup_ceph_user = cinder
|
|
backup_ceph_chunk_size = 134217728
|
|
backup_ceph_pool = backups
|
|
backup_ceph_stripe_unit = 0
|
|
backup_ceph_stripe_count = 0</programlisting>
|
|
</section>
|