summaryrefslogtreecommitdiffstats
path: root/documentation/toaster-manual/toaster-manual-setup-and-use.xml
diff options
context:
space:
mode:
authorEd Bartosh <ed.bartosh@linux.intel.com>2016-07-12 10:47:55 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2016-07-19 15:04:50 +0100
commit4e017740b7073ee992c9691110887d906e14e6ae (patch)
treed329d94593b986fa99999e8a619d6ba3d4010525 /documentation/toaster-manual/toaster-manual-setup-and-use.xml
parent3d24037b76c9c852b041b4b5870aa032c78c6ba8 (diff)
downloadpoky-4e017740b7073ee992c9691110887d906e14e6ae.tar.gz
toaster-manual: update runbuilds instructions
Added sample configuration files and instructions for the runbuilds systemd service. Service runs runbuilds in a screen session for user convenience. User can attach to the session to see the runbuilds output, monitor logs and build environment. (From yocto-docs rev: 40beaa575fb96a06992a1d62bb45cd0cbbe2ae86) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/toaster-manual/toaster-manual-setup-and-use.xml')
-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.