Difference between revisions of "Sugar on a Stick/Installation"
Line 21: | Line 21: | ||
*# 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.) | *# 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. | *# 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| | + | *# 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|945|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. | *# 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/}} | *# Change the working directory to {{Code|/LiveOS/}}<br>{{Code|cd /LiveOS/}} |
Revision as of 23:09, 25 May 2010
SoaS installation on USB/SD devices
with Microsoft Windows
- Either use Fedora Live USB Creator
- Download the Live USB Creator from 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 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 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 Windows 7 built-in Disk Image Burner or a free utility, like 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 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, , from the Home view.
- Click the 'Become root' icon, , to gain administrative permissions in the Terminal session.
- Change the working directory to
/LiveOS/
cd /LiveOS/
- execute the Linux command line:
./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 scsi drive node name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,
/dev/sdb1
. Use the mount command to confirm it before executing the script.
- Be certain of your USB/SD scsi drive node name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,
- Note: Every Mirabelle or 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 below.
with Apple Macintosh
- See and adapt the instructions at Sugar on a Stick/Mac.
with GNU/Linux
- Use this script file http://bit.ly/livecd-iso-to-disk to create a bootable image.
(Runchmod +x livecd-iso-to-disk.sh
after you download the script to make it executable.) - Execute, as the root user, in one command with arguments, the following:
./livecd-iso-to-disk.sh --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /path/to/source.iso /dev/sd?1
- where '
?
' in the final parameter represents the target bootable device node, such assdb1
orsdc1
, etc.
- Use the
df -Th
command to confirm your devices before executing the script.
- where '
[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
- where the mount point and filesystem sizes should help you identify what you want.
[root@MyComputer ~]# ./livecd-iso-to-disk.sh --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /mnt/VMs/soas-x86_64-20100509.09.iso /dev/sdb1 Verifying image... /mnt/VMs/soas-x86_64-20100509.09.iso: 7c5f3227e4d87bb03f1cf89415ee80ce Fragment sums: b68ffc49a1213bca823fd5f16887291c571b44d55755488b3c229dafb631 Fragment count: 20 Checking: 100.0% The media check is complete, the result is: PASS. It is OK to use this media. Copying live image to USB stick Updating boot config file Initializing persistent overlay file 200+0 records in 200+0 records out 209715200 bytes (210 MB) copied, 16.6121 s, 12.6 MB/s Initializing persistent /home 200+0 records in 200+0 records out 209715200 bytes (210 MB) copied, 15.2779 s, 13.7 MB/s Formatting unencrypted /home mke2fs 1.41.10 (10-Feb-2009) Filesystem label= OS type: Linux Block size=1024 (log=0) Fragment size=1024 (log=0) Stride=0 blocks, Stripe width=0 blocks 51200 inodes, 204800 blocks 10240 blocks (5.00%) reserved for the super user First data block=1 Maximum filesystem blocks=67371008 25 block groups 8192 blocks per group, 8192 fragments per group 2048 inodes per group Superblock backups stored on blocks: 8193, 24577, 40961, 57345, 73729 Writing inode tables: done Creating journal (4096 blocks): done Writing superblocks and filesystem accounting information: done This filesystem will be automatically checked every 23 mounts or 180 days, whichever comes first. Use tune2fs -c or -i to override. tune2fs 1.41.10 (10-Feb-2009) Setting maximal mount count to -1 Setting interval between checks to 0 seconds Installing boot loader USB stick set up as live image!
SoaS on VirtualBox
VirtualBox
With VirtualBox® one can run Sugar on Microsoft Windows, Intel-based Apple Macintosh, or GNU/Linux host computers from within a virtual machine window.
See this VirtualBox overview. VirtualBox is a large software installation with many features and operating system options. A User Manual and other documentation is available online. Those who have not used VirtualBox before, might find it more easy to understand and install than expected.
VirtualBox Downloads: https://www.virtualbox.org/wiki/Downloads
(See VirtualBox/Technical for some collected details.)
The following instructions are intended for those Learners interested in using VirtualBox to run Sugar. The process is not fully mature as the technology is evolving both in the VirtualBox and operating system software.
- Online IRC support is available from http://www.virtualbox.org/wiki/IRC
- Various VirtualBox experiments may be found on the discussion page.
Install VirtualBox
on Mac OS X
Follow the instructions on the VirtualBox Downloads page for Mac OS X.
on Microsoft Windows
- Download from http://www.virtualbox.org/wiki/Downloads.
on GNU/Linux
Use the VirtualBox packages available in your GNU/Linux distribution. For example, on Ubuntu, it is available in Ubuntu Software Centre.
Or, use the most recent packages from VirtualBox, see Linux Downloads.
Also, see Talk:VirtualBox page for experimental installation variations.
Setup a Virtual Machine for Sugar on a Stick
Notice: Prebuilt VirtualBox 4.1 Appliances are available. Just click "import" on one of the .vmdk or .ovf files.
- One may also use these instructions, VirtualBox/Preparing a disk image, to prepare one's own.
- In VirtualBox click New
- Click Next
- Enter a name "Sugar"
- Operating System: choose Linux
- Version: choose Fedora
- Click Next
- For memory leave 256 MB
- Click Next
- Virtual Hard Disk click Existing
- Click the little folder to the right of the selection box
- A new window pops up
- Click Add button in the toolbar
- Browse to the location where you extracted the .vdi disk image
- Click Open
- Click Select
- Click Next
- Click Finish
- Select Sugar on the left
- Click Start in the toolbar
- After a minute or two you should see the Sugar screen asking for you name
- Enter your name
- Click Done at the bottom of the window. You might have to scroll.
- From now on you can start VirtualBox and start the "Sugar" virtual machine
Setup a Virtual Machine for Ubuntu Sugar
Use Ubuntu Software Centre to install the virtualbox-guest-utils package, so that your virtual machine display can be resized to fit your computer.
Issues
- Activating the Frame might be a little difficult. The lower 2 corners are easiest and you may want to configure edge activation in the My Settings > Frame panel. With VirtualBox Guest Additions installed (see here), only the bottom edge and corners are available for Frame activation.
- On Mac keyboards, you might wish to change the Virtual Box default key for switching the Sugar cursor to the normal one, as the default key (control right arrow on Mac keyboards) is trapped by Sugar. (Windows and Linux keyboards use Right Ctrl.) You may do this change in File/settings of the Virtual Box menu.
Resources
- http://www.virtualbox.org/
- OLPC:VirtualBox
- How To Install Virtualbox Guest Additions in Fedora Guest (Based on Fedora 8)
- install the virtualbox guest additions
- on Debian, Ubuntu, or derived distributions
Backup and Restore
Some backup and restore options for Sugar on a Stick include the following:
- olpc:School Server - requires a server installation.
- Sugar on a Stick/deja-dup
- Sugar on a Stick/Sugar Clone