summaryrefslogtreecommitdiffstats
path: root/documentation/toaster-manual
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2016-01-25 07:25:49 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2016-01-29 17:04:47 +0000
commit7705b87dc61494a0a983513d6186e4723b808d0a (patch)
tree9a8055f9f8f61a10795beb32eab6e16eecf69fd8 /documentation/toaster-manual
parent4b4a8a6c15961329293be1745978bc2fdbf1d583 (diff)
downloadpoky-7705b87dc61494a0a983513d6186e4723b808d0a.tar.gz
toaster-manual: Updated instructions for production setup.
Current instructions were wrong. Applied changes to correct them. Author: Belen Barros Pena <belen.barros.pena@intel.com> (From yocto-docs rev: edbcd9e2ef35772008107ff00ebb8e6bc71b1d50) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/toaster-manual')
-rw-r--r--documentation/toaster-manual/toaster-manual-setup-and-use.xml43
1 files changed, 15 insertions, 28 deletions
diff --git a/documentation/toaster-manual/toaster-manual-setup-and-use.xml b/documentation/toaster-manual/toaster-manual-setup-and-use.xml
index 6a69706df2..3ac1654cfa 100644
--- a/documentation/toaster-manual/toaster-manual-setup-and-use.xml
+++ b/documentation/toaster-manual/toaster-manual-setup-and-use.xml
@@ -276,6 +276,7 @@
276 'PASSWORD': 'yourpasswordhere', 276 'PASSWORD': 'yourpasswordhere',
277 'HOST': 'localhost', 277 'HOST': 'localhost',
278 'PORT': '3306', 278 'PORT': '3306',
279 }
279 } 280 }
280 </literallayout> 281 </literallayout>
281 </para></listitem> 282 </para></listitem>
@@ -298,7 +299,7 @@
298 server defined earlier: 299 server defined earlier:
299 <literallayout class='monospaced'> 300 <literallayout class='monospaced'>
300 $ mysql -u root -p 301 $ mysql -u root -p
301 mysql> CREATE DATABASE toaster; 302 mysql> CREATE DATABASE toaster_data;
302 mysql> CREATE USER 'toaster'@'localhost' identified by 'yourpasswordhere'; 303 mysql> CREATE USER 'toaster'@'localhost' identified by 'yourpasswordhere';
303 mysql> GRANT all on toaster_data.* to 'toaster'@'localhost'; 304 mysql> GRANT all on toaster_data.* to 'toaster'@'localhost';
304 mysql> quit 305 mysql> quit
@@ -309,9 +310,9 @@
309 default data, and gather the statically-served files: 310 default data, and gather the statically-served files:
310 <literallayout class='monospaced'> 311 <literallayout class='monospaced'>
311 $ cd /var/www/toaster/poky/ 312 $ cd /var/www/toaster/poky/
312 $ ./bitbake/lib/toaster/manage.py syncdb --migrate 313 $ ./bitbake/lib/toaster/manage.py syncdb
313 $ ./bitbake/lib/toaster/manage.py loadconf ./meta-yocto/conf/toasterconf.json 314 $ ./bitbake/lib/toaster/manage.py migrate
314 $ ./bitbake/lib/toaster/manage.py lsupdates 315 $ TOASTER_DIR=`pwd` TOASTER_CONF=./meta-yocto/conf/toasterconf.json ./bitbake/lib/toaster/manage.py checksettings
315 $ ./bitbake/lib/toaster/manage.py collectstatic 316 $ ./bitbake/lib/toaster/manage.py collectstatic
316 </literallayout> 317 </literallayout>
317 </para> 318 </para>
@@ -319,33 +320,20 @@
319 <para> 320 <para>
320 For the above set of commands, after moving to the 321 For the above set of commands, after moving to the
321 <filename>poky</filename> directory, 322 <filename>poky</filename> directory,
322 the <filename>syncdb</filename> command with the 323 the <filename>syncdb</filename> and <filename>migrate</filename>
323 <filename>migrate</filename> option makes sure the database 324 commands ensure the database
324 schema has had changes propagated correctly (i.e. 325 schema has had changes propagated correctly (i.e.
325 migrations). 326 migrations).
326 See the
327 <ulink url='https://south.readthedocs.org/en/latest/commands.html#syncdb'><filename>syncdb</filename></ulink>
328 command for more information.
329 </para> 327 </para>
330 328
331 <para> 329 <para>
332 The 330 The next line sets the Toaster root directory
333 <link linkend='toaster-command-loadconf'><filename>loadconf</filename></link> 331 <filename>TOASTER_DIR</filename>, and the location of
334 command loads the 332 the Toaster configuration file <filename>TOASTER_CONF</filename>,
335 <filename>./meta-yocto/conf/toasterconf.json</filename> 333 relative to the root directory. For more information on the
336 JSON file. 334 Toaster configuration file see the
337 </para> 335 "<link linkend='toaster-json-files'>JSON Files</link>"
338 336 section of this manual.
339 <para>
340 The <filename>lsupdates</filename> command fetches
341 information about machines, recipes and
342 layers available as part of OpenEmbedded.
343 The information is fetched from the
344 <ulink url='http://layers.openembedded.org/'>OpenEmbedded Metadata Index</ulink>.
345 This information provides easy access to metadata
346 from Toaster, and it is key for Toaster's usability.
347 It is not recommended that you use Toaster without
348 fetching this information."
349 </para> 337 </para>
350 338
351 <para> 339 <para>
@@ -353,8 +341,6 @@
353 is a Django framework command that collects all the 341 is a Django framework command that collects all the
354 statically served files into a designated directory to 342 statically served files into a designated directory to
355 be served up by the Apache web server. 343 be served up by the Apache web server.
356 For more information on this Django command, see
357 <ulink url='https://docs.djangoproject.com/en/1.7/ref/contrib/staticfiles/'></ulink>.
358 </para></listitem> 344 </para></listitem>
359 <listitem><para> 345 <listitem><para>
360 Add an Apache configuration file for Toaster to your Apache web 346 Add an Apache configuration file for Toaster to your Apache web
@@ -389,6 +375,7 @@
389 <literallayout class='monospaced'> 375 <literallayout class='monospaced'>
390 $ sudo a2enmod wsgi 376 $ sudo a2enmod wsgi
391 $ sudo a2enconf toaster 377 $ sudo a2enconf toaster
378 $ chmod +x bitbake/lib/toaster/toastermain/wsgi.py
392 </literallayout> 379 </literallayout>
393 Finally, restart Apache to make sure all new configuration 380 Finally, restart Apache to make sure all new configuration
394 is loaded. 381 is loaded.