x/swiftonfile
Code Issues Proposed changes

Update documentation for the ring builder

Browse Source 
Change-Id: I10c591e7ddefeb42bd30fd0df1cce6cd99f25442
Signed-off-by: Luis Pabon <lpabon@redhat.com>
Reviewed-on: http://review.gluster.org/5959
Reviewed-by: Peter Portante <pportant@redhat.com>
Tested-by: Peter Portante <pportant@redhat.com>
This commit is contained in:
Luis Pabon 2013-09-17 15:27:42 -04:00 committed by Peter Portante
parent 0f90d1db18
commit 7d5e6ed57e
1 changed files with 20 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
doc/markdown/quick_start_guide.md
View File

@ -121,9 +121,9 @@ mount -a
You now need to create a GlusterFS volume You now need to create a GlusterFS volume
~~~ ~~~
mkdir /export/brick/test mkdir /export/brick/myvolume
gluster volume create test `hostname`:/export/brick/test gluster volume create myvolume `hostname`:/export/brick/myvolume
gluster volume start test gluster volume start myvolume
~~~ ~~~
<a name="swift_setup" /> <a name="swift_setup" />
@ -191,11 +191,21 @@ for tmpl in *.conf-gluster ; do cp ${tmpl} ${tmpl%.*}.conf; done
#### Generate Ring Files #### Generate Ring Files
You now need to generate the ring files, which inform Gluster You now need to generate the ring files, which inform Gluster
for Swift which GlusterFS volumes are accessible over the object for Swift which GlusterFS volumes are accessible over the object
storage interface: storage interface. The format is
~~~
gluster-swift-gen-builders [VOLUME] [VOLUME...]
~~~
Where *VOLUME* is the name of the GlusterFS volume which you would
like to access over Gluster for Swift.
Expose the GlusterFS volume called `myvolume` you created above
by executing the following command:
~~~ ~~~
cd /etc/swift cd /etc/swift
/usr/bin/gluster-swift-gen-builders test /usr/bin/gluster-swift-gen-builders myvolume
~~~ ~~~
### Start gluster-swift ### Start gluster-swift
@ -226,7 +236,7 @@ service openstack-swift-proxy start
Create a container using the following command: Create a container using the following command:
~~~ ~~~
curl -v -X PUT http://localhost:8080/v1/AUTH_test/mycontainer curl -v -X PUT http://localhost:8080/v1/AUTH_myvolume/mycontainer
~~~ ~~~
It should return `HTTP/1.1 201 Created` on a successful creation. You can It should return `HTTP/1.1 201 Created` on a successful creation. You can
@ -234,7 +244,7 @@ also confirm that the container has been created by inspecting the GlusterFS
volume: volume:
~~~ ~~~
ls /mnt/gluster-object/test ls /mnt/gluster-object/myvolume
~~~ ~~~
#### Create an object #### Create an object
@ -242,14 +252,14 @@ You can now place an object in the container you have just created:
~~~ ~~~
echo "Hello World" > mytestfile echo "Hello World" > mytestfile
curl -v -X PUT -T mytestfile http://localhost:8080/v1/AUTH_test/mycontainer/mytestfile curl -v -X PUT -T mytestfile http://localhost:8080/v1/AUTH_myvolume/mycontainer/mytestfile
~~~ ~~~
To confirm that the object has been written correctly, you can compare the To confirm that the object has been written correctly, you can compare the
test file with the object you created: test file with the object you created:
~~~ ~~~
cat /mnt/gluster-object/test/mycontainer/mytestfile cat /mnt/gluster-object/myvolume/mycontainer/mytestfile
~~~ ~~~
#### Request the object #### Request the object
@ -257,7 +267,7 @@ Now you can retreive the object and inspect its contents using the
following commands: following commands:
~~~ ~~~
curl -v -X GET -o newfile http://localhost:8080/v1/AUTH_test/mycontainer/mytestfile curl -v -X GET -o newfile http://localhost:8080/v1/AUTH_myvolume/mycontainer/mytestfile
cat newfile cat newfile
~~~ ~~~