Sugar Creation Kit

From Sugar Labs
Revision as of 04:43, 13 March 2011 by Satellit (talk | contribs) (→‎Activities: Activities_OLPCAU_10.1.3)
Jump to navigation Jump to search


Sugar Creation Kit DVD

A complete DVD containing all the resources required to create all 3 versions of Sugar-on-a-Stick without requiring Internet access.

Uses:

  • "sneakernet" or behind firewall at school.
  • save bandwidth on servers.
  • download once and distribute copies locally.

Get Sugar

Chat room Help

click this link^ to enter chat
  • NOTE: there are 4 channels on IRC: #sugar; #sugar-es; #sugar-it; #sugar-de
dogi has set up these channels which use MEETING to do translations between them. (02/28/2011)
to join enter this in command line of IRC: /join #sugar-it ; /join #sugar-de
Pida ayuda a través de este canal #sugar-es Por favor, sea cortés y hacer sus preguntas.
Los voluntarios no pueden estar en línea todo el tiempo.
Sea paciente y permanecer conectado durante varios minutos para ver su respuest
(utilizar la función de meeting para la traducción de estos artículos)
  • Ask for help on these IRC channels by clicking on either of the above links (English or Spanish)
Please be courteous and ask your questions.
Volunteers may not be on line all of the time. Be patient and stay connected for several minutes to see their answer.

Communication channels

Mailing Lists; IRC; Blogs; Forums; Jabber Networks; Video; Contacts; Mail.

Meetbot

Provides translation between IRC Channels

Community Distributions

Linux distributions where sugar is used
Fedora F13 SoaS, F14 SoaS, How to install Sugar packages
Trisquel Tris 4.0 Ubuntu 10.04LTS; Tris 4.5 Ubuntu 10.10; Sugar sweets 0.88.1 or 0.90.1
Mandriva 2010.2 mandriva sugar 0.88.0
Debian Debian 6 Sugar 0.88.1
Linux Mint Debian Debian 6 Sugar 0.88.1
Linux Caixa Magica based on mandriva 2010.1 repositories sugar 0.88.0
Ubuntu Sugar sweets 0.88.1 or 0.90.1
OpenSUSE

ON-LINE VERSION

An expanded and enhanced listing of Items Included in the SugarCreationKit DVD ver 1.2.3 (see Above)
NOTE: There are newer and additional items on this web page that are not in the SCK DVD.iso

Use to Download the elements you need and burn to your own DVD to save Downloading all of the above SCK DVD.iso

Look below to the References section to see how to then convert your customized DVD to an .iso
(revised 12/20/2010) satellit

Introduction

Sugar on a Stick (READ THIS FIRST) - AN Introduction to Sugar on a Stick

Cautions with using Live USB's.pdf

How to Make a live USB.pdf:

How to use Sugar on a Stick

  1. Download
  2. Install
  3. Boot
  4. Use

Hardware Compatibility

EeePC :http://fedoraproject.org/wiki/EeePc
smolt profiles:http://www.smolts.org/
http://smolts.org/smolt-wiki/Main_Page#Usage

Soas v4 Mango Lassi

(The current version of Sugar on a Stick)
(Burn the .iso to a CD and Boot with the resulting CD)
  • Activities Compatible with Mango Lassi & Mirabelle
Editable Listing of Activity Compatibility Features/Soas_V4/ASLOxo Activity Test Table Please Use this wiki page to report your findings

SoaS v3 Mirabelle

(Burn the .iso to a CD and Boot with the resulting CD)

Index of Sugar Labs Archive

  • click above link ^

ASLOxo-5.iso

  • click above link ^
New: Updated activities through 02/08/2011 (satellit )
  • These can be copied to a 2-GB USB device and drag-­dropped into the Sugar Journal to install them.

Activities

Mirabelle DVD covers and artwork

CD labels to print
  • Sugar on a stick Mirabelle.png (Mirabelle 4 stick Logo ) 300px-SugaronastickMirabelle.png

Expert install methods

Use "dd" command
click this link ^ for more details and examples
to make an install USB from a liveCD .iso file
  • Great for netbooks
Use (live).iso and terminal to make bootable USB
Use to install to HD or USB without needing a DVD/CD ROM
  • VERY DANGEROUS
