From 3fc93b105ac4e53de946acd8ea08f8c4a77a6da8 Mon Sep 17 00:00:00 2001
From: Jan David Mol <mol@astron.nl>
Date: Sun, 3 Oct 2021 20:00:44 +0000
Subject: [PATCH] L2SS-391: Improved order in documentation

---
 README.md | 48 ++++++++++++++++++++++--------------------------
 1 file changed, 22 insertions(+), 26 deletions(-)

diff --git a/README.md b/README.md
index 77f5fee55..b8d15a6b1 100644
--- a/README.md
+++ b/README.md
@@ -31,22 +31,20 @@ cd docker-compose
 make bootstrap
 ```
 
-PS: Once per reboot, the host kernel needs to be configured. This is already included in `make bootstrap`:
+Once per reboot, the host kernel needs to be configured. This is already included in `make bootstrap`:
 ```
 make start elk-configure-host
 ```
 
-## Use simulators
-
 If you lack access to LOFAR station hardware, configure the devices to use their simulators instead:
 
 ```
-for sim in sdp-sim recv-sim unb2-sim; do
+for sim in ../CDB/*-sim-config.json; do
   ../sbin/update_ConfigDb.sh ../CDB${sim}-config.json
 done
 ```
 
-## Start up the remaining containers
+## Start up
 
 Now we can start all containers, and make sure everything is up:
 
@@ -57,6 +55,25 @@ make status
 
 If not, you can inspect why with `docker logs <container>`.
 
+The software devices start in an OFF state. To boot the devices, go to Jupyter (port 8888), start a new notebook, and run:
+
+```
+# start boot device
+boot.initialise()
+boot.on()
+
+# this should report as DevState.ON
+boot.status()
+
+# boot station
+boot.initialise_station()
+
+# wait until this reports the initialisation is done (or was stopped half way):
+print(f"Still initialising: {boot.initialising_station_R}. Completeness: {boot.initialisation_progress_R}%. State: {boot.initialisation_status_R}")
+```
+
+Then, in Grafana (port 3000), you should see the devices reaching the ON state.
+
 # Remote Interfaces
 
 The station provides the following interfaces accessible through your browser (assuming you run on `localhost`):
@@ -77,24 +94,3 @@ Futhermore, there are some low-level interfaces:
 |Tango Database|MariaDB|http://localhost:3306|tango/tango|
 |Archive Database|MariaDB|http://localhost:3307|tango/tango|
 |Log Database|ElasticSearch|http://localhost:9200||
-
-# Boot the station
-
-Initially, all the devices controlling the station are down. To boot everything up, go to Jupyter (port 8888) and run:
-
-```
-# start boot device
-boot.initialise()
-boot.on()
-
-# this should report as DevState.ON
-boot.status()
-
-# boot station
-boot.initialise_station()
-
-# wait until this reports the initialisation is done (or was stopped half way):
-print(f"Still initialising: {boot.initialising_station_R}. Completeness: {boot.initialisation_progress_R}%. State: {boot.initialisation_status_R}")
-```
-
-Then, in Grafana (port 3000), you should see the devices reaching the ON state.
-- 
GitLab