server documentation

docs/src/firmware.rst

@@ -154,6 +154,8 @@ Upgrade (from v5.0.0)
 
 Check :ref:`firmware troubleshooting <blackfin firmware troubleshooting>` if you run into issues while programming firmware.
 
+Always ensure that the client and server software are of the same release.
+
 
 #. Program from console
     .. code-block:: bash
@@ -222,6 +224,8 @@ Download
 Upgrade (from v5.0.0)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+Always ensure that the client and server software are of the same release.
+
 #. Program from console
     .. code-block:: bash
 
@@ -251,6 +255,8 @@ Download
 Upgrade (from v5.0.0)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+Always ensure that the client and server software are of the same release.
+
 #. Program from console
     .. code-block:: bash
 
@@ -278,6 +284,8 @@ Upgrade (from v5.0.0)
 
 Check :ref:`firmware troubleshooting <blackfin firmware troubleshooting>` if you run into issues while programming firmware.
 
+Always ensure that the client and server software are of the same release.
+
 #. Program from console
     .. code-block:: bash
 
@@ -304,6 +312,8 @@ Upgrade (from v5.0.0)
 
 Check :ref:`firmware troubleshooting <blackfin firmware troubleshooting>` if you run into issues while programming firmware.
 
+Always ensure that the client and server software are of the same release.
+
 #. Program from console
     .. code-block:: bash
 
@@ -344,26 +354,43 @@ Firmware Troubleshooting with blackfin
 
 5. If one can't list it, read the next section to try to get the blackfin to list it.
 
-How to get back mtd3 drive remotely
+How to get back mtd3 drive remotely (copying new kernel)
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-This might take a few reruns (maybe even 10) until the mtd drive is accessed by the blackfin upon linux startup.
 
   .. code-block:: bash
     
-    # step 1: connect to the board
+    # step 1: get the kernel image (uImage.lzma) from slsdetectorgroup
+    # and copy it to pc's tftp folder
+
+    # step 2: connect to the board
     telnet bchipxxx
 
-    # step 2: check if mtd3 drive listed
+    #step 3: go to directory for space
-    more /proc/mtd
+    cd /var/tmp/
 
-    # step 3: tell fpga not to touch flash and reboot
+    # step 3: copy kernel to board
-    echo 9 > /sys/class/gpio/export; 
+    tftp pcxxx -r uImage.lzma -g
-    echo out > /sys/class/gpio/gpio9/direction; 
+
-    echo 0 > /sys/class/gpio/gpio9/value;
+    # step 4: verify kernel copied properly
+    ls -lrt
+    
+    # step 5: erase flash
+    flash_eraseall /dev/mtd1
+    
+    # step 6: copy new image to kernel drive
+    cat uImage.lzma > /dev/mtd1
+    
+    # step 7:
+    sync
+    
+    # step 8:
     reboot
-
+    
-    # step 4: repeat steps 1 - 3 until you see the mtd3 drive
+    # step 9: verification
-
+    telnet bchipxxx
+    uname -a # verify kernel date
+    more /proc/mtd # verify mtd3 is listed
+    
 
 Last Resort using USB Blaster
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

docs/src/index.rst

@@ -62,6 +62,7 @@ Welcome to slsDetectorPackage's documentation!
     :maxdepth: 2
 
     servers
+    serverbackground
     serverupgrade
     virtualserver
     serverdefaults

docs/src/serverbackground.rst

@@ -0,0 +1,128 @@
+Detector Server in the Background
+=================================
+
+
+
+Eiger
+-------------
+
+
+.. code-block:: bash
+
+    # step 1: connect to board
+    ssh root@bebxxx
+
+    # step 2: create file
+    vi /etc/rc5.d/S50board_com.ssh
+
+    # step 3: edit contents to start up server (and 10g_led script)
+    #! /bin/sh
+    ### BEGIN INIT INFO
+    # Provides:          feb_com
+    # Required-Start:    $remote_fs $all
+    # Required-Stop: 
+    # Default-Start:     2 3 4 5
+    # Default-Stop:
+    # Short-Description: Starts the beb_com and feb_com
+    # Description:       Starts feb communication ...
+    #                    
+    ### END INIT INFO
+
+    /home/root/executables/eigerDetectorServer &> /dev/null &
+    /home/root/executables/10g_led &
+
+    exit 0
+
+    # step 4: save file and reboot
+    reboot
+
+    #step 5: verify server is running in background
+    ps -ef | grep eigerDetectorServer
+
+
+Jungfrau
+-------------
+
+Check :ref:`Blackfin detector servers in background<blackfin detector servers in background>`.
+
+
+Gotthard
+---------
+
+Check :ref:`Blackfin detector servers in background<blackfin detector servers in background>`.
+
+
+Mythen3
+-------
+
+Check :ref:`Nios detector servers in background<nios detector servers in background>`.
+
+
+Gotthard2
+----------
+
+Check :ref:`Nios detector servers in background<nios detector servers in background>`.
+
+
+Moench
+------
+
+Check :ref:`Blackfin detector servers in background<blackfin detector servers in background>`.
+
+Ctb
+---
+
+Check :ref:`Blackfin detector servers in background<blackfin detector servers in background>`.
+
+.. _blackfin detector servers in background:
+
+Blackfin Detector Servers in Background (Respawning)
+----------------------------------------------------
+
+.. code-block:: bash
+
+    # step 1: connect to board
+    telnet bchipxxx
+
+    # step 2: create a soft link connecting the right server
+    ln -sf xxxDetectorServerxxxxx xxxDetectorServer
+
+    # step 3: edit file to respawn server
+    vi /etc/inittab
+
+    # step 4: add to the end of file 
+    ttyS0::respawn:/./xxxDetectorServer
+
+    # step 5: save file and reboot
+    reboot
+
+    # step 6: verify server is running in background
+    ps -ef | grep xxxDetectorServer
+
+
+.. _nios detector servers in background:
+
+Nios Detector Servers in Background
+----------------------------------------
+
+.. code-block:: bash
+
+    # step 1: connect to board
+    ssh root@bebxxx
+
+    # step 2: create a soft link connecting the right server
+    ln -sf xxxDetectorServerxxx xxxDetectorServer
+
+    # step 3: create file
+    vi /etc/init.d/S99DetServer.ssh
+
+    # step 4: add contents 
+    #! /bin/sh
+    cd /root >> /dev/null
+    /root/xxxDetectorServer >> /dev/null &
+
+    # step 5: save file and reboot
+    reboot
+
+    # step 6: verify server is running in background
+    ps -ef | grep xxxDetectorServer