blob: 93f48c7b265f4a0f3fa9f6c6d0189f0a60ac011b (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
<!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.
Toaster requires some packages that you must have installed before trying
to run Toaster.
</para>
<section id='toaster-setting-up-the-basic-system-requirements'>
<title>Setting Up the Basic System Requirements</title>
<para>
You first need to be sure your build system is set up to run
the Yocto Project.
See the
"<ulink url='&YOCTO_DOCS_QS_URL;#yp-resources'>What You Need and How You Get It</ulink>"
section in the Yocto Project Quick Start for information on how
to set up your system for the Yocto Project.
</para>
</section>
<section id='toaster-establishing-toaster-system-dependencies'>
<title>Establishing Toaster System Dependencies</title>
<para>
Toaster requires extra Python dependencies that Bitbake
does not need in order to run.
In order to make it easy to run Toaster, a requirements file
located in the root directory of
<ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>
<filename>bitbake/</filename>
(e.g. <filename>poky/bitbake/toaster-requirements.txt</filename>).
The dependencies appear in a <filename>pip</filename>,
install-compatible format:
<literallayout class='monospaced'>
Django==1.6
South==0.8.4
argparse==1.2.1
wsgiref==0.1.2
</literallayout>
Follow these steps to get set up:
<orderedlist>
<listitem><para><emphasis>Create and activate a virtual environment:</emphasis>
<literallayout class='monospaced'>
$ virtualenv venv
$ source venv/bin/activate
</literallayout>
</para></listitem>
<listitem><para><emphasis>Use <filename>pip</filename> to install needed packages:</emphasis>
<literallayout class='monospaced'>
$ pip install -r bitbake/toaster-requirements.txt
</literallayout>
</para></listitem>
</orderedlist>
Once you complete these steps, you execute in a lightweight
"virtual environment” with its own site directories that are
optionally isolated from system site directories.
The virtual environment has its own Python binary
(allowing creation of environments with various Python versions)
and can have its own independent set of installed Python packages
in its site directories.
</para>
</section>
</chapter>
<!--
vim: expandtab tw=80 ts=4
-->
|
