Repository: accumulo-website Updated Branches: refs/heads/asf-site 864f17d10 -> c147eb1e9 refs/heads/master 55a32af0a -> c7576e848
Blog post about Uno & Muchos Project: http://git-wip-us.apache.org/repos/asf/accumulo-website/repo Commit: http://git-wip-us.apache.org/repos/asf/accumulo-website/commit/c7576e84 Tree: http://git-wip-us.apache.org/repos/asf/accumulo-website/tree/c7576e84 Diff: http://git-wip-us.apache.org/repos/asf/accumulo-website/diff/c7576e84 Branch: refs/heads/master Commit: c7576e84809f47a8e58321fe7e23da7b26df6784 Parents: 55a32af Author: Mike Walch <mwa...@apache.org> Authored: Wed Dec 14 16:41:05 2016 -0500 Committer: Mike Walch <mwa...@apache.org> Committed: Fri Apr 21 14:31:25 2017 -0400 ---------------------------------------------------------------------- .../2016-11-16-simpler-scripts-and-config.md | 1 - .../2017-04-21-introducing-uno-and-muchos.md | 101 +++++++++++++++++++ 2 files changed, 101 insertions(+), 1 deletion(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/c7576e84/_posts/blog/2016-11-16-simpler-scripts-and-config.md ---------------------------------------------------------------------- diff --git a/_posts/blog/2016-11-16-simpler-scripts-and-config.md b/_posts/blog/2016-11-16-simpler-scripts-and-config.md index 1fe723d..1ad3f22 100644 --- a/_posts/blog/2016-11-16-simpler-scripts-and-config.md +++ b/_posts/blog/2016-11-16-simpler-scripts-and-config.md @@ -1,7 +1,6 @@ --- title: "Simpler scripts and configuration coming in Accumulo 2.0.0" author: Mike Walch -reviewers: Josh Elser, Chistopher Tubbs --- For the upcoming 2.0.0 release, Accumulo's scripts and configuration [were refactored][ACCUMULO-4490] http://git-wip-us.apache.org/repos/asf/accumulo-website/blob/c7576e84/_posts/blog/2017-04-21-introducing-uno-and-muchos.md ---------------------------------------------------------------------- diff --git a/_posts/blog/2017-04-21-introducing-uno-and-muchos.md b/_posts/blog/2017-04-21-introducing-uno-and-muchos.md new file mode 100644 index 0000000..e720524 --- /dev/null +++ b/_posts/blog/2017-04-21-introducing-uno-and-muchos.md @@ -0,0 +1,101 @@ +--- +title: "Introducing Uno and Muchos" +author: Mike Walch +--- + +While [Accumulo's installation instructions][install] are simple, it can be time consuming to install Accumulo +given its requirement on [Hadoop] and [Zookeeper] being installed and running. For a one-time production +installation, this set up time (which can take up to an hour) is not much of an inconvenience. However, it can become a burden +for developers who need to frequently set up Accumulo to test code changes, switch between different +versions, or start a fresh instance on a laptop. + +[Uno] and [Muchos] are tools that ease the burden on developers of installing Accumulo and its dependencies. +The names of Uno and Muchos indicate their use case. Uno is designed for running +Accumulo on a single node while Muchos is designed for running Accumulo on a cluster. While Uno and +Muchos are configured by default to install the most recent stable binary tarball release of Accumulo, Hadoop, +and Zookeeper from Apache mirrors, it is easy to configure different versions to match a production cluster. + +The sections below show how to use these tools. For more complete documentation, view their respective GitHub +pages. + +## Uno + +[Uno] is a command line tool that sets up Accumulo on a single machine. It can be installed by cloning the +Uno git repo. + +```bash +git clone https://github.com/astralway/uno.git +cd uno +``` + +Uno works out of the box but it can be customized by modifying `conf/uno.conf`. + +First, download the Accumulo, Hadoop, and Zookeeper tarballs from Apache by using the command below: + +```bash +./bin/uno fetch accumulo +``` + +The fetch command places all tarballs in the `downloads/` directory. Uno can be configured (in `conf/uno.conf`) +to build an Accumulo tarball from a local git repo when `fetch` is called. + +After downloading tarballs, the command below sets up Accumulo, Hadoop & Zookeeper in the `install/` directory. + +```bash +./bin/uno setup accumulo +``` + +Accumulo, Hadoop, & Zookeeper are now ready to use. You can view the Accumulo monitor at +[http://localhost:9995](http://localhost:9995). You can configure your shell using the command below: + +```bash +eval "$(./bin/uno env)" +``` + +Run `uno stop accumulo` to cleanly stop your cluster and `uno start accumulo` to start it again. + +If you need a fresh cluster, you can run `uno setup accumulo` again. To kill your cluster, run `uno kill`. + +## Muchos + +[Muchos] is a command line tool that launches an AWS EC2 cluster with Accumulo set up on it. It is installed by +cloning its git repo. + +```bash +git clone https://github.com/astralway/muchos.git +cd muchos +``` + +Before using Muchos, create `muchos.props` in `conf/` and edit it for your AWS environment. + +```bash +cp conf/muchos.props.example conf/muchos.props +vim conf/muchos.props +``` + +Next, run the command below to launch a cluster in AWS. + +```bash +muchos launch -c mycluster +``` + +After launching the cluster, set up Accumulo on it using the following command. + +```bash +muchos setup +``` + +Use `muchos ssh` to ssh to the cluster and `muchos terminate` to terminate all EC2 nodes when you are finished. + +## Conclusion + +Uno and Muchos automate installing Accumulo for developmment and testing. While not recommended for production +use at this time, Muchos is a great reference for running Accumulo in production. System admistrators can +reference the [Ansible] code in Muchos to automate management of their own clusters. + +[install]: https://github.com/apache/accumulo/blob/master/INSTALL.md +[Hadoop]: https://hadoop.apache.org/ +[Zookeeper]: https://zookeeper.apache.org/ +[Uno]: https://github.com/astralway/uno +[Muchos]: https://github.com/astralway/muchos +[Ansible]: https://www.ansible.com/
