Files
poky/documentation/toaster-manual/toaster-manual-start.xml
Scott Rifenbark f2242e613c documentation: Purged the YP Quick Start references from YP set
The original Yocto Project Quick Start is being retired for the
YP 2.5 release (sumo).  I have purged all the various references
from the YP manual set and replaced them with references to the
appropriate doc.  The references were mainly into the YP
dev-manual for setting up the host or for building an image.
There were a few references into the new "Yocto Project Quick
Build" document for overviewing manual-type references.

(From yocto-docs rev: 11c0ab693962f16f87f1e21f33dd5c6ca6a6f895)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24 17:16:07 +01:00

116 lines
5.1 KiB
XML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >
<chapter id='toaster-manual-start'>
<title>Preparing to Use Toaster</title>
<para>
This chapter describes how you need to prepare your system in order to
use Toaster.
</para>
<section id='toaster-setting-up-the-basic-system-requirements'>
<title>Setting Up the Basic System Requirements</title>
<para>
Before you can use Toaster, you need to first set up your
build system to run the Yocto Project.
To do this, follow the instructions in the
"<ulink url='&YOCTO_DOCS_DEV_URL;#setting-up-the-development-host-to-use-the-yocto-project'>Setting Up the Development Host to Use the Yocto Project</ulink>"
section of the Yocto Project Development Tasks
Manual.
For Ubuntu/Debian, you might also need to do an additional install
of pip3.
<literallayout class='monospaced'>
$ sudo apt-get install python3-pip
</literallayout>
</para>
</section>
<section id='toaster-establishing-toaster-system-dependencies'>
<title>Establishing Toaster System Dependencies</title>
<para>
Toaster requires extra Python dependencies in order to run.
A Toaster requirements file named
<filename>toaster-requirements.txt</filename> defines the
Python dependencies.
The requirements file is located in the
<filename>bitbake</filename> directory, which is located in the
root directory of the
<ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>
(e.g. <filename>poky/bitbake/toaster-requirements.txt</filename>).
The dependencies appear in a <filename>pip</filename>,
install-compatible format.
</para>
<section id='toaster-load-packages'>
<title>Install Toaster Packages</title>
<para>
You need to install the packages that Toaster requires.
Use this command:
<literallayout class='monospaced'>
$ pip3 install --user -r bitbake/toaster-requirements.txt
</literallayout>
The previous command installs the necessary Toaster modules
into a local python 3 cache in your
<filename>$HOME</filename> directory.
The caches is actually located in
<filename>$HOME/.local</filename>.
To see what packages have been installed into your
<filename>$HOME</filename> directory, do the following:
<literallayout class='monospaced'>
$ pip3 list installed --local
</literallayout>
If you need to remove something, the following works:
<literallayout class='monospaced'>
$ pip3 uninstall PackageNameToUninstall
</literallayout>
</para>
</section>
<!-- Commenting this section out for now in case it needs to be used again.
<section id='toaster-install-daemon'>
<title>Install <filename>daemon</filename></title>
<para>
Toaster depends on
<ulink url='http://www.libslack.org/daemon/'><filename>daemon</filename></ulink>.
Depending on your distribution, how you install
<filename>daemon</filename> differs:
<itemizedlist>
<listitem><para><emphasis>Debian-Based Systems:</emphasis>
If you are running a Debian-based distribution,
install <filename>daemon</filename> using the
following command:
<literallayout class='monospaced'>
$ sudo apt-get install daemon
</literallayout>
</para></listitem>
<listitem><para><emphasis>Non-Debian-Based Systems:</emphasis>
If you are not running a Debian-based distribution
(Redhat-based distribution such as Fedora),
you need to download the file relevant to the
architecture and then install
<filename>daemon</filename> manually.
Following are the commands for 64-bit distributions:
<literallayout class='monospaced'>
$ wget http://libslack.org/daemon/download/daemon-0.6.4-1.x86_64.rpm
$ sudo rpm -i daemon-0.6.4-1.x86_64.rpm
</literallayout>
Here are the commands for a 32-bit distribution:
<literallayout class='monospaced'>
$ wget http://libslack.org/daemon/download/daemon-0.6.4-1.i686.rpm
$ sudo rpm -i daemon-0.6.4-1.i686.rpm
</literallayout>
</para></listitem>
</itemizedlist>
</para>
</section> -->
</section>
</chapter>