From e077bc66a89220b0326f65f0bc5fea96f2576483 Mon Sep 17 00:00:00 2001
From: Marcin Chrzanowski <marcin.j.chrzanowski@gmail.com>
Date: Wed, 29 Jan 2020 22:32:35 +0100
Subject: Describe demo setup scripts

---
 README.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/README.md b/README.md
index 3a5ad5b..834574a 100644
--- a/README.md
+++ b/README.md
@@ -53,3 +53,55 @@ a hard-coded test hierarchy.
     ./gradlew test --tests InterpreterTests.fileTest13
 
 Generates an HTML test report at `build/reports/tests/test/index.html`.
+
+## Demo setup
+
+The `scripts/` directory contains a bundle of scripts that can be helpful when
+setting up a simple hierarchy.
+
+### Envrionment Variables
+
+The scripts assume that there are 5 machines with hostnames `rainbow01`, ...,
+`rainbow05`. Each machine should have the following environment variables
+available:
+
+* `NODE_NUMBER`: ranging from `01` to `05`
+* `ZONE`: a level-1 zone name (e.g. `uw`)
+
+For example, if `rainbow01` corresponds to node `/uw/rainbow01` in the
+hierarchy, it should have `NODE_NUMBER=01` and `ZONE=uw`.
+
+### RMI registry
+
+Each node should have an RMI registry running, started with
+
+    ./scripts/registry
+
+### Query signer
+
+The scripts assume that the query signer runs on `rainbow01`. Before starting
+it, run
+
+    ./scripts/generate_keys.sh
+
+If `rainbow01` has ssh access to the other machines, the public key can then be
+distributed with
+
+    ./scripts/copyKey.sh
+
+Finally, start the query signer on `rainbow01` with
+
+    ./scripts/runQuerySigner.sh
+
+### Agent and fetcher
+
+On each machine, the agent and fetcher components should be started with
+
+    ./scripts/runAgent.sh
+    ./scripts/runFetcher.sh
+
+### Client (optional)
+
+A client connected to the local agent can be optionally started with
+
+    ./scripts/runClient.sh
-- 
cgit v1.2.3