Merge branch 'script-refactor'
Project: http://git-wip-us.apache.org/repos/asf/accumulo/repo Commit: http://git-wip-us.apache.org/repos/asf/accumulo/commit/6494a829 Tree: http://git-wip-us.apache.org/repos/asf/accumulo/tree/6494a829 Diff: http://git-wip-us.apache.org/repos/asf/accumulo/diff/6494a829 Branch: refs/heads/master Commit: 6494a829b9560b3b38359641f25ecdcf3aac9a75 Parents: e2247ea 9a3cc5c Author: Mike Walch <mwa...@apache.org> Authored: Fri Feb 17 14:05:34 2017 -0500 Committer: Mike Walch <mwa...@apache.org> Committed: Fri Feb 17 14:05:34 2017 -0500 ---------------------------------------------------------------------- INSTALL.md | 42 +- assemble/bin/accumulo | 610 +++-------------- assemble/bin/accumulo-cluster | 300 +++++++- assemble/bin/accumulo-service | 95 ++- assemble/bin/accumulo-util | 686 +++++++++++++++++++ assemble/conf/examples/gc | 16 - .../conf/examples/generic_logger.properties | 6 +- assemble/conf/examples/generic_logger.xml | 6 +- assemble/conf/examples/masters | 16 - assemble/conf/examples/monitor | 16 - .../conf/examples/templates/accumulo-env.sh | 64 ++ .../conf/examples/templates/accumulo-site.xml | 175 +++++ assemble/conf/examples/tracers | 16 - assemble/conf/examples/tservers | 16 - assemble/contrib/bootstrap-hdfs.sh | 91 --- assemble/contrib/check-tservers | 199 ------ assemble/contrib/gen-monitor-cert.sh | 85 --- assemble/contrib/tool.sh | 93 --- assemble/libexec/accumulo-watcher.sh | 141 ---- assemble/libexec/cluster.sh | 325 --------- assemble/libexec/load-env.sh | 155 ----- assemble/libexec/service.sh | 239 ------- assemble/libexec/templates/accumulo-env.sh | 90 --- assemble/libexec/templates/accumulo-site.xml | 175 ----- assemble/pom.xml | 7 +- assemble/src/main/assemblies/component.xml | 50 +- .../main/scripts/generate-example-configs.sh | 2 +- contrib/scripts/check-tservers.py | 199 ++++++ .../accumulo/core/conf/ConfigurationDocGen.java | 2 +- .../org/apache/accumulo/core/conf/Property.java | 2 +- .../main/asciidoc/chapters/administration.txt | 187 ++--- docs/src/main/asciidoc/chapters/clients.txt | 4 +- docs/src/main/asciidoc/chapters/kerberos.txt | 14 +- docs/src/main/asciidoc/chapters/replication.txt | 4 +- docs/src/main/asciidoc/chapters/ssl.txt | 4 +- .../main/asciidoc/chapters/troubleshooting.txt | 7 +- .../apache/accumulo/server/init/Initialize.java | 2 +- .../java/org/apache/accumulo/start/Main.java | 2 - 38 files changed, 1691 insertions(+), 2452 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/accumulo/blob/6494a829/docs/src/main/asciidoc/chapters/administration.txt ---------------------------------------------------------------------- diff --cc docs/src/main/asciidoc/chapters/administration.txt index bfddb31,f2ed57a..ad6cf11 --- a/docs/src/main/asciidoc/chapters/administration.txt +++ b/docs/src/main/asciidoc/chapters/administration.txt @@@ -1178,24 -1129,25 +1129,16 @@@ are true interruptions to availability Several of these conditions become more common in VM environments, where they can be exacerbated by resource constraints and clock drift. - Accumulo includes a mechanism to limit the impact of the false positives known - as the <<watcher>>. The watcher monitors Accumulo processes and will restart - them when they fail for certain reasons. The watcher can be configured within - the accumulo-env.sh file inside of Accumulo's configuration directory. We - recommend using the watcher to monitor Accumulo processes, as it will restore - the system to full capacity without administrator interaction after many of the - common failure modes. - ==== Tested Versions -Another large consideration for Accumulo stability is to use versions of -software that have been tested together in a VM environment. Any cluster of -processes that have not been tested together are likely to expose running -conditions that vary from the environments individually tested in the various -components. For example, Accumulo's use of HDFS includes many short block -reads, which differs from the more common full file read used in most -map/reduce applications. We have found that certain versions of Accumulo and -Hadoop will include stability bugs that greatly affect overall stability. In -our testing, Accumulo 1.6.2, Hadoop 2.6.0, and Zookeeper 3.4.6 resulted in a -stable VM clusters that did not fail a month of testing, while Accumulo 1.6.1, -Hadoop 2.5.1, and Zookeeper 3.4.5 had a mean time between failure of less than -a week under heavy ingest and query load. We expect that results will vary with -other configurations, and you should choose your software versions with that in -mind. - - - - - - - +Each release of Accumulo is built with a specific version of Apache +Hadoop, Apache ZooKeeper and Apache Thrift. We expect Accumulo to +work with versions that are API compatable with those versions. +However this compatibility is not guaranteed because Hadoop, ZooKeeper +and Thift may not provide guarantees between their own versions. We +have also found that certain versions of Accumulo and Hadoop included +bugs that greatly affected overall stability. Thrift is particularly +prone to compatablity changes between versions and you must use the +same version your Accumulo is built with. + +Please check the release notes for your Accumulo version or use the +mailing lists at https://accumulo.apache.org for more info.