diff options
Diffstat (limited to 'yocto-poky/documentation/toaster-manual/toaster-manual-reference.xml')
-rw-r--r-- | yocto-poky/documentation/toaster-manual/toaster-manual-reference.xml | 81 |
1 files changed, 28 insertions, 53 deletions
diff --git a/yocto-poky/documentation/toaster-manual/toaster-manual-reference.xml b/yocto-poky/documentation/toaster-manual/toaster-manual-reference.xml index faca4ca73..3a46b61b7 100644 --- a/yocto-poky/documentation/toaster-manual/toaster-manual-reference.xml +++ b/yocto-poky/documentation/toaster-manual/toaster-manual-reference.xml @@ -159,25 +159,24 @@ </para> <para> - When you set up Toaster in Build Mode, you are prompted - to select a Toaster configuration file. + The Toaster startup script in + <filename>/bitbake/bin/toaster</filename> specifies + the location of a Toaster configuration file + <filename>toasterconf.json</filename> as the value of + the <filename>TOASTER_CONF</filename> variable. This configuration file is used to set up the initial configuration values within the Toaster database including the layer sources. - Three versions of the configuration file exist: + Two versions of the configuration file exist: <itemizedlist> <listitem><para> The first version of the file is found in the <filename>conf</filename> directory of the - <filename>meta-yocto</filename> layer + <filename>meta-poky</filename> layer (i.e. - <filename>meta-yocto/conf/toasterconf.json</filename>). + <filename>meta-poky/conf/toasterconf.json</filename>). This version contains the default Yocto Project configuration for Toaster. - You are prompted to select this file during the - Toaster set up process if you had cloned the - <filename>poky</filename> repository (i.e. - <filename>git://git.yoctoproject.org/poky</filename>). </para></listitem> <listitem><para> The second version of the file is in the @@ -186,19 +185,6 @@ (i.e. <filename>meta/conf/toasterconf.json</filename>). This version contains the default OpenEmbedded configuration for Toaster. - You are prompted to select this file during the - Toaster set up process if you had cloned the - <filename>openembedded-core</filename> repository - (i.e. - <filename>git://git.openembedded.org/openembedded-core</filename>). - </para></listitem> - <listitem><para> - The third version is a sample configuration - useful for when you want to set up a hosted - service in Build Mode. - You can find this version on the - <ulink url='https://wiki.yoctoproject.org/wiki/File:Toasterconf.json.txt.patch'>File:Toasterconf.json.txt.patch</ulink> - wiki page. </para></listitem> </itemizedlist> </para> @@ -228,10 +214,10 @@ "dirpath": "meta" }, { - "name": "meta-yocto", - "local_path": "meta-yocto", + "name": "meta-poky", + "local_path": "meta-poky", "vcs_url": "remote:origin", - "dirpath": "meta-yocto" + "dirpath": "meta-poky" }, { "name": "meta-yocto-bsp", @@ -307,10 +293,10 @@ <filename>toasterconf.json</filename> file you just edited. For example, if you cloned the <filename>poky</filename> repository and you edited the - <filename>meta-yocto/conf/toasterconf.json</filename> file, + <filename>meta-poky/conf/toasterconf.json</filename> file, you would type something like the following: <literallayout class='monospaced'> - $ bitbake/lib/toaster/manage.py loadconf /home/scottrif/poky/meta-yocto/conf/toasterconf.json + $ bitbake/lib/toaster/manage.py loadconf /home/scottrif/poky/meta-poky/conf/toasterconf.json </literallayout> After entering this command, you need to update the Toaster database with the information coming from your @@ -550,8 +536,7 @@ <title>JSON Files</title> <para> - If you are going to be using Toaster in Build Mode, it must - be initially configured before use. + You must configure Toaster before using it. Configuration customizes layer source settings and Toaster defaults for all users and is performed by the person responsible for Toaster Configuration (i.e the Toaster Administrator). @@ -577,23 +562,22 @@ <filename>toasterconf.json</filename>. The Toaster Administrator can customize the file prior to loading it into Toaster. - When you set up Toaster locally to run in Build Mode, the system - startup script actively looks for compatible configuration files - and prompts you to select a file to load if it detects that the - database has not been configured. + The <filename>TOASTER_CONF</filename> variable in the + Toaster startup script at <filename>bitbake/bin/toaster</filename> + specifies the location of the <filename>toasterconf.json</filename> file. </para> <section id='json-file-choices'> <title>Configuration File Choices</title> <para> - Three versions of the configuration file exist: + Two versions of the configuration file exist: <itemizedlist> <listitem><para> The - <filename>meta-yocto/conf/toasterconf.json</filename> + <filename>meta-poky/conf/toasterconf.json</filename> in the <filename>conf</filename> directory of the - Yocto Project's <filename>meta-yocto</filename> layer. + Yocto Project's <filename>meta-poky</filename> layer. This version contains the default Yocto Project configuration for Toaster. You are prompted to select this file during the Toaster @@ -613,15 +597,6 @@ <filename>openembedded-core</filename> repository (i.e. <filename>git://git.openembedded.org/openembedded-core</filename>). </para></listitem> - <listitem><para> - The <filename>Toasterconf.json.txt.patch</filename> - located on the - <ulink url='https://wiki.yoctoproject.org/wiki/File:Toasterconf.json.txt.patch'>File:Toasterconf.json.txt.patch</ulink> - wiki page. - This version of the file is useful as a sample - configuration for when you want to set up Toaster as a - hosted service in Build Mode. - </para></listitem> </itemizedlist> </para> </section> @@ -723,10 +698,10 @@ "dirpath": "meta" }, { - "name": "meta-yocto", - "local_path": "meta-yocto", + "name": "meta-poky", + "local_path": "meta-poky", "vcs_url": "remote:origin", - "dirpath": "meta-yocto" + "dirpath": "meta-poky" }, { "name": "meta-yocto-bsp", @@ -842,7 +817,7 @@ "description": "Yocto Project master", "bitbake": "master", "branch": "master", - "defaultlayers": [ "openembedded-core", "meta-yocto", "meta-yocto-bsp"], + "defaultlayers": [ "openembedded-core", "meta-poky", "meta-yocto-bsp"], "layersourcepriority": { "Imported layers": 99, "Local Yocto Project" : 10, "OpenEmbedded" : 0 }, "helptext": "Toaster will run your builds using the tip of the <a href=\"http://git.yoctoproject.org/cgit/cgit.cgi/poky/log/\">Yocto Project master branch</a>, where active development takes place. This is not a stable branch, so your builds might not work as expected." }, @@ -851,7 +826,7 @@ "description": "Yocto Project 2.0 Jethro", "bitbake": "jethro", "branch": "jethro", - "defaultlayers": [ "openembedded-core", "meta-yocto", "meta-yocto-bsp"], + "defaultlayers": [ "openembedded-core", "meta-poky", "meta-yocto-bsp"], "layersourcepriority": { "Imported layers": 99, "Local Yocto Project" : 10, "OpenEmbedded" : 0 }, "helptext": "Toaster will run your builds with the tip of the <a href=\"http://git.yoctoproject.org/cgit/cgit.cgi/poky/log/?h=jethro\">Yocto Project 2.0 \"Jethro\"</a> branch." }, @@ -860,7 +835,7 @@ "description": "Yocto Project 1.8 Fido", "bitbake": "fido", "branch": "fido", - "defaultlayers": [ "openembedded-core", "meta-yocto", "meta-yocto-bsp"], + "defaultlayers": [ "openembedded-core", "meta-poky", "meta-yocto-bsp"], "layersourcepriority": { "Imported layers": 99, "Local Yocto Project" : 10, "OpenEmbedded" : 0 }, "helptext": "Toaster will run your builds with the tip of the <a href=\"http://git.yoctoproject.org/cgit/cgit.cgi/poky/log/?h=fido\">Yocto Project 1.8 \"Fido\"</a> branch." }, @@ -869,7 +844,7 @@ "description": "Local Yocto Project", "bitbake": "HEAD", "branch": "HEAD", - "defaultlayers": [ "openembedded-core", "meta-yocto", "meta-yocto-bsp"], + "defaultlayers": [ "openembedded-core", "meta-poky", "meta-yocto-bsp"], "layersourcepriority": { "Imported layers": 99, "Local Yocto Project" : 10, "OpenEmbedded" : 0 }, "helptext": "Toaster will run your builds with the version of the Yocto Project you have cloned or downloaded to your computer." } @@ -1008,7 +983,7 @@ <literallayout class='monospaced'> $ bitbake/lib/toaster/manage.py checksettings </literallayout> - In Build Mode, Toaster uses settings that are based on the + Toaster uses settings that are based on the database to configure the building tasks. The <filename>checksettings</filename> command verifies that the database settings are valid in the sense that they have |