Sugar Creation Kit

Revision as of 08:01, 1 October 2010 by Satellit (talk | contribs) (→‎Liveusb Creator: ZyX-LiveInstaller)


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


Get Sugar

http://wiki.sugarlabs.org/go/Downloads

For Help

(click on this link to join #sugar on IRC Chat)

http://webchat.freenode.net/?randomnick=1&channels=sugar&prompt=1

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 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 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 09/12/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

WINDOWS: http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Windows

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 v3 Mirabelle

(the current version of SoaS)
(Burn the .iso to a CD and Boot with it)
  • Activities Compatible with Mirabelle
Editable Listing of Activity Compatibility http://wiki.sugarlabs.org/go/Features/Soas_V4/ASLOxo_Activity_Test_Table Use to report your findings Current

ASLOxo-4.iso (140+Activities)

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


Floss Manuals

(Important Manuals on how to use Sugar Applications and Features) http://en.flossmanuals.net/ http://en.flossmanuals.net/sugar

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

Activities

listing: Activities

  • Tests of Activities from ASLO [3]

E-books

Graphic installers

Liveusb Creator
ZyX-LiveInstaller
unetbootin

Older SoaS versions and variations

SoaS-v3-Mirabelle remix
  • ­Make a Live or non-live USB device installation from a booted CD
    1. Burn the .iso to a CD, and boot with it.
    2. In the Sugar Terminal Activity:
    3. su
    4. live-usbcreator --reset-mbr
    5. Insert USB device # 1 (2 GB or larger, formatted fat16, boot flag set)
    6. Insert USB device # 2 with live.iso you want to put on USB device #1, select the .iso file
    7. Move slider for desired persistence
    8. Create USB
  • 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

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

VMplayer Virtualization

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

Download VMware Player:[4]
Prebuilt VMplayer Appliances

• VMplayer Appliance of nightly composes soas-i386-20100818.16.iso
            read this firstdownload

  • VMplayer of Soas-v2-Blueberry
ReadMeFirst:[5] Download:[6]

• Open-suse-education
            read this first download Start networking in sugar-terminal [7]How to use: [8] |}

Virtualbox-Virtualization

  • A good solution for Macintosh Computers

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

Download Virtualbox: [9]
Prebuilt Virtualbox Appliances
  • Soas-v3-Mirabelle
READ FIRST: http://people.sugarlabs.org/Tgillard/soas-v3-MirabelleREADME_FIRST.txt
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
  • Soas-v2-Blueberry
  • Virtualbox 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

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: [10]


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:

  1. Create / Modify a kickstart file that specifies the packages you want installed on your remix, along with special settings you want to tweak.
  2. 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

  1. Open the kickstart file you chose from the spin-kickstart folder you copied to your Desktop in the editor of your choice.:
  2. Create the package manifest section and add your favorite packages:

# %include spin-kickstarts/(your).ks  (See :[11])

#redefine repo to some local mirror  (See below and :[12])

%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 and Examples of Usage
  • 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)
EXAMPLE
  • edit the boot parameters
delete "quiet" and "rhgb"
%post --nochroot 
sed -i -e '/ *append / { s/quiet// ; s/rhgb//;  }'  "${LIVE_ROOT}"/isolinux/isolinux.cfg
EXAMPLE
  • disable screensaver locking
%post
# disable screensaver locking
cat >> /home/liveuser/.xscreensaver << FOE
lock:	False
FOE
EXAMPLE
  • Isolinux and most other bootloaders let you edit the boot parameters;

just delete "quiet" and "rhgb" there at boot time. None of the above is livecd specific.

If you want to make this the default on images you build
then just add the following line in the %post --nochroot section:
sed -i -e '/ *append / { s/quiet// ; s/rhgb//;  }'  "${LIVE_ROOT}"/isolinux/isolinux.cfg
EXAMPLE
  • Include Documents in Books directory
%post --nochroot
# Mel's Example starts  (thanks to Mel Chua)
# pull and include sample content
WD=$PWD
CACHE_DIR=$WD/../cache/books
CONTENT_DIR=$INSTALL_ROOT/home/liveuser/Desktop/books
mkdir -p $CACHE_DIR
mkdir -p $CONTENT_DIR
cd $CONTENT_DIR
PDF="$PDF http://people.sugarlabs.org/Tgillard/ReadMeFirst-How-to-build-a-remix.pdf"
PDF="$PDF http://wiki.sugarlabs.org/go/Sugar_Creation_Kit"
PDF="$PDF http://people.sugarlabs.org/sdz/ForwardPages5-6.pdf"
PDF="$PDF http://people.sugarlabs.org/sdz/Sugar_on_a_Stick-3-Creation_Kit-en-US.pdf"
PDF="$PDF http://people.sugarlabs.org/sdz/Sugar_on_a_Stick-3-Customization_Guide-en-US.pdf"
PDF="$PDF http://en.flossmanuals.net/ActivitiesGuideSugar/FM_25Apr10.pdf"
PDF="$PDF http://en.flossmanuals.net/Sugar/FM_Sugar_28Oct08.pdf"
for pdf in $PDF ; do
 remote_file=$(basename $(curl -4 -s -L -w %{url_effective} -I $pdf | tail -1))
 file=$CACHE_DIR/$remote_file
 if [ ! -f $file ] ; then
   curl -s -4 -L $pdf > $file
 fi
 cp -p $file $CONTENT_DIR
done
%end
  • 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


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

Share your Custom.ks File

  • 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 [13] Sugar 0.86.3 USA / Testing f13 Testing EeePC900; Acer Aspire One [14] Works fine, CD, liveinst, zyx-liveinstaller, USBscr,dd, Liveusb-creator all work Read(bug) [15]
satellit soas-v4-0725-Remix [16] Sugar 0.89.1 USA /Testing f14(rawhide) Testing EeePC900; Acer Aspire One [17] Works fine, CD, zyx-liveinstaller, USBscr,dd Liveinst Fails on firstboot cannot log on Read(bug) [18]
             
             
             
             
             
             

References/Links

Fedora

Detailed KS Links

Fedora Bugs

https://bugzilla.redhat.com/buglist.cgi?component=livecd-tools&product=Fedora

Using KIWI with openSUSE to Customize

http://en.opensuse.org/SDB:KIWI_Cookbook_Live_USB-Stick

customizing-trisquel

customizing-trisquel http://trisquel.info/en/wiki/customizing-trisquel-iso