Lines Matching +full:start +full:- +full:up
1 .. SPDX-License-Identifier: CC-BY-SA-2.0-UK
6 Setting Up and Using Toaster
12 Once you have set up the Yocto Project and installed the Toaster system
13 dependencies as described in the ":ref:`toaster-manual/start:Preparing to Use
14 Toaster`" chapter, you are ready to start
24 $ source oe-init-build-env
27 ``poky/build``), start Toaster using this command::
29 $ source toaster start
33 ":ref:`toaster-manual/setup-and-use:using the toaster web interface`".
47 $ source toaster start webport=8400
49 Setting Up Toaster Without a Web Server
52 You can start a Toaster environment without starting its web server.
55 - Capturing a command-line build's statistics into the Toaster database
58 - Capturing a command-line build's statistics when the Toaster server
61 - Having one instance of the Toaster web server track and capture
62 multiple command-line builds, where each build is started in its own
65 The following commands show how to start a Toaster environment without
71 server instance running, you can watch this command-line build's
74 $ source toaster start noweb
78 Setting Up Toaster Without a Build Server
81 You can start a Toaster environment with the "New Projects" feature
84 - Sharing your build results over the web server while blocking others
87 - Allowing only local command-line builds to be captured into the
90 Use the following command to set up Toaster without a build server::
92 $ source toaster start nobuild webport=port
94 Setting up External Access
106 $ source toaster start webport=0.0.0.0:8400
110 $ source toaster start webport=192.168.1.1:8400
147 #. If you used ``pip3``, which is recommended, to set up the Toaster
167 #. Django prompts you to re-enter your password for verification.
185 Setting Up a Production Instance of Toaster
191 service. Use the instructions in the following sections to set up
195 ------------
201 You must comply with all Apache, ``mod-wsgi``, and Mysql requirements.
203 - Have all the build requirements as described in the ":ref:`toaster-manual/start:Preparing to
206 - Have an Apache webserver.
208 - Have ``mod-wsgi`` for the Apache webserver.
210 - Use the Mysql database server.
212 - If you are using Ubuntu, run the following::
214 $ sudo apt install apache2 libapache2-mod-wsgi-py3 mysql-server python3-pip libmysqlclient-dev
216 - If you are using Fedora or a RedHat distribution, run the
219 … $ sudo dnf install httpd python3-mod_wsgi python3-pip mariadb-server mariadb-devel python3-devel
221 - If you are using openSUSE, run the following::
223 …$ sudo zypper install apache2 apache2-mod_wsgi-python3 python3-pip mariadb mariadb-client python3-…
226 ------------
233 $ sudo /usr/sbin/useradd toaster -md /var/www/toaster -s /bin/false
234 $ sudo su - toaster -s /bin/bash
242 #. Install Toaster dependencies using the ``--user`` flag which keeps the
243 Python packages isolated from your system-provided packages::
246 $ pip3 install --user -r ./poky/bitbake/toaster-requirements.txt
247 $ pip3 install --user mysqlclient
259 - Edit the
263 .. code-block:: python
276 - Edit the
277 `SECRET_KEY <https://docs.djangoproject.com/en/2.2/ref/settings/#std:setting-SECRET_KEY>`__:
279 .. code-block:: python
283 - Edit the
284 … `STATIC_ROOT <https://docs.djangoproject.com/en/2.2/ref/settings/#std:setting-STATIC_ROOT>`__:
286 .. code-block:: python
292 $ mysql -u root -p
299 the statically-served files::
317 the ":ref:`toaster-manual/reference:Configuring Toaster`" section.
335 directory to be served up by the Apache web server as defined by
339 server. At this point, you can start up the normal Toaster Django
344 To start the default Toaster Django web server with the Toaster
345 database now in Mysql, use the standard start commands::
347 $ source oe-init-build-env
348 $ source toaster start
358 /etc/apache2/conf-available/toaster.conf
371 .. code-block:: apache
390 …emonProcess toaster_wsgi python-path=/var/www/toaster/poky/bitbake/lib/toaster:/var/www/toaster/.l…
416 .. code-block:: ini
423 …ExecStart=/usr/bin/screen -d -m -S runbuilds /var/www/toaster/poky/bitbake/lib/toaster/runbuilds-s…
424 ExecStop=/usr/bin/screen -S runbuilds -X quit
428 WantedBy=multi-user.target
431 Prepare the ``runbuilds-service.sh`` script that you need to place in the
433 up executable permissions::
441 source ./oe-init-build-env build
443 [ "$1" == 'start' ] && /bin/bash
447 $ sudo service runbuilds start
452 $ sudo su - toaster
453 $ screen -rS runbuilds
455 You can detach from the service again using "Ctrl-a" followed by "d" key
458 You can now open up a browser and start using Toaster.
465 - Browse published layers in the :oe_layerindex:`OpenEmbedded Layer Index <>`
468 - Import your own layers for building.
470 - Add and remove layers from your configuration.
472 - Set configuration variables.
474 - Select a target or multiple targets to build.
476 - Start your builds.
478 - See what was built (recipes and packages) and what packages were
481 - Browse the directory structure of your image.
483 - See the value of all variables in your build configuration, and which
486 - Examine error, warning and trace messages to aid in debugging.
488 - See information about the BitBake tasks executed and reused during
491 - See dependency relationships between recipes, packages and tasks.
493 - See performance information such as build time, task time, CPU usage,
497 ----------------------------
501 - *Build Configuration:* This
505 - *Build Custom Layers:* This
509 - *Toaster Homepage and Table Controls:* This
515 - *Build Dashboard:* This
520 - *Image Information:* This
525 - *Configuration:* This
526 `video <https://www.youtube.com/watch?v=UW-j-T2TzIg>`__ provides
529 - *Tasks:* This `video <https://www.youtube.com/watch?v=D4-9vGSxQtw>`__
533 - *Recipes and Packages Built:* This
534 `video <https://www.youtube.com/watch?v=x-6dx4huNnw>`__ shows the
537 - *Performance Data:* This
542 ------------------------------------------------------------
544 This section only applies if you have set up Toaster for local
546 ":ref:`toaster-manual/setup-and-use:starting toaster for local development`"
553 .. image:: figures/new-project.png
575 - :oe_layer:`openembedded-core </openembedded-core>`
577 - :oe_layer:`meta-poky </meta-poky>`
579 - :oe_layer:`meta-yocto-bsp </meta-yocto-bsp>`
581 .. image:: figures/compatible-layers.png
588 .. image:: figures/import-layer.png
593 --------------------------------------------------
596 recipe. For example, the ``openembedded-core`` layer provides two
597 versions of the ``bash`` recipe (i.e. 3.2.48 and 4.3.30-r0) and two
601 .. image:: figures/bash-oecore.png
606 For the ``bash`` case, version 4.3.30-r0 is built by default.
615 .. image:: figures/add-variable.png
623 .. image:: figures/set-variable.png
632 .. image:: figures/variable-added.png