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

View File

@ -144,7 +144,7 @@
</section>
<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>
If you do not want to use the Administration
@ -758,7 +758,7 @@
This area of the JSON file defines the version of
BitBake Toaster uses.
As shipped, Toaster is configured to recognize four
versions of BitBake: master, dizzy, and HEAD.
versions of BitBake: master, fido, dizzy, and HEAD.
<note>
HEAD is a special option that builds whatever is
available on disk, without checking out any remote

View File

@ -281,48 +281,35 @@
section.
</para></listitem>
<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
<filename>conf/toaster.conf</filename> file by doing
the following:
<note>
The following statements are automatically added
to the <filename>toaster.conf</filename> file
when Toaster starts through the
<filename>toaster start</filename> command.
</note>
<itemizedlist>
<listitem><para>
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:
You need to make sure that the
<ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-toaster'><filename>toaster</filename></ulink>
class and build history are enabled.
This is done in a
<filename>toaster.conf</filename> file that is
created automatically by the toaster
<filename>start</filename> command,
and that lives inside the
<ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>
in <filename>/conf/toaster.conf</filename>.</para>
<para>That file should include the following line:
<literallayout class='monospaced'>
export DATABASE_URL=mysql://<replaceable>newuser</replaceable>:<replaceable>password</replaceable>@192.168.0.25:3306/toaster
INHERIT += "toaster buildhistory"
</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>
<listitem><para><emphasis>Source your Build Environment Setup Script:</emphasis>
From your
@ -572,7 +559,7 @@
# Save your changes and exit
# 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
# set Name: master, Giturl git://git.openembedded.org/bitbake
# branch master, dirpath /
@ -816,8 +803,7 @@
<literallayout class='monospaced'>
http://localhost:8000/toastergui
</literallayout>
You can now use the Toaster web interface to do thing
such as track accesses and errors in the Apache
You can track accesses and errors in the Apache
service logs.
</para></listitem>
</orderedlist>
@ -885,7 +871,7 @@
<itemizedlist>
<listitem><para><emphasis>New Toaster Functionality:</emphasis>
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.
</para></listitem>
<listitem><para><emphasis>Toaster Homepage and Table Controls:</emphasis>
@ -911,8 +897,7 @@
<listitem><para><emphasis>Configuration:</emphasis>
This
<ulink url='https://www.youtube.com/watch?v=UW-j-T2TzIg'>video</ulink>
shows the information Toaster provides about build
configuration.
provides Toaster build configuration information.
</para></listitem>
<listitem><para><emphasis>Tasks:</emphasis>
This
@ -1019,7 +1004,7 @@
<videoobject>
<videodata width="640px" height="480px" fileref="http://www.youtube.com/v/x-6dx4huNnw"></videodata>
</videoobject>
</mediaobject>
</mediaobject>qYgDZ8YzV6w
</para>
</section>
<section id='toaster-gui-vids-7'>