1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
|
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
]>
<chapter id="chap-Creation_Kit-Preparation">
<title>Preparation</title>
<para>
This chapter will demonstrate the stages required to prepare Sugar on a Stick on different platforms and guide you through them step by step. Please pay close attention to the instructions to make sure no loss of data occurs.
</para>
<section id="sect-Creation_Kit-Preparation-System_Requirements">
<title>System Requirements</title>
<table id="tabl-Creation_Kit-Preparation-System_Requirements-Platforms">
<title>Platforms</title>
<tgroup cols="3">
<colspec colname="Platform" colnum="1" colwidth="2*"></colspec>
<colspec colname="Requirements" colnum="2" colwidth="4*"></colspec>
<colspec colname="Notes" colnum="3" colwidth="4*"></colspec>
<thead>
<row>
<entry> Platform </entry>
<entry> Requirements </entry>
<entry> Notes </entry>
</row>
</thead>
<tbody>
<row>
<entry> <simplelist> <member> Windows </member> </simplelist> </entry>
<entry>
<simplelist>
<member> Windows XP or higher </member>
<member> at least 2 GB of free hard disk space </member>
</simplelist>
</entry>
<entry> <simplelist> <member> older versions may be unsupported </member> </simplelist> </entry>
</row>
<row>
<entry> <simplelist> <member> Linux </member> </simplelist> </entry>
<entry>
<simplelist>
<member> Fedora 12 or higher </member>
<member> Ubuntu 8.04 or higher </member>
<member> at least 2 GB of free hard disk space </member>
</simplelist>
</entry>
<entry>
<simplelist>
<member> older versions may be unsupported </member>
<member> other distributions may be unsupported </member>
<member> the syslinux isomd5sum cryptsetup packages </member>
</simplelist>
</entry>
</row>
<row>
<entry> <simplelist> <member> Mac </member> </simplelist> </entry>
<entry>
<simplelist>
<member> Mac OS X 10.6 or higher </member>
<member> at least 2 GB of free hard disk space </member>
</simplelist>
</entry>
<entry>
<simplelist>
<member> older versions may be unsupported </member>
<member> a python 2.6 installation is required </member>
</simplelist>
</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
<section id="sect-Creation_Kit-Preparation-Windows_Instructions">
<title>Windows Instructions</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/liveusb-creator-win.png" format="PNG" width="240" />
</imageobject>
<textobject><phrase>Fedora LiveUSB Creator on Windows</phrase></textobject>
</mediaobject>
<para>
These instructions are intended for use with Windows XP or higher.
</para>
<itemizedlist>
<listitem>
<para>
Download the latest <application>Fedora LiveUSB Creator</application> from <ulink url="https://fedorahosted.org/liveusb-creator/">https://fedorahosted.org/liveusb-creator/</ulink> and install it.
</para>
</listitem>
<listitem>
<para>
Plug a blank target USB flash drive (or SD Card) into your computer (minimum 1-gigabyte).
</para>
</listitem>
<listitem>
<para>
Launch LiveUSB Creator.
</para>
</listitem>
<listitem>
<para>
Select <menuchoice><guimenuitem>Sugar on a Stick v3 Mirabelle</guimenuitem></menuchoice> in the drop-down menu on the upper-right side to download the liveUSB disk image. Alternatively, download Mirabelle <ulink url="http://download.sugarlabs.org/soas/releases/soas-3-mirabelle.iso">here</ulink>, then hit the Browse button and select the downloaded file.
</para>
</listitem>
<listitem>
<para>
Set the Persistent Storage slider to the maximum. This enables you to save the child's work in Sugar onto the device.
</para>
<blockquote>
<important>
<title>Important</title>
<para>
If you repeat this installation on a device after having saved some Sugar work or changes, all Sugar work and changes will be lost.
</para>
</important>
<para>
You may allocate as much storage as there is capacity on your device. You may allocate less than the maximum, if you want to use some of the device storage when not booting Sugar.
</para>
</blockquote>
</listitem>
<listitem>
<para>
Select your flash drive as the target and click the <guibutton>Create Live USB</guibutton> button.
</para>
</listitem>
<listitem>
<para>
Wait for the process to finish, then close the LiveUSB Creator program.
</para>
</listitem>
<listitem>
<para>
Stop your flash drive using the <guilabel>Safely Remove Hardware</guilabel> dialog and eject it.
</para>
</listitem>
</itemizedlist>
</section>
<section id="sect-Creation_Kit-Preparation-Linux_Instructions">
<title>Linux Instructions</title>
<para>
These instructions are intended for use with current Linux distributions. Supported examples include recent versions of Fedora, as well as of Ubuntu. Due to the numerous distributions out there, we cannot guarantee support for all of them, but are hoping to provide instructions for as many of them as possible and are looking forward to hearing your experiences with other distributions.
</para>
<section id="sect-Creation_Kit-Preparation-Linux_Instructions-Fedora">
<title>Fedora</title>
<itemizedlist>
<listitem>
<para>
Execute this command as root:<command><replaceable>yum install liveusb-creator</replaceable></command>
</para>
</listitem>
<listitem>
<para>
Plug a blank target USB flash drive (or SD Card) into your computer (minimum 1-gigabyte) and follow <xref linkend="sect-Creation_Kit-Preparation-Windows_Instructions" />.
</para>
</listitem>
</itemizedlist>
</section>
<section id="sect-Creation_Kit-Preparation-Linux_Instructions-Other">
<title>Other Distributions</title>
<para>
For a graphical way of putting SoaS on a USB stick, we recommend using <application>UNetbootin</application>. Since version 393, it is able to create Fedora Live USB sticks, the technology Sugar on a Stick is using. Please feel free
</para>
<itemizedlist>
<listitem>
<para>
Please check the <ulink url="http://unetbootin.sourceforge.net/">upstream website</ulink> for the latest version and use either the packages your distribution provides or the generic file.
</para>
</listitem>
<listitem>
<para>
Download the Sugar on a Stick image from <ulink url="http://download.sugarlabs.org/soas/releases/soas-3-mirabelle.iso">here</ulink>.
</para>
</listitem>
<listitem>
<para>
Open UNetbootin and plug a USB stick with a size of at least 1G in.
</para>
</listitem>
<listitem>
<para>
Click on <guibutton>Diskimage</guibutton> and select and open the .iso file you just downloaded for Sugar on a Stick above.
</para>
</listitem>
<listitem>
<para>
Select your USB device and click <guibutton>OK</guibutton> to proceed with the creation process. After a couple of minutes, your USB key should be ready.
</para>
</listitem>
</itemizedlist>
</section>
</section>
<section id="sect-Creation_Kit-Preparation-Mac_Instructions">
<title>Mac Instructions</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/image-writer-mac.png" format="PNG" width="240" />
</imageobject>
<textobject><phrase>Image Writer on Mac</phrase></textobject>
</mediaobject>
<para>
These instructions are intended for use with Mac OS X. This does, however, not guarantee that the resulting stick will work on a Mac, but possibly only on Linux or Windows machines. Hence, the Mac platform is not officially supported and instead marked as experimental.
</para>
<note>
<title>Note</title>
<para>
This way of preparing Sugar on a Stick does not create a persistant overlay. This means that you will not be able to keep the data you created in Sugar after reboot.
</para>
</note>
<itemizedlist>
<listitem>
<para>
Download the Sugar on a Stick image from <ulink url="http://download.sugarlabs.org/soas/releases/soas-3-mirabelle.iso">here</ulink>.
</para>
</listitem>
<listitem>
<para>
Download the image-writer tool for Macs from <ulink url="http://download.sugarlabs.org/soas/releases/image-writer-mac">here</ulink>.
</para>
</listitem>
<listitem>
<para>
Plug a blank target USB flash drive (or SD Card) into your computer (minimum 1-gigabyte).
</para>
</listitem>
<listitem>
<para>
Execute the following command in Terminal: <command>cd Downloads; python image-writer-mac soas-3-mirabelle.iso</command>
</para>
<warning>
<title>Warning</title>
<para>
If you proceed here, your flash drive will be wiped and you will lose all data on it.
</para>
</warning>
</listitem>
<listitem>
<para>
The script will output a device name; confirm that it matches with your flash drive.
</para>
</listitem>
</itemizedlist>
</section>
</chapter>
|
