accumulo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mwa...@apache.org
Subject [1/2] accumulo-website git commit: Blog post about Uno & Muchos
Date Fri, 21 Apr 2017 18:34:34 GMT
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 <mwalch@apache.org>
Authored: Wed Dec 14 16:41:05 2016 -0500
Committer: Mike Walch <mwalch@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/


Mime
View raw message