|
|
| (76 intermediate revisions by 9 users not shown) |
| Line 1: |
Line 1: |
| <noinclude>{{TOCright}} | | <noinclude> |
| | [[Category:HowTo]] |
| [[Category:Sugar on a Stick]] | | [[Category:Sugar on a Stick]] |
| [[Category:Live USB]]
| | </noinclude>__TOC__ |
| </noinclude> | |
|
| |
|
| | Sugar on a Stick is best installed by following the [https://docs.fedoraproject.org/en-US/fedora/rawhide/install-guide/ Fedora Installation Guide]. |
| | |
| | The rest of this Wiki page is outdated, or superceded by the Fedora Installation Guide. |
| | |
| | {{outdated}} |
| | |
| | ---- |
| | {|http://wiki.sugarlabs.org/index.php?title=Sugar_on_a_Stick/Installation&action=submit#SoaS_on_VirtualBox |
| | |- |
| | | |
| | * [[#with_Microsoft_Windows|Microsoft Windows]] |
| | * [[#with_GNU.2FLinux|GNU/Linux]] |
| | * [[#on_an_OLPC_XO|OLPC XO]] |
| | * [[#SoaS_on_VirtualBox|VirtualBox]] |
| | * [[#with_Apple_Macintosh|Apple Mac OS X]] |
| | * [[#Backup and Restore|Backup and Restore]] |
| | | |
| | * Following [[Sugar on a Stick/Downloads|download]], ''Sugar on a Stick'' may be [[Sugar_on_a_Stick/Installation|Installed]] (instructions here), then [[Sugar on a Stick/Boot|booted]]. |
| | * Then you are ready to [[Getting Started/Explore|start exploring Sugar]]. |
| | |} |
| ==SoaS installation on USB/SD devices== | | ==SoaS installation on USB/SD devices== |
| | {{:Sugar on a Stick/Windows}} |
|
| |
|
| ===with Microsoft Windows===
| |
| * Either use '''Fedora Live USB Creator'''
| |
| *# Download the Live USB Creator from [http://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].
| |
| *# Insert a USB flash drive (or SD Card) with 1 GB or more of free space into your computer. (See [[LiveOS image]] and [[Sugar on a Stick/Installation/Variations#Cautions with using Live USB devices|Cautions with using Live USB devices]] regarding flash drive size and usage.)
| |
| *# Launch Live USB Creator.
| |
| *# Select the 'Browse' button to 'Use existing Live CD' and find the downloaded .iso file image on your system.
| |
| *# Adjust the Persistent Storage slider. This enables you to save changes to the system and additional Sugar Activities 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 Live USB Creator program.
| |
| *# Stop your flash drive using the '''Safely Remove Hardware''' dialog, and eject it.
| |
| :'''Note:''' The above installation method does not allow the full [[LiveOS image|optimization]] of data storage that comes from installing a separate, persistent home directory—see the alternate method below.
| |
| * or '''Burn a CD-ROM disc''' with the soas-mirabelle.iso file.
| |
| *# Use [http://windowsteamblog.com/blogs/windowsexperience/archive/2009/04/13/burn-iso-images-natively-in-windows-7.aspx Windows 7 built-in Disk Image Burner] or a free utility, like [http://www.imgburn.com/ ImgBurn], to write the downloaded SoaS.iso file onto a blank CD.
| |
| *# Insert a USB flash drive (or SD Card) with 1 GB or more of free space into your computer. (See [[LiveOS image]] and [[Sugar on a Stick/Installation/Variations#Cautions with using Live USB devices|Cautions with using Live USB devices]] regarding flash drive size and usage.)
| |
| *# Boot your computer with the CD-ROM disc. You probably need to press F1, F12, Esc, or a similar key as the computer starts up to adjust the boot source to the CD-ROM device.
| |
| *# A successful boot will take you into ''Sugar on a Stick Mirabelle''. From there, open the Terminal Activity, [[File:Activity-terminal.png|bottom|link=http://en.flossmanuals.net/terminal]], from the Home view.<br>{{Iframe|[http://en.flossmanuals.net/terminal ''See the Terminal Activity manual.''] |http://en.flossmanuals.net/terminal|900|400|1}}
| |
| *# Click the 'Become root' icon, [[File:Activity-become-root.svg|40px|bottom|link=http://en.flossmanuals.net/terminal]], to gain administrative permissions in the Terminal session.
| |
| *# Change the working directory to {{Code|/LiveOS/}}<br>{{Code|cd /LiveOS/}}
| |
| *# execute the Linux command line:<br>{{Code|./livecd-iso-to-disk --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /dev/live /dev/sd'''?'''1}}
| |
| :: ''Be certain of your USB/SD '''s'''csi '''d'''rive node name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,'' {{Code|/dev/sdb1}}. ''Use the mount command to confirm it before executing the script.''
| |
| :'''Note:''' Every ''[[Sugar on a Stick/Mirabelle|Mirabelle]] or [[Sugar on a Stick/Strawberry|Strawberry]] Sugar on a Stick'' can copy its original installation to another USB stick or SD card by following the above instructions. See [[Sugar on a Stick/Sugar Clone]] for instructions on how to customize the contents of a Sugar on a Stick device.
| |
| * or '''Launch a virtual machine''', such as VirtualBox with the soas-mirabelle.iso file.
| |
| *: See [[#SoaS on VirtualBox|SoaS on VirtualBox]] below.
| |
|
| |
|
| ===with Apple Macintosh=== | | ===with Apple Macintosh=== |
| * See and adapt the instructions at [[Sugar on a Stick/Mac]]. | | [[File:Apple.gif|link=Macintosh]] |
| | * See and adapt the instructions at [[Macintosh]]. |
| | ===='''Fedora 15 and Fedora 16'''==== |
| | * Sugar on a Stick CD boots in a Mac - [[Testing/Reports/Sugar on a Stick#MacBook Pro i7 CD Boot]] |
| | : The following work on some Intel MacBooks |
| | :: Persistent USB for Mac - [[Testing/Reports/Sugar on a Stick#MacBook Persistent SoaS v5 and SoaS v6 EFI Boot USB]] |
| | ::dd writable USB.img - [[Testing/Reports/Sugar_on_a_Stick#dd_writable_1_GB_EFI_Boot_.28MAC.29_USB_Soas-v6-Pineapple_x86-USB_.img]] |
| | |
| | |
| ===with GNU/Linux=== | | ===with GNU/Linux=== |
| <ol start="0"> | | <span class="linkgroup">[[File:Gnulinux.png|link=Sugar on a Stick/Linux]]</span> |
| <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>
| | {{:Sugar on a Stick/Linux/Installation}} |
| <li>Execute, as the root user, in <u>one</u> command with arguments, the following:<br>
| | :: (See [[Sugar on a Stick/Linux]] for more details.) |
| {{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> | | :'''Note''': The graphical Liveusb-creator is an alternative installation method (see the first Windows [[#with Microsoft Windows |method]]), but it does not create the separate home.img filesystem, and so, the write-once persistent storage on the disk is more quickly consumed (see [[LiveOS image]]). If the USB device does not boot after running Liveusb-creator, the command {{Code|liveusb-creator --reset-mbr}} may help. |
| : 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'''csi '''d'''rive 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| 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.
| | === Sugar on a Stick on Raspberry Pi 2/3 === |
| | {{:Sugar on a Stick/Raspberry Pi}} |
|
| |
|
| It is OK to use this media.
| | === on an OLPC XO === |
| | [[File:OLPCXO.png|link=Testing/Reports/Sugar on a Stick#F16 SoaS Pineapple USB boot image for XO-1|50px]] |
| | * See [[Testing/Reports/Sugar on a Stick#F16 SoaS Pineapple USB boot image for XO-1|F16 SoaS Pineapple USB boot image for XO-1]] |
| | : Very slow but works |
|
| |
|
| Copying live image to USB stick
| | ==Hard disk and alternate USB stick installations== |
| Updating boot config file
| | ====[[Tutorials/Installation/Install with netinstall|with a Netinstall CD]]==== |
| Initializing persistent overlay file
| | * Fedora with the Sugar graphical environment |
| 200+0 records in
| | * Installs to a hard disk or to a 4 GB USB stick (not a LiveOS image like SoaS, but all of Sugar). |
| 200+0 records out
| | : {{Highlight|bgcolor=#f9f6b7|''This requires a high-speed Internet connection for software component downloading during installation.''}} |
| 209715200 bytes (210 MB) copied, 16.6121 s, 12.6 MB/s
| | ====[[Tutorials/Installation/Install with liveinst|with the {{Code|liveinst}} command]]==== |
| Initializing persistent /home
| | : '''..from a booted Fedora 16 SoaS Live CD/USB''' |
| 200+0 records in
| | * Installs to a hard disk or a 4 GB USB stick. You start with a SoaS LiveOS image, and then load an uncompressed version onto the hard disk or USB stick. |
| 200+0 records out
| | : The Fedora-16-Live-SoaS.iso file is a 443 MB download. |
| 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
| | ==SoaS on VirtualBox== |
| 180 days, whichever comes first. Use tune2fs -c or -i to override.
| | <noinclude>{{Transclude|VirtualBox|note= See instructions from the [[VirtualBox]] page (transcluded here): |collapsed=collapsed}}</noinclude><includeonly> |
| tune2fs 1.41.10 (10-Feb-2009)
| | * See [[VirtualBox]]</includeonly> |
| 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.
| | = Chat room help = |
| :*: [[Talk:Downloads]] and [[LiveOS image]] have more information on this and other installation options.
| | *'''[http://webchat.freenode.net/?randomnick=1&channels=sugar&prompt=1 Sugar chat room in English]''' |
| :* 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==
| | *'''[http://webchat.freenode.net/?randomnick=1&channels=sugar-es&prompt=1 Sugar chat room in Español]''' (with translations to English) |
| {{Transclude|VirtualBox|note= See instructions from the [[VirtualBox]] page (transcluded here): |collapsed=collapsed}}
| | *: Pida ayuda a través de este canal #sugar-es Por favor, sea cortés y hacer sus preguntas.<br>Los voluntarios no pueden estar en línea todo el tiempo.<br>Sea paciente y permanecer conectado durante varios minutos para ver su respuest. |
| == Backup and Restore ==
| | *::(Utilizar la función de meeting para la traducción de estos artículos.) |
| | |
| | |
| | = Backup and Restore = |
| Some backup and restore options for Sugar on a Stick include the following: | | Some backup and restore options for Sugar on a Stick include the following: |
| | * [http://activities.sugarlabs.org/en-US/sugar/addon/4326 Backup] and [http://activities.sugarlabs.org/en-US/sugar/addon/4327 Restore] - these are Activities that can be used on any Sugar installation to backup or restore the Sugar Journal. |
| | |
| * [[olpc:School Server]] - requires a server installation. | | * [[olpc:School Server]] - requires a server installation. |
| * [[Sugar on a Stick/deja-dup]]
| | * [[Sugar on a Stick/Sugar Clone]] - full image (operating system and home folder) cloning. |
| * [[Sugar on a Stick/Sugar Clone]] | |
|
| |
|
|
| |
|
| ==Subpage index==
| | =Subpage index= |
|
| |
|
| {{Special:PrefixIndex/Sugar on a Stick/Installation/}} | | {{Special:PrefixIndex/Sugar on a Stick/Installation/}} |