This is an automated email from the ASF dual-hosted git repository.
ctubbsii pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/accumulo-testing.git
The following commit(s) were added to refs/heads/master by this push:
new 75b6ef3 README.md for automateEC2.sh (#113)
75b6ef3 is described below
commit 75b6ef383ae980d24a1c4e2280928ef3cb860f9f
Author: Russell Carter <russell....@gmail.com>
AuthorDate: Thu Sep 26 16:05:31 2019 -0400
README.md for automateEC2.sh (#113)
---
README.md | 3 +++
test/automation/README.md | 17 +++++++++++++++++
2 files changed, 20 insertions(+)
diff --git a/README.md b/README.md
index 88b0009..e5e4f78 100644
--- a/README.md
+++ b/README.md
@@ -238,6 +238,9 @@ test and produce json result files.
There are some utilities for working with the json result files, run the
`performance` script
with no options to see them.
+## Automated Cluster Testing
+See the [readme.md](/test/automation/README.md).
+
[Uno]: https://github.com/apache/fluo-uno
[modules]: core/src/main/resources/randomwalk/modules
[image]: core/src/main/resources/randomwalk/modules/Image.xml
diff --git a/test/automation/README.md b/test/automation/README.md
new file mode 100644
index 0000000..06a74ea
--- /dev/null
+++ b/test/automation/README.md
@@ -0,0 +1,17 @@
+# Automated Cluster Testing
+
+Testing a snapshot version of Accumulo on a cluster using this respository
requires many repetive steps. Luckily, there is script that automates this
using [Muchos]. This script is found in
[test/automation/automateEC2.sh](automateEC2.sh).
+
+Before running the script, edit [cluster_props.sh](cluster_props.sh). All
repositories are set to the master branch of the corresponding Apache project
by default. You can change these values to your specific forks and branches as
desired.
+
+A path to `muchos.props` is required in order to run the script. You can find
the required configurations and an example of `muchos.props` [in the official
Fluo-Muchos readme][Muchos].
+
+### Execution takes no arguments as followed:
+ ./automateEC2.sh
+
+### Things to consider:
+* The script will read from the `MUCHOS_PROPS` environment variable if
defined.
+* Accumulo versions between `muchos.props` and `pom.xml` file of a given
Accumulo branch should be consistent.
+* Accumulo and Fluo-Muchos will be installed locally in a temporary directory
under `/tmp`, which is typically cleared by the operating system periodically
(system-specific, possibly on reboots, daily, weekly, etc.).
+
+[Muchos]: https://github.com/apache/fluo-muchos
