Differences

This shows you the differences between two versions of the page.

@@ Line 1: / Line 1: @@
+====== Auto start in user context ======
+[[:english#rocrail|{{  :server.png}}]][[:english|{{  :rocrail-logo-35.png}}]]
+[[english | Content ]] -> [[english#rocrail|Rocrail Server]]\\
+ \\
+{{:raspi:ps-x-raspi-crontab.png}}\\
+ \\
+| //The user **pi** is used in the examples. \\ This is the preferred way to start the Rocrail Server automatically after reboot instead of running it as daemon in root context.// |
+ \\
+=====Introduction=====
+If the Rocrail Server runs on a dedicated computer like the Raspberry Pi, it would be helpful if the Server starts automatically after every reboot in user context.\\
+There are several ways to establish this, but the crontab solution is very easy to implement.\\
+ \\
+=====Start script=====
+The provided ''[[#provided_startrocrailsh|~/Rocrail/startrocrail.sh]]'' can also be used instead of writing your own.\\
+This provided version supports also functions of the __**[[:servermonitor-en|Server Monitor]]**__.\\
+==== A start script from scratch ===
+Create a start script, **startrocrail.sh** in the home directory of user **pi** by opening an editor like **vi startrocrail.sh**:
+<code bash>
+#!/bin/sh
+cd /home/pi/Rocrail
+/home/pi/Rocrail/bin/rocrail -l /home/pi/Rocrail/bin
+</code>
+Make the script executable:
+<code bash>
+chmod +x startrocrail.sh
+</code>
+====Shutdown option====
+| //Use this option first if everything runs perfect.// \\ //User **pi** is supposed to be a sudoer.// |
+To automatically shutdown the computer after the Rocrail Server did stop, add the following line to the **startrocrail.sh** script:
+<code bash>
+if [ $? -eq 70 ]
+then
+  echo raspberry | sudo -S halt -p
+fi
+</code>
+The echo statement is followed by the password of the user. In this case its "raspberry", which is the default password of the user **pi** under Raspbian.\\
+| Rocrail will return 70 in case of a client shutdown command. A kill will return zero. |
+ \\
+=====CronTab=====
+Add the following line at the end of the crontab list of user **pi** with the command **crontab -e**:
+<code bash>
+@reboot /home/pi/startrocrail.sh
+</code>
+Or directly on the command line:
+<code bash>
+(crontab -l ; echo "@reboot /home/pi/startrocrail.sh")| crontab -
+</code>
+Check the crontab:
+<code bash>
+crontab -l
+</code>
+Output:
+<code bash>
+# For more information see the manual pages of crontab(5) and cron(8)
+#
+# m h  dom mon dow   command
+@reboot /home/pi/startrocrail.sh
+</code>
+ \\
+=====Stop the Rocrail Server=====
+| //A normal shutdown of the computer will issue to all running processes a kill command which also will shutdown the Rocrail Server normally.// |
+====Rocview====
+  * __**[[:rocgui-menu-en#shutdown_rocrail_and_exit|Shutdown Rocrail and exit]]**__
+====Rocweb====
+  * __**[[:rocweb:rocweb-en#system|System: Shutdown server]]**__
+====andRoc====
+  * System: Shutdown server.\\
+====Monitor====
+  * __**[[:servermonitor-en|Shutdown]]**__
+====SSH Shell====
+<code>
+killall rocrail
+</code>
+ \\
+=====Provided startrocrail.sh =====
+<code bash>
+#!/bin/sh
+WS=$1
+PASSWORD=$2
+cd
+if [ !  $1 ]; then
+  cd ~/Rocrail/default
+else
+  cd ~/Rocrail/$WS
+fi
+~/Rocrail/bin/rocrail -l ~/Rocrail/bin
+if [ $? -eq 70 ]
+then
+  echo $PASSWORD | sudo -S halt -p
+fi
+</code>