summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2016-01-25 07:25:49 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2016-02-04 23:22:30 +0000
commita23d2625e20b25b9ae102b6cb78641bff07ce934 (patch)
treea20ad2721177e1b2259110f39cf7f5f2318dbb27 /documentation
parentb6def81ff5ffb21fc999a340cb4edfd967c8a390 (diff)
downloadpoky-a23d2625e20b25b9ae102b6cb78641bff07ce934.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: 609e7bd8847cba70e49f4c8a58524392fdc1bd41) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-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 74c00c498c..356b7fbf9c 100644
--- a/documentation/toaster-manual/toaster-manual-setup-and-use.xml
+++ b/documentation/toaster-manual/toaster-manual-setup-and-use.xml
@@ -318,6 +318,7 @@
318 'PASSWORD': 'yourpasswordhere', 318 'PASSWORD': 'yourpasswordhere',
319 'HOST': 'localhost', 319 'HOST': 'localhost',
320 'PORT': '3306', 320 'PORT': '3306',
321 }
321 } 322 }
322 </literallayout> 323 </literallayout>
323 </para></listitem> 324 </para></listitem>
@@ -347,7 +348,7 @@
347 server defined earlier: 348 server defined earlier:
348 <literallayout class='monospaced'> 349 <literallayout class='monospaced'>
349 $ mysql -u root -p 350 $ mysql -u root -p
350 mysql> CREATE DATABASE toaster; 351 mysql> CREATE DATABASE toaster_data;
351 mysql> CREATE USER 'toaster'@'localhost' identified by 'yourpasswordhere'; 352 mysql> CREATE USER 'toaster'@'localhost' identified by 'yourpasswordhere';
352 mysql> GRANT all on toaster_data.* to 'toaster'@'localhost'; 353 mysql> GRANT all on toaster_data.* to 'toaster'@'localhost';
353 mysql> quit 354 mysql> quit
@@ -358,9 +359,9 @@
358 default data, and gather the statically-served files: 359 default data, and gather the statically-served files:
359 <literallayout class='monospaced'> 360 <literallayout class='monospaced'>
360 $ cd /var/www/toaster/poky/ 361 $ cd /var/www/toaster/poky/
361 $ ./bitbake/lib/toaster/manage.py syncdb --migrate 362 $ ./bitbake/lib/toaster/manage.py syncdb
362 $ ./bitbake/lib/toaster/manage.py loadconf ./meta-yocto/conf/toasterconf.json 363 $ ./bitbake/lib/toaster/manage.py migrate
363 $ ./bitbake/lib/toaster/manage.py lsupdates 364 $ TOASTER_DIR=`pwd` TOASTER_CONF=./meta-yocto/conf/toasterconf.json ./bitbake/lib/toaster/manage.py checksettings
364 $ ./bitbake/lib/toaster/manage.py collectstatic 365 $ ./bitbake/lib/toaster/manage.py collectstatic
365 </literallayout> 366 </literallayout>
366 </para> 367 </para>
@@ -368,33 +369,20 @@
368 <para> 369 <para>
369 For the above set of commands, after moving to the 370 For the above set of commands, after moving to the
370 <filename>poky</filename> directory, 371 <filename>poky</filename> directory,
371 the <filename>syncdb</filename> command with the 372 the <filename>syncdb</filename> and <filename>migrate</filename>
372 <filename>migrate</filename> option makes sure the database 373 commands ensure the database
373 schema has had changes propagated correctly (i.e. 374 schema has had changes propagated correctly (i.e.
374 migrations). 375 migrations).
375 See the
376 <ulink url='https://south.readthedocs.org/en/latest/commands.html#syncdb'><filename>syncdb</filename></ulink>
377 command for more information.
378 </para> 376 </para>
379 377
380 <para> 378 <para>
381 The 379 The next line sets the Toaster root directory
382 <link linkend='toaster-command-loadconf'><filename>loadconf</filename></link> 380 <filename>TOASTER_DIR</filename>, and the location of
383 command loads the 381 the Toaster configuration file <filename>TOASTER_CONF</filename>,
384 <filename>./meta-yocto/conf/toasterconf.json</filename> 382 relative to the root directory. For more information on the
385 JSON file. 383 Toaster configuration file see the
386 </para> 384 "<link linkend='toaster-json-files'>JSON Files</link>"
387 385 section of this manual.
388 <para>
389 The <filename>lsupdates</filename> command fetches
390 information about machines, recipes and
391 layers available as part of OpenEmbedded.
392 The information is fetched from the
393 <ulink url='http://layers.openembedded.org/'>OpenEmbedded Metadata Index</ulink>.
394 This information provides easy access to metadata
395 from Toaster, and it is key for Toaster's usability.
396 It is not recommended that you use Toaster without
397 fetching this information."
398 </para> 386 </para>
399 387
400 <para> 388 <para>
@@ -402,8 +390,6 @@
402 is a Django framework command that collects all the 390 is a Django framework command that collects all the
403 statically served files into a designated directory to 391 statically served files into a designated directory to
404 be served up by the Apache web server. 392 be served up by the Apache web server.
405 For more information on this Django command, see
406 <ulink url='https://docs.djangoproject.com/en/1.7/ref/contrib/staticfiles/'></ulink>.
407 </para></listitem> 393 </para></listitem>
408 <listitem><para> 394 <listitem><para>
409 Add an Apache configuration file for Toaster to your Apache web 395 Add an Apache configuration file for Toaster to your Apache web
@@ -438,6 +424,7 @@
438 <literallayout class='monospaced'> 424 <literallayout class='monospaced'>
439 $ sudo a2enmod wsgi 425 $ sudo a2enmod wsgi
440 $ sudo a2enconf toaster 426 $ sudo a2enconf toaster
427 $ chmod +x bitbake/lib/toaster/toastermain/wsgi.py
441 </literallayout> 428 </literallayout>
442 Finally, restart Apache to make sure all new configuration 429 Finally, restart Apache to make sure all new configuration
443 is loaded. 430 is loaded.