L2SS-391: Improved order in documentation

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.