Sugar Labs

Build Your Own Remix with Fedora: Difference between revisions

← Older edit
Satellit (talk | contribs)
12,355 edits
m →spin-kickstarts.git: move section down
Satellit (talk | contribs)
12,355 edits
 
(46 intermediate revisions by the same user not shown)
Line 7: Line 7:
: A 8GB USB is a minimum requirement.
: 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.
: 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: [http://fedora.osuosl.org/linux/releases/13/Fedora/i386/iso/Fedora-13-i386-netinst.iso]'''




''' THIS SHOULD BE LOOKED AT FIRST:http://download.sugarlabs.org/soas/docs/customization-guide'''
''' 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: this content should be used to enhance above link - 08/02/2010 satellit
'''NOTE: also look at SugarClone:'''  
'''NOTE: also look at SugarClone:'''  
: (SugarClone duplicates a customized live USB to 2nd USB.)
: (SugarClone duplicates a customized live USB to 2nd USB.)
Line 20: Line 18:
  single-word command.  It would probably serve the targeted-project,
  single-word command.  It would probably serve the targeted-project,
  special-focus case.
  special-focus case.
=='''livemedia-creator'''==
*Newer method in f24
:https://jbwillia.wordpress.com/2014/10/29/how-to-build-updated-fedora-live-iso-for-yourself/
*Older post
:https://www.brianlane.com/creating-live-isos-with-livemedia-creator.html
*Examples in f24 root terminal:
*Must be done first:
:'''You must be in the same fedora version (f24) first.'''
setenforce 0
=== ksflatten ===
::build works: 05/26/2016 tg
*Link:
:https://pagure.io/fedora-kickstarts/tree/f24
::<dgilmore> satellit: I suggest that you tell people to git clone the repo and not get each piece manually
:Kickstarts need to flattened before use:
:: hit raw tab and '''save-page-as''' to a local directory (/home/(user)/Downloads/pagure.ks/)
:https://pagure.io/fedora-kickstarts/blob/f24/f/fedora-live-soas.ks
:https://pagure.io/fedora-kickstarts/blob/f24/f/fedora-live-base.ks
:https://pagure.io/fedora-kickstarts/blob/f24/f/fedora-live-minimization.ks
:https://pagure.io/fedora-kickstarts/blob/f24/f/fedora-repo.ks
:https://pagure.io/fedora-kickstarts/blob/f24/f/fedora-repo-not-rawhide.ks
:https://pagure.io/fedora-kickstarts/blob/f24/f/fedora-repo-rawhide.ks
:https://pagure.io/fedora-kickstarts/blob/f24/f/fedora-soas-packages.ks


*switch root terminal to the local directory with the kickstart files (/home/(user)/Downloads/pagure.ks/)
ksflatten -v, --config fedora-live-soas.ks -o flat-fedora-live-soas.ks --version F24
livemedia-creator --ks /home/(user)/Downloads/pagure.ks/flat-fedora-live-soas.ks  --logfile /tmp/lmc-logs/livemedia-out.log --no-virt --resultdir /tmp/lmc --project Fedora-soas-Live --make-iso --volid Fedora-SoaS-flat-live --iso-only --iso-name Fedora-SoaS-flat-live.iso --releasever 24 --title Fedora-SoaS-flat-live --macboot
=== Make a remix ===
*edit the bottom of the flat-fedora-live-soas.ks
:in this section
%packages
:add a program  (add name)
:'''-''' delete a program ( put - in front)
:put '''#''' in front of listed program to not install it
:Build takes a long time wait for completion
:ends with:
..........clip........
..........clip........
2016-05-17 16:16:16,110: Disk Image install successful
2016-05-17 16:16:16,110: working dir is /var/tmp/lmc-work-rilyz2bm
2016-05-17 16:27:38,448: Rebuilding initrds
2016-05-17 16:27:38,448: dracut args = ['--xz', '--add', 'livenet dmsquash-live convertfs pollcdrom qemu qemu-net', '--omit', 'plymouth', '--no-hostonly', '--debug', '--no-early-microcode']
2016-05-17 16:27:38,449: rebuilding boot/initramfs-4.5.3-300.fc24.x86_64.img
2016-05-17 16:29:15,724: Building boot.iso
2016-05-17 16:29:15,784: running x86.tmpl
2016-05-17 16:29:48,959: Disk image erased
2016-05-17 16:29:49,377: SUMMARY
2016-05-17 16:29:49,377: -------
2016-05-17 16:29:49,377: Logs are in /tmp/lmc-logs
2016-05-17 16:29:49,377: Results are in /tmp/lmc
===Retrieve finished live.iso===
"Results are in /tmp/lmc"
*start files application
*click on '''Files system'''
:open  temp folder
:open lmc folder
*click on  the '''.....iso''' you just built
'''copy to''' (mouse right click) '''Home''' with files application
*Check that it is in Home
===Clean Up===
:delete the instance in /tmp
:delete the /tmp directory  (cannot run new build unless this is done?)
[root@localhost lmc]#
[root@localhost lmc]# cd ..
[root@localhost tmp]# rm -r lmc
rm: descend into directory 'lmc'? y
rm: remove regular file 'lmc/Fedora-LUCwks-20160524.iso'? y
rm: remove directory 'lmc'? y
[root@localhost tmp]#
== Fedora Remix Info ==
:https://fedoraproject.org/wiki/Remix
*Important Info and links
"A Fedora Remix is a combination of Fedora software, with or without third-party software,
that any community member can create at any time..."
''' The following is Modified/Adapted from: https://fedoraproject.org/wiki/Talk:How_to_create_and_use_a_Live_CD'''
''' The following is Modified/Adapted from: https://fedoraproject.org/wiki/Talk:How_to_create_and_use_a_Live_CD'''
* AND
* AND
'''FedoraQA Creating_a_Test_Day_Live_Image: https://fedoraproject.org/wiki/QA/Test_Days/Live_Image#Creating_a_Test_Day_Live_Image'''
'''FedoraQA Creating_a_Test_Day_Live_Image: https://fedoraproject.org/wiki/QA/Test_Days/Live_Image#Creating_a_Test_Day_Live_Image'''
*Other Important links:
::3/11/2014
:https://fedoraproject.org/wiki/How_to_create_and_use_a_Live_CD?rd=How_to_create_and_use_Fedora_Live_CD
:https://fedoraproject.org/wiki/How_to_create_a_Fedora_install_ISO_for_testing?rd=How_to_build_a_Rawhide_ISO_image_for_testing#Build_a_boot.iso


=== Introduction ===
== Introduction ==
*Complete Reference on Fedora [https://fedoraproject.org/wiki/Anaconda/Kickstart Anaconda Kickstart]
*Complete Reference on Fedora [https://fedoraproject.org/wiki/Anaconda/Kickstart Anaconda Kickstart]


Line 56: Line 145:


  su -c 'yum install livecd-tools spin-kickstarts'
  su -c 'yum install livecd-tools spin-kickstarts'
*'''https://git.fedorahosted.org/git/spin-kickstarts.git'''
:latest spin.ks files


If you are interested in localized live cd files, install also '''l10n-kickstarts'''.
If you are interested in localized live cd files, install also '''l10n-kickstarts'''.
Line 69: Line 162:
::f16 0.94.-
::f16 0.94.-
::f17 0.96.-
::f17 0.96.-
::f18 0.97.- works in Beta TC7
::f18 0.98.-
*It is best if your install is all in the / directory (ext4 format) as the temporary files need a lot of room on /
::f19 0.98.7-
::f20 0.99. -
::f21 0.102.x -
::f22
::f23
::f24 0.108.x -
 
==== Set up your environment ====
==== 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.
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
:We will use the /home/(user*)/ directory 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.
: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:'''
*'''Set SELinux in permissive mode:'''
::It will fail if this is not done
::Remix build will fail if this is not done
  su -c ‘setenforce 0’
  su -c ‘setenforce 0’
*Copy the kickstart files you've Downloaded to your Desktop:
*Copy the kickstart files you've Downloaded to a new spin-kickstarts directory:
::As noted above; copying changes the file permissions so it is easier to use them.
 
:(user*)= your user name
:(user*)= your user name
*In terminal $:
mkdir /home/(user*)/spin-kickstarts
cp /usr/share/spin-kickstarts/*.ks /home/(user*)/spin-kickstarts/
cd /home/(user*)/spin-kickstarts/


mkdir /home/(user*)/Desktop/spin-kickstarts
=====ksflatten=====
cp /usr/share/spin-kickstarts/*.ks /home/(user*)/Desktop/spin-kickstarts/
*program to convert kickstart files into one file
cd /home/(user*)/Desktop/spin-kickstarts/
*install:
  dnf install /usr/bin/ksflatten
KSFLATTEN(1)                           General Commands Manual                          KSFLATTEN(1)


* Edit one of the .ks files you just copied to your Desktop/spin-kickstarts directory
NAME
      ksflatten — flatten a kickstart file
 
SYNOPSIS
      ksflatten [-c | --config INFILE]  [-o | --output OUTFILE]  [-v | --version VERSION]
 
DESCRIPTION
      ksflatten is a program that takes an input kickstart file potentially containing includes and
      generates an output file with all the includes inlined.
 
EXIT STATUS
      ksflatten returns 0 on success, and 1 if INFILE does not exist or there is an  error  parsing
      the kickstart file.
 
OPTIONS
      -c, --config INFILE
                The name of the input kickstart file.
 
      -o, --output OUTFILE
                Write the flattened kickstart file to OUTFILE, or stdout if no filename is given.
 
      -v, --version VERSION
 
======Examples======
# /Downloads/spin-kickstarts
ksflatten -v, --config fedora-livecd-soas.ks -o flat-fedora-livecd-soas.ks --version F21
 
=====git spin-kickstarts=====
::Updated 11/09/2014
:https://git.fedorahosted.org/cgit/spin-kickstarts.git/
:'''https://git.fedorahosted.org/cgit/spin-kickstarts.git/tree/?h=f21'''
::'''Recommended for most up to date xxx.ks'''
:Latest spin-kickstarts used for composes of live cd's
 
::Downloaded spin-kickstarts usually are not up to date.
*These are more up to date kickstart files-(used for builds)
:Index: http://git.fedorahosted.org/cgit/spin-kickstarts.git/
:Unzip latest file
:Use these kick-start files as shown in the above example.
:Be sure to not mix them with the files we added to /spin-kickstarts
*Suggest copying them to /home/(user)*/ to keep them apart.
 
* Edit one of these .ks files with the '''gedit''' Text Editor
:see (section below for details of what you can do)
:see (section below for details of what you can do)
gedit


====Masher .ks files====
*use the flattened (one file) .ks file for the latest koji builds:
:http://koji.fedoraproject.org/koji/tasks?start=0&state=all&view=flat&method=createLiveCD&order=-id
::Click on the green (successful) build listed on this page and download the xxxx.ks listed below the xxxx.iso link
::Save this to  /home/(user)/spin-kickstarts/ 
::Link to this after you adjust the xxx.ks for your needs (see below)
====[https://fedoraproject.org/wiki/QA:Testcase_Kickstart_File_Path_Ks_Cfg Add a xxx.ks file in Anaconda]====
"This test will verify that anaconda can load a kickstart file from a file:// path. This is a typical case for when the kickstart file is located in the initrd.img."
====Example Terminal Command to Build .iso ====
====Example Terminal Command to Build .iso ====


'''You must be connected to a fast Internet connection for this to work'''
'''You must be connected to a fast Internet connection for this to work'''


:'''f14(rawhide)build system using fedora-livecd-soas.ks'''
*In root terminal:
::: (This example also works with a f13 to f17 Build System)
*In root terminal /home/(user)/Desktop:


  '''livecd-creator \'''
  '''livecd-creator \'''
  '''--config=/home/(user)/Desktop/spin-kickstarts/fedora-livecd-soas.ks \'''
  '''--config=/home/(user)/spin-kickstarts/fedora-livecd-soas.ks \'''
  '''--fslabel=Soas-v(2-3-4-5-6)-yearmmdd-Remix --cache=/var/cache/live --verbose'''
  '''--fslabel=Soas-v(2-11)-Remix-mmddyr --cache=/var/cache/live --verbose'''


*'''KEY'''
*'''KEY'''
: --fslabel=Soas-v(2-3-4-5-6-7)-yearmmdd-Remix = (The name you specify for the CD remix)
: --fslabel=Soas-v(2-14)-Remix-mmddyr = (The name you specify for the CD remix)


:: Explanation of format for name:  (preliminary layout pending approval by Soas)
:: Explanation of format for name:  (preliminary layout pending approval by Soas)
:::  v(2-3-4-5-6-7)= the sugar version v(2-3-4-5-6-7)
:::  v(2-11)= the sugar version
:::: v2= Fedora 12 sugar 0.86-
:::: v2= Fedora 12 sugar 0.86-
:::: v3= Fedora 13 sugar 0.88-
:::: v3= Fedora 13 sugar 0.88-
Line 113: Line 267:
:::: v6= Fedora 16 sugar 0.94.x
:::: v6= Fedora 16 sugar 0.94.x
:::: v7= Fedora 17 sugar 0.95.x
:::: v7= Fedora 17 sugar 0.95.x
:::: year/mm/dd= The Creation Date
:::: v8= Fedora 18 sugar 0.98.x
:::: v10=Fedora 20 sugar 0.99.x
:::: v11=Fedora 21 sugar 0102.x
:::: v12=Fedora 22 sugar 0102.x
:::: v13=Fedora 23 sugar 0104.x
:::: v14=Fedora 24 sugar 0106.x
 
 
:::: mmddyr= The Creation Date
:: '''Remix is REQUIRED for naming if Soas is used'''
:: '''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)
: --config=/home/(user*)/spin-kickstarts/  * (path to your spin-kickstarts folder and .ks file)
: the flattened .ks files from koji are preferred kickstarts to use:
::http://koji.fedoraproject.org/koji/tasks?start=0&state=all&view=flat&method=createLiveCD&order=-id


==== Create''/Modify'' the kickstart file ====
==== Create''/Modify'' the kickstart file ====
Line 228: Line 392:
  Now you can add any app that you want to start every time users log on.
  Now you can add any app that you want to start every time users log on.


* Look at this .ks for usage examples:http://people.sugarlabs.org/Tgillard/Mirabelle-Remix-plain.ks




Line 257: Line 420:
:test Digest, Vol 97, Issue 3 Comment (by adamwill)  
:test Digest, Vol 97, Issue 3 Comment (by adamwill)  
:I can build live images if needed. Actually, you probably could too, it's actually very simple to do. You basically just need a git checkout of spin-kickstarts:  
:I can build live images if needed. Actually, you probably could too, it's actually very simple to do. You basically just need a git checkout of spin-kickstarts:  
===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                    :                 
Country / Deployment            :                     
Build system fedora version      :                   
Number of USB's in Deployment    : 
PC/Netbooks used                :           
Notes and Any Bug No's submitted :
{| class="wikitable sortable"
|
|-
!Name!! Kickstart.file!!Sugar Version !!Country / Deployment!! class="unsortable" |Build system fedora version!! class="unsortable" | Number of USB's in Deployment !! class="unsortable" |Used with PC/Netbooks Types !! class="unsortable" |CD.iso (if available), Notes, Comments, Bug No's submitted.
|-
|satellit ||Mirabelle-remix [http://people.sugarlabs.org/Tgillard/Mirabelle-Remix-plain.ks]||Sugar 0.86.3||USA / Testing||f13||Testing ||EeePC900; Acer Aspire One ||[http://people.sugarlabs.org/Tgillard/Mirabelle-Remix-pl--LiveCD.iso] Works fine, CD, liveinst, zyx-liveinstaller, USBscr,dd, Liveusb-creator all work  Read(bug) [http://bugs.sugarlabs.org/ticket/1900]
|-
|satellit||soas-v4-0725-Remix [http://people.sugarlabs.org/Tgillard/soas-v4-0725-Remix_README.txt]||Sugar 0.89.1 ||USA /Testing||f14(rawhide)||Testing||EeePC900; Acer Aspire One ||[http://people.sugarlabs.org/Tgillard/soas-v4-0725-Remix.iso] Works fine, CD, zyx-liveinstaller, USBscr,dd '''Liveinst Fails on firstboot''' cannot log on  Read(bug) [http://bugs.sugarlabs.org/ticket/1900]
|-
|satellit||soas-v5-LDXE-Remix||Sugar 0.92.1||USA /Testing||f15 RC3||Testing||Acer Aspire One N450 ||Autologon to LXDE;has Menu/Education/sugar (sugar-emulator)
|-
|satellit||soas-v7 20120206 Remix||sugar 0.95.4||USA /Testing||f 17-GNOME3 3.3.4 (rawhide) ||Testing||Acer Aspire One N450||(add liveusb-creator to SoaS live i686 .ks): add these programs: liveusb-creator udisks.i686 0:1.0.4-4.fc17 sg3_utils-libs.i686 0:1.31-2.fc17 smp_utils.i686 0:0.96-2.fc17
|-
|satellit ||f18-Cinnamon-sugar-Remix||sugar 0.97.8 ||USA /Testing ||f18-betaTC7-Gnome 3.6.1||Testing ||Acer Aspire One N450 ||Liveuser x86-64 [http://people.sugarlabs.org/Tgillard/c-sugar-f18-Remix.iso c-sugar-f18-Remix.iso]
|-
|&ndash; ||&nbsp;||&nbsp; ||&nbsp; ||&nbsp; ||&nbsp; ||&nbsp; ||&nbsp;
|-
|&ndash; ||&nbsp;||&nbsp; ||&nbsp; ||&nbsp; ||&nbsp; ||&nbsp; ||&nbsp;
|-
|&ndash; ||&nbsp;||&nbsp; ||&nbsp; ||&nbsp; ||&nbsp; ||&nbsp; ||&nbsp;
|}
===References/Links===
===References/Links===


Line 302: Line 426:
::An alternative approach
::An alternative approach
* [[Sugar on a Stick/Customization]]
* [[Sugar on a Stick/Customization]]
*http://fedoraproject.org/wiki/Anaconda/Kickstart
*'''http://fedoraproject.org/wiki/Anaconda/Kickstart'''


=====Older Anaconda Kickstart Links=====
=====Older Anaconda Kickstart Links=====
Line 325: Line 449:
*http://spins.fedoraunity.org/team-documentation/composing-spins/doing-the-work
*http://spins.fedoraunity.org/team-documentation/composing-spins/doing-the-work
====spin-kickstarts.git====
====spin-kickstarts.git====
*https://pagure.io/fedora-kickstarts/tree/f24
:New
*http://git.fedorahosted.org/git/?p=spin-kickstarts.git;a=tree;hb=HEAD
*http://git.fedorahosted.org/git/?p=spin-kickstarts.git;a=tree;hb=HEAD
:Older depreciated


===Dextrose XO-1 & XO-1.5===
===Dextrose XO-1 & XO-1.5===
* [[Dextrose/Building]]
* [[Dextrose/Building]]


===Fedora Licensing===
===Licensing===
*http://fedoraproject.org/wiki/Licensing
*http://fedoraproject.org/wiki/Licensing
*http://opensource.org/licenses/lgpl-license
:How to label the license for your VirtualBox exports and Remixed .iso's


===Using KIWI with openSUSE to Customize===
===Using KIWI with openSUSE to Customize===
Line 345: Line 474:
===Notes/Links===
===Notes/Links===
http://marcopg.org/2011/06/12/html-activities/
http://marcopg.org/2011/06/12/html-activities/
====Building Boot Images====
====[https://fedoraproject.org/wiki/User:Bcl#Building_boot_images Building Boot Images]====
*(Very Advanced)
*(Very Advanced)
:https://fedoraproject.org/wiki/User:Bcl#Building_boot_images
:http://66.35.62.162/wiki/Install_and_configure_AutoQA
:http://66.35.62.162/wiki/Install_and_configure_AutoQA
Retrieved from "https://wiki.sugarlabs.org/go/Build_Your_Own_Remix_with_Fedora"