Sugar on a Stick/Beta: Difference between revisions

Line 8:

* See [[Sugar on a Stick/Mirabelle]]

* [[0.88/Testing|Sugar 0.88 Testing]].

==SoaS installation on USB/SD devices==

~~===with Linux===~~

* Use this script file to create a bootable image, http://bit.ly/livecd-iso-to-disk.

~~:(Run {{Code|chmod +x livecd-iso-to-disk.sh}} after you download the script to make it executable.)~~

* The .iso file may be burnt to a CD-ROM and booted on your PC (or mounted in a virtual machine to boot it).

~~'''Note:'''~~

~~To install the .iso disc image, execute the shell script as the root user in one command with arguments as follows:~~

~~{{Code|./livecd-iso-to-disk --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /path/to/source.iso /dev/sd'''?'''1}}~~

~~: where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc.~~

:* ''Be certain of your USB/SD '''s'''torage '''d'''evice node name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,'' {{Code|/dev/sdb1}}. ''Use the mount command or the partition manager to confirm it before executing the script.''

~~<!-- let simplify the base instructions and leave this sort of information on a troubleshooting page.~~

:* <code>--format --reset-mbr</code> are optional arguments for the shell script, but may be excluded to preserve the existing disc format and data. See [[olpc:How to Damage a FLASH Storage Device]] for a discussion of why you might want to try to keep your factory format on a flash storage device.

~~:*: [[Talk:Downloads]] and [[LiveOS image]] have more information on this and other installation options.~~

