d99744c3df
The XML root element of Docbook XML files should match the following format: <ELEMENT 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="THE_XML_ID_OF_THE_ELEMENT"> Change-Id: I95a6f36d6887af952257a800e3359d53ac1f895a
33 lines
1.8 KiB
XML
33 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>The previous command will also return a backup ID. Use this
|
|
backup ID when restoring the volume, as in:</para>
|
|
<screen><prompt>$</prompt> <userinput>cinder backup-restore <replaceable>backup_ID</replaceable></userinput></screen>
|
|
<para>As mentioned earlier, volume backups are dependent on the
|
|
Block Storage database. Because of this, we recommend that you
|
|
also back up your Block Storage database regularly in order to
|
|
ensure data recovery.</para>
|
|
<note><para>Alternatively, you can export and save the metadata of
|
|
selected volume backups. Doing so will preclude the need to
|
|
back up the entire Block Storage database. This is particularly
|
|
useful if you only need a small subset of volumes to survive a
|
|
catastrophic database failure.</para>
|
|
<para>For more information on how to export and import volume
|
|
backup metadata, see <xref linkend="volume-backup-restore-export-import"/>.</para></note>
|
|
</section>
|