sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

toaster-manual: Review edits applied. 

Some steps updated according to Belen and a video link fixed to
not point to Belen's Youtube area.

(From yocto-docs rev: 557c22fdd287160f6aabac0928ce6bd8d6af3394)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2015-04-02 09:30:41 -07:00 committed by Richard Purdie
parent 12f6c19d39
commit 51c68d742f
2 changed files with 34 additions and 49 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
documentation/toaster-manual/toaster-manual-reference.xml
View File

@ -144,7 +144,7 @@
</section> </section>
<section id='select-the-toasterconf-json-file'> <section id='select-the-toasterconf-json-file'>
<title>Select for Use the <filename>toasterconf.json</filename> File</title> <title>Use the <filename>toasterconf.json</filename> File</title>
<para> <para>
If you do not want to use the Administration If you do not want to use the Administration
@ -758,7 +758,7 @@
This area of the JSON file defines the version of This area of the JSON file defines the version of
BitBake Toaster uses. BitBake Toaster uses.
As shipped, Toaster is configured to recognize four As shipped, Toaster is configured to recognize four
versions of BitBake: master, dizzy, and HEAD. versions of BitBake: master, fido, dizzy, and HEAD.
<note> <note>
HEAD is a special option that builds whatever is HEAD is a special option that builds whatever is
available on disk, without checking out any remote available on disk, without checking out any remote

79
documentation/toaster-manual/toaster-manual-setup-and-use.xml
View File

@ -281,48 +281,35 @@
section. section.
</para></listitem> </para></listitem>
<listitem><para><emphasis>Enable Build Logging to the Common SQL Server for Each Build Directory you are Using:</emphasis> <listitem><para><emphasis>Enable Build Logging to the Common SQL Server for Each Build Directory you are Using:</emphasis>
In the Build Directory, create the required You need to make sure that the
<filename>conf/toaster.conf</filename> file by doing <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-toaster'><filename>toaster</filename></ulink>
the following: class and build history are enabled.
<note> This is done in a
The following statements are automatically added <filename>toaster.conf</filename> file that is
to the <filename>toaster.conf</filename> file created automatically by the toaster
when Toaster starts through the <filename>start</filename> command,
<filename>toaster start</filename> command. and that lives inside the
</note> <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>
<itemizedlist> in <filename>/conf/toaster.conf</filename>.</para>
<listitem><para> <para>That file should include the following line:
Be sure that Toaster inherits the
<ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-toaster'><filename>toaster</filename></ulink>
class and it is enabled in Bitbake in order to
record target image package information:
<literallayout class='monospaced'>
INHERIT += "toaster"
</literallayout>
</para></listitem>
<listitem><para>
Enable build history in BitBake.
Build history is needed to record target image
package information:
<literallayout class='monospaced'>
INHERIT += "buildhistory"
BUILDHISTORY_COMMIT = "1"
</literallayout>
This last command is not strictly needed.
However, without it build history will not
properly work.
For information on build history, see the
"<ulink url='&YOCTO_DOCS_REF_URL;#maintaining-build-output-quality'>Maintaining Build Output Quality</ulink>"
section in the Yocto Project Development
Manual.
</para></listitem>
</itemizedlist>
You also need to point to the database.
You can do this by exporting the
<filename>DATABASE_URL</filename> variable as follows:
<literallayout class='monospaced'> <literallayout class='monospaced'>
export DATABASE_URL=mysql://<replaceable>newuser</replaceable>:<replaceable>password</replaceable>@192.168.0.25:3306/toaster INHERIT += "toaster buildhistory"
</literallayout> </literallayout>
For information on build history, see the
"<ulink url='&YOCTO_DOCS_REF_URL;#maintaining-build-output-quality'>Maintaining Build Output Quality</ulink>"
section in the Yocto Project Development
Manual.</para>
<para>You also need to point to the database that you set
up in step 3.
You can do this by exporting the <filename>DATABASE_URL</filename>
variable as follows:
<literallayout class='monospaced'>
export DATABASE_URL=mysql://newuser:password@192.168.0.25:3306/toaster
</literallayout>
This example assumes that you are using
<filename>mysql-server</filename>.
The IP address should be the IP address of your
database server.
</para></listitem> </para></listitem>
<listitem><para><emphasis>Source your Build Environment Setup Script:</emphasis> <listitem><para><emphasis>Source your Build Environment Setup Script:</emphasis>
From your From your
@ -572,7 +559,7 @@
# Save your changes and exit # Save your changes and exit
# Go to Home, Bitbake Versions, Add bitbake version; # Go to Home, Bitbake Versions, Add bitbake version;
# take version infor from : http://git.openembedded.org/bitbake/refs/heads, # take version information from : http://git.openembedded.org/bitbake/refs/heads,
# this manual assumes the master version # this manual assumes the master version
# set Name: master, Giturl git://git.openembedded.org/bitbake # set Name: master, Giturl git://git.openembedded.org/bitbake
# branch master, dirpath / # branch master, dirpath /
@ -816,8 +803,7 @@
<literallayout class='monospaced'> <literallayout class='monospaced'>
http://localhost:8000/toastergui http://localhost:8000/toastergui
</literallayout> </literallayout>
You can now use the Toaster web interface to do thing You can track accesses and errors in the Apache
such as track accesses and errors in the Apache
service logs. service logs.
</para></listitem> </para></listitem>
</orderedlist> </orderedlist>
@ -885,7 +871,7 @@
<itemizedlist> <itemizedlist>
<listitem><para><emphasis>New Toaster Functionality:</emphasis> <listitem><para><emphasis>New Toaster Functionality:</emphasis>
This This
<ulink url='https://www.youtube.com/watch?v=f3gDg75FwFo'>video</ulink> <ulink url='https://www.youtube.com/watch?v=qYgDZ8YzV6w'>video</ulink>
introduces the new Toaster functionality for this release. introduces the new Toaster functionality for this release.
</para></listitem> </para></listitem>
<listitem><para><emphasis>Toaster Homepage and Table Controls:</emphasis> <listitem><para><emphasis>Toaster Homepage and Table Controls:</emphasis>
@ -911,8 +897,7 @@
<listitem><para><emphasis>Configuration:</emphasis> <listitem><para><emphasis>Configuration:</emphasis>
This This
<ulink url='https://www.youtube.com/watch?v=UW-j-T2TzIg'>video</ulink> <ulink url='https://www.youtube.com/watch?v=UW-j-T2TzIg'>video</ulink>
shows the information Toaster provides about build provides Toaster build configuration information.
configuration.
</para></listitem> </para></listitem>
<listitem><para><emphasis>Tasks:</emphasis> <listitem><para><emphasis>Tasks:</emphasis>
This This
@ -1019,7 +1004,7 @@
<videoobject> <videoobject>
<videodata width="640px" height="480px" fileref="http://www.youtube.com/v/x-6dx4huNnw"></videodata> <videodata width="640px" height="480px" fileref="http://www.youtube.com/v/x-6dx4huNnw"></videodata>
</videoobject> </videoobject>
</mediaobject> </mediaobject>qYgDZ8YzV6w
</para> </para>
</section> </section>
<section id='toaster-gui-vids-7'> <section id='toaster-gui-vids-7'>