aboutsummaryrefslogtreecommitdiff
path: root/docs/cinder-guide.rst
diff options
context:
space:
mode:
authorSteven Dake <stdake@cisco.com>2015-09-02 22:33:01 -0700
committerSteven Dake <stdake@cisco.com>2015-09-02 22:37:36 -0700
commit233864ff32af10a2c927cdbca3475b537c8e6808 (patch)
tree99a0f159b60f736faa09871db363ebd5da1f7d8d /docs/cinder-guide.rst
parent3ed7b3c3b4cb6c00cb9c3c55c9f00265e805d18f (diff)
downloadkolla-233864ff32af10a2c927cdbca3475b537c8e6808.tar.gz
kolla-233864ff32af10a2c927cdbca3475b537c8e6808.zip
Rename docs dir to doc for publishing
The publishing docs expect the documentation to be present in the /doc directory not the /docs directory. If the documentation is in the /docs directory, according to fungi the docs won't be published properly. Change-Id: I718fec7e69d298a5cb2376ca4e2455e12169566e Partially-Implements: blueprint kola-tox-doc
Diffstat (limited to 'docs/cinder-guide.rst')
-rw-r--r--docs/cinder-guide.rst77
1 files changed, 0 insertions, 77 deletions
diff --git a/docs/cinder-guide.rst b/docs/cinder-guide.rst
deleted file mode 100644
index 7247cc02a..000000000
--- a/docs/cinder-guide.rst
+++ /dev/null
@@ -1,77 +0,0 @@
-Cinder in Kolla
-===============
-
-Overview
---------
-Currently Kolla can deploy the cinder services:
-
-- cinder-api
-- cinder-scheduler
-- cinder-backup
-- cinder-volume
-
-The cinder implementation defaults to using LVM storage. The default
-implementation requires a volume group be set up. This can either be
-a real physical volume or a loopback mounted file for development.
-
-Create a Volume Group
----------------------
-Use pvcreate and vgcreate to create the volume group. For example with
-the devices /dev/sdb and /dev/sdc:
-
-::
-
- <WARNING ALL DATA ON /dev/sdb and /dev/sdc will be LOST!>
-
- pvcreate /dev/sdb /dev/sdc
- vgcreate cinder-volumes /dev/sdb /dev/sdc
-
-During development, it may be desireable to use file backed block storage. It
-is possible to use a file and mount it as a block device via the loopback
-system.
-
-::
-
- mknod /dev/loop2 b 7 2
- dd if=/dev/zero of=/var/lib/cinder_data.img bs=1g count=20
- losetup /dev/loop2 /var/lib/cinder_data.img
- pvcreate /dev/loop2
- vgcreate cinder-volumes /dev/loop2
-
-Validation
-----------
-
-Create a volume as follows:
-
-::
-
- $ openstack volume create --size 1 steak_volume
- <bunch of stuff printed>
-
-Verify it is available. If it says "error" here something went wrong during
-LVM creation of the volume.
-
-::
-
- $ openstack volume list
- +--------------------------------------+--------------+-----------+------+-------------+
- | ID | Display Name | Status | Size | Attached to |
- +--------------------------------------+--------------+-----------+------+-------------+
- | 0069c17e-8a60-445a-b7f0-383a8b89f87e | steak_volume | available | 1 | |
- +--------------------------------------+--------------+-----------+------+-------------+
-
-Attach the volume to a server using:
-
-::
-
- openstack server add volume steak_server 0069c17e-8a60-445a-b7f0-383a8b89f87e
-
-Check the console log added the disk:
-
-::
-
- opoenstack console log show steak_server
-
-A /dev/vdb should appear in the console log, atleast when booting cirros.
-If the disk stays in the available state, something went wrong during the
-iSCSI mounting of the volume to the guest VM.