summaryrefslogtreecommitdiffstats
path: root/doc/admin-guide/en-US/admin_storage_pools.xml
diff options
context:
space:
mode:
authorVijay Bellur <vijay@gluster.com>2012-04-23 12:51:50 +0530
committerAnand Avati <avati@redhat.com>2012-04-23 14:51:35 -0700
commit4c9e8fad23836d87b0c4327e990c789630fe5b97 (patch)
treee2402a2a0b8135add5cf0c6d810f141253877259 /doc/admin-guide/en-US/admin_storage_pools.xml
parent664daecef49d5e497bb5dd867fc1f51b046d4bf2 (diff)
doc: Added admin guide
Change-Id: Ic60558dee0d20df0c2a1bf41e4bd072ae4774912 BUG: 811311 Signed-off-by: Vijay Bellur <vijay@gluster.com> Reviewed-on: http://review.gluster.com/3209 Tested-by: Gluster Build System <jenkins@build.gluster.com> Reviewed-by: Amar Tumballi <amarts@redhat.com> Tested-by: divya M N <divyasetty@gmail.com> Reviewed-by: divya M N <divyasetty@gmail.com> Reviewed-by: Anand Avati <avati@redhat.com>
Diffstat (limited to 'doc/admin-guide/en-US/admin_storage_pools.xml')
-rw-r--r--doc/admin-guide/en-US/admin_storage_pools.xml57
1 files changed, 57 insertions, 0 deletions
diff --git a/doc/admin-guide/en-US/admin_storage_pools.xml b/doc/admin-guide/en-US/admin_storage_pools.xml
new file mode 100644
index 000000000..87b6320bd
--- /dev/null
+++ b/doc/admin-guide/en-US/admin_storage_pools.xml
@@ -0,0 +1,57 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. --><!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "docbookV4.5/docbookx.dtd" []>
+<chapter id="chap-Administration_Guide-Storage-pool">
+ <title>Setting up Trusted Storage Pools</title>
+ <para>Before you can configure a GlusterFS volume, you must create a trusted storage pool consisting of the storage servers that provides bricks to a volume. </para>
+ <para>A storage pool is a trusted network of storage servers. When you start the first server, the storage pool consists of that server alone. To add additional storage servers to the storage pool, you can use the probe command from a storage server that is already trusted. </para>
+ <para><note>
+ <para>Do not self-probe the first server/localhost.</para>
+ </note></para>
+ <para>The GlusterFS service must be running on all storage servers that you want to add to the storage pool. See <xref linkend="chap-Administration_Guide-Start_Stop_Daemon"/> for more information.</para>
+ <section id="sect-Administration_Guide-Storage_Pools-Adding_Servers">
+ <title>Adding Servers to Trusted Storage Pool</title>
+ <para>To create a trusted storage pool, add servers to the trusted storage pool</para>
+ <orderedlist>
+ <listitem>
+ <para>The hostnames used to create the storage pool must be resolvable by DNS.</para>
+ <para>To add a server to the storage pool:</para>
+ <para><command># gluster peer probe <replaceable>server</replaceable></command></para>
+ <para>For example, to create a trusted storage pool of four servers, add three servers to the storage pool from server1:</para>
+ <para><programlisting># gluster peer probe server2
+Probe successful
+
+# gluster peer probe server3
+Probe successful
+
+# gluster peer probe server4
+Probe successful
+</programlisting></para>
+ </listitem>
+ <listitem>
+ <para>Verify the peer status from the first server using the following commands:</para>
+ <para><programlisting># gluster peer status
+Number of Peers: 3
+
+Hostname: server2
+Uuid: 5e987bda-16dd-43c2-835b-08b7d55e94e5
+State: Peer in Cluster (Connected)
+
+Hostname: server3
+Uuid: 1e0ca3aa-9ef7-4f66-8f15-cbc348f29ff7
+State: Peer in Cluster (Connected)
+
+Hostname: server4
+Uuid: 3e0caba-9df7-4f66-8e5d-cbc348f29ff7
+State: Peer in Cluster (Connected)</programlisting></para>
+ </listitem>
+ </orderedlist>
+ </section>
+ <section>
+ <title>Removing Servers from the Trusted Storage Pool</title>
+ <para>To remove a server from the storage pool:</para>
+ <para><command># gluster peer detach<replaceable> server</replaceable></command></para>
+ <para> For example, to remove server4 from the trusted storage pool:</para>
+ <para><programlisting># gluster peer detach server4
+Detach successful</programlisting></para>
+ </section>
+</chapter>