summaryrefslogtreecommitdiffstats
path: root/doc/admin-guide/en-US/markdown/admin_setting_volumes.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/admin-guide/en-US/markdown/admin_setting_volumes.md')
-rw-r--r--doc/admin-guide/en-US/markdown/admin_setting_volumes.md38
1 files changed, 34 insertions, 4 deletions
diff --git a/doc/admin-guide/en-US/markdown/admin_setting_volumes.md b/doc/admin-guide/en-US/markdown/admin_setting_volumes.md
index 455238048be..028cd30647a 100644
--- a/doc/admin-guide/en-US/markdown/admin_setting_volumes.md
+++ b/doc/admin-guide/en-US/markdown/admin_setting_volumes.md
@@ -155,9 +155,17 @@ high-availability and high-reliability are critical.
auth.allow or auth.reject.
> **Note**:
- > Make sure you start your volumes before you try to mount them or
+
+ > - Make sure you start your volumes before you try to mount them or
> else client operations after the mount will hang.
+ > - GlusterFS will fail to create a replicate volume if more than one brick of a replica set is present on the same peer. For eg. four node replicated volume with a more that one brick of a replica set is present on the same peer.
+ > ```
+ # gluster volume create <volname> replica 4 server1:/brick1 server1:/brick2 server2:/brick3 server4:/brick4
+ volume create: <volname>: failed: Multiple bricks of a replicate volume are present on the same server. This setup is not optimal. Use 'force' at the end of the command if you want to override this behavior.```
+
+ > Use the `force` option at the end of command if you want to create the volume in this case.
+
##Creating Striped Volumes
Striped volumes stripes data across bricks in the volume. For best
@@ -275,9 +283,17 @@ environments.
auth.allow or auth.reject.
> **Note**:
- > Make sure you start your volumes before you try to mount them or
+ > - Make sure you start your volumes before you try to mount them or
> else client operations after the mount will hang.
+ > - GlusterFS will fail to create a distribute replicate volume if more than one brick of a replica set is present on the same peer. For eg. four node distribute (replicated) volume with a more than one brick of a replica set is present on the same peer.
+ > ```
+ # gluster volume create <volname> replica 2 server1:/brick1 server1:/brick2 server2:/brick3 server4:/brick4
+ volume create: <volname>: failed: Multiple bricks of a replicate volume are present on the same server. This setup is not optimal. Use 'force' at the end of the command if you want to override this behavior.```
+
+ > Use the `force` option at the end of command if you want to create the volume in this case.
+
+
##Creating Distributed Striped Replicated Volumes
Distributed striped replicated volumes distributes striped data across
@@ -312,9 +328,16 @@ Map Reduce workloads.
auth.allow or auth.reject.
> **Note**:
- > Make sure you start your volumes before you try to mount them or
+ > - Make sure you start your volumes before you try to mount them or
> else client operations after the mount will hang.
+ > - GlusterFS will fail to create a distribute replicate volume if more than one brick of a replica set is present on the same peer. For eg. four node distribute (replicated) volume with a more than one brick of a replica set is present on the same peer.
+ > ```
+ # gluster volume create <volname> stripe 2 replica 2 server1:/brick1 server1:/brick2 server2:/brick3 server4:/brick4
+ volume create: <volname>: failed: Multiple bricks of a replicate volume are present on the same server. This setup is not optimal. Use 'force' at the end of the command if you want to override this behavior.```
+
+ > Use the `force` option at the end of command if you want to create the volume in this case.
+
##Creating Striped Replicated Volumes
Striped replicated volumes stripes data across replicated bricks in the
@@ -356,9 +379,16 @@ of this volume type is supported only for Map Reduce workloads.
auth.allow or auth.reject.
> **Note**:
- > Make sure you start your volumes before you try to mount them or
+ > - Make sure you start your volumes before you try to mount them or
> else client operations after the mount will hang.
+ > - GlusterFS will fail to create a distribute replicate volume if more than one brick of a replica set is present on the same peer. For eg. four node distribute (replicated) volume with a more than one brick of replica set is present on the same peer.
+ > ```
+ # gluster volume create <volname> stripe 2 replica 2 server1:/brick1 server1:/brick2 server2:/brick3 server4:/brick4
+ volume create: <volname>: failed: Multiple bricks of a replicate volume are present on the same server. This setup is not optimal. Use 'force' at the end of the command if you want to override this behavior.```
+
+ > Use the `force` option at the end of command if you want to create the volume in this case.
+
##Starting Volumes
You must start your volumes before you try to mount them.