Sugar Creation Kit
Sugar Creation Kit DVD
Download: http://people.sugarlabs.org/Tgillard/SugarCreationKit-123.iso Caution 4.2 GB
- Complete DVD containing all the resources required to create all 3 versions of Sugar-on-a-Stick without requiring Internet access
- List of Contents: [1]
Uses:
- "sneakernet" or behind firewall at school.
- should save bandwidth on servers.
- Download 1 time and distribute copies Locally
INDEX OF Soas Features
- AN ON-LINE VERSION OF THE DVD
- An annotated listing of links to sources used in the SugarCreationKit DVD ver 1.2.3 (see Above)
- NOTE: There are newer plus additional items on this web page not included in the SCK DVD.iso
- Use to Download the elements you need and burn to your own DVD to save Dowloading all of the above SCK DVD.iso
- Look below to the References section [2] to see how to then convert your customized DVD to an .iso
- (revised 07/31/2010)
Introduction
Sugar on a Stick.pdf (READ THIS FIRST) - AN Introduction to Sugar on a Stick http://wiki.sugarlabs.org/go/Sugar_on_a_Stick
Cautions with using Live USB's.pdf Sugar on a Stick/Installation/Variations#Cautions with using Live USB devices
How to Make a live USB.pdf (instructions on how to make a live USB in Windows, GNU/Linux, and Intel Mac's) Sugar on a Stick/Installation#with Microsoft Windows
How to use Sugar on a Stick
- Download: http://wiki.sugarlabs.org/go/Downloads
- Installation: http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Installation
- Boot: http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Boot
- Usage: http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Usage
SoaS v3 Mirabelle
- (the current version of SoaS)
- Fedora13i686LiveSoaS.iso (Mirabelle .iso)http://wiki.sugarlabs.org/go/Downloads
- Fedora13x86_64LiveSoaS.iso (Mirabelle x86-64.iso)http://wiki.sugarlabs.org/go/Downloads
- (Burn the .iso to a CD and Boot with it)
- Activities Compatible with Mirabelle (Spreadsheet) +[3] needs updating
- Editable Listing of Activity Compatibility http://wiki.sugarlabs.org/go/Features/Soas_V4/ASLOxo_Activity_Test_Table Use to report your findings Current
ASLOxo3ss (140+Activities)
- Contains about 140.xo Sugar Activity files from ASLO plus some extras http://people.sugarlabs.org/Tgillard/ASLOxo-3ss.iso
- Including these NEW Programs: NOT ON DVD
- 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 IndexMirabell.ods (Included on DVD] OR
- http://people.sugarlabs.org/Tgillard/Activities-Index-ASLO.ods
- http://people.sugarlabs.org/Tgillard/Activities-Index-ASLO-f13-Mirabelle-f14-rawhide-Soas-tests.ods (more recent than on current DVD)
- Open Office Spreadsheet showing .xo File Compatibility with Mirabelle and earlier versions of SoaS.
- Note: You can sort it, as it is a spreadsheet!
- Note For Latest Activity Compatibility see:http://wiki.sugarlabs.org/go/Features/Soas_V4/ASLOxo_Activity_Test_Table#Activity_Test_Table_2
DVD covers and artwork
- 220px-Mirabellen.jpg
- 220px-Prunus_insititia_01.jpg
(from Wikipedia article) http://en.wikipedia.org/wiki/Mirabelle_plum
- 3892066169_dc33680a35_b.jpg
- Mirabelle Plums,txt (http://www.flickr.com/photos/enil/3892066169/)
- Flyer_englisch.pdf *http://people.sugarlabs.org/Tgillard/Flyer_englisch.pdf (Poster-Sugar Learning Program; 2-sided with text from past Show)
CD labels to print
- sugarlabs_SoaS-Creation-Kit_avery_cd_label_2up.eps
- sugarlabs_SoaS-Creation-Kit_avery_cd_label_2up.pdf http://people.sugarlabs.org/Tgillard/sugarlabs_SoaS-Creation-Kit_avery_cd_label_2up_Mirabelle.pdf
- sugarlabs_Sugar-demo_avery_cd_label_2up.eps
- sugarlabs_Sugar-demo_avery_cd_label_2up.pdf http://people.sugarlabs.org/Tgillard/sugarlabs_Sugar-demo_avery_cd_label_2up_Mirabelle.pdf
- Sugar on a stick Mirabelle.png ( Mirabelle 4 stick Logo )
Expert install methods
- How to install to a 4GB USB using liveinst (ANACONDA) from SoaS.pdf Talk:Sugar on a Stick/Blueberry#liveinst command to install to Hard-Disk.2FUSB from Soas CD
- Use livecd iso to disk script to write a live USB.pdf Sugar_on_a_Stick/Linux Fedora:How to create and use Live USB#Graphical Method - Windows or Fedora
- zyxliveinstaller Instructions.pdf Sugar on a Stick/ZyX-LiveInstaller
- zyxliveinstaller0.2.4-1.noarch.rpm http://people.sugarlabs.org/Tgillard/zyx-liveinstaller-0.2.4-1.noarch.rpm
Floss Manuals
(Important Manuals on how to use Sugar Applications and Features) http://en.flossmanuals.net/ http://en.flossmanuals.net/sugar
- Browse.pdf http://en.flossmanuals.net/browse
- Chat.pdf http://en.flossmanuals.net/chat
- Collaboration.pdf http://en.flossmanuals.net/collaborativefutures/
- Collaboration http://en.flossmanuals.net/ActivitiesGuideSugar/SugarCollaboration
- FunWithTheJournal.pdf http://en.flossmanuals.net/ActivitiesGuideSugar/FunWithTheJournal
- Linux Command Line.pdf http://en.flossmanuals.net/CommandLineIntro/Introduction#
- ActivitiesGuideSugar-English http://en.flossmanuals.net/ActivitiesGuideSugar/Introduction
- ActivitiesGuideSugar_Spanish http://translate.flossmanuals.net/ActivitiesGuideSugar_es/Introduction
- Record.pdf http://en.flossmanuals.net/record
- The Terminal.pdf http://en.flossmanuals.net/terminal
- Turtle Art.pdf http://en.flossmanuals.net/turtleart
- Write.pdf http://en.flossmanuals.net/write_activity
- Reading And Leading With One Laptop Per Child http://en.flossmanuals.net/ReadingandSugar/Introduction
References
- How to make your own custom iso file.pdf (How this DVD was converted to an .iso file)
- Collect, annotate and sort the files you want in a folder on your Desktop.
- Burn the contents of this folder to a CD or DVD.
- 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 .pdf (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
- PREPARATION OF AN OPERATIONAL SoaS USB KEY.pdf (Jean Thiéry [Jean.Thiery(ò)ModLibre.info][4] Member of OLPCFrance [5])
- The_Undiscoverable.pdf (The Undiscoverable Features of Sugar) The Undiscoverable
Activities
listing: Activities
- Tests of Activities from ASLO [6]
E-books
- http://wiki.sugarlabs.org/go/Education_Team/Creating_textbooks
- Reading And Leading With One Laptop Per Child http://en.flossmanuals.net/ReadingandSugar/Introduction
Graphic installers
Liveusb Creator
- how to create and use liveusb-creator fedora:FedoraLiveCD/USBHowTo fedora:How to create and use Live USB#Graphical Method - Windows or Fedora
- liveusbcreator3.9.1setup.exe (Windows)
- Liveusbcreator.pdf https://fedorahosted.org/liveusb-creator/
- liveusbcreator screenshots.pdf
- liveusbcreator3.9.tar.bz2 (GNU/Linux)
unetbootin
- unetbootinwindows471.exe http://unetbootin.sourceforge.net/unetbootin-windows-latest.exe
- unetbootinlinux471 http://unetbootin.sourceforge.net/unetbootin-linux-latest
- Unetbootin.pdf http://unetbootin.sourceforge.net/
- UnetbootinCommand_line.pdf (Advanced) http://sourceforge.net/apps/trac/unetbootin/wiki/commands
- How to create and use Live USB.pdf
Older SoaS versions and variations
- How to Make a USB.pdf (How to make a usb windows/linux/Mac + Helper Boot Disks) Sugar on a Stick/Installation
- imagewriter http://download.sugarlabs.org/soas/releases/imagewriter (use to make a non persistent USB from an .iso file)
- imagewritermac http://download.sugarlabs.org/soas/releases/imagewritermac (Intel Mac use to make a non-persistent USB device installation from an .iso file)
- livecd-iso-to-disk http://download.sugarlabs.org/soas/releases/livecd-iso-to-disk (script used to load USB devices in Linux)
- soas-1-boot.iso http://download.sugarlabs.org/soas/releases/soas1boot.iso (Use as CD to boot SoaS v1 Strawberry, for older PC's that do not boot from a USB device)
- soas-1-strawberry.iso http://download.sugarlabs.org/soas/releases/soas1strawberry.iso (Burn this to a CD and boot with it)
- Working with Live USB's.pdf (ADVANCED) Variations of Live USB Installation Methods
- soas-2-boot.iso http://download.sugarlabs.org/soas/releases/soas2boot.iso (Use as CD to boot SoaS v2 Blueberry for older PC's that do not boot from a USB device)
- soas2blueberry.iso http://download.sugarlabs.org/soas/releases/soas2blueberry.iso (Burn this to a CD and boot with it)
- soas-2-blueberry-direct-cleared3GB.img.xz
- soas-2-blueberry-direct-cleared3GB.pdf (Non-live EXT3 file structured USB Image file, How to USE and How it was Made) (ADVANCED)
- Download: http://people.sugarlabs.org/Tgillard/soas-2-blueberry-direct-cleared-3GB.img.xz
- Information: http://people.sugarlabs.org/Tgillard/soas-2-blueberry-direct-cleared-3GB.txt
- Listing of Other Live USB Distributions and install Methods: Category:Live USB
SoaS-v3-Mirabelle remix
- Make a Live or non-live USB device installation from a booted CD
- Burn the .iso to a CD, and boot with it.
- In the Sugar Terminal Activity:
su
live-usbcreator --reset-mbr
- Insert USB device # 1 (2 GB or larger, formatted fat16, boot flag set)
- Insert USB device # 2 with live.iso you want to put on USB device #1, select the .iso file
- Move slider for desired persistence
- Create USB
- Mirabelle-Remix-pl-LiveCD.iso http://people.sugarlabs.org/Tgillard/Mirabelle-Remix-pl--LiveCD.iso
- Mirabelle-Remix-pl-Live-CDREADME.pdf http://people.sugarlabs.org/Tgillard/Mirabelle-Remix-pl--LiveCD-README.txt
- kickstart file http://people.sugarlabs.org/Tgillard/Mirabelle-Remix-plain.ks (To see what is included in build)
- This is a Mirabelle build, with these programs added to the build:
- deja-dup
- Simple Backup for duplicity
- duplicity
- Backup
- gparted
- partition editor
- gedit
- text editor
- liveusbcreator
- Install to USB devices graphically
- zyxliveinstaller
- Install from a running Live USB device to a full, non-live installation on a USB device or hard disk
- These programs are accessed from Sugar Terminal Activity, they are not Sugarized
Mirabelle backup, deja-dup
- Mirabelle-Backup-(deja-dup).pdf Sugar on a Stick/deja-dup
- write Mirabelle to USB.pdf
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
Virtualbox-Virtualization
- A good solution for Macintosh Computers
Link: http://wiki.sugarlabs.org/go/VirtualBox
Prebuilt Virtualbox Appliance
- Download these three files:
http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.ovf http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.vmdk http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.mf
Sugar Clone
- customize or duplicate Live USB installations
- (script files for making a customized Live USB installation self-replicating)
- SugarCloneREADMEFIRST.pdf Sugar on a Stick/Sugar Clone
- Sugar Clone http://people.sugarlabs.org/fgrose/SugarClone
- Sugar Cellar, script to report on disk space in LiveOS images
- included in Sugar Clone
- or available separately at http://people.sugarlabs.org/fgrose/SugarCellar
Build Your Own Remix
CAUTION: DO NOT TRY DOING THIS FROM A SOAS USB STICK. A MINIMUM OF 8GB IS REQUIRED TO BUILD A CUSTOM-REMIX.ISO
- A 8GB USB is a minimum requirement.
- It is usually Cheaper to buy a 120GB or larger external USB Hard Drive and install fedora on it.
- A Gnome Desktop install seems to work best. Link: [7]
THIS SHOULD BE LOOKED AT FIRST:http://download.sugarlabs.org/soas/docs/customization-guide
- NOTE: this content should be used to enhance above link - 08/02/2010 satellit
NOTE: also look at SugarClone:
- (SugarClone duplicates a customized live USB to 2nd USB.)
Sugar Clone, http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Sugar_Clone, is a short-cut method to customize a SoaS installation that works with a single-word command. It would probably serve the targeted-project, special-focus case.
The following is Modified/Adapted from: https://fedoraproject.org/wiki/Talk:How_to_create_and_use_a_Live_CD
- AND
FedoraQA Creating_a_Test_Day_Live_Image: https://fedoraproject.org/wiki/QA/Test_Days/Live_Image#Creating_a_Test_Day_Live_Image
Introduction
- NOTE THAT THESE REMIXES ARE NOT SUPPORTED BY FEDORA
- You may find some volunteer support on IRC freenode #sugar however.
This page explains how to make a custom-content Live CD or DVD on Fedora-based systems including derived distributions such as RHEL, CentOS and others.
If you simply want to burn a pre-made ISO to a disc, visit http://fedoraproject.org/en/get-fedora to download a LiveCD or LiveDVD, then see the install guide or burning how-to for further instructions.
Instructions
The basic workflow for creating a remix is:
- Create / Modify a kickstart file that specifies the packages you want installed on your remix, along with special settings you want to tweak.
- Run that kickstart file through livecd-creator, which will pull in the packages and compose an .iso, which you can then burn to CD.
...that's it! We will walk you through these steps below.
Install the necessary software
To create a live image, the livecd-creator tool is used. Super user privileges are needed. The tool is more or less self-documenting, use the --help option to see options.
The livecd-creator tool is part of the livecd-tools
package. If it is not installed on your system, add it with:
su -c 'yum install livecd-tools spin-kickstarts'
If you are interested in localized live cd files, install also l10n-kickstarts.
su -c 'yum install l10n-kickstarts'
Note the spin-kickstart files that download are specific for the version of fedora you are using
- The version of sugar will also be different for each version of fedora:
- f12 0.86.-
- f13 0.88.-
- f14(rawhide) 0.89.- (0.90.-?)
Set up your environment
Now we'll set up the place you'll be building your remix's image file in. We assume you're running a recent version of Fedora.
- We will use the /home/(user*)/Desktop to do our builds
- Note: If you use the Kickstart files in the default installed location in /usr/share/spin-kickstarts you will have permission problems editing the files.
- Set SELinux in permissive mode:
- It will fail if this is not done
su -c ‘setenforce 0’
- Copy the kickstart files you've Downloaded to your Desktop:
- (user*)= your user name
mkdir /home/(user*)/Desktop/spin-kickstarts cp /usr/share/spin-kickstarts/*.ks /home/(user*)/Desktop/spin-kickstarts/ cd /home/(user*)/Desktop/spin-kickstarts/
- Edit one of the .ks files you just copied to your Desktop/spin-kickstarts directory
gedit
Create/Modify the kickstart file
- Open the kickstart file you chose from the spin-kickstart folder you copied to your Desktop in the editor of your choice.:
- Create the package manifest section and add your favorite packages:
# %include spin-kickstarts/(your).ks (See :[8])
#redefine repo to some local mirror (See below and :[9])
%packages
#provide list of packages (normal, wildcarded, @comps) to be added or removed - dependencies are handled
#packageYouWant
#wildcardedPackagesYouWant*
#@CompYouWant
#-packageYouDontWant
%end
%post
#put any shell commands here
%end
More Information
- In the worst case you can base the whole livecd on Fedora 12 packages with this definition:
# not really rawhide, overriden with F12 'released' repo
repo --name=rawhide --mirrorlist=http://mirrors.fedoraproject.org/mirrorlist?repo=fedora-12&arch=$basearch
repo --name=updates --mirrorlist=http://mirrors.fedoraproject.org/mirrorlist?repo=updates-released-f12&arch=$basearch
- %packages
- Add and or remove programs
- Any Program with a minus sign (-) will be removed; any program without a minus will be added
- %post
- Manipulate files that have been installed
- %post command are done in cheroot (the commands are only run against the new file system created for the live CD)
- To change repository: (eg: enable rawhide)
- Edit the fedora-live-mini.ks
- Put # in front of repos you do not want to use
- (remove # )from The repos you want to use
- EXAMPLE: repo --name=rawhide --mirrorlist=http://mirrors.fedoraproject.org/mirrorlist?repo=rawhide&arch=$basearch
- Look at this .ks for usage examples:http://people.sugarlabs.org/Tgillard/Mirabelle-Remix-plain.ks
- Congrats -- you're done!
Example Terminal Command to Build .iso
You must be connected to a fast Internet connection for this to work
- f14(rawhide)build system using fedora-livecd-soas.ks
- (This example also works with a f13 Build System)
- In terminal /home/(user)/Desktop:
- su
- "#"
livecd-creator \
--config=/home/(user)/Desktop/spin-kickstarts/fedora-livecd-soas.ks \
--fslabel=Soas-v(2-3-4)-ddmmyear-Remix --cache=/var/cache/live --verbose
- KEY
- --fslabel=Soas-v(2-3-4)-ddmmyear-xxxx-Remix = (The name you specify for the CD remix)
- Explanation of format for name: (preliminary layout pending approval by Soas)
- v(2-3-4)= the sugar version v(2-3-4)
- v2= Fedora 12 sugar 0.86-
- v3= Fedora 13 sugar 0.88-
- v4= Fedora 14 sugar 0.89-0.90
- dd/mm/year= The Creation Date
- -xxxx = custom name
- Remix is REQUIRED for naming if Soas is used
- --config=/home/(user*)/Desktop/spin-kickstarts/ * (path to your Desktop/spin-kickstarts folder and .ks file)
Build the image
- The build process will take some time, as well as space and bandwidth.
- Success is indicated by message:
- "Setting supported flag to 0"
- your new remix CD.iso is located in your Home Folder.
Credits
- Parts of this page were based on Rahul Sundaram's article Roll Out A Fedora Remix. And the References listed below:
- we plan to have a listing of Customized kickstart.files to share on the WIKI
- We will list them here so others can try them out and learn from them.
- Please send e-mail to:
To: soas@lists.sugarlabs.org
Subject: [Custom KS]-{Name of your kickstart file}
*Attach your Custom.ks file*
PLEASE INCLUDE THE FOLLOWING INFORMATION in e-mail:
Sugar Version :
(0.82; 0.86.x; 0.88.x; 0.89.x)
Country / Deployment :
Build system fedora version :
Number of USB's in Deployment :
PC/Netbooks used :
Notes and Any Bug No's submitted :
Name
Kickstart.file
Sugar Version
Country / Deployment
Build system fedora version
Number of USB's in Deployment
Used with PC/Netbooks Types
CD.iso (if available), Notes, Comments, Bug No's submitted.
satellit
Mirabelle-remix [10]
Sugar 0.86.3
USA / Testing
f13
Testing
EeePC900; Acer Aspire One
[11] Works fine, CD, liveinst, zyx-liveinstaller, USBscr,dd, Liveusb-creator all work Read(bug) [12]
satellit
soas-v4-0725-Remix [13]
Sugar 0.89.1
USA /Testing
f14(rawhide)
Testing
EeePC900; Acer Aspire One
[14] Works fine, CD, zyx-liveinstaller, USBscr,dd Liveinst Fails on firstboot cannot log on Read(bug) [15]
–
–
–
–
–
–
References/Links
Fedora
- http://mirrors.ibiblio.org/pub/mirrors/sugar/soas/docs/customization-guide/index.html
- https://fedoraproject.org/wiki/Talk:How_to_create_and_use_a_Live_CD
- https://fedoraproject.org/wiki/How_to_create_and_use_a_Live_CD
- http://www.linuxforu.com/how-to/roll-out-a-fedora-remix/
- http://www.ibm.com/developerworks/linux/library/l-fedora-livecd/
Detailed KS Links
- NOTE: This Part Under Construction...Info may be out of date or not applicable
- http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/sysadmin-guide/index.html
- http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/sysadmin-guide/s1-kickstart2-howuse.html
- http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/sysadmin-guide/s1-kickstart2-file.html
- http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/sysadmin-guide/s1-kickstart2-options.html
- http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/sysadmin-guide/s1-kickstart2-packageselection.html
- http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/sysadmin-guide/s1-kickstart2-postinstallconfig.html
- http://www.ibm.com/developerworks/linux/library/l-fedora-livecd/index.html
- http://forums.fedoraforum.org/showthread.php?t=231281
- http://fedoraproject.org/wiki/FedoraLiveCD
- http://fedoraproject.org/wiki/FedoraLiveCD/USBHowTo#How_to_Make_a_bootable_USB_Drive_to_Install_Fedora_instead_of_using_a_physical_DVD
Options provided by the livecd-creator command
- f14(rawhide)
livecd-creator --help
Options:
-h, --help show this help message and exit
Image options:
These options define the created image.
-c KSCFG, --config=KSCFG
Path or url to kickstart config file
-b BASE_ON, --base-on=BASE_ON
Add packages to an existing live CD iso9660 image.
-f FS_LABEL, --fslabel=FS_LABEL
File system label (default based on config name)
--compression-type=COMPRESS_TYPE * Note: NEW TO F14(rawhide)
Compression type recognized by mksquashfs (default
zlib, lzma needs custom kernel)
System directory options:
These options define directories used on your system for creating the
live image
-t TMPDIR, --tmpdir=TMPDIR
Temporary directory to use (default: /var/tmp)
--cache=CACHEDIR Cache directory to use (default: private cache
Debugging options:
These options control the output of logging information during image
creation
-d, --debug Output debugging information
-v, --verbose Output verbose progress information
--logfile=FILE Save debug information to FILE