openstack/openstack-manuals
Code Issues Proposed changes

[install] Add cinder backup service

Browse Source 
Add instructions to optionally install and configure the
Block Storage (cinder) backup service on the storage node.

Change-Id: Idf61bf9249c34cafcd37f97c37f33983e9a2a000
Co-Authored-By: Matt Kassawara <mkassawara@gmail.com>
Closes-Bug: #1547173
This commit is contained in:
LisaLi 2016-03-16 17:01:46 +08:00 committed by Matthew Kassawara
parent a470743426
commit 265d4bb5fc
4 changed files with 89 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
doc/install-guide-debconf/source/cinder-backup-install.rst Symbolic link
View File

@ -0,0 +1 @@
../../install-guide/source/cinder-backup-install.rst

82
doc/install-guide/source/cinder-backup-install.rst Normal file
View File

@ -0,0 +1,82 @@
.. _cinder-backup-install:
Install and configure the backup service
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Optionally, install and configure the backup service. For simplicity,
this configuration uses the Block Storage node and the Object Storage
(swift) driver, thus depending on the
`Object Storage service <http://docs.openstack.org/project-install-guide/newton/object-storage>`_.
.. note::
You must :ref:`install and configure a storage node <cinder-storage>` prior
to installing and configuring the backup service.
Install and configure components
--------------------------------
.. note::
Perform these steps on the Block Storage node.
.. only:: obs
#. Install the packages:
.. code-block:: console
# zypper install openstack-cinder-backup
.. only:: rdo
#. Install the packages:
.. code-block:: console
# yum install openstack-cinder
.. only:: ubuntu or debian
#. Install the packages:
.. code-block:: console
# apt-get install cinder-backup
2. Edit the ``/etc/cinder/cinder.conf`` file
and complete the following actions:
* In the ``[DEFAULT]`` section, configure backup options:
.. code-block:: ini
[DEFAULT]
...
backup_driver = cinder.backup.drivers.swift
backup_swift_url = SWIFT_URL
Replace ``SWIFT_URL`` with the URL of the Object Storage service, typically
``http://10.0.0.51:8080/v1/AUTH_`` if using the installation guide
architecture.
Finalize installation
---------------------
.. only:: obs or rdo
Start the Block Storage backup service and configure it to
start when the system boots:
.. code-block:: console
# systemctl enable openstack-cinder-backup.service
# systemctl start openstack-cinder-backup.service
.. only:: ubuntu or debian
Restart the Block Storage backup service:
.. code-block:: console
# service cinder-backup restart

5
doc/install-guide/source/cinder-verify.rst
View File

@ -26,4 +26,9 @@ Verify operation of the Block Storage service.
+------------------+------------+------+---------+-------+----------------------------+-----------------+
| cinder-scheduler | controller | nova | enabled | up | 2014-10-18T01:30:54.000000 | None |
| cinder-volume | block1@lvm | nova | enabled | up | 2014-10-18T01:30:57.000000 | None |
| cinder-backup | block1 | nova | enabled | up | 2014-10-18T01:30:59.000000 | None |
+------------------+------------+------+---------+-------+----------------------------+-----------------+
.. note::
The ``cinder-backup`` service only appears if you :ref:`cinder-backup-install`.

5
doc/install-guide/source/cinder.rst
View File

@ -9,6 +9,7 @@ Block Storage service
common/get_started_block_storage.rst
cinder-controller-install.rst
cinder-storage-install.rst
cinder-backup-install.rst
cinder-verify.rst
cinder-next-steps.rst
@ -25,7 +26,3 @@ on controllers, compute nodes, or standalone storage nodes.
For more information, see the
`Configuration Reference <http://docs.openstack.org/mitaka/config-reference/block-storage/volume-drivers.html>`__.
.. note::
This chapter omits the backup manager because it depends on the
Object Storage service.