918be91229
Updated the Cloud Administrator Guide with information on backup encryption: volume encryption remains valid after a volume is backed up, and then restored. Change-Id: I9edc85ef75cfe16353319249fe53444f0364b55b Backport: none Closes-Bug: #1401237
26 lines
1.8 KiB
XML
26 lines
1.8 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<section 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" xml:id="volume-backup-restore">
|
|
<title>Back up and restore volumes</title>
|
|
<para>The <command>cinder</command> command-line interface provides the tools for creating a
|
|
volume backup. You can restore a volume from a backup as long as the backup's associated
|
|
database information (or backup metadata) is intact in the Block Storage database.</para>
|
|
<para>Run this command to create a backup of a volume:</para>
|
|
<screen><prompt>$</prompt> <userinput>cinder backup-create <replaceable>VOLUME</replaceable></userinput></screen>
|
|
<para>Where <replaceable>VOLUME</replaceable> is the name or ID of the volume.</para>
|
|
<para>This command also returns a backup ID. Use this backup ID when restoring the volume:</para>
|
|
<screen><prompt>$</prompt> <userinput>cinder backup-restore <replaceable>BACKUP_ID</replaceable></userinput></screen>
|
|
<para>Because volume backups are dependent on the Block Storage database, you must also back up
|
|
your Block Storage database regularly to ensure data recovery.</para>
|
|
<note>
|
|
<para>Alternatively, you can export and save the metadata of selected volume backups. Doing so
|
|
precludes the need to back up the entire Block Storage database. This is useful if you need
|
|
only a small subset of volumes to survive a catastrophic database failure.</para>
|
|
<para>If you specify a UUID encryption key when setting up the volume specifications, the
|
|
backup metadata ensures that the key will remain valid when you back up and restore
|
|
the volume.</para>
|
|
<para>For more information about how to export and import volume backup metadata, see <xref
|
|
linkend="volume-backup-restore-export-import"/>.</para>
|
|
</note>
|
|
</section>
|