From a822b8e782b8e7f55b5ed030f024cef542b7b6f4 Mon Sep 17 00:00:00 2001 From: Aditya Manthramurthy Date: Fri, 25 Nov 2016 01:08:19 +0530 Subject: [PATCH] docs: Fix command sample to be copy-pastable (#3345) --- docs/distributed/README.md | 39 ++++++++++++++++++-------------------- 1 file changed, 18 insertions(+), 21 deletions(-) diff --git a/docs/distributed/README.md b/docs/distributed/README.md index 65ded1f92..90cd6c639 100644 --- a/docs/distributed/README.md +++ b/docs/distributed/README.md @@ -14,17 +14,17 @@ Distributed Minio provides protection against multiple node/drive failures and [ A stand-alone Minio server would go down if the server hosting the disks goes offline. In contrast, a distributed Minio setup with _n_ disks will have your data safe as long as _n/2_ or more disks are online. You'll need a minimum of _(n/2 + 1)_ [Quorum](https://github.com/minio/dsync#lock-process) disks to create new objects though. -For example, a 8 nodes distributed Minio setup, with 1 disk per node would stay put, even if upto 4 nodes are offline. But, you'll need atleast 5 nodes online to create new objects. +For example, an 8-node distributed Minio setup, with 1 disk per node would stay put, even if upto 4 nodes are offline. But, you'll need atleast 5 nodes online to create new objects. ## Limitations -As with Minio in standalone mode, distributed Minio has the per tenant limit of minimum 4 and maximum 16 drives (imposed by erasure code). This helps maintain simplicity and yet remain scalable. If you need a multiple tenant setup, you can easily spin multiple Minio instances managed by orchestration tools like Kubernetes. +As with Minio in stand-alone mode, distributed Minio has a per tenant limit of minimum 4 and maximum 16 drives (imposed by erasure code). This helps maintain simplicity and yet remain scalable. If you need a multiple tenant setup, you can easily spin multiple Minio instances managed by orchestration tools like Kubernetes. -Note that with distributed Minio you can play around with the number of nodes and drives as long as the limits are adhered to. For example you can have 2 nodes with 4 drives each, 4 nodes with 4 drives each, 8 nodes with 2 drives each, and so on. +Note that with distributed Minio you can play around with the number of nodes and drives as long as the limits are adhered to. For example, you can have 2 nodes with 4 drives each, 4 nodes with 4 drives each, 8 nodes with 2 drives each, and so on. # Get started -If you're aware of stand-alone Minio set up, the process remains largely the same, as the Minio server automatically switches to standalone or distributed mode, depending on the command line parameters. +If you're aware of stand-alone Minio set up, the process remains largely the same, as the Minio server automatically switches to stand-alone or distributed mode, depending on the command line parameters. ## 1. Prerequisites @@ -40,33 +40,30 @@ Below examples will clarify further: Example 1: Start distributed Minio instance with 1 drive each on 8 nodes, by running this command on all the 8 nodes. -``` - +```shell $ export MINIO_ACCESS_KEY= $ export MINIO_SECRET_KEY= -$ minio server http://192.168.1.11/export1 http://192.168.1.12/export2 -http://192.168.1.13/export3 http://192.168.1.14/export4 http://192.168.1.15/export5 http://192.168.1.16/export6 -http://192.168.1.17/export7 http://192.168.1.18/export8 - +$ minio server http://192.168.1.11/export1 http://192.168.1.12/export2 \ + http://192.168.1.13/export3 http://192.168.1.14/export4 \ + http://192.168.1.15/export5 http://192.168.1.16/export6 \ + http://192.168.1.17/export7 http://192.168.1.18/export8 ``` ![Distributed Minio, 8 nodes with 1 disk each](https://raw.githubusercontent.com/minio/minio/master/docs/screenshots/Architecture-diagram_distributed_8.png) Example 2: Start distributed Minio instance with 4 drives each on 4 nodes, by running this command on all the 4 nodes. -``` - +```shell $ export MINIO_ACCESS_KEY= $ export MINIO_SECRET_KEY= -$ minio server http://192.168.1.11/export1 http://192.168.1.11/export2 -http://192.168.1.11/export3 http://192.168.1.11/export4 -http://192.168.1.12/export1 http://192.168.1.12/export2 -http://192.168.1.12/export3 http://192.168.1.12/export4 -http://192.168.1.13/export1 http://192.168.1.13/export2 -http://192.168.1.13/export3 http://192.168.1.13/export4 -http://192.168.1.14/export1 http://192.168.1.14/export2 -http://192.168.1.14/export3 http://192.168.1.14/export4 - +$ minio server http://192.168.1.11/export1 http://192.168.1.11/export2 \ + http://192.168.1.11/export3 http://192.168.1.11/export4 \ + http://192.168.1.12/export1 http://192.168.1.12/export2 \ + http://192.168.1.12/export3 http://192.168.1.12/export4 \ + http://192.168.1.13/export1 http://192.168.1.13/export2 \ + http://192.168.1.13/export3 http://192.168.1.13/export4 \ + http://192.168.1.14/export1 http://192.168.1.14/export2 \ + http://192.168.1.14/export3 http://192.168.1.14/export4 ``` ![Distributed Minio, 4 nodes with 4 disks each](https://raw.githubusercontent.com/minio/minio/master/docs/screenshots/Architecture-diagram_distributed_16.png)