[ZOOKEEPER-2240] Make the three-node minimum more explicit in documentation and on website

• Type: Improvement
• Status: Closed
• Priority: Trivial
• Resolution: Fixed
• Fix Version/s: 3.4.9, 3.5.2, 3.6.0
• Component/s: documentation
• Hadoop Flags: Reviewed
• Assignee: Mohammad Arshad
• Reporter: Shawn Heisey
• Created: 05/Aug/15 04:09
• Updated: 21/Jul/16 20:18
• Resolved: 20/Mar/16 04:31

Description

One of the most important parts of a production zookeeper deployment is the three-node minimum requirement for fault tolerance ... but when I glance at the website and the documentation, this requirement is difficult to actually find.

It is buried deep in the admin documentation, in a sentence that says "Thus, a deployment that consists of three machines can handle one failure, and a deployment of five machines can handle two failures." Other parts of the documentation hint at it, but nothing that I've seen comes out and explicitly says it.

Ideally, documentation about this requirement would be in a location where it can be easily pinpointed with a targeted URL, so I can point to ZK documentation with a link and clearly tell SolrCloud users that this is a real requirement.

If someone can point me to version control locations where I can check out or clone the docs and the website, I'm happy to attempt a patch.