summaryrefslogtreecommitdiffstats
path: root/documentation/toaster-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/toaster-manual')
-rw-r--r--documentation/toaster-manual/toaster-manual-setup-and-use.xml53
1 files changed, 42 insertions, 11 deletions
diff --git a/documentation/toaster-manual/toaster-manual-setup-and-use.xml b/documentation/toaster-manual/toaster-manual-setup-and-use.xml
index b3609c8954..2510c2b878 100644
--- a/documentation/toaster-manual/toaster-manual-setup-and-use.xml
+++ b/documentation/toaster-manual/toaster-manual-setup-and-use.xml
@@ -440,21 +440,52 @@
440 </literallayout> 440 </literallayout>
441 </para></listitem> 441 </para></listitem>
442 <listitem><para> 442 <listitem><para>
443 Install the build runner service. 443 Prepare the systemd service to run Toaster builds.
444 This service needs to be running in order to dispatch 444 Here is a sample configuration file for the service:
445 builds.
446 Use this command:
447 <literallayout class='monospaced'> 445 <literallayout class='monospaced'>
448 /var/www/toaster/poky/bitbake/lib/toaster/manage.py runbuilds 446 [Unit]
447 Description=Toaster runbuilds
448
449 [Service]
450 Type=forking
451 User=toaster
452 ExecStart=/usr/bin/screen -d -m -S runbuilds /var/www/toaster/poky/bitbake/lib/toaster/runbuilds-service.sh start
453 ExecStop=/usr/bin/screen -S runbuilds -X quit
454 WorkingDirectory=/var/www/toaster/poky
455
456 [Install]
457 WantedBy=multi-user.target
449 </literallayout> 458 </literallayout>
450 Here is an example: 459 Prepare the <filename>runbuilds-service.sh</filename>
460 script that you need to place in the
461 <filename>/var/www/toaster/poky/bitbake/lib/toaster/</filename>
462 directory by setting up executable permissions:
451 <literallayout class='monospaced'> 463 <literallayout class='monospaced'>
452 #!/bin/sh 464 #!/bin/bash
453 # toaster run builds dispatcher 465
454 cd /var/www/toaster/ 466 #export http_proxy=http://proxy.host.com:8080
455 source ./venv/bin/activate 467 #export https_proxy=http://proxy.host.com:8080
456 ./bitbake/lib/toaster/manage.py runbuilds 468 #export GIT_PROXY_COMMAND=$HOME/bin/gitproxy
469
470 cd ~/poky/
471 source ./oe-init-build-env build
472 source ../bitbake/bin/toaster $1 noweb
473 [ "$1" == 'start' ] &amp;&amp; /bin/bash
474 </literallayout>
475 </para></listitem>
476 <listitem><para>
477 Run the service:
478 <literallayout class='monospaced'>
479 # service runbuilds start
480 </literallayout>
481 Since the service is running in a detached screen
482 session, you can attach to it using this command:
483 <literallayout class='monospaced'>
484 $ sudo su - toaster
485 $ screen -rS runbuilds
457 </literallayout> 486 </literallayout>
487 You can detach from the service again using "Ctrl-a"
488 followed by "d" key combination.
458 </para></listitem> 489 </para></listitem>
459 </orderedlist> 490 </orderedlist>
460 You can now open up a browser and start using Toaster. 491 You can now open up a browser and start using Toaster.