summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorLuis Pabon <lpabon@redhat.com>2013-09-17 15:27:42 -0400
committerPeter Portante <pportant@redhat.com>2013-09-17 18:25:19 -0700
commit7d5e6ed57e4b818c5b8b130b53f57d47dc20e327 (patch)
tree3eb4d49be38f4dced2f32f476ea1f42ce13fdeb6 /doc
parent0f90d1db18713396c9f250a9c980bc7583a6171f (diff)
Update documentation for the ring builder
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>
Diffstat (limited to 'doc')
-rw-r--r--doc/markdown/quick_start_guide.md30
1 files changed, 20 insertions, 10 deletions
diff --git a/doc/markdown/quick_start_guide.md b/doc/markdown/quick_start_guide.md
index 0acdb9d..20cc323 100644
--- a/doc/markdown/quick_start_guide.md
+++ b/doc/markdown/quick_start_guide.md
@@ -121,9 +121,9 @@ mount -a
You now need to create a GlusterFS volume
~~~
-mkdir /export/brick/test
-gluster volume create test `hostname`:/export/brick/test
-gluster volume start test
+mkdir /export/brick/myvolume
+gluster volume create myvolume `hostname`:/export/brick/myvolume
+gluster volume start myvolume
~~~
<a name="swift_setup" />
@@ -191,11 +191,21 @@ for tmpl in *.conf-gluster ; do cp ${tmpl} ${tmpl%.*}.conf; done
#### Generate Ring Files
You now need to generate the ring files, which inform Gluster
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
-/usr/bin/gluster-swift-gen-builders test
+/usr/bin/gluster-swift-gen-builders myvolume
~~~
### Start gluster-swift
@@ -226,7 +236,7 @@ service openstack-swift-proxy start
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
@@ -234,7 +244,7 @@ also confirm that the container has been created by inspecting the GlusterFS
volume:
~~~
-ls /mnt/gluster-object/test
+ls /mnt/gluster-object/myvolume
~~~
#### Create an object
@@ -242,14 +252,14 @@ You can now place an object in the container you have just created:
~~~
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
test file with the object you created:
~~~
-cat /mnt/gluster-object/test/mycontainer/mytestfile
+cat /mnt/gluster-object/myvolume/mycontainer/mytestfile
~~~
#### Request the object
@@ -257,7 +267,7 @@ Now you can retreive the object and inspect its contents using the
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
~~~