From 3b93fa47f47196d633a93c42adef4b87f3b1c890 Mon Sep 17 00:00:00 2001
From: Dhanya Thattil <dhanya.thattil@psi.ch>
Date: Thu, 19 Aug 2021 13:37:40 +0200
Subject: [PATCH] added doc on automatic start up of detector server

---
 docs/src/servers.rst | 46 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/docs/src/servers.rst b/docs/src/servers.rst
index 8c3203062..dd3284d26 100644
--- a/docs/src/servers.rst
+++ b/docs/src/servers.rst
@@ -34,3 +34,49 @@ Detector Servers include:
       *  Client requests for detector status, stop acquisition, temperature, advanced read/write registers.
 
 When using a blocking acquire command (sls_detector_acquire or Detector::acquire), the control server is blocked until end of acquisition. However, stop server commands could be used in parallel.
+
+
+Automatic start 
+------------------
+
+One can start the on-board detector server automatically upon powering on the board.
+
+First create a soft link to the binary on board. 
+   .. code-block:: bash
+      
+      ln -sf someDetectorServervx.x.x someDetectorServer
+
+Then, do the following depending on the detector type.
+
+
+Eiger
+   .. code-block:: bash
+      
+      # create script in rc5.d on the board
+      vi /etc/rc5.d/S50board_com.sh
+
+      # enter the following (edit server name)
+      #! /bin/sh
+      /home/root/executables/eigerDetectorServer &> /dev/null &
+      exit 0
+
+Jungfrau | Moench | CTB | Gotthard I
+   .. code-block:: bash
+      
+      # Edit inittab on board
+      vi /etc/inittab
+
+      # enter the following line
+      ttyS0::respawn:/./jungfrauDetectorServer
+
+
+Gotthard II | Mythen III
+   .. code-block:: bash
+      
+      # create script in init.d on the board
+      vi /etc/init.d/S99detServer.sh
+
+      # enter the following (edit server name)
+      #! /bin/sh
+      cd /root >> /dev/null
+      /root/mythen3DetectorServer >> /dev/null &