21d93118f0
We aim to have no lines longer than 79 characters, enable the line checking niceness check but set it to 100 as current maximum. Convert files that fail this line length. Convert one table to a definition list, convert two tables to use list-table directive. Change-Id: I8d0a95cc1c8e72965b3e0e69445e7b2bc6d77f0f
156 lines
7.1 KiB
ReStructuredText
156 lines
7.1 KiB
ReStructuredText
===============================
|
|
Manage volumes and volume types
|
|
===============================
|
|
|
|
Volumes are the Block Storage devices that you attach to instances to enable
|
|
persistent storage. Users can attach a volume to a running instance or detach
|
|
a volume and attach it to another instance at any time. For information about
|
|
using the dashboard to create and manage volumes as an end user, see the
|
|
`OpenStack End User Guide <http://docs.openstack.org/user-guide/>`_.
|
|
|
|
As an administrative user, you can manage volumes and volume types for users
|
|
in various projects. You can create and delete volume types, and you can view
|
|
and delete volumes. Note that a volume can be encrypted by using the steps
|
|
outlined below.
|
|
|
|
.. _create-a-volume-type:
|
|
|
|
Create a volume type
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
#. Log in to the dashboard and choose the :guilabel:`admin`
|
|
project from the drop-down list at the top of the page.
|
|
|
|
#. On the :guilabel:`Admin` tab, open the :guilabel:`System Panel` button
|
|
and click the :guilabel:`Volumes` category.
|
|
|
|
#. Click :guilabel:`Create Volume Type` button. In the
|
|
:guilabel:`Create Volume Type` window, enter a name for the volume type.
|
|
|
|
#. Click :guilabel:`Create Volume Type` button to confirm your changes.
|
|
|
|
.. note:: A message indicates whether the action succeeded.
|
|
|
|
Create an encrypted volume type
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
#. Create a volume type using the steps above for :ref:`create-a-volume-type`.
|
|
|
|
#. Click :guilabel:`Create Encryption` in the Actions column of the newly
|
|
created volume type.
|
|
|
|
#. Configure the encrypted volume by setting the parameters below from
|
|
available options (see table):
|
|
|
|
Provider
|
|
Specifies the class responsible for configuring the encryption.
|
|
Control Location
|
|
Specifies whether the encryption is from the front end (nova) or the
|
|
back end (cinder).
|
|
Cipher
|
|
Specifies the encryption algorithm.
|
|
Key Size
|
|
Specifies the encryption key size.
|
|
|
|
#. Click :guilabel:`Create Volume Type Encryption`.
|
|
|
|
.. note::
|
|
Once a volume type is updated by the :guilabel:`Create
|
|
Encryption` option, the volume type cannot be deleted.
|
|
|
|
**Encryption Options**
|
|
|
|
The table below provides a few alternatives available for creating encrypted
|
|
volumes.
|
|
|
|
+--------------------+-----------------------+----------------------------+
|
|
| Encryption | Parameter | Comments |
|
|
| parameters | options | |
|
|
+====================+=======================+============================+
|
|
| Provider |nova.volume.encryptors.|Allows easier import and |
|
|
| |luks.LuksEncryptor |migration of imported |
|
|
| |(Recommended) |encrypted volumes, and |
|
|
| | |allows access key to be |
|
|
| | |changed without |
|
|
| | |re-encrypting the volume |
|
|
+ +-----------------------+----------------------------+
|
|
| |nova.volume.encryptors.|Less disk overhead than |
|
|
| |cryptsetup. |LUKS |
|
|
| |CryptsetupEncryptor | |
|
|
+--------------------+-----------------------+----------------------------+
|
|
| Control Location | front-end |The encryption occurs within|
|
|
| | (Recommended) |nova so that the data |
|
|
| | |transmitted over the network|
|
|
| | |is encrypted |
|
|
| | | |
|
|
+ +-----------------------+----------------------------+
|
|
| | back-end |This could be selected if a |
|
|
| | |cinder plug-in supporting |
|
|
| | |an encrypted back-end block |
|
|
| | |storage device becomes |
|
|
| | |available in the future. |
|
|
| | |TLS or other network |
|
|
| | |encryption would also be |
|
|
| | |needed to protect data as it|
|
|
| | |traverses the network |
|
|
+--------------------+-----------------------+----------------------------+
|
|
| Cipher | aes-xts-plain64 |See NIST reference below |
|
|
| | (Recommended) |to see advantages* |
|
|
+ +-----------------------+----------------------------+
|
|
| | aes-cbc-essiv |Note: On the command line, |
|
|
| | |type 'cryptsetup benchmark' |
|
|
| | |for additional options |
|
|
+--------------------+-----------------------+----------------------------+
|
|
| Key Size (bits)| 512 (Recommended for |Using this selection for |
|
|
| | aes-xts-plain64. 256 |aes-xts, the underlying key |
|
|
| | should be used for |size would only be 256-bits*|
|
|
| | aes-cbc-essiv) | |
|
|
+ +-----------------------+----------------------------+
|
|
| | 256 |Using this selection for |
|
|
| | |aes-xts, the underlying key |
|
|
| | |size would only be 128-bits*|
|
|
+--------------------+-----------------------+----------------------------+
|
|
|
|
`*` Source `NIST SP 800-38E <http://csrc.nist.gov/publications/nistpubs/800-38E/nist-sp-800-38E.pdf>`_
|
|
|
|
Delete volume types
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
When you delete a volume type, volumes of that type are not deleted.
|
|
|
|
#. Log in to the dashboard and choose the :guilabel:`admin` project from
|
|
the drop-down list at the top of the page.
|
|
|
|
#. On the :guilabel:`Admin` tab, open the :guilabel:`System Panel` button
|
|
and click the :guilabel:`Volumes` category.
|
|
|
|
#. Select the volume type or types that you want to delete.
|
|
|
|
#. Click :guilabel:`Delete Volume Types` button.
|
|
|
|
#. In the :guilabel:`Confirm Delete Volume Types` window, click the
|
|
:guilabel:`Delete Volume Types` button to confirm the action.
|
|
|
|
.. note:: A message indicates whether the action succeeded.
|
|
|
|
Delete volumes
|
|
~~~~~~~~~~~~~~
|
|
|
|
When you delete an instance, the data of its attached volumes is not
|
|
destroyed.
|
|
|
|
#. Log in to the dashboard and choose the :guilabel:`admin` project
|
|
from the drop-down list at the top of the page.
|
|
|
|
#. On the :guilabel:`Admin` tab, open the :guilabel:`System Panel` button
|
|
and click the :guilabel:`Volumes` category.
|
|
|
|
#. Select the volume or volumes that you want to delete.
|
|
|
|
#. Click :guilabel:`Delete Volumes` button.
|
|
|
|
#. In the :guilabel:`Confirm Delete Volumes` window, click the
|
|
:guilabel:`Delete Volumes` button to confirm the action.
|
|
|
|
.. note:: A message indicates whether the action succeeded.
|