Sugar Labs - User contributions [en]

Sugar on a Stick/ZyX-LiveInstaller

2009-12-09T06:15:44Z

Dmc: /* ZyX-LiveInstaller */

====ZyX-LiveInstaller====
* ZyX-LiveInstaller allows you to install SoaS when it is already running '''from''' either a LiveUSB device or LiveCD media '''to''' a system or external disk. This results in what is considered a traditional operating system installation on disk (or USB-Stick/SD-Card).

* note: this is *not* a method to create a SugarOnAStick (LiveUSB). Though you can install to an external usb drive/stick, resulting in an installation that very similarly boots your system to the Sugar UI. The difference is that the resulting system is not a 'Live' system. This means that it uses a normal filesystem, instead of a compressed read-only filesystem with a read-write snapshot/overlay above, as a 'LiveUSB' does.

* IMPORTANT WARNING: understand that this is a fairly new piece of open source software, that will overwrite entire partitions or disks ** as well as your bootloader ** during installation. In this release of SoaS, it is intended only for users that are familiar with the risks and possible complications of installing a Linux distribution to system disk. If you need a dual boot configuration, you will need to configure grub yourself (at least for the current version).

* To use
:* boot your SugarOnAStick
:* start the terminal activity, type in lowercase 'zyx-liveinstaller', then press enter.
:* start the partitioner 'gparted' if necessary
::* you will need at least a single partition for the root filesystem, that is greater than 2GB. Some disks labeled and sold as 2GB may not be quite large enough.
::* optionally create a seperate partition for the /boot filesystem, at least 42MB in size
::* optionally create a seperate partition for swap space, typically 1 or 2 times the size of ram in your system. This will allow the use of hibernation (suspend-to-disk, via pm-hibernate command run from root terminal shell).
::* note: formatting in the partitioner is not required.
::* exit the partitioner by hitting the X in the top corner of window.
:* read and follow the simple wizard, choosing destination volumes/partitions for root, boot, and swap.
* This is a *destructive* install, meaning that the contents of the disks or partitions you choose will be overwritten entirely.
* During installation, you are free to use other activities.
* After installation completes, you may remove the LiveUSB or LiveCD, and continue using the newly installed system - ''without rebooting''!!!. This means that anything done with the system before, during, or after installation persists into the installed system.
* For more information, see the upstream project website [http://filteredperception.org/smiley/projects/zyx-liveinstaller]

Sugar on a Stick/ZyX-LiveInstaller

2009-12-09T06:09:49Z

Dmc: /* ZyX-LiveInstaller */ cleanups, note I did just do a real no /boot test, and for me, it works

====ZyX-LiveInstaller====
* ZyX-LiveInstaller allows you to install SoaS when it is already running '''from''' either a LiveUSB device or LiveCD media '''to''' a system or external disk. This results in what is considered a traditional operating system installation on disk (or USB-Stick/SD-Card).

* note: this is *not* a method to create a SugarOnAStick (LiveUSB). Though you can install to an external usb drive/stick, resulting in an installation that very similarly boots your system to the Sugar UI. The difference is that the resulting system is not a 'Live' system. This means that it uses a normal filesystem, instead of a compressed read-only filesystem with a read-write snapshot/overlay above, as a 'LiveUSB' does.

* IMPORTANT WARNING: understand that this is a fairly new piece of open source software, that will overwrite entire partitions or disks ** as well as your bootloader ** during installation. In this release of SoaS, it is intended only for users that are familiar with the risks and possible complications of installing a Linux distribution to system disk.

* To use
:* boot your SugarOnAStick
:* start the terminal activity, type in lowercase 'zyx-liveinstaller', then press enter.
:* start the partitioner 'gparted' if necessary
::* you will need at least a single partition for the root filesystem, that is greater than 2GB. Some disks labeled and sold as 2GB may not be quite large enough.
::* optionally create a seperate partition for the /boot filesystem, at least 42MB in size
::* optionally create a seperate partition for swap space, typically 1 or 2 times the size of ram in your system. This will allow the use of hibernation (suspend-to-disk, via pm-hibernate command run from root terminal shell).
::* note: formatting in the partitioner is not required.
::* exit the partitioner by hitting the X in the top corner of window.
:* read and follow the simple wizard, choosing destination volumes/partitions for boot, root, and swap. ( swap is optional).
* This is a *destructive* install, meaning that the contents of the disks or partitions you choose will be overwritten entirely.
* During installation, you are free to use other activities.
* After installation completes, you may remove the LiveUSB or LiveCD, and continue using the newly installed system - ''without rebooting''!!!. This means that anything done with the system before, during, or after installation persists into the installed system.
* For more information, see the upstream project website [http://filteredperception.org/smiley/projects/zyx-liveinstaller]

SoaS Blueberry Instructions

2009-12-09T04:32:46Z

Dmc: /* For GNU/Linux Users */ extra the

__NOTOC__

=== For Windows Users ===

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"
|-
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]
|valign=top|
* Download the latest version of the '''Fedora LiveUSB Creator''' from http://fedorahosted.org/liveusb-creator and extract it.
* Plug a blank target USB flash drive (or SD Card) into your computer (minimum 1-gigabyte). '''WARNING:''' this procedure erases all data already on the flash drive! Copy any existing data elsewhere first.
* Launch LiveUSB Creator.
* Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. Alternatively, download Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here], then hit the Browse button and select the downloaded file.
* Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.
* Select your flash drive as the target and click the '''Create Live USB''' button.
* Wait for the process to finish, then close the LiveUSB Creator program.
* Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.
|}

=== For GNU/Linux Users ===

Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility
with different distributions. Please follow the instructions carefully to ensure your data is preserved.

If you are a '''Fedora User''', run the following command:

<code>''yum install liveusb-creator''</code>

Then [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso download the soas-2-blueberry.iso] and select it by using the "BROWSE" button.

* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].
If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].

'''Unfortunately, image-writer will not allow you to save your work; it does not create a persistent storage overlay'''
* Open a terminal and become root, either by using su or sudo.
* Enter the following command: ''./image-writer soas-2-blueberry.iso''
* '''WARNING:''' If you proceed here, your flash drive will be wiped!
* The script will output a device name; confirm that it matches with your flash drive.
* You will be notified once the process has finished.

For a '''persistent USB''' see this link:[http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions]

=== For Mac OS X Users ===

