From d9a3afbfe067613942b6dd43287ea53598604942 Mon Sep 17 00:00:00 2001 From: Ryan Hallisey Date: Fri, 31 Jul 2015 08:15:59 -0400 Subject: Fix some spelling and formatting errors in the Cinder doc Closes-bug: #1480174 Change-Id: I1ef695e910405f41045ffa1c8a13afa1a443c39e --- docs/block-storage-guide.md | 54 +++++++++++++++++++++++++++++++++++++++++++++ docs/storage-guide.md | 45 ------------------------------------- 2 files changed, 54 insertions(+), 45 deletions(-) create mode 100644 docs/block-storage-guide.md delete mode 100644 docs/storage-guide.md (limited to 'docs') diff --git a/docs/block-storage-guide.md b/docs/block-storage-guide.md new file mode 100644 index 000000000..aa7f3d5b7 --- /dev/null +++ b/docs/block-storage-guide.md @@ -0,0 +1,54 @@ +# Storage Guide + +This is a overview of how Cinder is implemented in Kolla so that it is easier +to understand how to use it. Keep in mind, this is the first iteration for +Cinder as support for Ceph and physical devices will follow. + +## Overview + +Kolla's setup for Cinder uses tgtd as the default iSCSI helper to implement +persistent targets. By default, we use a loop back file that is defined by +CINDER_LVM_LO_VOLUME_SIZE to create the cinder-volumes volume group. + +## Configure Cinder + +Listed below are the default configurations for Cinder. For more info on what +each variable does look at the [integration guide.](https://github.com/stackforge/kolla/blob/master/docs/integration-guide.md): + + # Cinder Volume + CINDER_ENABLED_BACKEND=lvm57 + CINDER_LVM_LO_VOLUME_SIZE=4G + CINDER_VOLUME_API_LISTEN=$HOST_IP + CINDER_VOLUME_BACKEND_NAME=LVM_iSCSI57 + CINDER_VOLUME_DRIVER=cinder.volume.drivers.lvm.LVMISCSIDriver + CINDER_VOLUME_GROUP=cinder-volumes + ISCSI_HELPER=tgtadm + ISCSI_IP_ADDRESS=$HOST_IP + +## Using Cinder + +After you've started all your containers, you should be able to interact +with Cinder. + + cinder list + +Next, you will want to create a volume and attach it to a running instance. + + cinder create 1 + nova volume-attach + +## Debugging and deleting volumes + +The cinder-volumes volume group can't be seen from the host. In order to +interact with an existing volume, you need to jump into the Cinder Volume +container. + + sudo docker exec -it /bin/bash + vgs + +Running 'vgs' will list the volumes groups. From there, you can look +specific volumes to make sure volume creation succeeded. + +To delete the cinder-volumes volume group from within the container run: + + vgs remove cinder-volumes diff --git a/docs/storage-guide.md b/docs/storage-guide.md deleted file mode 100644 index 17f8b7af0..000000000 --- a/docs/storage-guide.md +++ /dev/null @@ -1,45 +0,0 @@ -# Storage Guide - -This is a overview of how Cinder is implemented in Kolla so that it is easier to understand how to use it. Keep in mind, this is the first iteration for Cinder as support for Ceph and physical devices will follow. - -## Overview - -Kolla's setup for Cinder uses tgtd as the default iSCSI helper to implement persistent targets. By default, we use a loop back file that is defined by CINDER_LVM_LO_VOLUME_SIZE to create the cinder-volumes volume group. - -## Configure Cinder - -Listed below are the default configurations for Cinder. For more info on what each variable does look at the [integration guide.](https://github.com/stackforge/kolla/blob/master/docs/integration-guide.md): - - # Cinder Volume - CINDER_ENABLED_BACKEND=lvm57 - CINDER_LVM_LO_VOLUME_SIZE=4G - CINDER_VOLUME_API_LISTEN=$HOST_IP - CINDER_VOLUME_BACKEND_NAME=LVM_iSCSI57 - CINDER_VOLUME_DRIVER=cinder.volume.drivers.lvm.LVMISCSIDriver - CINDER_VOLUME_GROUP=cinder-volumes - ISCSI_HELPER=tgtadm - ISCSI_IP_ADDRESS=$HOST_IP - -## Using Cinder - -After you've started all you containers, you should be able to interact with Cinder. - - cinder list - -Next, you will want to create a volume and attach it to a running instance. - - cinder create 1 - nova volume-attach - -## Debugging and deleting volumes - -The cinder-volumes volume group can't be seen from the host. In order to interact with an existing volume, you need to jump into the Cinder Volume container. - - sudo docker exec -it /bin/bash - sudo vgs - -Running 'vgs' will list the volumes groups. From there, you can look at specific volumes to make sure volume creation succeeded. - -To delete the cinder-volumes volume group from within the container run: - - sudo vgs remove cinder-volumes -- cgit v1.2.3