Difference between revisions of "Sugar Creation Kit"

From Sugar Labs
Jump to navigation Jump to search
Line 98: Line 98:
 
* These can be copied to a 1-GB USB device and drag-­dropped into the Sugar Journal to install them.
 
* These can be copied to a 1-GB USB device and drag-­dropped into the Sugar Journal to install them.
 
====Activities====
 
====Activities====
'''listing:  [[Activities]]''' Descriptions
+
'''listing:  [[Activities]]''' Descriptions and Developer Pages
* Tests of Activities from ASLO [http://wiki.sugarlabs.org/go/Features/Soas_V4/ASLOxo_Activity_Test_Table#Activity_Test_Results]
 
  
 
=====Activity Links=====
 
=====Activity Links=====

Revision as of 05:22, 26 January 2011


Sugar Creation Kit DVD

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

SugarCreationKit-123.iso Caution 4.2 GB

SugarCreationKit-123.md5
List of Contents

Uses:

  • "sneakernet" or behind firewall at school.
  • should save bandwidth on servers.
  • Download 1 time and distribute copies Locally

Get Sugar

Join IRC for Help

Ask for help on this channel
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.

Community Distributions

Linux distributions where sugar is used

AN ON-LINE VERSION OF THE Sugar Creation Kit

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 [1] 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: http://wiki.sugarlabs.org/go/Downloads
  2. Installation: http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Installation
  3. Boot: http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Boot
  4. Usage: http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Usage

Hardware Compatibility

EeePC :http://fedoraproject.org/wiki/EeePc

Soas v4 Mango Lassi

(The current version of Sugar on a Stick)
(Burn the .iso to a CD and Boot with he resulting CD)
  • Activities Compatible with Mango Lassi & Mirabelle
Editable Listing of Activity Compatibility http://wiki.sugarlabs.org/go/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 Sugarlabs Archive(download)

http://download.sugarlabs.org/activities/ .xo activities by Number
http://download.sugarlabs.org/dextrose/
http://download.sugarlabs.org/docs/
http://download.sugarlabs.org/images/ SugarCreationKit-123.iso(DVD); ASLO-4.iso; VirtualBox Appliances,VMPlayer Appliances
http://download.sugarlabs.org/packages/
http://download.sugarlabs.org/services/
http://download.sugarlabs.org/soas/  Nightly-composes; Releases (soas-v1-3)
http://download.sugarlabs.org/sources/
http://download.sugarlabs.org/usr/ Ubuntu Sugar Remix Builds (Old)

ASLOxo-4.iso (140+Activities)

  • Contains about 140.xo Sugar­ Activity files from ASLO plus some extras
ASLO-4.iso 881M (DVD)
Including these NEW Programs:
OOo4Kids-1_0.9.5_en-US.xo (Open Office Suite) 113.3 MB http://wiki.ooo4kids.org/index.php/Main_Page
gcompris-15.xo (Suite of gcompris games) 62.9 MB
gcompris_administration-15.xo (for teacher control)
  • These can be copied to a 1-GB USB device and drag-­dropped into the Sugar Journal to install them.

Activities

listing: Activities Descriptions and Developer Pages

Activity Links
http://activities.sugarlabs.org//en-US/sugar/ ASLO site for downloading xx.xo files
http://activities.sugarlabs.org/ Activities by Number (with most old versions)
http://wiki.laptop.org/go/Activities (OLPC Listings)
http://oficina.paraguayeduca.org/~jsaldivar/activities/ bundled activities (paraguayeduca)
  • GCompris
http://activities.sugarlabs.org/en-US/sugar/addon/4313/ GCompris-15 activity
http://wiki.sugarlabs.org/go/Activities/GCompris Home Page
http://activities.sugarlabs.org/en-US/sugar/addon/4314/ Administration tool for GCompris activity (for Teachers)
http://wiki.sugarlabs.org/go/Activities/GCompris Home Page
http://download.ooo4kids.org/en/download-ooo4kids-XO
http://download.ooo4kids.org/en/node/1082/download/OOo4Kids1.0-en-es-fr.xo
http://download.ooo4kids.org/en/node/1083/download/OOo4Kids1.0-en-es-fr.xo.md5
  • Activities Index­Mirabell.ods (Included on DVD] OR
http://people.sugarlabs.org/Tgillard/Activities-Index-ASLO.ods (not being updated)
http://people.sugarlabs.org/Tgillard/Activities-Index-ASLO-f13-Mirabelle-f14-rawhide-Soas-tests.ods (more recent than on current DVD-not being updated)
Open Office Spreadsheet showing .xo File Compatibility with Mirabelle and earlier versions of SoaS.
Note: You can sort it, as it is a spreadsheet!

DVD covers and artwork

  • 220px-Mirabellen.jpg
  • 220px-Prunus_insititia_01.jpg

(from Wikipedia article) http://en.wikipedia.org/wiki/Mirabelle_plum

CD labels to print


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

Expert install methods

Technical Details
Use "dd" Command Make Install USB from live .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 your Hard Disk if you enter the letter in (X) of=/dev/sd(X) in error
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
http://wiki.sugarlabs.org/go/Running_Linux_Applications_Under_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

SoaS versions, Helper Boot Disks. and 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
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 USB 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 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
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: http://wiki.sugarlabs.org/go/QEMU

VMware Player Virtualization

Download VMware Player (free)

Prebuilt 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

"VirtualBox is a general-purpose full virtualizer for x86 hardware. Targeted at server, desktop and embedded use, it is now the only professional-quality virtualization solution that is also Open Source Software. "

  • A good solution for Macintosh Computers

Link: http://wiki.sugarlabs.org/go/VirtualBox

Prebuilt VirtualBox Appliances

>>>Follow this link for a complete listing of Prebuilt Virtualbox Appliances

  • 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)
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

Build_Your_Own_Remix_with_Fedora (Advanced)
Fedora only


Fedora Sugar Bugs

https://bugzilla.redhat.com/buglist.cgi?component=sugar&product=Fedora

Sugar Bugs

  • Sugar_on_a_Stick
http://wiki.sugarlabs.org/go/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 (fgross)
  • 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)