diff --git a/docs/src/firmware.rst b/docs/src/firmware.rst index 9eb00547a..7b7e8d235 100644 --- a/docs/src/firmware.rst +++ b/docs/src/firmware.rst @@ -154,6 +154,8 @@ Upgrade (from v5.0.0) Check :ref:`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 ` 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 ` 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 -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -This might take a few reruns (maybe even 10) until the mtd drive is accessed by the blackfin upon linux startup. +How to get back mtd3 drive remotely (copying new kernel) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. 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 - more /proc/mtd + #step 3: go to directory for space + cd /var/tmp/ - # step 3: tell fpga not to touch flash and reboot - echo 9 > /sys/class/gpio/export; - echo out > /sys/class/gpio/gpio9/direction; - echo 0 > /sys/class/gpio/gpio9/value; + # step 3: copy kernel to board + tftp pcxxx -r uImage.lzma -g + + # 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 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/docs/src/index.rst b/docs/src/index.rst index 65a3d6d8b..364f1acf9 100644 --- a/docs/src/index.rst +++ b/docs/src/index.rst @@ -62,6 +62,7 @@ Welcome to slsDetectorPackage's documentation! :maxdepth: 2 servers + serverbackground serverupgrade virtualserver serverdefaults diff --git a/docs/src/serverbackground.rst b/docs/src/serverbackground.rst new file mode 100644 index 000000000..34f2af301 --- /dev/null +++ b/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`. + + +Gotthard +--------- + +Check :ref:`Blackfin detector servers in background`. + + +Mythen3 +------- + +Check :ref:`Nios detector servers in background`. + + +Gotthard2 +---------- + +Check :ref:`Nios detector servers in background`. + + +Moench +------ + +Check :ref:`Blackfin detector servers in background`. + +Ctb +--- + +Check :ref:`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