For Advanced Users
You can destroy all the data and programs on your hard disk if you enter the wrong letter in (X) of=/dev/sd(X)
Use "mount" command in terminal and look for the correct USB name ie /dev/sdb;/dev/sdc/;/dev/sdd etc
Enter the root terminal with "su" (Fedora) or "sudo su" (Ubuntu) command
  • Sample Build:
dd if=Fedora-13-i686-Live.iso of=/dev/sd(X)
1384448+0 records in
1384448+0 records out
708837376 bytes (709 MB) copied, 194.409 s, 3.6 MB/s

Floss Manuals

(Important Manuals on how to use Sugar Applications and Features)

READ THESE FIRST!
(Local copies of the.pdf files shown below:)
  • Source Links:
Introduction to Sugar http://en.flossmanuals.net/sugar
MakeYourOwnSugarActivities Internet Archive Publishing Quality
In PDF, EPUB, Kindle, Daisy, Full Text. DjVu formats
MakeYourOwnSugarActivities-es with corrected index
Browse http://en.flossmanuals.net/browse
Chat http://en.flossmanuals.net/chat
Collaboration http://en.flossmanuals.net/collaborativefutures/
SugarCollaboration http://en.flossmanuals.net/ActivitiesGuideSugar/SugarCollaboration
FunWithTheJournal http://en.flossmanuals.net/ActivitiesGuideSugar/FunWithTheJournal
Linux Command Line http://en.flossmanuals.net/CommandLineIntro/Introduction#
ActivitiesGuideSugar-English http://en.flossmanuals.net/ActivitiesGuideSugar/Introduction
Record http://en.flossmanuals.net/record
The Terminal http://en.flossmanuals.net/terminal
Turtle Art http://en.flossmanuals.net/turtleart
Write http://en.flossmanuals.net/write_activity
Reading And Leading With One Laptop Per Child http://en.flossmanuals.net/ReadingandSugar/Introduction
Text to Speech: http://en.flossmanuals.net/ActivitiesGuideSugar/TextToSpeech

References

  • How to make your own custom Sugar-Creation_Kit.iso file (How this DVD was converted to an .iso file)
    1. Collect, annotate and sort the files you want in a folder on your Desktop.
    2. Burn the contents of this folder to a CD or DVD.
    3. Use the following command in Terminal as the root user:
      dd if=/dev/sr0 of=Sugar-Creation-Kit.iso
    Sample output:
         dd if=/dev/sr0 of=Sugar-Creation-Kit.iso
 5555584+0 records in
 5555584+0 records out
 2844459008 bytes (2.8 GB) copied, 232.86 s, 12.2 MB/s
  • the resulting .iso file can be sent over the internet or used to make copies by burning to a DVD
  • How To Sugarize a Program
Instructions on how to make a program appear in the (F3) Home view of Sugar as an icon
http://people.sugarlabs.org/Tgillard/sugarize/wiki-sugarize.txt
Running Linux Applications Under Sugar

The Undiscoverable

(The Undiscoverable Features of Sugar)
Features and tips not easily discovered about using Sugar

E-books

Graphic installers

Liveusb Creator
Fedora and Windows (BEST METHOD TO USE)
liveusb-creator Digest, Vol 28, Issue 6
Message: 2
Date: Mon, 24 Jan 2011 23:02:46 -0500
From: Luke Macken <lmacken@redhat.com>
Subject: [ANNOUNCE] liveusb-creator 3.10.0 Windows release
To: liveusb-creator@lists.fedorahosted.org
Message-ID: <20110125040246.GD16772@tomservo.cable.rcn.com>
Content-Type: text/plain; charset=us-ascii
liveusb-creator 3.10.0 Windows Release 

https://fedorahosted.org/releases/l/i/liveusb-creator/liveusb-creator-3.10.0-setup.exe

* Changes Install the Microsoft Visual C++ Redistributable Package, if neccessary, to
  get the liveusb-creator running on more versions of Windows.
*Tickets Fixed  Live USB Creator (3.9.3) doesn't run on Windows XP
  https://fedorahosted.org/liveusb-creator/ticket/793

