3edc5322ab
install-guide is version-independent, so we need to include links to both releases. Change-Id: Ie7bb2ed92d258d48a92f04579c6caae47573beb6
148 lines
5.3 KiB
ReStructuredText
148 lines
5.3 KiB
ReStructuredText
.. _launch-instance-cinder:
|
|
|
|
Block Storage
|
|
~~~~~~~~~~~~~
|
|
|
|
Create a volume
|
|
---------------
|
|
|
|
#. Source the ``demo`` credentials to perform
|
|
the following steps as a non-administrative project:
|
|
|
|
.. code-block:: console
|
|
|
|
$ . demo-openrc
|
|
|
|
.. end
|
|
|
|
#. Create a 1 GB volume:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack volume create --size 1 volume1
|
|
|
|
+---------------------+--------------------------------------+
|
|
| Field | Value |
|
|
+---------------------+--------------------------------------+
|
|
| attachments | [] |
|
|
| availability_zone | nova |
|
|
| bootable | false |
|
|
| consistencygroup_id | None |
|
|
| created_at | 2016-03-08T14:30:48.391027 |
|
|
| description | None |
|
|
| encrypted | False |
|
|
| id | a1e8be72-a395-4a6f-8e07-856a57c39524 |
|
|
| multiattach | False |
|
|
| name | volume1 |
|
|
| properties | |
|
|
| replication_status | disabled |
|
|
| size | 1 |
|
|
| snapshot_id | None |
|
|
| source_volid | None |
|
|
| status | creating |
|
|
| type | None |
|
|
| updated_at | None |
|
|
| user_id | 684286a9079845359882afc3aa5011fb |
|
|
+---------------------+--------------------------------------+
|
|
|
|
.. end
|
|
|
|
#. After a short time, the volume status should change from ``creating``
|
|
to ``available``:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack volume list
|
|
|
|
+--------------------------------------+--------------+-----------+------+-------------+
|
|
| ID | Display Name | Status | Size | Attached to |
|
|
+--------------------------------------+--------------+-----------+------+-------------+
|
|
| a1e8be72-a395-4a6f-8e07-856a57c39524 | volume1 | available | 1 | |
|
|
+--------------------------------------+--------------+-----------+------+-------------+
|
|
|
|
.. end
|
|
|
|
Attach the volume to an instance
|
|
--------------------------------
|
|
|
|
#. Attach a volume to an instance:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack server add volume INSTANCE_NAME VOLUME_NAME
|
|
|
|
.. end
|
|
|
|
Replace ``INSTANCE_NAME`` with the name of the instance and ``VOLUME_NAME``
|
|
with the name of the volume you want to attach to it.
|
|
|
|
**Example**
|
|
|
|
Attach the ``volume1`` volume to the ``provider-instance`` instance:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack server add volume provider-instance volume1
|
|
|
|
.. end
|
|
|
|
.. note::
|
|
|
|
This command provides no output.
|
|
|
|
#. List volumes:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack volume list
|
|
|
|
+--------------------------------------+--------------+--------+------+--------------------------------------------+
|
|
| ID | Display Name | Status | Size | Attached to |
|
|
+--------------------------------------+--------------+--------+------+--------------------------------------------+
|
|
| a1e8be72-a395-4a6f-8e07-856a57c39524 | volume1 | in-use | 1 | Attached to provider-instance on /dev/vdb |
|
|
+--------------------------------------+--------------+--------+------+--------------------------------------------+
|
|
|
|
.. end
|
|
|
|
#. Access your instance using SSH and use the ``fdisk`` command to verify
|
|
presence of the volume as the ``/dev/vdb`` block storage device:
|
|
|
|
.. code-block:: console
|
|
|
|
$ sudo fdisk -l
|
|
|
|
Disk /dev/vda: 1073 MB, 1073741824 bytes
|
|
255 heads, 63 sectors/track, 130 cylinders, total 2097152 sectors
|
|
Units = sectors of 1 * 512 = 512 bytes
|
|
Sector size (logical/physical): 512 bytes / 512 bytes
|
|
I/O size (minimum/optimal): 512 bytes / 512 bytes
|
|
Disk identifier: 0x00000000
|
|
|
|
Device Boot Start End Blocks Id System
|
|
/dev/vda1 * 16065 2088449 1036192+ 83 Linux
|
|
|
|
Disk /dev/vdb: 1073 MB, 1073741824 bytes
|
|
16 heads, 63 sectors/track, 2080 cylinders, total 2097152 sectors
|
|
Units = sectors of 1 * 512 = 512 bytes
|
|
Sector size (logical/physical): 512 bytes / 512 bytes
|
|
I/O size (minimum/optimal): 512 bytes / 512 bytes
|
|
Disk identifier: 0x00000000
|
|
|
|
Disk /dev/vdb doesn't contain a valid partition table
|
|
|
|
.. end
|
|
|
|
.. note::
|
|
|
|
You must create a file system on the device and mount it
|
|
to use the volume.
|
|
|
|
For more information about how to manage volumes, see the
|
|
`python-openstackclient documentation for Pike
|
|
<https://docs.openstack.org/python-openstackclient/pike/cli/command-objects/volume.html>`_
|
|
or the
|
|
`python-openstackclient documentation for Queens
|
|
<https://docs.openstack.org/python-openstackclient/queens/cli/command-objects/volume.html>`_.
|
|
|
|
Return to :ref:`launch-instance`.
|