Build Your Own Remix link: http://wiki.sugarlabs.org/go/Sugar_Creation_Kit#Build_Your_Own_Remix 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. [edit] 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. [edit] 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.-?) [edit] 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 [edit] 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 :[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 [edit] 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! [edit] 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) [edit] 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: [edit] 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 : link: http://wiki.sugarlabs.org/go/Sugar_Creation_Kit#Share_your_Custom.ks_File