:* If you do use the format and reset master boot record arguments, you'll want to specify the target device name and not a partition, that is {{Code|/dev/sd'''?'''}} with no partition number, instead of {{Code|/dev/sd'''?'''1}} as in the example above used to specify an existing partition. ''As noted above, confirm your target disc device name—in this case, it is VERY DANGEROUS to your other discs if this is entered wrong, as the whole disc will be reformatted and a new master boot record written causing all previously written data on that disc to be lost.'' -->

===with Microsoft Windows===

Line 52:

Line 36:

===with Apple Macintosh===

* See and adapt the instructions at [[Sugar on a Stick/Mac]].

===with GNU/Linux===

<li>Use this script file http://bit.ly/livecd-iso-to-disk to create a bootable image. (Run {{Code|chmod +x livecd-iso-to-disk.sh}} after you download the script to make it executable.)</li>

<li>Execute, as the root user, in one command with arguments, the following:

{{Code|./livecd-iso-to-disk.sh --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /path/to/source.iso /dev/sd'''?'''1}}

: where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc.

''Be certain of your USB/SD '''s'''torage '''d'''evice node name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.).

: Use the {{Code|df -Th}} command to confirm your devices before executing the script.

</li></ol>

{{Show|         You should see something like the following:

|<pre>

[root@MyComputer ~]# df -Th

Filesystem Type Size Used Avail Use% Mounted on

/dev/sda1 ext4 18G 6.6G 11G 38% /

tmpfs tmpfs 1.6G 740K 1.6G 1% /dev/shm

/dev/sdc1 vfat 15G 697M 15G 5% /media/SANDY

/dev/sdb1 vfat 15G 2.0G 13G 14% /media/TOSHIBA

</pre>

:: where the mount point and filesystem sizes should help you identify what you want.

<pre>

[root@MyComputer ~]#

./livecd-iso-to-disk.sh --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /mnt/VMs/soas-x86_64-20100509.09.iso /dev/sdb1

Verifying image...

/mnt/VMs/soas-x86_64-20100509.09.iso: 7c5f3227e4d87bb03f1cf89415ee80ce

Fragment sums: b68ffc49a1213bca823fd5f16887291c571b44d55755488b3c229dafb631

Fragment count: 20

Checking: 100.0%

The media check is complete, the result is: PASS.

It is OK to use this media.

Copying live image to USB stick

Updating boot config file

Initializing persistent overlay file

200+0 records in

200+0 records out

209715200 bytes (210 MB) copied, 16.6121 s, 12.6 MB/s

Initializing persistent /home

200+0 records in

200+0 records out

209715200 bytes (210 MB) copied, 15.2779 s, 13.7 MB/s

Formatting unencrypted /home

mke2fs 1.41.10 (10-Feb-2009)

Filesystem label=

OS type: Linux

Block size=1024 (log=0)

Fragment size=1024 (log=0)

Stride=0 blocks, Stripe width=0 blocks

51200 inodes, 204800 blocks

10240 blocks (5.00%) reserved for the super user

First data block=1

Maximum filesystem blocks=67371008

25 block groups

8192 blocks per group, 8192 fragments per group

2048 inodes per group

Superblock backups stored on blocks:

8193, 24577, 40961, 57345, 73729

Writing inode tables: done

Creating journal (4096 blocks): done

Writing superblocks and filesystem accounting information: done

This filesystem will be automatically checked every 23 mounts or

180 days, whichever comes first. Use tune2fs -c or -i to override.

tune2fs 1.41.10 (10-Feb-2009)

Setting maximal mount count to -1

Setting interval between checks to 0 seconds

Installing boot loader

USB stick set up as live image!

</pre>}}<!--

Let's simplify the base instructions and leave this sort of information on a troubleshooting page.

:* <code>--format --reset-mbr</code> are optional arguments for the shell script, but may be excluded to preserve the existing disc format and data. See [[olpc:How to Damage a FLASH Storage Device]] for a discussion of why you might want to try to keep your factory format on a flash storage device.

:*: [[Talk:Downloads]] and [[LiveOS image]] have more information on this and other installation options.

:* If you do use the format and reset master boot record arguments, you'll want to specify the target device name and not a partition, that is {{Code|/dev/sd'''?'''}} with no partition number, instead of {{Code|/dev/sd'''?'''1}} as in the example above used to specify an existing partition. ''As noted above, confirm your target disc device name—in this case, it is VERY DANGEROUS to your other discs if this is entered wrong, as the whole disc will be reformatted and a new master boot record written causing all previously written data on that disc to be lost.'' -->

==SoaS on VirtualBox==

{{Transclude|VirtualBox|note=   See instructions from the [[VirtualBox]] page (transcluded here): |collapsed=collapsed}}

@@ Line 8: / Line 8: @@
 * See [[Sugar on a Stick/Mirabelle]]
 * [[0.88/Testing|Sugar 0.88 Testing]].
 ==SoaS installation on USB/SD devices==
-===with Linux===
-* Use this script file to create a bootable image, http://bit.ly/livecd-iso-to-disk.
-:(Run {{Code|chmod +x livecd-iso-to-disk.sh}} after you download the script to make it executable.)
-* The .iso file may be burnt to a CD-ROM and booted on your PC (or mounted in a virtual machine to boot it).
-'''Note:'''
-To install the .iso disc image, execute the shell script as the root user in <u>one</u> command with arguments as follows:
-{{Code|./livecd-iso-to-disk --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /path/to/source.iso /dev/sd'''?'''1}}
-: where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc.
-:* ''Be certain of your USB/SD '''s'''torage '''d'''evice node name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,'' {{Code|/dev/sdb1}}. ''Use the mount command or the partition manager to confirm it before executing the script.''
-<!-- let simplify the base instructions and leave this sort of information on a troubleshooting page.
-:* <code>--format --reset-mbr</code> are optional arguments for the shell script, but may be excluded to preserve the existing disc format and data.  See [[olpc:How to Damage a FLASH Storage Device]] for a discussion of why you might want to try to keep your factory format on a flash storage device.
-:*: [[Talk:Downloads]] and [[LiveOS image]] have more information on this and other installation options.
-:* If you do use the format and reset master boot record arguments, you'll want to specify the target device name and not a partition, that is {{Code|/dev/sd'''?'''}} with no partition number, instead of {{Code|/dev/sd'''?'''1}} as in the example above used to specify an existing partition. ''As noted above, confirm your target disc device name&mdash;in this case, it is VERY DANGEROUS to your other discs if this is entered wrong, as the whole disc will be reformatted and a new master boot record written causing all previously written data on that disc to be lost.''  -->
 ===with Microsoft Windows===
@@ Line 52: / Line 36: @@
 ===with Apple Macintosh===
 * See and adapt the instructions at [[Sugar on a Stick/Mac]].
+===with GNU/Linux===
+<ol start="0">
+<li>Use this script file http://bit.ly/livecd-iso-to-disk to create a bootable image.<br>(Run {{Code|chmod +x livecd-iso-to-disk.sh}} after you download the script to make it executable.)</li>
+<li>Execute, as the root user, in <u>one</u> command with arguments, the following:<br>
+{{Code|./livecd-iso-to-disk.sh --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /path/to/source.iso /dev/sd'''?'''1}}<br>
+: where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc.<br>
+''Be certain of your USB/SD '''s'''torage '''d'''evice node name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.).<br>
+: Use the {{Code|df -Th}} command to confirm your devices before executing the script.
+</li></ol>
+{{Show|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;You should see something like the following:
+|<pre>
+[root@MyComputer ~]# df -Th
+Filesystem    Type    Size  Used Avail Use% Mounted on
+/dev/sda1     ext4     18G  6.6G   11G  38% /
+tmpfs        tmpfs    1.6G  740K  1.6G   1% /dev/shm
+/dev/sdc1     vfat     15G  697M   15G   5% /media/SANDY
+/dev/sdb1     vfat     15G  2.0G   13G  14% /media/TOSHIBA
+</pre>
+:: where the mount point and filesystem sizes should help you identify what you want.
+<pre>
+[root@MyComputer ~]#
+./livecd-iso-to-disk.sh --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /mnt/VMs/soas-x86_64-20100509.09.iso /dev/sdb1
+Verifying image...
+/mnt/VMs/soas-x86_64-20100509.09.iso:   7c5f3227e4d87bb03f1cf89415ee80ce
+Fragment sums: b68ffc49a1213bca823fd5f16887291c571b44d55755488b3c229dafb631
+Fragment count: 20
+Checking: 100.0%
+The media check is complete, the result is: PASS.
+It is OK to use this media.
+Copying live image to USB stick
+Updating boot config file
+Initializing persistent overlay file
++0 records in
++0 records out
+209715200 bytes (210 MB) copied, 16.6121 s, 12.6 MB/s
+Initializing persistent /home
++0 records in
++0 records out
+209715200 bytes (210 MB) copied, 15.2779 s, 13.7 MB/s
+Formatting unencrypted /home
+mke2fs 1.41.10 (10-Feb-2009)
+Filesystem label=
+OS type: Linux
+Block size=1024 (log=0)
+Fragment size=1024 (log=0)
+Stride=0 blocks, Stripe width=0 blocks
+inodes, 204800 blocks
+blocks (5.00%) reserved for the super user
+First data block=1
+Maximum filesystem blocks=67371008
+block groups
+blocks per group, 8192 fragments per group
+inodes per group
+Superblock backups stored on blocks:
+, 24577, 40961, 57345, 73729
+Writing inode tables: done
+Creating journal (4096 blocks): done
+Writing superblocks and filesystem accounting information: done
+This filesystem will be automatically checked every 23 mounts or
+days, whichever comes first.  Use tune2fs -c or -i to override.
+tune2fs 1.41.10 (10-Feb-2009)
+Setting maximal mount count to -1
+Setting interval between checks to 0 seconds
+Installing boot loader
+USB stick set up as live image!
+</pre>}}<!--
+Let's simplify the base instructions and leave this sort of information on a troubleshooting page.
+:* <code>--format --reset-mbr</code> are optional arguments for the shell script, but may be excluded to preserve the existing disc format and data.  See [[olpc:How to Damage a FLASH Storage Device]] for a discussion of why you might want to try to keep your factory format on a flash storage device.
+:*: [[Talk:Downloads]] and [[LiveOS image]] have more information on this and other installation options.
+:* If you do use the format and reset master boot record arguments, you'll want to specify the target device name and not a partition, that is {{Code|/dev/sd'''?'''}} with no partition number, instead of {{Code|/dev/sd'''?'''1}} as in the example above used to specify an existing partition. ''As noted above, confirm your target disc device name&mdash;in this case, it is VERY DANGEROUS to your other discs if this is entered wrong, as the whole disc will be reformatted and a new master boot record written causing all previously written data on that disc to be lost.''  -->
 ==SoaS on VirtualBox==
 {{Transclude|VirtualBox|note=&nbsp;&nbsp;&nbsp;See instructions from the [[VirtualBox]] page (transcluded here): |collapsed=collapsed}}