[SoaS] SoaS windows USB builder
01:14 PM 01/21/2011
Kevin Gordon
Folks:
It would appear that the fix which now allows the Fedora Windows USB builder
to now correctly create a bootable USB stick of the most recent F14 based
SoaS USB (with syslinux 4.03),  the app now no longer properlry creates the
previous SoaS versions (the berries) from the spin ISO's, that will boot.
Workaround appears to be to use the same methodology as before but in the
case where one wants to create older version bootable usb's,  one now
manually copies an  *older* 3xx syslinux into the windows working directory
before doing the build
Full instructions for this method are listed in this SoaS digest in previous
posts.  If one didn't keep their old syslinux, its available in the archives
at http://www.kernel.org/pub/linux/utils/boot/syslinux/
ZyX-LiveInstaller
UNetbootin
pendrivelinux
openSUSE Live USB stick
Multisystem LiveUSB

Multisystem enables a LiveUSB to do everything, ideal for exploring different Linux distributions without installing on your PC, or to install the Linux distribution of your choice on your PC much faster than via a LiveCD by using fast USB 2.0 ports.

Essential for the current range of netbooks that have no CD drive.

Ideal for any geek, anyone doing maintenance, keep your USB key with you always, and be ready for use in wherever you are with friends in a cafe, ...

  • Multisystem is a free software developed under GPL-V3 written in bash / gtkdialog for creating USB sticks MultiBoot.
(in French with google translations on some pages)
Multisystem LiveUSB Web Page
Supported Systems
Supported Systems pdf with links
Plop Linux

Plop Linux is a small distribution that can boot from CD, DVD, USB flash drive (UFD), USB harddisk or from network with PXE. It's designed to rescue data from a damaged system, backup and restore operating systems, automate tasks and more.

GPL2 http://www.plop.at/de/ploplinuxdl.html
  • Instructions to build a Custom bootable CD/USB with your files on it.
http://www.plop.at/en/ploplinux.html#licreatenewiso

SoaS installation variations