The procedure for Mac OS X users is similar to the one for Linux users. Verify that you have an Intel processor, and not a PowerPC (PPC) G3, G4, or G5 processor Apple Macintosh. Mac users should be aware that they may be able to prepare their flash drive on a Mac, but depending on the generation of the hardware used, they may need to use another computer to test whether the prepared flash drive works.

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"
|-
|valign=top|[[Image:image-writer-mac.png|left|300px]]
|valign=top|
* Download the '''Sugar on a Stick v2 Blueberry''' liveUSB image from here: http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso
* Download the '''image-writer''' tool for Macs from here: http://download.sugarlabs.org/soas/releases/image-writer-mac
* Insert a flash drive. '''WARNING:''' your flash drive will be wiped in the next step!
* Execute the following command in Terminal: ''cd Downloads; python image-writer-mac soas-2-blueberry.iso''
* Proceed as stated in the instructions for Linux Users.
|}
=== Helper CD ===
If your machine doesn't support booting from USB devices, then download the following soas-2-boot.iso and burn it to a CD.
* [http://www.imgburn.com/ ImgBurn] and [http://www.dvdflick.net/download.php DVD flick] are some freeware, .iso burning tools for Windows.

Download the boot support helper CD image at http://download.sugarlabs.org/soas/releases/soas-2-boot.iso.
# Use [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), otherwise it won't be recognized by the boot-support CD.
# Put both the boot-support CD and the USB flash drive in your computer and let it boot from the CD.

SoaS Blueberry Notes

2009-12-08T04:29:08Z

Dmc: /* ZyX-LiveInstaller */ one too many 'even's in too close proximity

__NOTOC__

'''Sugar on a Stick v2 Blueberry''' contains a number of new features that improve the overall user and learning experience. Here is an overview of the most notable ones:

=== Sugar 0.86 ===
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"
|-
|valign=top|[[Image:0.86_Browse_new_toolbar.png|left|300px]]
|valign=top|Sugar on a Stick v2 Blueberry ships the latest '''Sugar''' release, 0.86.3. It features:

* redesigned toolbars;
* improved wireless networking;
* EPUB file support for e-books ([http://activities.sugarlabs.org/en-US/sugar/addon/4028 Read]);
* better Gnash support for Adobe Flash content;
* easier keyboard configuration;
* support for tabbed browsing ([http://activities.sugarlabs.org/en-US/sugar/addon/4024 Browse]);
* and an easy way to update to the latest Activities (Control Panel).

Detailed release notes for Sugar 0.86 are available [[0.86/Notes|here]].
|}

=== ZyX-LiveInstaller ===

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"
|-
|valign=top|[[Image:zyx-liveinstaller.png|left|300px]]
|valign=top|A frequent request we received concerned a means of installing Sugar to a hard disk.
We teamed up with the '''zyx-liveinstaller''' developer in order to provide:

* seamless installation of your personalized environment onto your computer's hard disk;
* it saves any changes that you made to your Sugar on a Stick system;
* and the installation does not even require a reboot.
* [[Sugar_on_a_Stick/ZyX-LiveInstaller|Instructions]]
|}

=== E-Books ===

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"
|-
|valign=top|[[Image:read-alice.png|left|300px]]
|valign=top|Sugar on a Stick v2 Blueberry supports viewing e-books through '''Read''', including the increasingly popular .epub file format. Historical classicals and interesting literature for young readers are provided through an additional [[Sugar_on_a_Stick/E-Books|page]].
Thousands of additional e-books can even be easily accessed through the included '''Get Internet Archive Books''' Activity.
A [http://people.sugarlabs.org/sayamindu/shared_read.ogv screencast] of the e-book sharing process is also available.
|}

=== Activities ===

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"
|-
|valign=top|[[Image:social-calc-activity.png|left|300px]]
|valign=top|Sugar on a Stick v2 Blueberry also includes updates to the standard collection of Activities for children and many new ones. An example is '''SocialCalc''', a spreadsheet activity that allows users to do complex mathematical calculations. Sugar on a Stick v2 Blueberry also ships the '''TamTam''' activity suite, which takes the learner on a journey through sound and music, beginning with a simple musical toy and progressing up to a sophisticated sound synthesizer. Other activities, such as the very popular '''Physics''' and '''TurtleArt''', have been updated. Sugar's rich collection of Activities are available for download from [http://activities.sugarlabs.org Sugar's Activity Library].
|}

=== Based On Fedora ===

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"
|-
|valign=top|[[Image:Fedora_remix_logo.png|left]]
|valign=top|Sugar on a Stick v2 Blueberry is based on the latest version (F12) of the [http://fedoraproject.org/ Fedora operating system], a GNU/Linux distribution which showcases the latest in free and open source software.
|}

Sugar on a Stick/ZyX-LiveInstaller

2009-12-08T04:24:28Z

Dmc: /* ZyX-LiveInstaller */ clean up reference to prior page's context

====ZyX-LiveInstaller====
* ZyX-LiveInstaller allows you to install SoaS when it is already running '''from''' either a LiveUSB device or LiveCD media '''to''' a system or external disk. This results in what is considered a traditional operating system installation on disk (or USB-Stick/SD-Card).

* NOTE: this is NOT a method to create a SugarOnAStick (LiveUSB).

* IMPORTANT WARNING: understand that this is a fairly new piece of open source software, that will overwrite entire partitions or disks ** as well as your bootloader ** during installation. In this release of SoaS, it is intended only for users that are familiar with the risks and possible complications of installing a Linux distribution to system disk.

* To use
:* boot your SugarOnAStick
:* start the terminal activity, type in lowercase 'zyx-liveinstaller', then press enter.
:* start the partitioner 'gparted' if necessary
::* you will need at least a single partition for the root filesystem, that is greater than 2GB. Some disks labeled and sold as 2GB may not be quite large enough.
::* Create a seperate partition for the /boot filesystem
::* optionally, you may select a seperate partition for swap space. 1-2GB is recommended and will allow the use of hibernation (suspend-to-disk)
::* note: formatting in the partitioner is not required.
::* exit the partitioner by hitting the X in the top corner of window.
:* read and follow the simple wizard, choosing destination volumes/partitions for boot, root, and swap. ( swap is optional).
* This is a *destructive* install, meaning that the contents of the disks or partitions you choose will be overwritten entirely.
* During installation, you are free to use other activities.
* After installation completes, you may remove the LiveUSB or LiveCD, and continue using the newly installed system - ''without rebooting''!!!. This means that anything done with the system before, during, or after installation persists into the installed system.
* For more information, see the upstream project website [http://filteredperception.org/smiley/projects/zyx-liveinstaller]

Sugar on a Stick/ZyX-LiveInstaller

2009-12-08T04:20:17Z

Dmc: /* ZyX-LiveInstaller */ added link to upstream website

====ZyX-LiveInstaller====
* ZyX-LiveInstaller allows you to install SoaS when it is already running '''from''' either a LiveUSB device or LiveCD media '''to''' a system or external disk. This results in what is considered a traditional operating system installation on disk (or USB-Stick/SD-Card). This is unlike the above methods which create a Live Media (USB/SD) from the .iso file. Please note, this is NOT a method to create a SugarOnAStick LiveUSB. This is a method to

* To use
:* understand that this is a fairly new piece of open source software, that will overwrite entire partitions or disks ** as well as your bootloader ** during installation. In this release of SoaS, it is intended only for users that are familiar with the risks and possible complications of installing a Linux distribution to system disk.
:* boot your SugarOnAStick
:* start the terminal activity, type in lowercase 'zyx-liveinstaller', then press enter.
:* start the partitioner 'gparted' if necessary
::* you will need at least a single partition for the root filesystem, that is greater than 2GB. Some disks labeled and sold as 2GB may not be quite large enough.
::* Create a seperate partition for the /boot filesystem
::* optionally, you may select a seperate partition for swap space. 1-2GB is recommended and will allow the use of hibernation (suspend-to-disk)
::* note: formatting in the partitioner is not required.
::* exit the partitioner by hitting the X in the top corner of window.
:* read and follow the simple wizard, choosing destination volumes/partitions for boot, root, and swap. ( swap is optional).
* This is a *destructive* install, meaning that the contents of the disks or partitions you choose will be overwritten entirely.
* During installation, you are free to use other activities.
* After installation completes, you may remove the LiveUSB or LiveCD, and continue using the newly installed system - ''without rebooting''!!!. This means that anything done with the system before, during, or after installation persists into the installed system.
* For more information, see the upstream project website [http://filteredperception.org/smiley/projects/zyx-liveinstaller]

SoaS Blueberry Notes

2009-12-08T04:18:39Z

Dmc: /* ZYX-Liveinstaller */ moved contents of target link to a new page, updating reference

__NOTOC__

'''Sugar on a Stick v2 Blueberry''' contains a number of new features that improve the overall user and learning experience. Here is an overview of the most notable ones:

=== Sugar 0.86 ===
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"
|-
|valign=top|[[Image:0.86_Browse_new_toolbar.png|left|300px]]
|valign=top|Sugar on a Stick v2 Blueberry ships the latest '''Sugar''' release, 0.86.3. It features:

* redesigned toolbars;
* improved wireless networking;
* EPUB file support for e-books ([http://activities.sugarlabs.org/en-US/sugar/addon/4028 Read]);
* better Gnash support for Adobe Flash content;
* easier keyboard configuration;
* support for tabbed browsing ([http://activities.sugarlabs.org/en-US/sugar/addon/4024 Browse]);
* and an easy way to update to the latest Activities (Control Panel).

Detailed release notes for Sugar 0.86 are available [[0.86/Notes|here]].
|}

=== ZyX-LiveInstaller ===

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"
|-
|valign=top|[[Image:zyx-liveinstaller.png|left|300px]]
|valign=top|A frequent request we received concerned a means of installing Sugar to a hard disk.
We teamed up with the '''zyx-liveinstaller''' developer in order to provide:

* seamless installation of your personalized environment onto your computer's hard disk;
* it even saves any changes that you made to your Sugar on a Stick system;
* and the installation does not even require a reboot.
* [[Sugar_on_a_Stick/ZyX-LiveInstaller|Instructions]]
|}

=== E-Books ===

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"
|-
|valign=top|[[Image:read-alice.png|left|300px]]
|valign=top|Sugar on a Stick v2 Blueberry supports viewing e-books through '''Read''', including the increasingly popular .epub file format. Historical classicals and interesting literature for young readers are provided through an additional [[Sugar_on_a_Stick/E-Books|page]].
Thousands of additional e-books can even be easily accessed through the included '''Get Internet Archive Books''' Activity.
A [http://people.sugarlabs.org/sayamindu/shared_read.ogv screencast] of the e-book sharing process is also available.
|}

=== Activities ===

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"
|-
|valign=top|[[Image:social-calc-activity.png|left|300px]]
|valign=top|Sugar on a Stick v2 Blueberry also includes updates to the standard collection of Activities for children and many new ones. An example is '''SocialCalc''', a spreadsheet activity that allows users to do complex mathematical calculations. Sugar on a Stick v2 Blueberry also ships the '''TamTam''' activity suite, which takes the learner on a journey through sound and music, beginning with a simple musical toy and progressing up to a sophisticated sound synthesizer. Other activities, such as the very popular '''Physics''' and '''TurtleArt''', have been updated. Sugar's rich collection of Activities are available for download from [http://activities.sugarlabs.org Sugar's Activity Library].
|}

=== Based On Fedora ===

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"
|-
|valign=top|[[Image:Fedora_remix_logo.png|left]]
|valign=top|Sugar on a Stick v2 Blueberry is based on the latest version (F12) of the [http://fedoraproject.org/ Fedora operating system], a GNU/Linux distribution which showcases the latest in free and open source software.
|}

Sugar on a Stick/Beta

2009-12-08T04:12:16Z

Dmc: ZyX LiveInstaller under the same heading as hybrid mode usage, was entirely wrong and confusing. Now moved to its own page.

Sugar on a Stick/ZyX-LiveInstaller

2009-12-08T04:10:08Z

Dmc: better place than the soas05 page

====ZyX-LiveInstaller====
* ZyX-LiveInstaller allows you to install SoaS when it is already running '''from''' either a LiveUSB device or LiveCD media '''to''' a system or external disk. This results in what is considered a traditional operating system installation on disk (or USB-Stick/SD-Card). This is unlike the above methods which create a Live Media (USB/SD) from the .iso file. Please note, this is NOT a method to create a SugarOnAStick LiveUSB. This is a method to

* To use
:* understand that this is a fairly new piece of open source software, that will overwrite entire partitions or disks ** as well as your bootloader ** during installation. In this release of SoaS, it is intended only for users that are familiar with the risks and possible complications of installing a Linux distribution to system disk.
:* boot your SugarOnAStick
:* start the terminal activity, type in lowercase 'zyx-liveinstaller', then press enter.
:* start the partitioner 'gparted' if necessary
::* you will need at least a single partition for the root filesystem, that is greater than 2GB. Some disks labeled and sold as 2GB may not be quite large enough.
::* Create a seperate partition for the /boot filesystem
::* optionally, you may select a seperate partition for swap space. 1-2GB is recommended and will allow the use of hibernation (suspend-to-disk)
::* note: formatting in the partitioner is not required.
::* exit the partitioner by hitting the X in the top corner of window.
:* read and follow the simple wizard, choosing destination volumes/partitions for boot, root, and swap. ( swap is optional).
* This is a *destructive* install, meaning that the contents of the disks or partitions you choose will be overwritten entirely.
* During installation, you are free to use other activities.
* After installation completes, you may remove the LiveUSB or LiveCD, and continue using the newly installed system - ''without rebooting''!!!. This means that anything done with the system before, during, or after installation persists into the installed system.

Sugar on a Stick/Beta

2009-12-08T04:08:46Z

Dmc: /* ZyX-LiveInstaller */ add warnings, remove statements more likely to confuse than educate

{{TOCright}}
==Soas05 Beta==
*(Fedora 12 beta (rawhide)) See [[Talk:Sugar_on_a_Stick/Linux#SoaS_Fedora_matrix|Soas Fedora image matrix]].
===Download===

* Help save our bandwidth. Please download via BitTorrent, if possible.

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
|-style="background:#787878; color: white;"
| '''Tracker''' || '''Link'''
|-
| LegalTorrents.com || http://www.legaltorrents.com/torrents/847-sugar-on-a-stick-v2-beta-nov-11-2009-release
|}

Alternatively, you can download via http:
* ''Sugar on a Stick v2'' snapshots are available for download at [http://download.sugarlabs.org/soas/snapshots/2/?C=M;O=D http://download.sugarlabs.org/soas/snapshots/2/], latest test version, [http://download.sugarlabs.org/soas/snapshots/2/soas06.iso soas06.iso] (updated 24 Nov 2009).

===SoaS Installation on USB/SD===
* Use ONLY this script file to create a bootable image, http://bit.ly/livecd-iso-to-disk.
:(Don't forget to <code>chmod +x tools_livecd-iso-to-disk.sh</code> after you download the script.)
* 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:'''
* See this [http://www.mail-archive.com/soas@lists.sugarlabs.org/msg00436.html announcement] for more information.
* To install the .iso disc image, execute the shell script as the root user in <u>one</u> command with arguments as follows:
<div style="border:1px dashed #2f6fab; padding:8px; margin:8px; background-color:#f9f9f9"><code>sudo ./tools_livecd-iso-to-disk.sh --overlay-size-mb 400 --delete-home --extra-kernel-args selinux=0 ./soas06.iso /dev/sd*1</code></div>
:* (*) ''be sure of your USB/SD '''s'''torage '''d'''evice name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,'' <code>/dev/sdb1</code>. ''Use the mount command or the partition manager to confirm it before executing the script.''
:* <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.
:* 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*</code> with no partition number, instead of <code>/dev/sd*1</code> 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.''

====Alternate 'hybrid-mode' method using dd (works with soas-v2-blueberry.iso)====
An alternate method of creating a Live USB stick form of the .iso (a 'hybrid' image) to make a bootable USB/SD (NOT RECOMMENDED)

*If you use dd command to write a USB or SD image, there will be no persistence. The SCRIPT method detailed above should be used.

In Root Terminal:

dd if=soas-2-blueberry.iso of=/dev/sd(?) bs=4M

* Be sure your USB/SD is /dev/sd? check with partition manager to be sure.
CAUTION: ** You can destroy you Hard Disk if you enter it wrong! **

====ZyX-LiveInstaller====
* ZyX-LiveInstaller allows you to install SoaS when it is already running '''from''' either a LiveUSB device or LiveCD media '''to''' a system or external disk. This results in what is considered a traditional operating system installation on disk (or USB-Stick/SD-Card). This is unlike the above methods which create a Live Media (USB/SD) from the .iso file. Please note, this is NOT a method to create a SugarOnAStick LiveUSB. This is a method to

* To use
:* understand that this is a fairly new piece of open source software, that will overwrite entire partitions or disks ** as well as your bootloader ** during installation. In this release of SoaS, it is intended only for users that are familiar with the risks and possible complications of installing a Linux distribution to system disk.
:* boot your SugarOnAStick
:* start the terminal activity, type in lowercase 'zyx-liveinstaller', then press enter.
:* start the partitioner 'gparted' if necessary
::* you will need at least a single partition for the root filesystem, that is greater than 2GB. Some disks labeled and sold as 2GB may not be quite large enough.
::* Create a seperate partition for the /boot filesystem
::* optionally, you may select a seperate partition for swap space. 1-2GB is recommended and will allow the use of hibernation (suspend-to-disk)
::* note: formatting in the partitioner is not required.
::* exit the partitioner by hitting the X in the top corner of window.
:* read and follow the simple wizard, choosing destination volumes/partitions for boot, root, and swap. ( swap is optional).
* This is a *destructive* install, meaning that the contents of the disks or partitions you choose will be overwritten entirely.
* During installation, you are free to use other activities.
* After installation completes, you may remove the LiveUSB or LiveCD, and continue using the newly installed system - ''without rebooting''!!!. This means that anything done with the system before, during, or after installation persists into the installed system.

Sugar on a Stick/Beta

2009-11-08T21:22:45Z

Dmc: example link should be a note, not a subsection

{{TOCright}}
==Soas04 Beta==
*(Fedora 12 beta (rawhide)) See [[Talk:Sugar_on_a_Stick/Linux#SoaS_Fedora_matrix|Soas Fedora image matrix]].
===Download===

* ''Sugar on a Stick v2'' snapshots are available for download at http://download2.sugarlabs.org/soas/snapshots/2/, latest test version, [http://download2.sugarlabs.org/soas/snapshots/2/soas04.iso soas04.iso] (updated 30 Oct 2009).

===SoaS Installation on USB/SD===
* Use ONLY this script file to create a bootable image, http://bit.ly/livecd-iso-to-disk.
:(Don't forget to <code>chmod +x tools_livecd-iso-to-disk.sh</code> after you download the script.)
* 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:'''
* See this [http://www.mail-archive.com/soas@lists.sugarlabs.org/msg00335.html announcement] for more information.
* To install the .iso disc image, execute the shell script as the root user in <u>one</u> command with arguments as follows:
<div style="border:1px dashed #2f6fab; padding:8px; margin:8px; background-color:#f9f9f9"><code>sudo ./tools_livecd-iso-to-disk.sh --overlay-size-mb 400 --delete-home --extra-kernel-args selinux=0 ./soas04.iso /dev/sd*1</code></div>
:* (*) ''be sure of your USB/SD '''s'''torage '''d'''evice name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,'' <code>/dev/sdb1</code>. ''Use the mount command or the partition manager to confirm it before executing the script.''
:* <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.
:* 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*</code> with no partition number, instead of <code>/dev/sd*1</code> 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.''

====Alternate 'hybrid-mode' method using dd (not working at present)====
An alternate method of creating a LiveUSB stick form of the .iso (a 'hybrid' image) to make a bootable USB/SD (NOT RECOMMENDED)

*If you use dd command to write a USB or SD image, there will be no persistence. The SCRIPT method detailed above should be used.

In Root Terminal:

dd if=soas04.iso of=/dev/sd(?) bs=4M

* Be sure your USB/SD is /dev/sd? check with partition manager to be sure.
CAUTION: ** You can destroy you Hard Disk if you enter it wrong! **

====ZyX-LiveInstaller====
* ZyX-LiveInstaller allows you to install SoaS when it is already running '''from''' either a LiveUSB device or LiveCD media '''to''' a system or external disk. This results in what is considered a traditional operating system installation on disk (or USB-Stick/SD-Card). This is unlike the above methods which create a Live Media (USB/SD) from the .iso file.
* It is known to work best with the most recent snapshot build - soas04.iso.[http://download.sugarlabs.org/soas/snapshots/2/]

* To use
:* start the terminal activity, type in lowercase 'zyx-liveinstaller', then press enter.
:* start the partitioner 'gparted' if necessary
::* you will need at least a single partition for the root filesystem, that is greater than 2GB. Some disks labeled and sold as 2GB may not be quite large enough.
::* optionally, you may use a seperate partition for the /boot filesystem
::* optionally, you may select a seperate partition for swap space. 1-2GB is recommended and will allow the use of hibernation (suspend-to-disk)
::* note: formatting in the partitioner is not required.
::* exit the partitioner by hitting the X in the top corner of window.
:* read and follow the simple wizard, choosing destination volumes/partitions for boot, root, and swap. boot may be the same as root, and swap is optional.
* This is a *destructive* install, meaning that the contents of the disks or partitions you choose will be overwritten entirely.
* During installation, you are free to use other activities.
* After installation completes, you may remove the LiveUSB or LiveCD, and continue using the newly installed system - ''without rebooting''!!!. This means that anything done with the system before, during, or after installation persists into the installed system.
* An example with details of install in a virtual machine[http://wiki.sugarlabs.org/go/VMware#Soas04.iso_Install_using_zyx-liveinstaller]

Sugar on a Stick/Beta

2009-11-04T00:03:49Z

Dmc: /* ZyX-LiveInstaller */

{{TOCright}}
==Soas04 Beta==
*(Fedora 12 beta (rawhide)) See [[Talk:Sugar_on_a_Stick/Linux#SoaS_Fedora_matrix|Soas Fedora image matrix]].
===Download===

* ''Sugar on a Stick v2'' snapshots are available for download at http://download2.sugarlabs.org/soas/snapshots/2/, latest test version, [http://download2.sugarlabs.org/soas/snapshots/2/soas04.iso soas04.iso] (updated 30 Oct 2009).

===SoaS Installation on USB/SD===
* Use ONLY this script file to create a bootable image, http://bit.ly/livecd-iso-to-disk.
:(Don't forget to <code>chmod +x tools_livecd-iso-to-disk.sh</code> after you download the script.)
* 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:'''
* See this [http://www.mail-archive.com/soas@lists.sugarlabs.org/msg00335.html announcement] for more information.
* To install the .iso disc image, execute the shell script as the root user in <u>one</u> command with arguments as follows:
<div style="border:1px dashed #2f6fab; padding:8px; margin:8px; background-color:#f9f9f9"><code>sudo ./tools_livecd-iso-to-disk.sh --overlay-size-mb 400 --delete-home --extra-kernel-args selinux=0 ./soas04.iso /dev/sd*1</code></div>
:* (*) ''be sure of your USB/SD '''s'''torage '''d'''evice name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,'' <code>/dev/sdb1</code>. ''Use the mount command or the partition manager to confirm it before executing the script.''
:* <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.
:* 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*</code> with no partition number, instead of <code>/dev/sd*1</code> 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.''

====Alternate 'hybrid-mode' method using dd (not working at present)====
An alternate method of creating a LiveUSB stick form of the .iso (a 'hybrid' image) to make a bootable USB/SD (NOT RECOMMENDED)

*If you use dd command to write a USB or SD image, there will be no persistence. The SCRIPT method detailed above should be used.

In Root Terminal:

dd if=soas04.iso of=/dev/sd(?) bs=4M

* Be sure your USB/SD is /dev/sd? check with partition manager to be sure.
CAUTION: ** You can destroy you Hard Disk if you enter it wrong! **

====ZyX-LiveInstaller====
* ZyX-LiveInstaller allows you to install SoaS when it is already running '''from''' either a LiveUSB device or LiveCD media '''to''' a system or external disk. This results in what is considered a traditional operating system installation on disk (or USB-Stick/SD-Card). This is unlike the above methods which create a Live Media (USB/SD) from the .iso file.
* It is known to work best with the most recent snapshot build - soas04.iso.[http://download.sugarlabs.org/soas/snapshots/2/]
* To use
:* start the terminal activity, type in lowercase 'zyx-liveinstaller', then press enter.
:* start the partitioner 'gparted' if necessary
::* you will need at least a single partition for the root filesystem, that is greater than 2GB. Some disks labeled and sold as 2GB may not be quite large enough.
::* optionally, you may use a seperate partition for the /boot filesystem
::* optionally, you may select a seperate partition for swap space. 1-2GB is recommended and will allow the use of hibernation (suspend-to-disk)
::* note: formatting in the partitioner is not required.
::* exit the partitioner by hitting the X in the top corner of window.
:* read and follow the simple wizard, choosing destination volumes/partitions for boot, root, and swap. boot may be the same as root, and swap is optional.
* This is a *destructive* install, meaning that the contents of the disks or partitions you choose will be overwritten entirely.
* During installation, you are free to use other activities.
* After installation completes, you may remove the LiveUSB or LiveCD, and continue using the newly installed system - ''without rebooting''!!!. This means that anything done with the system before, during, or after installation persists into the installed system.

Sugar on a Stick/Beta

2009-11-03T23:54:28Z

Dmc: dd method is logically much closer to livecd-iso-to-disk, so reordering it there and several other clarification edits

{{TOCright}}
==Soas04 Beta==
*(Fedora 12 beta (rawhide)) See [[Talk:Sugar_on_a_Stick/Linux#SoaS_Fedora_matrix|Soas Fedora image matrix]].
===Download===

* ''Sugar on a Stick v2'' snapshots are available for download at http://download2.sugarlabs.org/soas/snapshots/2/, latest test version, [http://download2.sugarlabs.org/soas/snapshots/2/soas04.iso soas04.iso] (updated 30 Oct 2009).

===SoaS Installation on USB/SD===
* Use ONLY this script file to create a bootable image, http://bit.ly/livecd-iso-to-disk.
:(Don't forget to <code>chmod +x tools_livecd-iso-to-disk.sh</code> after you download the script.)
* 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:'''
* See this [http://www.mail-archive.com/soas@lists.sugarlabs.org/msg00335.html announcement] for more information.
* To install the .iso disc image, execute the shell script as the root user in <u>one</u> command with arguments as follows:
<div style="border:1px dashed #2f6fab; padding:8px; margin:8px; background-color:#f9f9f9"><code>sudo ./tools_livecd-iso-to-disk.sh --overlay-size-mb 400 --delete-home --extra-kernel-args selinux=0 ./soas04.iso /dev/sd*1</code></div>
:* (*) ''be sure of your USB/SD '''s'''torage '''d'''evice name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,'' <code>/dev/sdb1</code>. ''Use the mount command or the partition manager to confirm it before executing the script.''
:* <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.
:* 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*</code> with no partition number, instead of <code>/dev/sd*1</code> 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.''

====Alternate 'hybrid-mode' method using dd (not working at present)====
An alternate method of creating a LiveUSB stick form of the .iso (a 'hybrid' image) to make a bootable USB/SD (NOT RECOMMENDED)

*If you use dd command to write a USB or SD image, there will be no persistence. The SCRIPT method detailed above should be used.

In Root Terminal:

dd if=soas04.iso of=/dev/sd(?) bs=4M

* Be sure your USB/SD is /dev/sd? check with partition manager to be sure.
CAUTION: ** You can destroy you Hard Disk if you enter it wrong! **

====ZyX-LiveInstaller====
* zyx-liveinstaller is a method for installing SoaS when it is already running '''from''' either a LiveUSB device or LiveCD media '''to''' a system or external disk. This results in what is considered a traditional operating system installation on disk (or USB-Stick/SD-Card). This is unlike the above methods which create a LiveUSB from a .iso file.
* It is known to work best with the most recent snapshot build - soas04.iso.[http://download.sugarlabs.org/soas/snapshots/2/]
* To use
:* start the terminal activity, type 'zyx-liveinstaller', then press enter.
:* start the partitioner 'gparted' if necessary
::* you will need at least a single partition for the root filesystem, that is greater than 2GB. Some disks labeled and sold as 2GB may not be quite large enough.
::* optionally, you may use a seperate partition for the /boot filesystem
::* optionally, you may select a seperate partition for swap space. 1-2GB is recommended and will allow the use of hibernation (suspend-to-disk)
::* note: formatting in the partitioner is not required.
::* exit the partitioner by hitting the X in the top corner of window.
:* read and follow the simple wizard, choosing destination volumes/partitions for boot, root, and swap. boot may be the same as root, and swap is optional.
* This is a *destructive* install, meaning that the contents of the disks or partitions you choose will be overwritten entirely.
* During installation, you are free to use other activities.
* After installation completes, you may remove the LiveUSB or LiveCD, and continue using the newly installed system - ''without rebooting''!!!. This means that anything done with the system before, during, or after installation persists into the installed system.

Sugar on a Stick/Linux

2009-10-24T10:11:21Z

Dmc: zyx-liveinstaller author cleaning up the relevent entry

<noinclude>{{GoogleTrans-en}}{{TOCright}}</noinclude>
== Introduction ==
This page offers a variety of '''experimental''' options for putting a [[Sugar on a Stick]] image on a USB flash drive under GNU/Linux. Look at the page Contents box to the right to select a suitable option.

For a more stable, released version, see '''[[Sugar_on_a_Stick/Strawberry#Linux_Users | v1 Strawberry]]'''.

If you have questions, trouble, or feedback, please let us know on the [[{{TALKPAGENAMEE}}|discussion]] page. "Sugar on a Stick" is provided in a number of [[Talk:Sugar_on_a_Stick/Linux#SoaS_Fedora_matrix|variants]]. If you can improve these instructions, please edit the page and do so!

==SoaS V2 Beta==
*(Fedora 12 alpha) See [[Talk:Sugar_on_a_Stick/Linux#SoaS_Fedora_matrix|Soas Fedora image matrix]].
===Download===
* Help save our bandwidth. Please download via BitTorrent, if possible.

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
|-style="background:#787878; color: white;"
| '''Tracker''' || '''Link'''
|-
| LegalTorrents.com || http://www.legaltorrents.com/torrents/780-sugar-on-a-stick-v2-beta
|}

Alternatively, you can download via http:
* ''Sugar on a Stick v2'' snapshots are available for download at http://download2.sugarlabs.org/soas/snapshots/2/, latest test version, [http://download2.sugarlabs.org/soas/snapshots/2/soas02.iso] (Oct 12 2009)

===SoaS v2 Installation===
* Use ONLY this script file to create a bootable image, http://bit.ly/livecd-iso-to-disk.
:(Don't forget to <code>chmod +x tools_livecd-iso-to-disk.sh</code> after you download the script.)
* The .iso file may be burnt to a CD-ROM and booted on your PC (or mounted in a virtual machine to boot it):
*# Press <Esc> at the blue. initial boot screen,
*# Press <Tab> to enter more boot options,
*# Append <code>selinux=0</code> to the startup command arguments,
*# Press <Enter> to continue with the boot.

'''Note:'''
* See this [http://lists.sugarlabs.org/archive/sugar-devel/2009-September/019829.html announcement] for more information (noting the changes and notes below).
* Do ''NOT'' use installation instructions in other sections of this page for this version of SoaS.
* Note that selinux must be disabled in the startup (selinux=0) or Sugar will not load.
*: This precludes using a dd command to write a USB or SD image. The SCRIPT MUST BE USED.
* To install the .iso disc image, execute the shell script as the root user in <u>one</u> command with arguments as follows:
<div style="border:1px dashed #2f6fab; padding:8px; margin:8px; background-color:#f9f9f9"><code>sudo ./tools_livecd-iso-to-disk.sh --overlay-size-mb 400 --delete-home --extra-kernel-args selinux=0 ./SoaS3-200909271154.iso /dev/sd*1</code></div>
:* (*) ''be sure of your USB/SD '''s'''torage '''d'''evice name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,'' <code>/dev/sdb1</code>. ''Use the mount command or the partition manager to confirm it before executing the script.''
:* The <code>--format --reset-mbr</code> arguments for the shell script were in the example 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.
:* 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*</code> with no partition number, instead of <code>/dev/sd*1</code> 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.''

====zyx-liveinstaller====
* zyx-liveinstaller is a method for installing SoaS *from* either stick or LiveCD form *to* a system or external disk. It is known to work best with the most recent snapshot build - soas03.iso.
* To use, start the terminal activity, type 'zyx-liveinstaller', then press enter.
* Then read and follow the simple wizard, choosing destination volumes/partitons for boot, root, and swap. root must be at least 2GB(not currently checked for by the installer). boot may be the same as root, and swap is optional.
* This is a *destructive* install, meaning that the contents of the disks or partitions you choose will be overwritten entirely.
* During installation, you are free to use other activities.
* After installation completes, you may remove the LiveUSB or LiveCD, and continue using the newly installed system - *without rebooting*!!!. This means that anything done with the system before, during, or after installation persists into the installed system.
* here are some older notes for use with VMWare [http://wiki.sugarlabs.org/go/VMware#Soas02.iso_PRELIMINARY_INSTALL_zyx-liveinstaller_FOR_TESTING_ONLY]

== Put [[Sugar on a Stick/Installation/OLPC | SoaS on an OLPC XO-1]] ==
* See [[Sugar on a Stick/Installation/OLPC]] for booting an OLPC XO-1 with SoaS images.
== Put SoaS onto a stick using Fedora and Ubuntu ==

This is known to work in Fedora and Ubuntu.

First, start downloading a SoaS <tt>.iso</tt> image from the [[Sugar on a Stick#Download locations|download locations section]], then return here.

:(A program called UNetBootin available at http://unetbootin.sourceforge.net/ does all this magic for you... or you can do the magic yourself:)

* Make sure you have the ''syslinux'' package installed on the operating system that you will use to prepare the Live USB image. It is recommended that you also have the ''isomd5sum'' package installed. The ''cryptsetup'' package is another option potentially used by the "livecd-iso-to-disk" installation script. (On Ubuntu, <code>sudo apt-get install syslinux isomd5sum cryptsetup</code> will install the packages. They are also available through the Synaptic Package Manager.)
: (On Gentoo, one needs to uncomment 'SAMPLE FILE' in /etc/mtools/mtools.conf to make syslinux work.)
:*''syslinux'' is needed to set up booting on the FAT file system of the USB disc or Live CD.
:*''isomd5sum'' is needed for the recommended verification step, which checks that the .iso file is complete after its travels. If there is a problem with the .iso file, the script will exit and provide a failure message. The verification step can be bypassed by using the <code>--noverify</code> option.
:*''cryptsetup'' is only needed for the option to provide password protection and encryption for the persistent /home/liveuser folder. It is not necessary if one applies the recommended <code>--unencrypted-home</code> option. The <code>--unencrypted-home</code> option is preferred because the reduced overhead improves robustness with the compressed ''squashfs'' file system employed by the Live USB deployment.
* Plug in a 1GB or larger USB stick into your computer.
* Download the installation script: http://download.sugarlabs.org/soas/releases/livecd-iso-to-disk.sh (23 June 2009).<br>(You will execute this script several steps below.)
* Check the USB device name. In the example below, the '''s'''torage '''d'''evice is /dev/sdb and filesystem partition on that device is /dev/sdb1:
: <tt>'''df -h'''</tt>
Filesystem Size Used Avail Use% Mounted on
/dev/sda1 19G 7.0G 11G 40% /
tmpfs 1.5G 0 1.5G 0% /lib/init/rw
varrun 1.5G 96K 1.5G 1% /var/run
varlock 1.5G 0 1.5G 0% /var/lock
udev 1.5G 2.9M 1.5G 1% /dev
tmpfs 1.5G 104K 1.5G 1% /dev/shm
lrm 1.5G 2.0M 1.5G 1% /lib/modules/2.6.27-11-generic/volatile
/dev/sdb1 996M 913M 84M 92% /mnt/myUSBdisc

* Unmount the drive,<br>
: <tt>sudo umount /dev/sd''b1''</tt>

* Then check to see that the partition is marked as bootable,<br>
: <tt>sudo fdisk '''-l'''</tt> ''<----that's a lowercase letter 'L' for the '''l'''ist option.''
You should see output that looks like this:
Disk /dev/sdb: 1047 MB, 1047265280 bytes
255 heads, 63 sectors/track, 127 cylinders
Units = cylinders of 16065 * 512 = 8225280 bytes
Disk identifier: 0x0008325f
.
Device Boot Start End Blocks Id System
/dev/sdb1 * 1 127 1020096 6 FAT16
The '*' under the Boot column is what you want to see.
: If not, then
:* For Ubuntu 8.10, menu: System -> Administration -> Partition Editor (GParted).
::# Select your USB device (/dev/sd''b'' for the rest of these instructions),
::# then your partition (/dev/sd''b1''),
::# then menu: Partition -> Manage Flags,
::# check the boot box,
::# and Close to mark the partition as bootable.

:* For Fedora,
::# <tt>parted /dev/sd''b''</tt>
::# toggle 1 boot
::# quit

* Also, check to see that you do not already have an existing boot loader (such as [[wikipedia:GNU GRUB|GRUB]]) in the [[wikipedia:Master boot record|MBR]] of your stick. (If you have not previously used this stick as a live boot, you can skip this step.) To be sure that the USB stick's MBR is wiped clean, overwrite it completely using:
: <tt>dd if=/dev/zero of=/dev/sd''b'' bs=446 count=1</tt>
:: (Actually, that didn't work for me. But this did:
::: <tt>lilo -M /dev/sd''b''</tt>
:::It put in a standard MBR that boots whichever partition has been called bootable. It does not install [[wikipedia:LILO (boot loader)|LILO]] as such.)
* Change mode to make the script executable.
: <tt>chmod +x livecd-iso-to-disk.sh</tt>
* Run it as root, making sure to pass the correct USB device and to set overlay and home size appropriately, depending on the stick size.
: <tt>sudo ./livecd-iso-to-disk.sh --overlay-size-mb 300 --home-size-mb 160 --delete-home --unencrypted-home soas-strawberry.iso /dev/sd''b1''</tt>
::The ''livecd-iso-to-disk'' installation has the advantage over the ''liveusb-creator'' installation method by allowing a persistent /home/liveuser folder with the <tt>--home-size-mb ''NNN''</tt> option. This feature would allow you to update the OS image while keeping the user files (by running the script against your existing installation but <u>leaving out</u> the --home-size-mb NNN option).
::* The <code>--delete-home</code> option is used to avoid an error message while requesting both a new home (with <code>--home-size-mb</code>) and a persistent home (indirectly with <code>--unencrypted-home</code>). You wouldn't use the --delete-home option on an upgrade of the operation system only.
:Depending on the size of your USB stick, you may have to decrease <code>--overlay-size-mb</code> and <code>--home-size-mb</code> values (for example, for a 1-GB stick, use 200 for each).
:* If you get an error about udevinfo, you have the new version of udev where "udevadm info" is the proper command. :Create an executable file called udevinfo somewhere in your path with the following contents:
:::<code>#!/bin/bash</code><br>
:::<code>udevadm info $*</code>
:* Watch out for errors in the output of the script, the script seems to ignore them! (and say all is fine on the last line).

===livecd-iso-to-disk.sh transcript===

$ sudo ./livecd-iso-to-disk.sh --overlay-size-mb 300 --home-size-mb 160 --delete-home --unencrypted-home Soas2-200906211228.iso /dev/sdb1
Verifying image...
/home/walter/Desktop/Soas2-200906211228.iso: 9f1aa3c7a19dd9c68d1047d681f703c6
Fragment sums: f5ddb7deb26b6474bd59be9f57b6c7abcd624e1ccc682ddf664ba73da4ed
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
300+0 records in
300+0 records out
314572800 bytes (315 MB) copied, 88.7551 s, 3.5 MB/s
Initializing persistent /home
160+0 records in
160+0 records out
167772160 bytes (168 MB) copied, 48.1191 s, 3.5 MB/s
Formatting unencrypted /home
mke2fs 1.41.4 (27-Jan-2009)
Filesystem label=
OS type: Linux
Block size=1024 (log=0)
Fragment size=1024 (log=0)
40960 inodes, 163840 blocks
8192 blocks (5.00%) reserved for the super user
First data block=1
Maximum filesystem blocks=67371008
20 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 28 mounts or
180 days, whichever comes first. Use tune2fs -c or -i to override.
tune2fs 1.41.4 (27-Jan-2009)
Setting maximal mount count to -1
Setting interval between checks to 0 seconds
Installing boot loader
USB stick set up as live image!

== Full Fedora 11 Install of Sugar-Desktop on a Stick to USB ==
Uses [[wikipedia:Logical_Volume_Manager_(Linux)|Logical Volume Manager (LVM)]] layer over the file structure on the USB flash drive. Other methods on this page install a LiveUSB image that uses a compressed file system ([[wikipedia:SquashFS|SquashFS]]) to hold the system and content.

THIS IS A WORK IN PROGRESS. Please make suggestions or improvements.
===='''Download of Prebuilt SUGAR-DESKTOP USB.img file'''====

* DOWNLOAD Link:[[http://people.sugarlabs.org/Tgillard/]]
'''Requires:'''
* GNU/Linux system with ability to decompress archive
* 4 GB or larger USB Stick
* Familiarity with dd commands in terminal (see below)

====Make your OWN Custom SUGAR-DESKTOP USB Boot Stick====
* Uses Fedora 11 Net Install CD,[http://mirrors.cat.pdx.edu/fedora/linux/releases/11/Fedora/i386/iso/] so best with a fast internet connection.
* USB 2.0 recommended or install would take a excessive time using USB 1.0
* '''Requires 4-GB USB drive.''' (Tested with Cruzer Micro USB Stick, an 8-GB Toshiba USB drive works faster.)
# Boot from CD
# Enter language, time, location, root user password
# Replace existing Linux system
# Review and modify partitioning layout
# edit LVM VolGroup
# delete LV_swap (needed to fit on 4GB stick and for reduced writes to USB)
# edit LV_root (Edit LVM and increase to max size on (/dev/sda*)
# size:(change to max shown)
# yes for no swap file
# Write changes to disk '''*NOTE: Be sure this is the USB drive, or you will ruin your hard disk installation on the host PC.'''
# install boot loader Fedora/dev/mapper/VolGroup-lv_root
# enable network interface (DHCP, IPv4)
# retrieve install informtion for Fedora 11-i386
# Select customize now
## sugar-desktop ONLY / deselect gnome-desktop
## deselect other unwanted applications in categories (Games, etc)
#: Installer will reformat drive; install bootloader; transfer 957 packages (about 2 hours)
#reboot
# Configuration setup (Graphical), add user and password on first boot
# Log in User
# Select Sugar on selection bar
*
*''' You can also do a hard disk install of SUGAR this way ''' (not tested yet)

*''' This procedure can be used with a Windows PC if it will boot from CD'''

====8 GB Gnome/Sugar-Desktop USB====
*''' install gnome or KDE desktop with this technique and then, use add/remove programs to install sugar from other desktops'''

*''' you get a 8GB USB that boots either gnome or sugar (8 GB Toshiba USB)'''
This Works well....can switch back between desktops by logging off and back on.

===='''AUTO Login to SUGAR'''====

TO bypass gdm Login and start up Stick in SUGAR DESKTOP:
*start up and log in to sugar
*Open Terminal Application
su -
password=sugarroot
yum install gedit
(after gedit is installed:)
gedit /etc/gdm/gdm.schemas
*change: (to true and add sugar)
--snip--
<key>daemon/AutomaticLoginEnable</key>
<signature>b</signature>
<default>true</default>
</schema>
<schema>
<key>daemon/AutomaticLogin</key>
<signature>s</signature>
<default>sugar</default>
</schema>
--snip--
*Reboot

===='''Duplication of USB Sticks'''====
'''Caution:''' ''This is a work in progress''

====Preparation of target device====
'''Caution if you purchase Sandisk cruzer micro 4 GB USB you have to use Windows machine to to start the U3 program and delete the hidden U3 directory'''

'''This will make the USB a full 4GB otherwise it will be too small to use dd to copy .img file'''
* U3 partition will not be removed by formating with Partition Manager

'''CAUTION VERY DANGEROUS IF NOT ENTERED CORRECTLY:'''

* Enter Terminal
su -
<password>
(Need to be ROOT or get permission denied)
* Target USB device MUST be larger for this to work (not all USB Sticks are exactly the same size)
** be certain of the device identifier, /dev/sd(x), for your USB Stick. (I use the partition editor in Ubuntu 9.04 to identify the USB device.)
* Note that .img file on Desktop can be compressed for distribution.

'''Example of sucessful clone session:''''
=====Make Image from USB:=====
* 8-GB Toshiba USB
root@xxxxx:/home/robert/Desktop# dd if=/dev/sda* of=USB8.img
15687680+0 records in
15687680+0 records out
8032092160 bytes (8.0 GB) copied, 421.146 s, 19.1 MB/s

=====use image to write USB Clone:=====
* 4-GB SanDisk Cruzer with U3 partition removed
root@xxxx:/home/robert/Desktop# dd if=USB4C2.img of=/dev/sdg bs=4k
986623+1 records in
986623+1 records out
4041211392 bytes (4.0 GB) copied, 595.509 s, 6.8 MB/s

== Make a Sugar-Desktop on a Stick VMware appliance ==

Prebuilt VMware Appliances: [http://people.sugarlabs.org/Tgillard/]
# Download and expand file
# copy to USB Stick (min 4GB)
# Play with VMPlayer (free) available here: [http://www.vmware.com/download/player/]

OR

[[VMware|These instructions]] will help you put a [[Sugar on a Stick#Downloading|SoaS image]] onto a USB
stick that boots into VMware Player that then runs a VMware Virtual Appliance containing a [[Sugar on a Stick#Downloading|SoaS image]].

== openSUSE Sugar-Desktop on a stick ==

* The openSUSE version is a .raw image that is burned to a stick by the dd command. It creates a usb stick that boots sugar-desktop with 55 applications.

* '''This is a persistent live image on a stick''' (a file system is created on the stick on first boot)

* Installation of openSUSE.raw file to USB/SD: [[VMware#Image USB/SD Drives]]

* Download Link for .raw files:[[http://download.opensuse.org/repositories/Education/images/]]

* Details http://en.opensuse.org/Sugar
===Dual Mode .iso Files===
NOTE: Latest versions of opensuse-edu-sugar.iso files can be burned to USB with dd command. "They are dual mode"
Download: [[http://download.opensuse.org/repositories/Education/images/iso/]]

The resulting USB/SD has not got persistence. It is equivalent to Booting from the CD

Example record:
*be sure /dev/sd(x) points to your USB (can destroy your Hard Disk if wrong) use Partition Manager to see proper label...
dd if=openSUSE-Sugar-live-unstable.i686-0.2.0-Build5.1.iso of=/dev/sd(x)* bs=4M
102+1 records in
102+1 records out
428867584 bytes (429 MB) copied, 53.2686 s, 8.1 MB/s

== What's next? ==

After you've created your stick, it's time to [[Sugar_on_a_Stick#Boot|boot your stick]] and [[Sugar on a Stick/Getting Involved | test]] it out. Please also [[Sugar on a Stick/Getting Involved/Testing | report]] your observations.

[[Category:HowTo]]

Sugar on a Stick/Linux

2009-10-24T10:09:19Z

Dmc:

<noinclude>{{GoogleTrans-en}}{{TOCright}}</noinclude>
== Introduction ==
This page offers a variety of '''experimental''' options for putting a [[Sugar on a Stick]] image on a USB flash drive under GNU/Linux. Look at the page Contents box to the right to select a suitable option.

For a more stable, released version, see '''[[Sugar_on_a_Stick/Strawberry#Linux_Users | v1 Strawberry]]'''.

If you have questions, trouble, or feedback, please let us know on the [[{{TALKPAGENAMEE}}|discussion]] page. "Sugar on a Stick" is provided in a number of [[Talk:Sugar_on_a_Stick/Linux#SoaS_Fedora_matrix|variants]]. If you can improve these instructions, please edit the page and do so!

==SoaS V2 Beta==
*(Fedora 12 alpha) See [[Talk:Sugar_on_a_Stick/Linux#SoaS_Fedora_matrix|Soas Fedora image matrix]].
===Download===
* Help save our bandwidth. Please download via BitTorrent, if possible.

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
|-style="background:#787878; color: white;"
| '''Tracker''' || '''Link'''
|-
| LegalTorrents.com || http://www.legaltorrents.com/torrents/780-sugar-on-a-stick-v2-beta
|}

Alternatively, you can download via http:
* ''Sugar on a Stick v2'' snapshots are available for download at http://download2.sugarlabs.org/soas/snapshots/2/, latest test version, [http://download2.sugarlabs.org/soas/snapshots/2/soas02.iso] (Oct 12 2009)

===SoaS v2 Installation===
* Use ONLY this script file to create a bootable image, http://bit.ly/livecd-iso-to-disk.
:(Don't forget to <code>chmod +x tools_livecd-iso-to-disk.sh</code> after you download the script.)
* The .iso file may be burnt to a CD-ROM and booted on your PC (or mounted in a virtual machine to boot it):
*# Press <Esc> at the blue. initial boot screen,
*# Press <Tab> to enter more boot options,
*# Append <code>selinux=0</code> to the startup command arguments,
*# Press <Enter> to continue with the boot.

'''Note:'''
* See this [http://lists.sugarlabs.org/archive/sugar-devel/2009-September/019829.html announcement] for more information (noting the changes and notes below).
* Do ''NOT'' use installation instructions in other sections of this page for this version of SoaS.
* Note that selinux must be disabled in the startup (selinux=0) or Sugar will not load.
*: This precludes using a dd command to write a USB or SD image. The SCRIPT MUST BE USED.
* To install the .iso disc image, execute the shell script as the root user in <u>one</u> command with arguments as follows:
<div style="border:1px dashed #2f6fab; padding:8px; margin:8px; background-color:#f9f9f9"><code>sudo ./tools_livecd-iso-to-disk.sh --overlay-size-mb 400 --delete-home --extra-kernel-args selinux=0 ./SoaS3-200909271154.iso /dev/sd*1</code></div>
:* (*) ''be sure of your USB/SD '''s'''torage '''d'''evice name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,'' <code>/dev/sdb1</code>. ''Use the mount command or the partition manager to confirm it before executing the script.''
:* The <code>--format --reset-mbr</code> arguments for the shell script were in the example 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.
:* 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*</code> with no partition number, instead of <code>/dev/sd*1</code> 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.''

====zyx-liveinstaller====
* zyx-liveinstaller is a method for installing SoaS *from* either stick or LiveCD form *to* a system or external disk.
* To use, start the terminal activity, type 'zyx-liveinstaller', then press enter.
* Then read and follow the simple wizard, choosing destination volumes/partitons for boot, root, and swap. root must be at least 2GB(not currently checked for by the installer). boot may be the same as root, and swap is optional.
* This is a *destructive* install, meaning that the contents of the disks or partitions you choose will be overwritten entirely.
* During installation, you are free to use other activities.
* After installation completes, you may remove the LiveUSB or LiveCD, and continue using the newly installed system - *without rebooting*!!!. This means that anything done with the system before, during, or after installation persists into the installed system.
* here are some older notes for use with VMWare [http://wiki.sugarlabs.org/go/VMware#Soas02.iso_PRELIMINARY_INSTALL_zyx-liveinstaller_FOR_TESTING_ONLY]

== Put [[Sugar on a Stick/Installation/OLPC | SoaS on an OLPC XO-1]] ==
* See [[Sugar on a Stick/Installation/OLPC]] for booting an OLPC XO-1 with SoaS images.
== Put SoaS onto a stick using Fedora and Ubuntu ==

This is known to work in Fedora and Ubuntu.

First, start downloading a SoaS <tt>.iso</tt> image from the [[Sugar on a Stick#Download locations|download locations section]], then return here.

:(A program called UNetBootin available at http://unetbootin.sourceforge.net/ does all this magic for you... or you can do the magic yourself:)

* Make sure you have the ''syslinux'' package installed on the operating system that you will use to prepare the Live USB image. It is recommended that you also have the ''isomd5sum'' package installed. The ''cryptsetup'' package is another option potentially used by the "livecd-iso-to-disk" installation script. (On Ubuntu, <code>sudo apt-get install syslinux isomd5sum cryptsetup</code> will install the packages. They are also available through the Synaptic Package Manager.)
: (On Gentoo, one needs to uncomment 'SAMPLE FILE' in /etc/mtools/mtools.conf to make syslinux work.)
:*''syslinux'' is needed to set up booting on the FAT file system of the USB disc or Live CD.
:*''isomd5sum'' is needed for the recommended verification step, which checks that the .iso file is complete after its travels. If there is a problem with the .iso file, the script will exit and provide a failure message. The verification step can be bypassed by using the <code>--noverify</code> option.
:*''cryptsetup'' is only needed for the option to provide password protection and encryption for the persistent /home/liveuser folder. It is not necessary if one applies the recommended <code>--unencrypted-home</code> option. The <code>--unencrypted-home</code> option is preferred because the reduced overhead improves robustness with the compressed ''squashfs'' file system employed by the Live USB deployment.
* Plug in a 1GB or larger USB stick into your computer.
* Download the installation script: http://download.sugarlabs.org/soas/releases/livecd-iso-to-disk.sh (23 June 2009).<br>(You will execute this script several steps below.)
* Check the USB device name. In the example below, the '''s'''torage '''d'''evice is /dev/sdb and filesystem partition on that device is /dev/sdb1:
: <tt>'''df -h'''</tt>
Filesystem Size Used Avail Use% Mounted on
/dev/sda1 19G 7.0G 11G 40% /
tmpfs 1.5G 0 1.5G 0% /lib/init/rw
varrun 1.5G 96K 1.5G 1% /var/run
varlock 1.5G 0 1.5G 0% /var/lock
udev 1.5G 2.9M 1.5G 1% /dev
tmpfs 1.5G 104K 1.5G 1% /dev/shm
lrm 1.5G 2.0M 1.5G 1% /lib/modules/2.6.27-11-generic/volatile
/dev/sdb1 996M 913M 84M 92% /mnt/myUSBdisc

* Unmount the drive,<br>
: <tt>sudo umount /dev/sd''b1''</tt>

* Then check to see that the partition is marked as bootable,<br>
: <tt>sudo fdisk '''-l'''</tt> ''<----that's a lowercase letter 'L' for the '''l'''ist option.''
You should see output that looks like this:
Disk /dev/sdb: 1047 MB, 1047265280 bytes
255 heads, 63 sectors/track, 127 cylinders
Units = cylinders of 16065 * 512 = 8225280 bytes
Disk identifier: 0x0008325f
.
Device Boot Start End Blocks Id System
/dev/sdb1 * 1 127 1020096 6 FAT16
The '*' under the Boot column is what you want to see.
: If not, then
:* For Ubuntu 8.10, menu: System -> Administration -> Partition Editor (GParted).
::# Select your USB device (/dev/sd''b'' for the rest of these instructions),
::# then your partition (/dev/sd''b1''),
::# then menu: Partition -> Manage Flags,
::# check the boot box,
::# and Close to mark the partition as bootable.

:* For Fedora,
::# <tt>parted /dev/sd''b''</tt>
::# toggle 1 boot
::# quit

* Also, check to see that you do not already have an existing boot loader (such as [[wikipedia:GNU GRUB|GRUB]]) in the [[wikipedia:Master boot record|MBR]] of your stick. (If you have not previously used this stick as a live boot, you can skip this step.) To be sure that the USB stick's MBR is wiped clean, overwrite it completely using:
: <tt>dd if=/dev/zero of=/dev/sd''b'' bs=446 count=1</tt>
:: (Actually, that didn't work for me. But this did:
::: <tt>lilo -M /dev/sd''b''</tt>
:::It put in a standard MBR that boots whichever partition has been called bootable. It does not install [[wikipedia:LILO (boot loader)|LILO]] as such.)
* Change mode to make the script executable.
: <tt>chmod +x livecd-iso-to-disk.sh</tt>
* Run it as root, making sure to pass the correct USB device and to set overlay and home size appropriately, depending on the stick size.
: <tt>sudo ./livecd-iso-to-disk.sh --overlay-size-mb 300 --home-size-mb 160 --delete-home --unencrypted-home soas-strawberry.iso /dev/sd''b1''</tt>
::The ''livecd-iso-to-disk'' installation has the advantage over the ''liveusb-creator'' installation method by allowing a persistent /home/liveuser folder with the <tt>--home-size-mb ''NNN''</tt> option. This feature would allow you to update the OS image while keeping the user files (by running the script against your existing installation but <u>leaving out</u> the --home-size-mb NNN option).
::* The <code>--delete-home</code> option is used to avoid an error message while requesting both a new home (with <code>--home-size-mb</code>) and a persistent home (indirectly with <code>--unencrypted-home</code>). You wouldn't use the --delete-home option on an upgrade of the operation system only.
:Depending on the size of your USB stick, you may have to decrease <code>--overlay-size-mb</code> and <code>--home-size-mb</code> values (for example, for a 1-GB stick, use 200 for each).
:* If you get an error about udevinfo, you have the new version of udev where "udevadm info" is the proper command. :Create an executable file called udevinfo somewhere in your path with the following contents:
:::<code>#!/bin/bash</code><br>
:::<code>udevadm info $*</code>
:* Watch out for errors in the output of the script, the script seems to ignore them! (and say all is fine on the last line).

===livecd-iso-to-disk.sh transcript===

$ sudo ./livecd-iso-to-disk.sh --overlay-size-mb 300 --home-size-mb 160 --delete-home --unencrypted-home Soas2-200906211228.iso /dev/sdb1
Verifying image...
/home/walter/Desktop/Soas2-200906211228.iso: 9f1aa3c7a19dd9c68d1047d681f703c6
Fragment sums: f5ddb7deb26b6474bd59be9f57b6c7abcd624e1ccc682ddf664ba73da4ed
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
300+0 records in
300+0 records out
314572800 bytes (315 MB) copied, 88.7551 s, 3.5 MB/s
Initializing persistent /home
160+0 records in
160+0 records out
167772160 bytes (168 MB) copied, 48.1191 s, 3.5 MB/s
Formatting unencrypted /home
mke2fs 1.41.4 (27-Jan-2009)
Filesystem label=
OS type: Linux
Block size=1024 (log=0)
Fragment size=1024 (log=0)
40960 inodes, 163840 blocks
8192 blocks (5.00%) reserved for the super user
First data block=1
Maximum filesystem blocks=67371008
20 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 28 mounts or
180 days, whichever comes first. Use tune2fs -c or -i to override.
tune2fs 1.41.4 (27-Jan-2009)
Setting maximal mount count to -1
Setting interval between checks to 0 seconds
Installing boot loader
USB stick set up as live image!

== Full Fedora 11 Install of Sugar-Desktop on a Stick to USB ==
Uses [[wikipedia:Logical_Volume_Manager_(Linux)|Logical Volume Manager (LVM)]] layer over the file structure on the USB flash drive. Other methods on this page install a LiveUSB image that uses a compressed file system ([[wikipedia:SquashFS|SquashFS]]) to hold the system and content.

THIS IS A WORK IN PROGRESS. Please make suggestions or improvements.
===='''Download of Prebuilt SUGAR-DESKTOP USB.img file'''====

* DOWNLOAD Link:[[http://people.sugarlabs.org/Tgillard/]]
'''Requires:'''
* GNU/Linux system with ability to decompress archive
* 4 GB or larger USB Stick
* Familiarity with dd commands in terminal (see below)

====Make your OWN Custom SUGAR-DESKTOP USB Boot Stick====
* Uses Fedora 11 Net Install CD,[http://mirrors.cat.pdx.edu/fedora/linux/releases/11/Fedora/i386/iso/] so best with a fast internet connection.
* USB 2.0 recommended or install would take a excessive time using USB 1.0
* '''Requires 4-GB USB drive.''' (Tested with Cruzer Micro USB Stick, an 8-GB Toshiba USB drive works faster.)
# Boot from CD
# Enter language, time, location, root user password
# Replace existing Linux system
# Review and modify partitioning layout
# edit LVM VolGroup
# delete LV_swap (needed to fit on 4GB stick and for reduced writes to USB)
# edit LV_root (Edit LVM and increase to max size on (/dev/sda*)
# size:(change to max shown)
# yes for no swap file
# Write changes to disk '''*NOTE: Be sure this is the USB drive, or you will ruin your hard disk installation on the host PC.'''
# install boot loader Fedora/dev/mapper/VolGroup-lv_root
# enable network interface (DHCP, IPv4)
# retrieve install informtion for Fedora 11-i386
# Select customize now
## sugar-desktop ONLY / deselect gnome-desktop
## deselect other unwanted applications in categories (Games, etc)
#: Installer will reformat drive; install bootloader; transfer 957 packages (about 2 hours)
#reboot
# Configuration setup (Graphical), add user and password on first boot
# Log in User
# Select Sugar on selection bar
*
*''' You can also do a hard disk install of SUGAR this way ''' (not tested yet)

*''' This procedure can be used with a Windows PC if it will boot from CD'''

====8 GB Gnome/Sugar-Desktop USB====
*''' install gnome or KDE desktop with this technique and then, use add/remove programs to install sugar from other desktops'''

*''' you get a 8GB USB that boots either gnome or sugar (8 GB Toshiba USB)'''
This Works well....can switch back between desktops by logging off and back on.

===='''AUTO Login to SUGAR'''====

TO bypass gdm Login and start up Stick in SUGAR DESKTOP:
*start up and log in to sugar
*Open Terminal Application
su -
password=sugarroot
yum install gedit
(after gedit is installed:)
gedit /etc/gdm/gdm.schemas
*change: (to true and add sugar)
--snip--
<key>daemon/AutomaticLoginEnable</key>
<signature>b</signature>
<default>true</default>
</schema>
<schema>
<key>daemon/AutomaticLogin</key>
<signature>s</signature>
<default>sugar</default>
</schema>
--snip--
*Reboot

===='''Duplication of USB Sticks'''====
'''Caution:''' ''This is a work in progress''

====Preparation of target device====
'''Caution if you purchase Sandisk cruzer micro 4 GB USB you have to use Windows machine to to start the U3 program and delete the hidden U3 directory'''

'''This will make the USB a full 4GB otherwise it will be too small to use dd to copy .img file'''
* U3 partition will not be removed by formating with Partition Manager

'''CAUTION VERY DANGEROUS IF NOT ENTERED CORRECTLY:'''

* Enter Terminal
su -
<password>
(Need to be ROOT or get permission denied)
* Target USB device MUST be larger for this to work (not all USB Sticks are exactly the same size)
** be certain of the device identifier, /dev/sd(x), for your USB Stick. (I use the partition editor in Ubuntu 9.04 to identify the USB device.)
* Note that .img file on Desktop can be compressed for distribution.

'''Example of sucessful clone session:''''
=====Make Image from USB:=====
* 8-GB Toshiba USB
root@xxxxx:/home/robert/Desktop# dd if=/dev/sda* of=USB8.img
15687680+0 records in
15687680+0 records out
8032092160 bytes (8.0 GB) copied, 421.146 s, 19.1 MB/s

=====use image to write USB Clone:=====
* 4-GB SanDisk Cruzer with U3 partition removed
root@xxxx:/home/robert/Desktop# dd if=USB4C2.img of=/dev/sdg bs=4k
986623+1 records in
986623+1 records out
4041211392 bytes (4.0 GB) copied, 595.509 s, 6.8 MB/s

== Make a Sugar-Desktop on a Stick VMware appliance ==

Prebuilt VMware Appliances: [http://people.sugarlabs.org/Tgillard/]
# Download and expand file
# copy to USB Stick (min 4GB)
# Play with VMPlayer (free) available here: [http://www.vmware.com/download/player/]

OR

[[VMware|These instructions]] will help you put a [[Sugar on a Stick#Downloading|SoaS image]] onto a USB
stick that boots into VMware Player that then runs a VMware Virtual Appliance containing a [[Sugar on a Stick#Downloading|SoaS image]].

== openSUSE Sugar-Desktop on a stick ==

* The openSUSE version is a .raw image that is burned to a stick by the dd command. It creates a usb stick that boots sugar-desktop with 55 applications.

* '''This is a persistent live image on a stick''' (a file system is created on the stick on first boot)

* Installation of openSUSE.raw file to USB/SD: [[VMware#Image USB/SD Drives]]

* Download Link for .raw files:[[http://download.opensuse.org/repositories/Education/images/]]

* Details http://en.opensuse.org/Sugar
===Dual Mode .iso Files===
NOTE: Latest versions of opensuse-edu-sugar.iso files can be burned to USB with dd command. "They are dual mode"
Download: [[http://download.opensuse.org/repositories/Education/images/iso/]]

The resulting USB/SD has not got persistence. It is equivalent to Booting from the CD

Example record:
*be sure /dev/sd(x) points to your USB (can destroy your Hard Disk if wrong) use Partition Manager to see proper label...
dd if=openSUSE-Sugar-live-unstable.i686-0.2.0-Build5.1.iso of=/dev/sd(x)* bs=4M
102+1 records in
102+1 records out
428867584 bytes (429 MB) copied, 53.2686 s, 8.1 MB/s

== What's next? ==

After you've created your stick, it's time to [[Sugar_on_a_Stick#Boot|boot your stick]] and [[Sugar on a Stick/Getting Involved | test]] it out. Please also [[Sugar on a Stick/Getting Involved/Testing | report]] your observations.

[[Category:HowTo]]