From c5477f6f11b4d474f4f17b0ee58dd61bdfd66e99 Mon Sep 17 00:00:00 2001
From: Jan David Mol <mol@astron.nl>
Date: Sun, 3 Oct 2021 20:08:34 +0000
Subject: [PATCH] L2SS-391: Better split of bootstrap and startup

---
 README.md | 23 ++++++++++++-----------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index b8d15a6b1..69331e6a7 100644
--- a/README.md
+++ b/README.md
@@ -22,20 +22,15 @@ You will also need:
 * python3.7+
 * pip
 
-## Bootstrap
+## Bootstra
 
-First we build all docker containers, and load the initial configuration. This may take a while:
+The bootstrap procedure is needed only once. First we build all docker containers, and load the initial configuration. This may take a while:
 
 ```
 cd docker-compose
 make bootstrap
 ```
 
-Once per reboot, the host kernel needs to be configured. This is already included in `make bootstrap`:
-```
-make start elk-configure-host
-```
-
 If you lack access to LOFAR station hardware, configure the devices to use their simulators instead:
 
 ```
@@ -44,8 +39,6 @@ for sim in ../CDB/*-sim-config.json; do
 done
 ```
 
-## Start up
-
 Now we can start all containers, and make sure everything is up:
 
 ```
@@ -53,9 +46,17 @@ make start
 make status
 ```
 
-If not, you can inspect why with `docker logs <container>`.
+If not, you can inspect why with `docker logs <container>`. The containers will automatically be restarted on reboot or failure. Stop them explicitly to bring them down (`make stop <container>`).
+
+## Start up
+
+The start-up procedure is needed both after bootstrapping and after a system reboot. Once per reboot, the host kernel needs to be configured:
+
+```
+make start elk-configure-host
+```
 
-The software devices start in an OFF state. To boot the devices, go to Jupyter (port 8888), start a new notebook, and run:
+The software devices start in an OFF state, after bootstrap or reboot. To boot the devices, go to Jupyter (port 8888), start a new notebook, and run:
 
 ```
 # start boot device
-- 
GitLab