soas­-2-­blueberry-direct-­cleared­3GB.img.xz - Non­-live EXT3 file structured USB Image file, How to USE and How it was Made (ADVANCED)]
Building a bootable USB
(tested on a MacBook Air)
1 Boot Intel Mac
Download Soas-v4 Fedora-14-x86_64-Live-SoaS Download
Download Soas-v3 soas-3-mirabelle Download
Copy them to a USB for transfer later (see below)
2 Format a 2nd Target USB (2GB) in OSX Disk utility
Insert Target USB
start Disk Utility
highlight the target USB in left column of OSX Disk Utility
Click on erase; select fat16; Name FEDORA; hit return
3 Burn USB
Start Oracle VirtualBox for OSX VirtualBox-3.2.10-66523-OSX.dmg Download
TO download F14: Fedora-14-x86_64-Live-Desktop Download
Start the F14 Desktop you have installed to VirtualBox
Insert USB that contains: Fedora-14-x86_64-Live-SoaS.iso and soas-3-mirabelle.iso
Copy them to running f14-Desktop in VirtualBox
4 Start liveusb-creator (To install liveusb-creator; In Terminal:"yum install liveusb-creator)
<Browse>/Desktop/ Fedora-14-x86_64-Live-SoaS.iso or soas-3-mirabelle.iso
<Target Device> /dev/sdb1 (FEDORA)
<Persistent Storage> choose 900 MB
<Create Live USB>
5 Shutdown Fedora 14 in VirtualBox; Close VirtualBox Program; Shutdown Mac.
6 Insert Soas-4-boot-test CD in USB DVD/CD; Plug in Live USB you just built
soas-4-boot-test Download
OR Make a rEFIt Boot CD:
Here is a simple way to recognize a bootable USB on a Mac.

Go to rEFIt (http://refit.sourceforge.net/) and make a bootable cd. "There is no need to install rEFIt on your mac. In fact installing rEFIt may make it impossible to upgrade the Mac OS to a newer version later on (personal experience, I had to do a clean install). Put the rEFIt CD[1] in and hold the option key after turning the computer on. The Mac will recognize the CD because it uses EFI and then the CD will recognize the bootable USB."[2]

[1] How to Burn a rEFIt CD (You can rename the .cdr file to .iso for use in linux.)

[2] Downloads#Apple Mac OS X

7 Boot from Soas-4-boot-test helper CD
Hold down "C" key and do not release until Fedora Blue "soas-boot" screen appears
It may take 10-15 seconds
Select "Boot with basic video driver"
Hit return
  • Congratulations Your Live USB should Boot and run Sugar on a Stick from the live USB with persistence
  • Notes:
  1. Wireless connection does not work. Use an USB Ethernet Adapter for Internet Connectivity
  2. you can eject a USB CD/DVD drive, if used (In bottom right of sugar frame) and unplug the CD/DVD USB connector from the Mac. It will not be needed until next time you boot the Live USB
  3. Note Do Not try to Boot this USB outside of intel MAC with boot disk It becomes corrupted if boot is attempted as standalone Live Soas in a Netbook
Boot Helper CD's
  • MAC SOAS-3 Mirabelle Boot DISK
soas-3-boot-test.iso (Burn this to a CD and boot with it)
Read Me First & Credits to Programmer
  • MAC SOAS-4 Mango Lassi Boot DISK
soas-4-boot-test (Burn this to a CD and boot with it)
  • rEFIt
rEFIt
burn a bootable rEFIt CD on Mac OS X Used to Boot live USB's in a Mac
rEFIt is a boot menu and maintenance toolkit for EFI-based machines like the Intel Macs.
You can use it to boot multiple operating systems easily, including triple-boot setups with Boot Camp.
It also provides an easy way to enter and explore the EFI pre-boot environment.

Backup and Restore

QEMU Virtualization

  • f12 AND F13
In Gnome terminal:
su
yum install @virtualization
Start (Graphical): Applications/System Tools/Virtual Machine Manager
  • installs soas.iso files to VM HD (with liveinst command in terminal of running Virtual Machine)

ALSO See: QEMU

VMware Player Virtualization

Download VMware Player (free)

VMware Player Appliances

  • VMware Player appliance of soas-v3-Mirabelle
Compressed in .zip file
Download
This appliance is ready to run "firstboot" (agree/user name/password/tz/etc)
sugarroot is the root password.
  • VMware Player appliance Trisquel-3 (NEW) 01/05/2011
Compressed in .zip file
download
User=sugar
Password=sugaruser
  • VMware Player appliance Trisquel-4+sugar (NEW) 01/05/2011
Compressed in .zip file
download
User=sugar
Password=sugaruser
  • VMware Player appliance Sugar on a Stick v2 (Blueberry)
Read this first.
download
  • VMware Player appliance of openSUSE-Sugar
Read this first.
download
networking help
how to use

VirtualBox Virtualization

With VirtualBox® one can run Sugar in a window on Microsoft Windows, Intel-based Apple Macintosh, or Linux host computers from a virtual machine (VM) window. VirtualBox overview

  • VirtualBox
  • A good solution for Macintosh computers
Trisquel41_sugar_installer.iso
Revised 03/02/2011 to remove sugar identity
RECOMMENDED
  • click above link^ to download 1.1GB DVD which contains
32bit-VirtualBox Installers (OSE) (Directory with install files for VirtualBox 4.0.4)
(Does not include Free for Personal Use licensed extension pack) - includes instructions on how to download for personal use.
ReadMeFirst_Install_Instructions.pdf  (Instructions-how to install VirtualBox and import appliance)
trisquel-sugar-4.1-i686-feb18.ovf
trisquel-sugar-4.1-i686-feb18-disk1.vmdk
UserManual.pdf (VirtualBox 4.0.4 User Manual-269 pages)
Instructions and .vmdk/.ovf files to import
  • Cleared of sugar identity Starts on Color Selection Screen ( <===(back) to change name)

Template:Admon/note


This DVD.iso is a great way to "SneakerNet" distribute this VM Appliance

VirtualBox Appliances

  • click above link ^ to see a complete listing of Prebuilt VirtualBox Appliances

Trisquel-4.1-sugar

(click this ^ link for details)
RECOMMENDED
  • Sugar sweets 0.88.1
  • Cleared of sugar identity Starts on Color Selection Screen ( <===(back) to change name) 03/02/2011


  • Appliance of Sugar on a Stick v3-Mirabelle
firstboot has not yet run; so a new user name and password will be set for the gdm login on startup for the first time
How Built:
root=sugarroot
8-GB VirtualBox hard disc
English and English keyboard
USA-Los Angeles (Pacific timezone)
download and import 2 files:
http://download.sugarlabs.org/images/VirtualBox/Fedora-13-i686-Live-SoaS-sugaruser.vmdk 533M
http://download.sugarlabs.org/images/VirtualBox/Fedora-13-i686-Live-SoaS-sugaruser.ovf   12K
  • Note1:Use the latest version of Oracle VM VirtualBox (3.2_10.8-64453 or later). Some appliances have multiple hard disc controllers and the earlier Sun VirtualBox 3.1 version does not support them.
  • Note2: All appliances were built on a MacBook Air with Oracle VM VirtualBox (3.2.10-r66523) then tested on a Ubuntu installation on an Acer Aspire One Netbook imported into VirtualBox (3.2.10 r66523)
  • Note3:Set ControlPanel/Frame "Edge" slider to far left for easier access to sugar-frame features


  • Appliance of Soas-v2 Blueberry
READ FIRST: http://people.sugarlabs.org/Tgillard/soas-2-blueberry_ovf_README_FIRST.txt
Download these three files:
http://people.sugarlabs.org/Tgillard/soas-2-blueberry.vmdk
http://people.sugarlabs.org/Tgillard/soas-2-blueberry.ovf
http://people.sugarlabs.org/Tgillard/soas-2-blueberry.mf

Sugar Clone

customize or duplicate Live USB installations
(script files for making a customized Live USB installation self­-replicating)
Update: http://www.mail-archive.com/soas@lists.sugarlabs.org/msg02044.html
Rebuild/Refresh a custom SoaS iso from a running stick
Possible Use Cases

(from Wiki Page)

Curriculum packaging
  1. A teacher wants to prepare a SoaS image with a custom set of installed Activity bundles or a Journal of Activity instances for an upcoming class term.
  2. The teacher modifies their current working image by adding or deleting Activity bundles from their Home view and adding or removing Journal entries with specific content
   (such as a Physics model template or Etoys project), even saving distributable ebooks, or bookmarks in Browse Activity instances that are named for specific sets of local web destinations
   (a class portal perhaps for deployments lacking Internet connectivity).
  3. The teacher scrubs out any personal passwords or other history that should not be shared in the new copies.
  4. A fresh or recycled USB stick is inserted into the computer running the customized SoaS image and the SugarClone script is executed.
Full image backup or sharing
  1. A Learner has modified their environment, perhaps adding Activity bundles and prepared specific instances such as a Activities/Physics simulation.
  2. Their modifications include changes to their operating system installed through yum or RPM to obtain some new core functionality.
  3. The Learner wants to archive or share this image with friends or for a backup.
  4. Personal or private information is scrubbed from the Journal or Browse history and other potential stores.
  5. The User creates one or more Sugar Clones.

This method of backup has the advantage that it copies Learner changes to the core operating system as well as the Journal. A LiveOS image using a separate persistent home folder could be partially cloned with either the operating system overlay or home folder without the other should that be desired.

Build Your Own Remix with Fedora (Advanced)

  • click above link^
Make your own Custom CD/DVD.iso with a customized kickstart file
  • Links to Trisquel, Debian and Mandriva on how to remix Live CD's
http://trisquel.info/en/wiki/customizing-trisquel-iso
http://wiki.debian.org/DebianCustomCD
http://wiki.mandriva.com/en/Draklive

XO-1 & XO-1.5

http://wiki.laptop.org/go/OS_images
http://wiki.sugarlabs.org/go/Dextrose
http://build.laptop.org/11.2.0/os9/xo-1.5/

Fedora Sugar Bugs

Sugar Bugs

  • Sugar on a Stick
Sugar on a Stick Bugs
  • Soas-Sugar
http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=new&status=reopened&groupdesc=1&group=milestone&component=SoaS&order=priority&col=id&col=summary&col=component&col=status&col=type&col=priority&col=milestone&col=reporter&col=time&col=changetime (fgrose)
  • 0.90-olpc
http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=new&status=reopened&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component&keywords=~olpc-0.90 (pbrobinson)
Retrieved from "https://wiki.sugarlabs.org/index.php?title=Sugar_Creation_Kit&oldid=63509"