diff options
Diffstat (limited to 'documentation/toaster-manual/toaster-manual-start.xml')
| -rw-r--r-- | documentation/toaster-manual/toaster-manual-start.xml | 116 |
1 files changed, 0 insertions, 116 deletions
diff --git a/documentation/toaster-manual/toaster-manual-start.xml b/documentation/toaster-manual/toaster-manual-start.xml deleted file mode 100644 index 8a857006e5..0000000000 --- a/documentation/toaster-manual/toaster-manual-start.xml +++ /dev/null | |||
| @@ -1,116 +0,0 @@ | |||
| 1 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | ||
| 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" | ||
| 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
| 4 | <!--SPDX-License-Identifier: CC-BY-2.0-UK--> | ||
| 5 | |||
| 6 | <chapter id='toaster-manual-start'> | ||
| 7 | |||
| 8 | <title>Preparing to Use Toaster</title> | ||
| 9 | |||
| 10 | <para> | ||
| 11 | This chapter describes how you need to prepare your system in order to | ||
| 12 | use Toaster. | ||
| 13 | </para> | ||
| 14 | |||
| 15 | <section id='toaster-setting-up-the-basic-system-requirements'> | ||
| 16 | <title>Setting Up the Basic System Requirements</title> | ||
| 17 | |||
| 18 | <para> | ||
| 19 | Before you can use Toaster, you need to first set up your | ||
| 20 | build system to run the Yocto Project. | ||
| 21 | To do this, follow the instructions in the | ||
| 22 | "<ulink url='&YOCTO_DOCS_DEV_URL;#dev-preparing-the-build-host'>Preparing the Build Host</ulink>" | ||
| 23 | section of the Yocto Project Development Tasks | ||
| 24 | Manual. | ||
| 25 | For Ubuntu/Debian, you might also need to do an additional install | ||
| 26 | of pip3. | ||
| 27 | <literallayout class='monospaced'> | ||
| 28 | $ sudo apt-get install python3-pip | ||
| 29 | </literallayout> | ||
| 30 | </para> | ||
| 31 | </section> | ||
| 32 | |||
| 33 | <section id='toaster-establishing-toaster-system-dependencies'> | ||
| 34 | <title>Establishing Toaster System Dependencies</title> | ||
| 35 | |||
| 36 | <para> | ||
| 37 | Toaster requires extra Python dependencies in order to run. | ||
| 38 | A Toaster requirements file named | ||
| 39 | <filename>toaster-requirements.txt</filename> defines the | ||
| 40 | Python dependencies. | ||
| 41 | The requirements file is located in the | ||
| 42 | <filename>bitbake</filename> directory, which is located in the | ||
| 43 | root directory of the | ||
| 44 | <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink> | ||
| 45 | (e.g. <filename>poky/bitbake/toaster-requirements.txt</filename>). | ||
| 46 | The dependencies appear in a <filename>pip</filename>, | ||
| 47 | install-compatible format. | ||
| 48 | </para> | ||
| 49 | |||
| 50 | <section id='toaster-load-packages'> | ||
| 51 | <title>Install Toaster Packages</title> | ||
| 52 | |||
| 53 | <para> | ||
| 54 | You need to install the packages that Toaster requires. | ||
| 55 | Use this command: | ||
| 56 | <literallayout class='monospaced'> | ||
| 57 | $ pip3 install --user -r bitbake/toaster-requirements.txt | ||
| 58 | </literallayout> | ||
| 59 | The previous command installs the necessary Toaster modules | ||
| 60 | into a local python 3 cache in your | ||
| 61 | <filename>$HOME</filename> directory. | ||
| 62 | The caches is actually located in | ||
| 63 | <filename>$HOME/.local</filename>. | ||
| 64 | To see what packages have been installed into your | ||
| 65 | <filename>$HOME</filename> directory, do the following: | ||
| 66 | <literallayout class='monospaced'> | ||
| 67 | $ pip3 list installed --local | ||
| 68 | </literallayout> | ||
| 69 | If you need to remove something, the following works: | ||
| 70 | <literallayout class='monospaced'> | ||
| 71 | $ pip3 uninstall PackageNameToUninstall | ||
| 72 | </literallayout> | ||
| 73 | </para> | ||
| 74 | </section> | ||
| 75 | |||
| 76 | <!-- Commenting this section out for now in case it needs to be used again. | ||
| 77 | |||
| 78 | <section id='toaster-install-daemon'> | ||
| 79 | <title>Install <filename>daemon</filename></title> | ||
| 80 | |||
| 81 | <para> | ||
| 82 | Toaster depends on | ||
| 83 | <ulink url='http://www.libslack.org/daemon/'><filename>daemon</filename></ulink>. | ||
| 84 | Depending on your distribution, how you install | ||
| 85 | <filename>daemon</filename> differs: | ||
| 86 | <itemizedlist> | ||
| 87 | <listitem><para><emphasis>Debian-Based Systems:</emphasis> | ||
| 88 | If you are running a Debian-based distribution, | ||
| 89 | install <filename>daemon</filename> using the | ||
| 90 | following command: | ||
| 91 | <literallayout class='monospaced'> | ||
| 92 | $ sudo apt-get install daemon | ||
| 93 | </literallayout> | ||
| 94 | </para></listitem> | ||
| 95 | <listitem><para><emphasis>Non-Debian-Based Systems:</emphasis> | ||
| 96 | If you are not running a Debian-based distribution | ||
| 97 | (Redhat-based distribution such as Fedora), | ||
| 98 | you need to download the file relevant to the | ||
| 99 | architecture and then install | ||
| 100 | <filename>daemon</filename> manually. | ||
| 101 | Following are the commands for 64-bit distributions: | ||
| 102 | <literallayout class='monospaced'> | ||
| 103 | $ wget http://libslack.org/daemon/download/daemon-0.6.4-1.x86_64.rpm | ||
| 104 | $ sudo rpm -i daemon-0.6.4-1.x86_64.rpm | ||
| 105 | </literallayout> | ||
| 106 | Here are the commands for a 32-bit distribution: | ||
| 107 | <literallayout class='monospaced'> | ||
| 108 | $ wget http://libslack.org/daemon/download/daemon-0.6.4-1.i686.rpm | ||
| 109 | $ sudo rpm -i daemon-0.6.4-1.i686.rpm | ||
| 110 | </literallayout> | ||
| 111 | </para></listitem> | ||
| 112 | </itemizedlist> | ||
| 113 | </para> | ||
| 114 | </section> --> | ||
| 115 | </section> | ||
| 116 | </chapter> | ||