openstack/kolla
Code Issues Proposed changes

Merge "Document how to use loopback devices for Swift"

Browse Source
This commit is contained in:
Jenkins 2016-03-08 18:33:31 +00:00 committed by Gerrit Code Review
commit 1015993808
1 changed files with 19 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
doc/swift-guide.rst
View File

@ -11,8 +11,8 @@ Before running Swift we need to generate "rings", which are binary compressed
files that at a high level let the various Swift services know where data is in files that at a high level let the various Swift services know where data is in
the cluster. We hope to automate this process in a future release. the cluster. We hope to automate this process in a future release.
disks with partition table (recommended) Disks with a partition table (recommended)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Swift also expects block devices to be available for storage. To prepare a disk Swift also expects block devices to be available for storage. To prepare a disk
for use as Swift storage device, a special partition name and filesystem label for use as Swift storage device, a special partition name and filesystem label
@ -30,8 +30,22 @@ Follow the example below to add 3 disks for an AIO demo setup.
(( index++ )) (( index++ ))
done done
disks without partition table For evaluation, loopback devices can be used in lieu of real disks:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
::
index=0
for d in sdc sdd sde; do
free_device=$(losetup -f)
fallocate -l 1G /tmp/$d
losetup $free_device /tmp/$d
parted $free_device -s -- mklabel gpt mkpart KOLLA_SWIFT_DATA 1 -1
sudo mkfs.xfs -f -L d${index} ${free_device}p1
(( index++ ))
done
Disks without a partition table
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Kolla also supports unpartitioned disk (filesystem on /dev/sdc instead of Kolla also supports unpartitioned disk (filesystem on /dev/sdc instead of
/dev/sdc1) detection purely based on filesystem label. This is generally not a /dev/sdc1) detection purely based on filesystem label. This is generally not a
@ -46,7 +60,7 @@ ansible/roles/swift/defaults/main.yml
swift_devices_match_mode: "prefix" swift_devices_match_mode: "prefix"
swift_devices_name: "swd" swift_devices_name: "swd"
rings Rings
~~~~~ ~~~~~
Run following commands locally to generate Rings for AIO demo setup. The Run following commands locally to generate Rings for AIO demo setup. The