summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2018-04-30 09:37:14 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2018-05-24 17:16:29 +0100
commit8a29ca5d51a647edc59d8b55ae592ee1eac74630 (patch)
tree106c48b5d1243bb5835a3c830e53d416cb69ffcc /documentation
parent588e353a1ef5d600dbaa754d182e75fed9d10512 (diff)
downloadpoky-8a29ca5d51a647edc59d8b55ae592ee1eac74630.tar.gz
toaster-manual: Updated bad links and added two sections
The links to the DATABASES, SECRET_KEY, and STATIC_ROOT were bad. They were pointing to old dated software. I updated the links. Also, added a couple new sections. One is how to start a Toaster environment without its web server. The other is how to start a Toaster environment without a build server. (From yocto-docs rev: afe2708014600c0a86c649f6533dd1f6317fe742) 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.xml60
1 files changed, 57 insertions, 3 deletions
diff --git a/documentation/toaster-manual/toaster-manual-setup-and-use.xml b/documentation/toaster-manual/toaster-manual-setup-and-use.xml
index 68cfd5ee10..25762a603a 100644
--- a/documentation/toaster-manual/toaster-manual-setup-and-use.xml
+++ b/documentation/toaster-manual/toaster-manual-setup-and-use.xml
@@ -61,6 +61,60 @@
61 </para> 61 </para>
62 </section> 62 </section>
63 63
64 <section id='setting-up-toaster-without-a-web-server'>
65 <title>Setting Up Toaster Without a Web Server</title>
66
67 <para>
68 You can start a Toaster environment without starting its
69 web server. This is useful for the following:
70 <itemizedlist>
71 <listitem><para>
72 Capturing a command-line build’s statistics into
73 the Toaster database for examination later.
74 </para></listitem>
75 <listitem><para>
76 Capturing a command-line build’s statistics when
77 the Toaster server is already running.
78 </para></listitem>
79 </itemizedlist>
80 The following commands show how to start a Toaster environment
81 without starting its web server, perform BitBake operations,
82 and then shut down the Toaster environment.
83 Once the environment is shut down, you can examine the
84 BitBake build statistics:
85 <literallayout class='monospaced'>
86 $ source toaster start noweb
87 $ bitbake <replaceable>target</replaceable>
88 $ source toaster stop
89 </literallayout>
90 </para>
91 </section>
92
93 <section id='setting-up-toaster-without-a-build-server'>
94 <title>Setting Up Toaster Without a Build Server</title>
95
96 <para>
97 You can start a Toaster environment with the
98 “New Projects” feature disabled.
99 Doing so is useful for the following:
100 <itemizedlist>
101 <listitem><para>
102 Sharing your build results over the web server while
103 blocking others from starting builds on your host.
104 </para></listitem>
105 <listitem><para>
106 Allowing only local command-line builds to be captured
107 into the Toaster database.
108 </para></listitem>
109 </itemizedlist>
110 Use the following command to set up Toaster without a
111 build server:
112 <literallayout class='monospaced'>
113 $ source toaster start nobuild webport=<replaceable>port</replaceable>
114 </literallayout>
115 </para>
116 </section>
117
64 <section id='setting-up-external-access'> 118 <section id='setting-up-external-access'>
65 <title>Setting up External Access</title> 119 <title>Setting up External Access</title>
66 120
@@ -312,7 +366,7 @@
312 <itemizedlist> 366 <itemizedlist>
313 <listitem><para> 367 <listitem><para>
314 Edit the 368 Edit the
315 <ulink url='http://docs.djangoproject.com/en/1.8/ref/settings/#std:setting-SECRET_KEY'>DATABASE</ulink> 369 <ulink url='https://docs.djangoproject.com/en/1.11/ref/settings/#databases'>DATABASES</ulink>
316 settings: 370 settings:
317 <literallayout class='monospaced'> 371 <literallayout class='monospaced'>
318 DATABASES = { 372 DATABASES = {
@@ -329,14 +383,14 @@
329 </para></listitem> 383 </para></listitem>
330 <listitem><para> 384 <listitem><para>
331 Edit the 385 Edit the
332 <ulink url='http://docs.djangoproject.com/en/1.8/ref/settings/#std:setting-SECRET_KEY'>SECRET_KEY</ulink>: 386 <ulink url='https://docs.djangoproject.com/en/1.11/ref/settings/#std:setting-SECRET_KEY'>SECRET_KEY</ulink>:
333 <literallayout class='monospaced'> 387 <literallayout class='monospaced'>
334 SECRET_KEY = '<replaceable>your_secret_key</replaceable>' 388 SECRET_KEY = '<replaceable>your_secret_key</replaceable>'
335 </literallayout> 389 </literallayout>
336 </para></listitem> 390 </para></listitem>
337 <listitem><para> 391 <listitem><para>
338 Edit the 392 Edit the
339 <ulink url='http://docs.djangoproject.com/en/1.8/ref/settings/#std:setting-SECRET_KEY'>STATIC_ROOT</ulink>: 393 <ulink url='https://docs.djangoproject.com/en/1.11/ref/settings/#std:setting-STATIC_ROOT'>STATIC_ROOT</ulink>:
340 <literallayout class='monospaced'> 394 <literallayout class='monospaced'>
341 STATIC_ROOT = '/var/www/toaster/static_files/' 395 STATIC_ROOT = '/var/www/toaster/static_files/'
342 </literallayout> 396 </literallayout>