Sugar Creation Kit
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
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.
- Read the Floss_Manuals first!
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:
- (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
- 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
Hardware Compatibility
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)
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.
- Note For Latest Activity Testing and Compatibility see:http://wiki.sugarlabs.org/go/Features/Soas_V4/ASLOxo_Activity_Test_Table#Activity_Test_Results
- Activities IndexMirabell.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
- 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.pdf http://people.sugarlabs.org/Tgillard/sugarlabs_SoaS-Creation-Kit_avery_cd_label_2up_Mirabelle.pdf
- 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 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 Sugar_on_a_Stick/Linux Fedora:How to create and use Live USB#Graphical Method - Windows or Fedora
- zyxliveinstaller Instructions 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
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
- MakeYourOwnSugarActivities Internet Archive Publishing Quality
- Introduction to Sugar http://en.flossmanuals.net/sugar
- 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)
- 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
- Instructions on how to make a program appear in the (F3) Home view of Sugar as an icon
- The_Undiscoverable (The Undiscoverable Features of Sugar) The Undiscoverable
- Features and tips not easily discovered about using Sugar
Activities
listing: Activities
- Tests of Activities from ASLO [2]
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
- Liveusb-creator https://fedorahosted.org/liveusb-creator/
- F14 version for windows released: http://lewk.org/blog/liveusb-creator-3.9.3.html 01/06/2011
[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
- unetbootinwindows471.exe for windows
- unetbootinlinux471
- Unetbootin
- (Advanced) UnetbootinCommand_line
- How_to_Make_a_2GB_Installer_USB with unetbootin
pendrivelinux
- usb-installs-from-linux How to Do it Information
- universal-usb-installer-easy-as-1-2-3 Windows
- boot-multiple-iso-from-usb-via-grub2-using-linux linux (Advanced)
- boot-a-usb-flash-drive-in-virtualbox VirtualBox
SoaS versions, Helper Boot Disks. and variations
- How to Make a USB.pdf (How to make a usb windows/linux/Mac + Helper Boot Disks) Sugar on a Stick/Installation
- 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 (Burn this to a CD and boot with it)
- 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 (Burn this to a CD and boot with it)
- soas-3-mirabelle.iso (Burn this to a CD and boot with it)
- soas-2-blueberry-direct-2GB.img.gz
- soas-2-blueberry-direct-cleared3GB.img.xz
- Listing of Other Live USB Distributions and install Methods: Category:Live USB
- VirtualBox 3.2 with multiple student's Copies of Soas each on a 2nd USB
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
- Start Oracle Virtualbox for OSX VirtualBox-3.2.10-66523-OSX.dmg Download
- 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
- 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
- Hold down "C" key and do not release until Fedora Blue "soas-boot" screen appears
- Congratulations Your Live USB should Boot and run Sugar on a Stick from the live USB with persistence
- Notes:
- Wireless connection does not work. Use an USB Ethernet Adapter for Internet Connectivity
- 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
- 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)
Backup and Restore
- Backup 4 (Activity) http://activities.sugarlabs.org/en-US/sugar/addon/4326
- Restore 3 (Activity) http://activities.sugarlabs.org/en-US/sugar/addon/4327
- Mirabelle-Backup-(deja-dup) Sugar on a Stick/deja-dup
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
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)
- VMware Player appliance of openSUSE-Sugar
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
- http://www.virtualbox.org/
- Download Virtualbox: Windows:[3]Linux[4]Intel Macs:[5]
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)
- Sugar Clone Wiki PageSugar on a Stick/Sugar Clone
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: [6]
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.
- click on this link to join #sugar on IRC Chat
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 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 :[7])
#redefine repo to some local mirror (See below and :[8])
%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
- 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 [9]
Sugar 0.86.3
USA / Testing
f13
Testing
EeePC900; Acer Aspire One
[10] Works fine, CD, liveinst, zyx-liveinstaller, USBscr,dd, Liveusb-creator all work Read(bug) [11]
satellit
soas-v4-0725-Remix [12]
Sugar 0.89.1
USA /Testing
f14(rawhide)
Testing
EeePC900; Acer Aspire One
[13] Works fine, CD, zyx-liveinstaller, USBscr,dd Liveinst Fails on firstboot cannot log on Read(bug) [14]
–
–
–
–
–
–
References/Links
Using the Anaconda Kickstart file
- Modify the Anaconda Installer Kickstart file for a Customized install
- An alternative approach
Older Anaconda Kickstart Links
- 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
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/
- 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
Fedora Sugar Bugs
Sugar Bugs
- Sugar_on_a_Stick
- Soas-Sugar
- 0.90-olpc
Using KIWI with openSUSE to Customize
Customizing-Trisquel
DebianCustomCD