Difference between revisions of "Development Team/Jhbuild"

From Sugar Labs
Jump to navigation Jump to search
(added "Configure the mode and resolutions of Sugar" hack, to make Sugar run in different resolutions and in a window)
 
m (→‎Deprecated: updating sugar-build doc url)
 
(207 intermediate revisions by 46 users not shown)
Line 1: Line 1:
One of the easiest ways to install [[Sugar]] is to use [[sugar-jhbuild]].
+
<noinclude>{{Translations}}{{TOCright}}</noinclude>
 +
{{Template:Obsolete}}
  
Sugar-jhbuild will automatically download the latest of Sugar's dependencies as well as Sugar itself directly from their source repositories, rather than relying on source packages that may have become stale. Below are generic instructions on how to use sugar-jhbuild to get up and running with Sugar.
+
==Deprecated==
  
'''Note:''' Some Linux distributions may need or have special procedures; you can check the pages on [[:Category:Installing Sugar|installing Sugar]] to see if they are available.
+
'''Note: <font color=red>Sugar-jhbuild is deprecated.</font>''' Please use [http://sugarlabs.org/~buildbot/docs/dev-environment.md.html sugar-build].
  
==Checkout sugar-jhbuild==
+
== sugar-jhbuild ==
 +
Sugar-jhbuild will automatically download the latest of Sugar's dependencies as well as Sugar itself directly from their source repositories, rather than relying on source packages that may have become stale.
 +
Below are generic instructions on how to use jhbuild to get up and running with Sugar.
  
In a suitable directory, execute
+
==Compatible platforms==
  
  git-clone git://dev.laptop.org/sugar-jhbuild
+
Jhbuild is quite demanding with regard to the packages and setup for the host Linux distribution. As a result there are only a few Linux distributions which are known to work with it.
 +
 
 +
See the distribution-specific instructions for information about whether your distribution is currently supported. Other distros which have a recent-enough release (e.g. including the latest stable GNOME release) can be supported if someone is willing to maintain the dependencies for that distro release (in config/sysdeps).
 +
 
 +
==Check distro-specific instructions==
 +
 
 +
Many distributions have some quirks that need to be catered for and there are different package managing tools in use, so please check the page for your distribution before proceeding:
 +
 
 +
* [[/Debian | Debian]]
 +
* [[/Fedora | Fedora]] (some [http://www.youtube.com/profile?user=pleabargain&view=videos&query=jhbuild videos of the Fedora jhbuild install process]).
 +
* [[/Ubuntu | Ubuntu]]
 +
 
 +
Distro packaging guidelines vary, so please don't worry if jhbuild requires twice/half the packages in one distro that it did on another.
 +
 
 +
==Some general advice==
 +
 
 +
Note: Like most other Unix applications, sugar-jhbuild should never be run as root. It may easily screw up your whole system and/or break in unexpected ways if you do. If you get any permissions error, there's something wrong with your installation that should be fixed.
 +
 
 +
If you're stuck or if you get strange errors, feel free to ask for help on the [[Sugar_Labs/Communication channels#irc.freenode.net_channels|#sugar IRC channel]] or the [[Sugar_Labs/Communication channels#Developer_Lists|sugar-devel mailing list]]. Don't waste too much time chasing strange problems: usually it's caused by some basic, easy to fix problem. You might also want to check the [https://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=new&status=reopened&component=sugar-jhbuild bug tracker] to see if it's a known issue.
 +
 
 +
 
 +
==Prerequisites==
 +
; python
 +
: The sugar-jhbuild command is a Python script, so you need the Python interpreter.
 +
; git
 +
: To get the source code of sugar-jhbuild itself and many other Sugar packages you need the <code>git</code> command-line tool from the distributed version control system of the same name. In many distributions the minimal package you need to install is "git-core".
 +
; subversion
 +
: A few packages (as of January 2010, only squeak and part of etoys) do not use git, and you need the <code>svn</code> command-line tool from the Subversion version control system to get their source code.
 +
 
 +
These should be enough to run sugar-jhbuild itself on a typical Linux installation.  Running <code>sugar-jhbuild depscheck</code> (see below) will probably list dozens of additional required packages.
 +
 
 +
==Check out sugar-jhbuild==
 +
 
 +
In a suitable directory (i.e. usually your user's home directory i.e. /home/yourusername/~), execute
 +
  git clone git://git.sugarlabs.org/sugar-jhbuild/mainline.git sugar-jhbuild
 +
 
 +
You'll know if it worked if you get something like this:
 +
<pre>
 +
localhost ~]$ git clone git://git.sugarlabs.org/sugar-jhbuild/mainline.git sugar-jhbuild
 +
Initialized empty Git repository in /home/denny/sugar-jhbuild/.git/
 +
remote: Counting objects: 4688, done.
 +
remote: Compressing objects: 100% (1998/1998), done.
 +
remote: Total 4688 (delta 2759), reused 4488 (delta 2638)
 +
Receiving objects: 100% (4688/4688), 1.86 MiB | 197 KiB/s, done.
 +
Resolving deltas: 100% (2759/2759), done.
 +
</pre>
  
 
==Build sugar base system and its dependencies==
 
==Build sugar base system and its dependencies==
  
Change directory and start the build.
+
Go into the directory you created and start the build. It takes about 30 minutes on a 1.6ghz machine with a wireless G connection.
  
 
  cd sugar-jhbuild
 
  cd sugar-jhbuild
git pull
 
 
  ./sugar-jhbuild update
 
  ./sugar-jhbuild update
 +
./sugar-jhbuild depscheck
 +
 +
Install everything depscheck complains about. [[#Check distro-specific instructions|Read the distro-specific instructions]] for how to do this.
 +
Now build all Sugar packages in sugar-jhbuild:
 +
 
  ./sugar-jhbuild build
 
  ./sugar-jhbuild build
 +
::[http://www.youtube.com/results?search_query=pleabargain+jhbuild&search_type=&aq=f Here are videos of the process].
 +
 +
If everything worked out fine, you can now [[#Run Sugar|run Sugar]].
 +
If it doesn't run or you have other problems read on.
 +
 +
=== Dealing with dependencies ===
 +
 +
''sugar-jhbuild depscheck'' will print a list of required packages. They are part of the distribution you're using and should be installed using your favourite package manager (e.g. aptitude/synaptic for Debian, yum for Fedora).
 +
 +
If you notice that there's a package missing from the <code>./sugar-jhbuild depscheck </code> output (i.e. it's required for Sugar to work properly and not installed, but depscheck does not mention it), please [https://bugs.sugarlabs.org/newticket?component=sugar-jhbuild&version=Git%20as%20of%20bugdate&type=defect&summary=Need%20package%20%3cinsert%20name%20of%20package%3e%20on%20%3cinsert%20name%20of%20distribution%3e&description=%3cplease%20explain%20why%20you%20think%20the%20package%20is%20required%20%28e.g.%20error%20message%29%3e file a bug report] (login required first, but currently no automatic redirection to login page) against the sugar-jhbuild Component in the [https://bugs.sugarlabs.org/ Sugar Labs bug tracker].
 +
 +
===Some tips===
 +
 +
A useful sequence of commands for building Sugar, from the [http://mailman.laptop.org/pipermail/sugar/2007-February/001352.html Sugar mailing list]: (Note that build without -n will update first anyway, so run update separately if you want to see what changed more easily.)
 +
 +
./sugar-jhbuild update
 +
./sugar-jhbuild build -n -a --clean
 +
./sugar-jhbuild run sugar-emulator
  
For the base packages , you may be able to use the binary packages from your GNU distribution instead of building them from scratch. Check the [[:Category:Installing Sugar|Installing]] or [[:Category:Linux distributions|Linux]] categories for specific distro info.
+
The use of -a and --clean flags are needed when a file is removed so that autogen.sh is run. '''Note:''' Some packages, e.g., squeak and etoys, don't have a ''make clean''. Just ignore the error.
  
==Run Sugar==
+
=== If build breaks after an update ===
  
This command launches the Sugar emulator:
+
The packages in sugar-jhbuild are the latest development versions, so you not only get the latest features, but also the latest breakages. The dependencies may change often, too, so be sure to run
 +
./sugar-jhbuild depscheck
 +
regularly and install the missing packages.
  
./sugar-jhbuild run
+
If your problem persists for more than a day (and even though you installed all missing packages), please [https://bugs.sugarlabs.org/newticket?component=sugar-jhbuild&version=Git%20as%20of%20bugdate&type=defect&summary=%3cPlease%20enter%20short%20summary%20of%20your%20problem%20here%3e&description=%3cplease%20copy%20exact%20error%20message%20and%20additional%20information%20here%3e file a bug report].
  
To exit the emulator, press Alt-Q.
+
== Run Sugar ==
  
== Running multiple instances==
+
Note: if you have a non-US keyboard, please follow the instructions on [[#Running sugar in a VNC session|running Sugar in a VNC session]] instead.
To run multiple instances of sugar you can start it in the following way:
 
  
SUGAR_PROFILE=2 ./sugar-jhbuild run
+
This command launches Sugar in a nested X session:
  
== Run an individual activity ==
+
./sugar-jhbuild run sugar-emulator
  
Within the sugar shell (./sugar-jhbuild shell), this command launches an individual activity for testing (from the [http://mailman.laptop.org/pipermail/sugar/2007-March/001720.html mailing list]):
+
To set debug variables, modify <code>~/.sugar/debug</code> (this file will be created on first run of Sugar).
  
  sugar-activity [bundle name]
+
Note that due to a [https://bugs.sugarlabs.org/ticket/342 bug in Xephyr] your keyboard might not work as expected. A partial workaround is to run <code>setxkbmap &lt;keymap name&gt;</code> by adding this command line to <code>~/.sugar/debug</code>. Most "regular" keys should work fine after that, some "special keys" (e.g. cursor up/down) might still refuse to operate as intended. The "keymap name" usually is a two letter country code, e.g. "de" for german or "fr" for french.
  
== Configure the mode and resolution of Sugar ==
+
== Running sugar in a VNC session ==
  
You can make Sugar run in a window as well as specify a resolution. Within the sugar-jhbuild directory, backup, then edit the python program file '''sugar-emulator''':
+
Many users and developers have reported problems with running sugar-emulator because it uses Xephyr. As an alternative, you can run sugar in a VNC session. To accomplish this create a <code>~/.vnc/xstartup</code> file containing the code below:
  
  cp build/bin/sugar-emulator build/bin/sugar-emulator.backup
+
  #!/bin/sh
nano build/bin/sugar-emulator
+
exec ~/sugar-jhbuild/sugar-jhbuild run dbus-launch --exit-with-session sugar
  
Find this piece of code:
+
Note: The above code assumes that sugar-jhbuild is installed in the <code>~/sugar-jhbuild/</code> directory.
  
<PRE>
+
Now, you may run Sugar by creating a VNC session and accessing it using a VNC viewer. E.g.:
    cmd = [ 'Xephyr' ]
+
vncserver :1
    cmd.append(':%d' % display)
+
vncviewer :1
    cmd.append('-ac')
 
  
    if gtk.gdk.screen_width() < 1200 or gtk.gdk.screen_height() < 900:
+
== Run an individual activity ==
        cmd.append('-fullscreen')
 
    else:
 
        cmd.append('-screen')
 
        cmd.append('%dx%d' % (1200, 900))
 
</PRE> 
 
  
Comment out the '''if''' and '''else''' instructions, and specify the screen resolution and mode you want:
+
Within sugar, e.g. in Terminal, this command launches an individual activity for testing:
  
<PRE>
+
sugar-launch ''bundle_name''
    cmd = [ 'Xephyr' ]
 
    cmd.append(':%d' % display)
 
    cmd.append('-ac')
 
  
#    if gtk.gdk.screen_width() < 1200 or gtk.gdk.screen_height() < 900:
+
You will see debug output appearing in Terminal.
#        cmd.append('-fullscreen')
 
#    else:
 
    cmd.append('-screen')
 
    cmd.append('%dx%d' % (800, 600))
 
</PRE>
 
  
Sugar will now run on a 800x600 window.
+
== Configure the mode and resolution of Xephyr ==
 +
 
 +
You can make Xephyr run fullscreen or specify a size (in pixels):
 +
 
 +
./sugar-jhbuild run sugar-emulator --fullscreen
 +
./sugar-jhbuild run sugar-emulator --dimensions 1200x900
 +
./sugar-jhbuild run sugar-emulator --dimensions 832x624
 +
The default size of 800x600 is currently the minimum that should work without issues. I.e., activities should be tested to work in this mode (and in others as well).  832x624 approximates the display proportions of the XO laptops, closely matching the toolbar, for example.
  
 
== Other commands ==
 
== Other commands ==
Line 84: Line 148:
 
  ./sugar-jhbuild --help-commands
 
  ./sugar-jhbuild --help-commands
  
A useful sequence of commands for building Sugar, from the [http://mailman.laptop.org/pipermail/sugar/2007-February/001352.html Sugar mailing list]:
+
== From within Sugar ==
 +
Once you have Sugar running, here are some useful commands (these are not specific to sugar-jhbuild or sugar-emulator, but work in all Sugar sessions):
  
./sugar-jhbuild update
+
*'''Alt+Shift+F''' makes the frame appear and disappear
./sugar-jhbuild build
+
*'''Ctrl-Q''' quits an activity
./sugar-jhbuild run
+
*'''Alt+Shift+Q''' quits Sugar
 +
*'''Alt+Shift+O''' opens the search
 +
*'''Alt+Shift+R''' rotates the screen
  
 
== Customize ==
 
== Customize ==
  
To customize the build create a configuration file, named .olpc.jhbuildrc, in your home directory.
+
To customize the build you can modify the configuration file named <code>sugar.jhbuildrc</code> or create a copy of it and pass <code>--file /path/to/your/new/config</code> to sugar-jhbuild.
  
=== Write access to the repositories ===
+
== Compiling using 2 or more CPU cores ==
  
If you have write access to the repositories you can add:
+
Before running <code>./sugar-jhbuild build</code>, append this to <code>sugar.jhbuildrc</code>:
repos['gnome.org'] = ':ext:marco@cvs.gnome.org:/cvs/gnome'
+
 
repos['mozilla.org'] = ':ext:marco%gnome.org@cvs.mozilla.org:/cvsroot'
+
<pre>
repos['dev.laptop.org'] = 'git+ssh://marco@dev.laptop.org/git/'
+
os.environ["MAKEFLAGS"] = "-j4 -l4"
repos['dev.laptop.org/projects'] = 'git+ssh://marco@dev.laptop.org/git/projects/'
+
</pre>
 +
 
 +
Adjust the numbers to be twice the number of CPU cores in your machine.
 +
 
 +
== Using ccache to speed up rebuilds ==
 +
 
 +
To speed up full rebuilds of sugar-jhbuild (i.e. running <code>./sugar-jhbuild build</code> after removing the <code>source</code> directory) you can use [http://ccache.samba.org/ ccache]. Install it and append the following to <code>sugar.jhbuildrc</code>:
 +
 
 +
<pre>
 +
os.environ["CCACHE_DIR"] = os.path.join(os.path.dirname(__file__), "ccache")
 +
os.environ["PATH"] = "/usr/lib/ccache:"+os.environ["PATH"]
 +
</pre>
 +
 
 +
Adjust <code>/usr/lib/ccache</code> to the path used by your distribution and create the <code>ccache</code> directory (inside your <code>sugar-jhbuild</code> checkout).
 +
 
 +
== Building specific version of Sugar ==
 +
 
 +
To build a specific version of Sugar do the following:
 +
 
 +
* Open ''sugar.jhbuildrc'' and find line:
 +
<pre>modulesets = 'sugar'</pre>
 +
* Set this to:
 +
<pre>modulesets = 'sugar-0.84'</pre>
 +
customizing the latter to your specific needs.
 +
* Copy ''sugar.jhbuildrc'' to ''~/.jhbuildrc''
 +
* <code>./sugar-jhbuild</code>
 +
 
 +
=== Suggestions ===
 +
 
 +
* Copy all your sugar-jhbuild to sugar-jhbuild-0.84 (for example) or check the repositories out again.
 +
* <code>rm -r install source/</code>
 +
* If you want to keep the <code>source</code> directory to save bandwidth, you need to be extra careful: delete all unpacked tarballs and  cleanup all git repositories with <code>git clean -d -a</code>.
 +
* Don't forget to delete or modify ''.jhbuildrc'' after building the specific version of Sugar if you still want to receive the latest updates from the repositories, '''OR'''
 +
* Create another user.
 +
 
 +
==Useful Internal Links==
 +
* [[Development Team/Understanding the Code|Understanding Sugar Code]]
 +
* [[Taxonomy]] -- explains the components of Sugar (Glucose, Fructose, Sugar, Starches)
 +
* [[Sugar Instructions]] -- how to actually use Sugar once you have it running[http://en.flossmanuals.net/sugar]
  
 
==External links==
 
==External links==
  
* [http://www.gnome.org/~jamesh/jhbuild.html JHBuild manual]
+
* [http://library.gnome.org/devel/jhbuild/unstable/ JHBuild manual]
* [http://www.redhatmagazine.com/2007/02/23/building-the-xo-introducing-sugar/ Red Hat Magazine article: Introducing Sugar]
+
 
* [http://learn.laptop.org/tinderbox/ Tinderbox] (see the "Sugar JHBuild" tab).  The old [http://dev.laptop.org/~cjb/sugar-tinder/ sugar-jhbuild tinderbox].
+
 
 +
== Known issues==
 +
 
 +
=== Known issue with hulahop ===
 +
 
 +
* hulahop stopped building because I had installed a more recent version of xulrunner on my machine. The workaround was to <code>rm -rf ~/sugar-jhbuild/source/hulahop</code> and then run update and build again.
  
 
[[Category:Installing Sugar]]
 
[[Category:Installing Sugar]]
 +
[[Category:Jhbuild]]
 +
 +
 +
 +
== Dual-Booting F17 and F14 ==
 +
 +
 +
=== Install F17, using a LiveUSB. This would erase all the previous existing OSes (if any). ===
 +
 +
* Start "Install to Hard Drive".
 +
 +
* Choose "Use the entire space", with "Use LVM" UNCHECKED. Note that this is important, since using the LVM option prevents the drive to be partitioned later for the two Fedoras.
 +
 +
* When asked for bootloader-installation position, choose "MBR in /dev/sda".
 +
 +
* Installation should complete successfully.
 +
 +
 +
 +
=== Re-install F17, using a LiveUSB (but this time on a dedicated partition) ===
 +
 +
* Start "Install to Hard Drive".
 +
 +
* Choose "Create Custom Layout".
 +
 +
* Delete "dev/sda4" (extended-partition-root). This should also automatially delete "/dev/sda5" (extended-partition-leaf).
 +
 +
* Now, select on the "Free" chunk (mine was 500 GB).
 +
** Click "Edit".
 +
** Select "/" as the mount-point.
 +
** Choose an appropriate space (I chose 300 GB).
 +
** Click "OK".
 +
** This sould create "/dev/sda4" as the extended-partition-root, and "/dev/sda5" (worth 300 GB of space) as extended-partition-leaf.
 +
 +
* Click "Next".
 +
 +
* When asked for bootloader-installation position, choose "MBR in /dev/sda".
 +
 +
* Installation should complete successfully.
 +
 +
 +
 +
=== Install F14, using a LiveUSB (on a dedicated partition) ===
 +
 +
* Start "Install to Hard Drive".
 +
 +
* Choose "Create Custom Layout".
 +
 +
* Now, select on the "Free" chunk (mine was about 175 GB).
 +
** Click "Edit".
 +
** Select "/" as the mount-point.
 +
** Choose an appropriate space (I chose 175 GB).
 +
** Click "OK".
 +
** This sould create "/dev/sda6" as the extended-partition-leaf.
 +
 +
* Click "Next".
 +
 +
* When asked for bootloader-installation position, choose "First sector of /dev/sda6".
 +
 +
* Installation should complete successfully.
 +
 +
 +
 +
=== Enabling dual-boot ===
 +
 +
* At the moment, with all LiveUSBs removed, I was able to boot into F17 only. I could not see any option to boot into F14.
 +
 +
 +
* Boot into F17.
 +
 +
 +
* In one terminal, open the file "/etc/grub2.cfg" (in editable mode). The original contents should be on the lines of
 +
<pre>
 +
#
 +
# DO NOT EDIT THIS FILE
 +
#
 +
# It is automatically generated by grub2-mkconfig using templates
 +
# from /etc/grub.d and settings from /etc/default/grub
 +
#
 +
 +
### BEGIN /etc/grub.d/00_header ###
 +
if [ -s $prefix/grubenv ]; then
 +
  load_env
 +
fi
 +
set default="${saved_entry}"
 +
 +
if [ x"${feature_menuentry_id}" = xy ]; then
 +
  menuentry_id_option="--id"
 +
else
 +
  menuentry_id_option=""
 +
fi
 +
 +
export menuentry_id_option
 +
 +
if [ "${prev_saved_entry}" ]; then
 +
  set saved_entry="${prev_saved_entry}"
 +
  save_env saved_entry
 +
  set prev_saved_entry=
 +
  save_env prev_saved_entry
 +
  set boot_once=true
 +
fi
 +
 +
function savedefault {
 +
  if [ -z "${boot_once}" ]; then
 +
    saved_entry="${chosen}"
 +
    save_env saved_entry
 +
  fi
 +
}
 +
 +
function load_video {
 +
  if [ x$feature_all_video_module = xy ]; then
 +
    insmod all_video
 +
  else
 +
    insmod efi_gop
 +
    insmod efi_uga
 +
    insmod ieee1275_fb
 +
    insmod vbe
 +
    insmod vga
 +
    insmod video_bochs
 +
    insmod video_cirrus
 +
  fi
 +
}
 +
 +
if [ x$feature_default_font_path = xy ] ; then
 +
  font=unicode
 +
else
 +
insmod part_msdos
 +
insmod ext2
 +
set root='hd0,msdos5'
 +
if [ x$feature_platform_search_hint = xy ]; then
 +
  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
else
 +
  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
fi
 +
    font="/usr/share/grub/unicode.pf2"
 +
fi
 +
 +
if loadfont $font ; then
 +
  set gfxmode=auto
 +
  load_video
 +
  insmod gfxterm
 +
  set locale_dir=$prefix/locale
 +
  set lang=en_US
 +
  insmod gettext
 +
fi
 +
terminal_output gfxterm
 +
set timeout=5
 +
### END /etc/grub.d/00_header ###
 +
 +
### BEGIN /etc/grub.d/10_linux ###
 +
menuentry 'Fedora Linux' --class fedora --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-simple-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
 +
load_video
 +
set gfxpayload=keep
 +
insmod gzio
 +
insmod part_msdos
 +
insmod ext2
 +
set root='hd0,msdos5'
 +
if [ x$feature_platform_search_hint = xy ]; then
 +
  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
else
 +
  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
fi
 +
echo 'Loading Linux 3.3.4-5.fc17.i686 ...'
 +
linux /boot/vmlinuz-3.3.4-5.fc17.i686 root=UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 ro rd.md=0 rd.lvm=0 rd.dm=0 SYSFONT=True  KEYTABLE=us rd.luks=0 LANG=en_US.UTF-8 rhgb quiet
 +
echo 'Loading initial ramdisk ...'
 +
initrd /boot/initramfs-3.3.4-5.fc17.i686.img
 +
}
 +
submenu 'Advanced options for Fedora Linux' $menuentry_id_option 'gnulinux-advanced-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
 +
menuentry 'Fedora Linux, with Linux 3.3.4-5.fc17.i686' --class fedora --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-3.3.4-5.fc17.i686-advanced-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
 +
load_video
 +
set gfxpayload=keep
 +
insmod gzio
 +
insmod part_msdos
 +
insmod ext2
 +
set root='hd0,msdos5'
 +
if [ x$feature_platform_search_hint = xy ]; then
 +
  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
else
 +
  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
fi
 +
echo 'Loading Linux 3.3.4-5.fc17.i686 ...'
 +
linux /boot/vmlinuz-3.3.4-5.fc17.i686 root=UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 ro rd.md=0 rd.lvm=0 rd.dm=0 SYSFONT=True  KEYTABLE=us rd.luks=0 LANG=en_US.UTF-8 rhgb quiet
 +
echo 'Loading initial ramdisk ...'
 +
initrd /boot/initramfs-3.3.4-5.fc17.i686.img
 +
}
 +
menuentry 'Fedora Linux, with Linux 3.3.4-5.fc17.i686 (recovery mode)' --class fedora --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-3.3.4-5.fc17.i686-recovery-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
 +
load_video
 +
set gfxpayload=keep
 +
insmod gzio
 +
insmod part_msdos
 +
insmod ext2
 +
set root='hd0,msdos5'
 +
if [ x$feature_platform_search_hint = xy ]; then
 +
  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
else
 +
  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
fi
 +
echo 'Loading Linux 3.3.4-5.fc17.i686 ...'
 +
linux /boot/vmlinuz-3.3.4-5.fc17.i686 root=UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 ro single rd.md=0 rd.lvm=0 rd.dm=0 SYSFONT=True  KEYTABLE=us rd.luks=0 LANG=en_US.UTF-8 rhgb quiet
 +
echo 'Loading initial ramdisk ...'
 +
initrd /boot/initramfs-3.3.4-5.fc17.i686.img
 +
}
 +
}
 +
if [ "x$default" = 'Fedora Linux, with Linux 3.3.4-5.fc17.i686' ]; then default='Advanced options for Fedora Linux>Fedora Linux, with Linux 3.3.4-5.fc17.i686'; fi;
 +
### END /etc/grub.d/10_linux ###
 +
 +
### BEGIN /etc/grub.d/20_linux_xen ###
 +
### END /etc/grub.d/20_linux_xen ###
 +
 +
### BEGIN /etc/grub.d/20_ppc_terminfo ###
 +
### END /etc/grub.d/20_ppc_terminfo ###
 +
 +
### BEGIN /etc/grub.d/30_os-prober ###
 +
menuentry 'Fedora release 17 (Beefy Miracle)' --class gnu-linux --class gnu --class os $menuentry_id_option 'osprober-gnulinux-simple-9a669232-ec18-4571-85da-904db5b24112' {
 +
insmod part_msdos
 +
insmod ext2
 +
set root='hd0,msdos1'
 +
if [ x$feature_platform_search_hint = xy ]; then
 +
  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos1 --hint-efi=hd0,msdos1 --hint-baremetal=ahci0,msdos1 --hint='hd0,msdos1'  f2a4fc34-1b1d-494e-903f-7481e6381302
 +
else
 +
  search --no-floppy --fs-uuid --set=root f2a4fc34-1b1d-494e-903f-7481e6381302
 +
fi
 +
linux /vmlinuz-3.3.4-5.fc17.i686 root=/dev/sda2
 +
initrd /initramfs-3.3.4-5.fc17.i686.img
 +
}
 +
submenu 'Advanced options for Fedora release 17 (Beefy Miracle)' $menuentry_id_option 'osprober-gnulinux-advanced-9a669232-ec18-4571-85da-904db5b24112' {
 +
menuentry 'Fedora release 17 (Beefy Miracle) (on /dev/sda2)' --class gnu-linux --class gnu --class os $menuentry_id_option 'osprober-gnulinux-/vmlinuz-3.3.4-5.fc17.i686--9a669232-ec18-4571-85da-904db5b24112' {
 +
insmod part_msdos
 +
insmod ext2
 +
set root='hd0,msdos1'
 +
if [ x$feature_platform_search_hint = xy ]; then
 +
  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos1 --hint-efi=hd0,msdos1 --hint-baremetal=ahci0,msdos1 --hint='hd0,msdos1'  f2a4fc34-1b1d-494e-903f-7481e6381302
 +
else
 +
  search --no-floppy --fs-uuid --set=root f2a4fc34-1b1d-494e-903f-7481e6381302
 +
fi
 +
linux /vmlinuz-3.3.4-5.fc17.i686 root=/dev/sda2
 +
initrd /initramfs-3.3.4-5.fc17.i686.img
 +
}
 +
}
 +
 +
### END /etc/grub.d/30_os-prober ###
 +
 +
### BEGIN /etc/grub.d/40_custom ###
 +
# This file provides an easy way to add custom menu entries.  Simply type the
 +
# menu entries you want to add after this comment.  Be careful not to change
 +
# the 'exec tail' line above.
 +
### END /etc/grub.d/40_custom ###
 +
 +
### BEGIN /etc/grub.d/41_custom ###
 +
if [ -f  $prefix/custom.cfg ]; then
 +
  source $prefix/custom.cfg;
 +
fi
 +
### END /etc/grub.d/41_custom ###
 +
</pre>
 +
 +
 +
 +
 +
* In another terminal, mount F14 on a directory.
 +
<pre>
 +
[ajay@localhost ~]$ su -
 +
Password:
 +
 +
[root@localhost ~]# mkdir qq
 +
 +
[root@localhost ~]# mount -t ext4 /dev/sda6 qq
 +
 +
[root@localhost ~]# ls -l qq/boot
 +
total 19064
 +
-rw-r--r--. 1 root root  114968 Oct 18  2010 config-2.6.35.6-45.fc14.i686
 +
drwxr-xr-x. 3 root root    4096 Oct 22  2010 efi
 +
-rw-r--r--. 1 root root  166756 May 25  2010 elf-memtest86+-4.10
 +
drwxr-xr-x. 2 root root    4096 Aug  5  2010 grub
 +
-rw-r--r--. 1 root root 12562626 Jun 15 15:59 initramfs-2.6.35.6-45.fc14.i686.img
 +
-rw-r--r--. 1 root root  1106254 Oct 22  2010 initrd-plymouth.img
 +
-rw-r--r--. 1 root root  165080 May 25  2010 memtest86+-4.10
 +
-rw-r--r--. 1 root root  1681526 Oct 18  2010 System.map-2.6.35.6-45.fc14.i686
 +
-rwxr-xr-x. 1 root root  3696448 Oct 18  2010 vmlinuz-2.6.35.6-45.fc14.i686
 +
</pre>
 +
 +
 +
 +
 +
* Now, open the contents of "qq/boot/grub/menu.lst"
 +
<pre>
 +
# grub.conf generated by anaconda
 +
#
 +
# Note that you do not have to rerun grub after making changes to this file
 +
# NOTICE:  You do not have a /boot partition.  This means that
 +
#          all kernel and initrd paths are relative to /, eg.
 +
#          root (hd0,5)
 +
#          kernel /boot/vmlinuz-version ro root=/dev/sda6
 +
#          initrd /boot/initrd-[generic-]version.img
 +
#boot=/dev/sda6
 +
default=0
 +
timeout=0
 +
splashimage=(hd0,5)/boot/grub/splash.xpm.gz
 +
hiddenmenu
 +
title Fedora (2.6.35.6-45.fc14.i686)
 +
root (hd0,5)
 +
kernel /boot/vmlinuz-2.6.35.6-45.fc14.i686 ro root=UUID=333b5104-4f4a-41d9-856a-c7802677bec0 rd_NO_LUKS rd_NO_LVM rd_NO_MD rd_NO_DM LANG=en_US.UTF-8 SYSFONT=latarcyrheb-sun16 KEYBOARDTYPE=pc KEYTABLE=us rhgb quiet
 +
initrd /boot/initramfs-2.6.35.6-45.fc14.i686.img
 +
</pre>
 +
 +
 +
 +
 +
* Now, in the originally opened "/etc/grub2.cfg", add the entry for boot-option for Fedora-14. Take note that
 +
** Replace the UUID, with the UUID of F14 partition (as seen from contents of "qq/boot/grub/menu.lst".
 +
 +
 +
** The arguments to "initrd" should of the initramfs of  F14 (As seen from the output of '''ls qq/boot''').
 +
 +
 +
** '''hd0,msdos5''' (corresponding to "/dev/sda5" for F17) is replaced by '''hd0,msdos6''' (corresponding to "/dev/sda6" for F14).
 +
 +
 +
** Finally, the command '''kernel /boot/vmlinuz-2.6.35.6-45.fc14.i686 ro root=UUID=333b5104-4f4a-41d9-856a-c7802677bec0 rd_NO_LUKS rd_NO_LVM rd_NO_MD rd_NO_DM LANG=en_US.UTF-8 SYSFONT=latarcyrheb-sun16 KEYBOARDTYPE=pc KEYTABLE=us rhgb quiet''' (as seen in '''qq/boot/grub/menu.lst''', used to boot up kernel vis F14's grub) is replaced by '''linux /boot/vmlinuz-2.6.35.6-45.fc14.i686 ro root=UUID=333b5104-4f4a-41d9-856a-c7802677bec0 rd_NO_LUKS rd_NO_LVM rd_NO_MD rd_NO_DM LANG=en_US.UTF-8 SYSFONT=latarcyrheb-sun16 KEYBOARDTYPE=pc KEYTABLE=us rhgb quiet''' (in '''/etc/grub2.cfg''', since we intend to boot F14 via F17's grub2).
 +
 +
 +
<pre>
 +
#
 +
# DO NOT EDIT THIS FILE
 +
#
 +
# It is automatically generated by grub2-mkconfig using templates
 +
# from /etc/grub.d and settings from /etc/default/grub
 +
#
 +
 +
### BEGIN /etc/grub.d/00_header ###
 +
if [ -s $prefix/grubenv ]; then
 +
  load_env
 +
fi
 +
set default="${saved_entry}"
 +
 +
if [ x"${feature_menuentry_id}" = xy ]; then
 +
  menuentry_id_option="--id"
 +
else
 +
  menuentry_id_option=""
 +
fi
 +
 +
export menuentry_id_option
 +
 +
if [ "${prev_saved_entry}" ]; then
 +
  set saved_entry="${prev_saved_entry}"
 +
  save_env saved_entry
 +
  set prev_saved_entry=
 +
  save_env prev_saved_entry
 +
  set boot_once=true
 +
fi
 +
 +
function savedefault {
 +
  if [ -z "${boot_once}" ]; then
 +
    saved_entry="${chosen}"
 +
    save_env saved_entry
 +
  fi
 +
}
 +
 +
function load_video {
 +
  if [ x$feature_all_video_module = xy ]; then
 +
    insmod all_video
 +
  else
 +
    insmod efi_gop
 +
    insmod efi_uga
 +
    insmod ieee1275_fb
 +
    insmod vbe
 +
    insmod vga
 +
    insmod video_bochs
 +
    insmod video_cirrus
 +
  fi
 +
}
 +
 +
if [ x$feature_default_font_path = xy ] ; then
 +
  font=unicode
 +
else
 +
insmod part_msdos
 +
insmod ext2
 +
set root='hd0,msdos5'
 +
if [ x$feature_platform_search_hint = xy ]; then
 +
  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
else
 +
  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
fi
 +
    font="/usr/share/grub/unicode.pf2"
 +
fi
 +
 +
if loadfont $font ; then
 +
  set gfxmode=auto
 +
  load_video
 +
  insmod gfxterm
 +
  set locale_dir=$prefix/locale
 +
  set lang=en_US
 +
  insmod gettext
 +
fi
 +
terminal_output gfxterm
 +
set timeout=5
 +
### END /etc/grub.d/00_header ###
 +
 +
### BEGIN /etc/grub.d/10_linux ###
 +
menuentry 'Fedora Linux' --class fedora --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-simple-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
 +
load_video
 +
set gfxpayload=keep
 +
insmod gzio
 +
insmod part_msdos
 +
insmod ext2
 +
set root='hd0,msdos5'
 +
if [ x$feature_platform_search_hint = xy ]; then
 +
  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
else
 +
  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
fi
 +
echo 'Loading Linux 3.3.4-5.fc17.i686 ...'
 +
linux /boot/vmlinuz-3.3.4-5.fc17.i686 root=UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 ro rd.md=0 rd.lvm=0 rd.dm=0 SYSFONT=True  KEYTABLE=us rd.luks=0 LANG=en_US.UTF-8 rhgb quiet
 +
echo 'Loading initial ramdisk ...'
 +
initrd /boot/initramfs-3.3.4-5.fc17.i686.img
 +
}
 +
### [STARTS] OPTION TO ADD BOOT-UP OPTION FOR F14 ###
 +
menuentry 'Fedora Linux 14' --class fedora --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-simple-333b5104-4f4a-41d9-856a-c7802677bec0' {
 +
load_video
 +
set gfxpayload=keep
 +
insmod gzio
 +
insmod part_msdos
 +
insmod ext2
 +
set root='hd0,msdos6'
 +
if [ x$feature_platform_search_hint = xy ]; then
 +
  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos6 --hint-efi=hd0,msdos6 --hint-baremetal=ahci0,msdos6 --hint='hd0,msdos6'  333b5104-4f4a-41d9-856a-c7802677bec0
 +
else
 +
  search --no-floppy --fs-uuid --set=root 333b5104-4f4a-41d9-856a-c7802677bec0
 +
fi
 +
echo 'Loading Linux 14 waala ...'
 +
linux /boot/vmlinuz-2.6.35.6-45.fc14.i686 ro root=UUID=333b5104-4f4a-41d9-856a-c7802677bec0 rd_NO_LUKS rd_NO_LVM rd_NO_MD rd_NO_DM LANG=en_US.UTF-8 SYSFONT=latarcyrheb-sun16 KEYBOARDTYPE=pc KEYTABLE=us rhgb quiet
 +
echo 'Loading initial ramdisk ...'
 +
initrd /boot/initramfs-2.6.35.6-45.fc14.i686.img
 +
}
 +
### [ENDS] OPTION TO ADD BOOT-UP OPTION FOR F14 ###
 +
submenu 'Advanced options for Fedora Linux' $menuentry_id_option 'gnulinux-advanced-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
 +
menuentry 'Fedora Linux, with Linux 3.3.4-5.fc17.i686' --class fedora --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-3.3.4-5.fc17.i686-advanced-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
 +
load_video
 +
set gfxpayload=keep
 +
insmod gzio
 +
insmod part_msdos
 +
insmod ext2
 +
set root='hd0,msdos5'
 +
if [ x$feature_platform_search_hint = xy ]; then
 +
  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
else
 +
  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
fi
 +
echo 'Loading Linux 3.3.4-5.fc17.i686 ...'
 +
linux /boot/vmlinuz-3.3.4-5.fc17.i686 root=UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 ro rd.md=0 rd.lvm=0 rd.dm=0 SYSFONT=True  KEYTABLE=us rd.luks=0 LANG=en_US.UTF-8 rhgb quiet
 +
echo 'Loading initial ramdisk ...'
 +
initrd /boot/initramfs-3.3.4-5.fc17.i686.img
 +
}
 +
menuentry 'Fedora Linux, with Linux 3.3.4-5.fc17.i686 (recovery mode)' --class fedora --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-3.3.4-5.fc17.i686-recovery-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
 +
load_video
 +
set gfxpayload=keep
 +
insmod gzio
 +
insmod part_msdos
 +
insmod ext2
 +
set root='hd0,msdos5'
 +
if [ x$feature_platform_search_hint = xy ]; then
 +
  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
else
 +
  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
 +
fi
 +
echo 'Loading Linux 3.3.4-5.fc17.i686 ...'
 +
linux /boot/vmlinuz-3.3.4-5.fc17.i686 root=UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 ro single rd.md=0 rd.lvm=0 rd.dm=0 SYSFONT=True  KEYTABLE=us rd.luks=0 LANG=en_US.UTF-8 rhgb quiet
 +
echo 'Loading initial ramdisk ...'
 +
initrd /boot/initramfs-3.3.4-5.fc17.i686.img
 +
}
 +
}
 +
if [ "x$default" = 'Fedora Linux, with Linux 3.3.4-5.fc17.i686' ]; then default='Advanced options for Fedora Linux>Fedora Linux, with Linux 3.3.4-5.fc17.i686'; fi;
 +
### END /etc/grub.d/10_linux ###
 +
 +
### BEGIN /etc/grub.d/20_linux_xen ###
 +
### END /etc/grub.d/20_linux_xen ###
 +
 +
### BEGIN /etc/grub.d/20_ppc_terminfo ###
 +
### END /etc/grub.d/20_ppc_terminfo ###
 +
 +
### BEGIN /etc/grub.d/30_os-prober ###
 +
menuentry 'Fedora release 17 (Beefy Miracle)' --class gnu-linux --class gnu --class os $menuentry_id_option 'osprober-gnulinux-simple-9a669232-ec18-4571-85da-904db5b24112' {
 +
insmod part_msdos
 +
insmod ext2
 +
set root='hd0,msdos1'
 +
if [ x$feature_platform_search_hint = xy ]; then
 +
  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos1 --hint-efi=hd0,msdos1 --hint-baremetal=ahci0,msdos1 --hint='hd0,msdos1'  f2a4fc34-1b1d-494e-903f-7481e6381302
 +
else
 +
  search --no-floppy --fs-uuid --set=root f2a4fc34-1b1d-494e-903f-7481e6381302
 +
fi
 +
linux /vmlinuz-3.3.4-5.fc17.i686 root=/dev/sda2
 +
initrd /initramfs-3.3.4-5.fc17.i686.img
 +
}
 +
submenu 'Advanced options for Fedora release 17 (Beefy Miracle)' $menuentry_id_option 'osprober-gnulinux-advanced-9a669232-ec18-4571-85da-904db5b24112' {
 +
menuentry 'Fedora release 17 (Beefy Miracle) (on /dev/sda2)' --class gnu-linux --class gnu --class os $menuentry_id_option 'osprober-gnulinux-/vmlinuz-3.3.4-5.fc17.i686--9a669232-ec18-4571-85da-904db5b24112' {
 +
insmod part_msdos
 +
insmod ext2
 +
set root='hd0,msdos1'
 +
if [ x$feature_platform_search_hint = xy ]; then
 +
  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos1 --hint-efi=hd0,msdos1 --hint-baremetal=ahci0,msdos1 --hint='hd0,msdos1'  f2a4fc34-1b1d-494e-903f-7481e6381302
 +
else
 +
  search --no-floppy --fs-uuid --set=root f2a4fc34-1b1d-494e-903f-7481e6381302
 +
fi
 +
linux /vmlinuz-3.3.4-5.fc17.i686 root=/dev/sda2
 +
initrd /initramfs-3.3.4-5.fc17.i686.img
 +
}
 +
}
 +
 +
### END /etc/grub.d/30_os-prober ###
 +
 +
### BEGIN /etc/grub.d/40_custom ###
 +
# This file provides an easy way to add custom menu entries.  Simply type the
 +
# menu entries you want to add after this comment.  Be careful not to change
 +
# the 'exec tail' line above.
 +
### END /etc/grub.d/40_custom ###
 +
 +
### BEGIN /etc/grub.d/41_custom ###
 +
if [ -f  $prefix/custom.cfg ]; then
 +
  source $prefix/custom.cfg;
 +
fi
 +
### END /etc/grub.d/41_custom ###
 +
</pre>
 +
 +
 +
 +
* As a last step, change "/etc/fstab" from
 +
<pre>
 +
 +
#
 +
# /etc/fstab
 +
# Created by anaconda on Fri Jun 15 15:30:02 2012
 +
#
 +
# Accessible filesystems, by reference, are maintained under '/dev/disk'
 +
# See man pages fstab(5), findfs(8), mount(8) and/or blkid(8) for more info
 +
#
 +
UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 /                      ext4    defaults        1 1
 +
UUID=9d06cbba-57e6-4cb2-93be-61a430601a67 swap                    swap    defaults        0 0
 +
</pre>
 +
 +
to
 +
 +
<pre>
 +
 +
#
 +
# /etc/fstab
 +
# Created by anaconda on Fri Jun 15 15:30:02 2012
 +
#
 +
# Accessible filesystems, by reference, are maintained under '/dev/disk'
 +
# See man pages fstab(5), findfs(8), mount(8) and/or blkid(8) for more info
 +
#
 +
UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 /                      ext4    defaults        1 1
 +
UUID=333b5104-4f4a-41d9-856a-c7802677bec0 /                      ext4    defaults        1 1
 +
UUID=9d06cbba-57e6-4cb2-93be-61a430601a67 swap                    swap    defaults        0 0
 +
</pre>
 +
 +
 +
 +
* Reboot. Now the option to boot into F14 should be present (in options via F17's grub).
 +
 +
 +
 +
=== Useful links ===
 +
 +
* http://www.dedoimedo.com/computers/grub-2.html
 +
 +
[[Category:Jhbuild]]

Latest revision as of 16:43, 28 August 2013

english | 日本語 | spanish HowTo [ID# 89573]  +/-  
Stop hand.png NOTE:
The content of this page is considered
DEPRECATED and OBSOLETE
It is preserved for historical research, along with its talk page.


Deprecated

Note: Sugar-jhbuild is deprecated. Please use sugar-build.

sugar-jhbuild

Sugar-jhbuild will automatically download the latest of Sugar's dependencies as well as Sugar itself directly from their source repositories, rather than relying on source packages that may have become stale. Below are generic instructions on how to use jhbuild to get up and running with Sugar.

Compatible platforms

Jhbuild is quite demanding with regard to the packages and setup for the host Linux distribution. As a result there are only a few Linux distributions which are known to work with it.

See the distribution-specific instructions for information about whether your distribution is currently supported. Other distros which have a recent-enough release (e.g. including the latest stable GNOME release) can be supported if someone is willing to maintain the dependencies for that distro release (in config/sysdeps).

Check distro-specific instructions

Many distributions have some quirks that need to be catered for and there are different package managing tools in use, so please check the page for your distribution before proceeding:

Distro packaging guidelines vary, so please don't worry if jhbuild requires twice/half the packages in one distro that it did on another.

Some general advice

Note: Like most other Unix applications, sugar-jhbuild should never be run as root. It may easily screw up your whole system and/or break in unexpected ways if you do. If you get any permissions error, there's something wrong with your installation that should be fixed.

If you're stuck or if you get strange errors, feel free to ask for help on the #sugar IRC channel or the sugar-devel mailing list. Don't waste too much time chasing strange problems: usually it's caused by some basic, easy to fix problem. You might also want to check the bug tracker to see if it's a known issue.


Prerequisites

python
The sugar-jhbuild command is a Python script, so you need the Python interpreter.
git
To get the source code of sugar-jhbuild itself and many other Sugar packages you need the git command-line tool from the distributed version control system of the same name. In many distributions the minimal package you need to install is "git-core".
subversion
A few packages (as of January 2010, only squeak and part of etoys) do not use git, and you need the svn command-line tool from the Subversion version control system to get their source code.

These should be enough to run sugar-jhbuild itself on a typical Linux installation. Running sugar-jhbuild depscheck (see below) will probably list dozens of additional required packages.

Check out sugar-jhbuild

In a suitable directory (i.e. usually your user's home directory i.e. /home/yourusername/~), execute

git clone git://git.sugarlabs.org/sugar-jhbuild/mainline.git sugar-jhbuild

You'll know if it worked if you get something like this:

localhost ~]$ git clone git://git.sugarlabs.org/sugar-jhbuild/mainline.git sugar-jhbuild
Initialized empty Git repository in /home/denny/sugar-jhbuild/.git/
remote: Counting objects: 4688, done.
remote: Compressing objects: 100% (1998/1998), done.
remote: Total 4688 (delta 2759), reused 4488 (delta 2638)
Receiving objects: 100% (4688/4688), 1.86 MiB | 197 KiB/s, done.
Resolving deltas: 100% (2759/2759), done.

Build sugar base system and its dependencies

Go into the directory you created and start the build. It takes about 30 minutes on a 1.6ghz machine with a wireless G connection.

cd sugar-jhbuild
./sugar-jhbuild update
./sugar-jhbuild depscheck

Install everything depscheck complains about. Read the distro-specific instructions for how to do this. Now build all Sugar packages in sugar-jhbuild:

./sugar-jhbuild build
Here are videos of the process.

If everything worked out fine, you can now run Sugar. If it doesn't run or you have other problems read on.

Dealing with dependencies

sugar-jhbuild depscheck will print a list of required packages. They are part of the distribution you're using and should be installed using your favourite package manager (e.g. aptitude/synaptic for Debian, yum for Fedora).

If you notice that there's a package missing from the ./sugar-jhbuild depscheck output (i.e. it's required for Sugar to work properly and not installed, but depscheck does not mention it), please file a bug report (login required first, but currently no automatic redirection to login page) against the sugar-jhbuild Component in the Sugar Labs bug tracker.

Some tips

A useful sequence of commands for building Sugar, from the Sugar mailing list: (Note that build without -n will update first anyway, so run update separately if you want to see what changed more easily.)

./sugar-jhbuild update
./sugar-jhbuild build -n -a --clean
./sugar-jhbuild run sugar-emulator

The use of -a and --clean flags are needed when a file is removed so that autogen.sh is run. Note: Some packages, e.g., squeak and etoys, don't have a make clean. Just ignore the error.

If build breaks after an update

The packages in sugar-jhbuild are the latest development versions, so you not only get the latest features, but also the latest breakages. The dependencies may change often, too, so be sure to run

./sugar-jhbuild depscheck

regularly and install the missing packages.

If your problem persists for more than a day (and even though you installed all missing packages), please file a bug report.

Run Sugar

Note: if you have a non-US keyboard, please follow the instructions on running Sugar in a VNC session instead.

This command launches Sugar in a nested X session:

./sugar-jhbuild run sugar-emulator

To set debug variables, modify ~/.sugar/debug (this file will be created on first run of Sugar).

Note that due to a bug in Xephyr your keyboard might not work as expected. A partial workaround is to run setxkbmap <keymap name> by adding this command line to ~/.sugar/debug. Most "regular" keys should work fine after that, some "special keys" (e.g. cursor up/down) might still refuse to operate as intended. The "keymap name" usually is a two letter country code, e.g. "de" for german or "fr" for french.

Running sugar in a VNC session

Many users and developers have reported problems with running sugar-emulator because it uses Xephyr. As an alternative, you can run sugar in a VNC session. To accomplish this create a ~/.vnc/xstartup file containing the code below:

#!/bin/sh
exec ~/sugar-jhbuild/sugar-jhbuild run dbus-launch --exit-with-session sugar

Note: The above code assumes that sugar-jhbuild is installed in the ~/sugar-jhbuild/ directory.

Now, you may run Sugar by creating a VNC session and accessing it using a VNC viewer. E.g.:

vncserver :1
vncviewer :1

Run an individual activity

Within sugar, e.g. in Terminal, this command launches an individual activity for testing:

sugar-launch bundle_name

You will see debug output appearing in Terminal.

Configure the mode and resolution of Xephyr

You can make Xephyr run fullscreen or specify a size (in pixels):

./sugar-jhbuild run sugar-emulator --fullscreen
./sugar-jhbuild run sugar-emulator --dimensions 1200x900
./sugar-jhbuild run sugar-emulator --dimensions 832x624

The default size of 800x600 is currently the minimum that should work without issues. I.e., activities should be tested to work in this mode (and in others as well). 832x624 approximates the display proportions of the XO laptops, closely matching the toolbar, for example.

Other commands

JHBuild has several other commands that can be useful for development. You can get an overview with:

./sugar-jhbuild --help-commands

From within Sugar

Once you have Sugar running, here are some useful commands (these are not specific to sugar-jhbuild or sugar-emulator, but work in all Sugar sessions):

  • Alt+Shift+F makes the frame appear and disappear
  • Ctrl-Q quits an activity
  • Alt+Shift+Q quits Sugar
  • Alt+Shift+O opens the search
  • Alt+Shift+R rotates the screen

Customize

To customize the build you can modify the configuration file named sugar.jhbuildrc or create a copy of it and pass --file /path/to/your/new/config to sugar-jhbuild.

Compiling using 2 or more CPU cores

Before running ./sugar-jhbuild build, append this to sugar.jhbuildrc:

os.environ["MAKEFLAGS"] = "-j4 -l4"

Adjust the numbers to be twice the number of CPU cores in your machine.

Using ccache to speed up rebuilds

To speed up full rebuilds of sugar-jhbuild (i.e. running ./sugar-jhbuild build after removing the source directory) you can use ccache. Install it and append the following to sugar.jhbuildrc:

os.environ["CCACHE_DIR"] = os.path.join(os.path.dirname(__file__), "ccache")
os.environ["PATH"] = "/usr/lib/ccache:"+os.environ["PATH"]

Adjust /usr/lib/ccache to the path used by your distribution and create the ccache directory (inside your sugar-jhbuild checkout).

Building specific version of Sugar

To build a specific version of Sugar do the following:

  • Open sugar.jhbuildrc and find line:
modulesets = 'sugar'
  • Set this to:
modulesets = 'sugar-0.84'

customizing the latter to your specific needs.

  • Copy sugar.jhbuildrc to ~/.jhbuildrc
  • ./sugar-jhbuild

Suggestions

  • Copy all your sugar-jhbuild to sugar-jhbuild-0.84 (for example) or check the repositories out again.
  • rm -r install source/
  • If you want to keep the source directory to save bandwidth, you need to be extra careful: delete all unpacked tarballs and cleanup all git repositories with git clean -d -a.
  • Don't forget to delete or modify .jhbuildrc after building the specific version of Sugar if you still want to receive the latest updates from the repositories, OR
  • Create another user.

Useful Internal Links

External links


Known issues

Known issue with hulahop

  • hulahop stopped building because I had installed a more recent version of xulrunner on my machine. The workaround was to rm -rf ~/sugar-jhbuild/source/hulahop and then run update and build again.


Dual-Booting F17 and F14

Install F17, using a LiveUSB. This would erase all the previous existing OSes (if any).

  • Start "Install to Hard Drive".
  • Choose "Use the entire space", with "Use LVM" UNCHECKED. Note that this is important, since using the LVM option prevents the drive to be partitioned later for the two Fedoras.
  • When asked for bootloader-installation position, choose "MBR in /dev/sda".
  • Installation should complete successfully.


Re-install F17, using a LiveUSB (but this time on a dedicated partition)

  • Start "Install to Hard Drive".
  • Choose "Create Custom Layout".
  • Delete "dev/sda4" (extended-partition-root). This should also automatially delete "/dev/sda5" (extended-partition-leaf).
  • Now, select on the "Free" chunk (mine was 500 GB).
    • Click "Edit".
    • Select "/" as the mount-point.
    • Choose an appropriate space (I chose 300 GB).
    • Click "OK".
    • This sould create "/dev/sda4" as the extended-partition-root, and "/dev/sda5" (worth 300 GB of space) as extended-partition-leaf.
  • Click "Next".
  • When asked for bootloader-installation position, choose "MBR in /dev/sda".
  • Installation should complete successfully.


Install F14, using a LiveUSB (on a dedicated partition)

  • Start "Install to Hard Drive".
  • Choose "Create Custom Layout".
  • Now, select on the "Free" chunk (mine was about 175 GB).
    • Click "Edit".
    • Select "/" as the mount-point.
    • Choose an appropriate space (I chose 175 GB).
    • Click "OK".
    • This sould create "/dev/sda6" as the extended-partition-leaf.
  • Click "Next".
  • When asked for bootloader-installation position, choose "First sector of /dev/sda6".
  • Installation should complete successfully.


Enabling dual-boot

  • At the moment, with all LiveUSBs removed, I was able to boot into F17 only. I could not see any option to boot into F14.


  • Boot into F17.


  • In one terminal, open the file "/etc/grub2.cfg" (in editable mode). The original contents should be on the lines of
#
# DO NOT EDIT THIS FILE
#
# It is automatically generated by grub2-mkconfig using templates
# from /etc/grub.d and settings from /etc/default/grub
#

### BEGIN /etc/grub.d/00_header ###
if [ -s $prefix/grubenv ]; then
  load_env
fi
set default="${saved_entry}"

if [ x"${feature_menuentry_id}" = xy ]; then
  menuentry_id_option="--id"
else
  menuentry_id_option=""
fi

export menuentry_id_option

if [ "${prev_saved_entry}" ]; then
  set saved_entry="${prev_saved_entry}"
  save_env saved_entry
  set prev_saved_entry=
  save_env prev_saved_entry
  set boot_once=true
fi

function savedefault {
  if [ -z "${boot_once}" ]; then
    saved_entry="${chosen}"
    save_env saved_entry
  fi
}

function load_video {
  if [ x$feature_all_video_module = xy ]; then
    insmod all_video
  else
    insmod efi_gop
    insmod efi_uga
    insmod ieee1275_fb
    insmod vbe
    insmod vga
    insmod video_bochs
    insmod video_cirrus
  fi
}

if [ x$feature_default_font_path = xy ] ; then
   font=unicode
else
insmod part_msdos
insmod ext2
set root='hd0,msdos5'
if [ x$feature_platform_search_hint = xy ]; then
  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
else
  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
fi
    font="/usr/share/grub/unicode.pf2"
fi

if loadfont $font ; then
  set gfxmode=auto
  load_video
  insmod gfxterm
  set locale_dir=$prefix/locale
  set lang=en_US
  insmod gettext
fi
terminal_output gfxterm
set timeout=5
### END /etc/grub.d/00_header ###

### BEGIN /etc/grub.d/10_linux ###
menuentry 'Fedora Linux' --class fedora --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-simple-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
	load_video
	set gfxpayload=keep
	insmod gzio
	insmod part_msdos
	insmod ext2
	set root='hd0,msdos5'
	if [ x$feature_platform_search_hint = xy ]; then
	  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
	else
	  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
	fi
	echo	'Loading Linux 3.3.4-5.fc17.i686 ...'
	linux	/boot/vmlinuz-3.3.4-5.fc17.i686 root=UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 ro rd.md=0 rd.lvm=0 rd.dm=0 SYSFONT=True  KEYTABLE=us rd.luks=0 LANG=en_US.UTF-8 rhgb quiet 
	echo	'Loading initial ramdisk ...'
	initrd	/boot/initramfs-3.3.4-5.fc17.i686.img
}
submenu 'Advanced options for Fedora Linux' $menuentry_id_option 'gnulinux-advanced-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
	menuentry 'Fedora Linux, with Linux 3.3.4-5.fc17.i686' --class fedora --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-3.3.4-5.fc17.i686-advanced-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
		load_video
		set gfxpayload=keep
		insmod gzio
		insmod part_msdos
		insmod ext2
		set root='hd0,msdos5'
		if [ x$feature_platform_search_hint = xy ]; then
		  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
		else
		  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
		fi
		echo	'Loading Linux 3.3.4-5.fc17.i686 ...'
		linux	/boot/vmlinuz-3.3.4-5.fc17.i686 root=UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 ro rd.md=0 rd.lvm=0 rd.dm=0 SYSFONT=True  KEYTABLE=us rd.luks=0 LANG=en_US.UTF-8 rhgb quiet 
		echo	'Loading initial ramdisk ...'
		initrd	/boot/initramfs-3.3.4-5.fc17.i686.img
	}
	menuentry 'Fedora Linux, with Linux 3.3.4-5.fc17.i686 (recovery mode)' --class fedora --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-3.3.4-5.fc17.i686-recovery-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
		load_video
		set gfxpayload=keep
		insmod gzio
		insmod part_msdos
		insmod ext2
		set root='hd0,msdos5'
		if [ x$feature_platform_search_hint = xy ]; then
		  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
		else
		  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
		fi
		echo	'Loading Linux 3.3.4-5.fc17.i686 ...'
		linux	/boot/vmlinuz-3.3.4-5.fc17.i686 root=UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 ro single rd.md=0 rd.lvm=0 rd.dm=0 SYSFONT=True  KEYTABLE=us rd.luks=0 LANG=en_US.UTF-8 rhgb quiet
		echo	'Loading initial ramdisk ...'
		initrd	/boot/initramfs-3.3.4-5.fc17.i686.img
	}
}
if [ "x$default" = 'Fedora Linux, with Linux 3.3.4-5.fc17.i686' ]; then default='Advanced options for Fedora Linux>Fedora Linux, with Linux 3.3.4-5.fc17.i686'; fi;
### END /etc/grub.d/10_linux ###

### BEGIN /etc/grub.d/20_linux_xen ###
### END /etc/grub.d/20_linux_xen ###

### BEGIN /etc/grub.d/20_ppc_terminfo ###
### END /etc/grub.d/20_ppc_terminfo ###

### BEGIN /etc/grub.d/30_os-prober ###
menuentry 'Fedora release 17 (Beefy Miracle)' --class gnu-linux --class gnu --class os $menuentry_id_option 'osprober-gnulinux-simple-9a669232-ec18-4571-85da-904db5b24112' {
	insmod part_msdos
	insmod ext2
	set root='hd0,msdos1'
	if [ x$feature_platform_search_hint = xy ]; then
	  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos1 --hint-efi=hd0,msdos1 --hint-baremetal=ahci0,msdos1 --hint='hd0,msdos1'  f2a4fc34-1b1d-494e-903f-7481e6381302
	else
	  search --no-floppy --fs-uuid --set=root f2a4fc34-1b1d-494e-903f-7481e6381302
	fi
	linux /vmlinuz-3.3.4-5.fc17.i686 root=/dev/sda2
	initrd /initramfs-3.3.4-5.fc17.i686.img
}
submenu 'Advanced options for Fedora release 17 (Beefy Miracle)' $menuentry_id_option 'osprober-gnulinux-advanced-9a669232-ec18-4571-85da-904db5b24112' {
	menuentry 'Fedora release 17 (Beefy Miracle) (on /dev/sda2)' --class gnu-linux --class gnu --class os $menuentry_id_option 'osprober-gnulinux-/vmlinuz-3.3.4-5.fc17.i686--9a669232-ec18-4571-85da-904db5b24112' {
		insmod part_msdos
		insmod ext2
		set root='hd0,msdos1'
		if [ x$feature_platform_search_hint = xy ]; then
		  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos1 --hint-efi=hd0,msdos1 --hint-baremetal=ahci0,msdos1 --hint='hd0,msdos1'  f2a4fc34-1b1d-494e-903f-7481e6381302
		else
		  search --no-floppy --fs-uuid --set=root f2a4fc34-1b1d-494e-903f-7481e6381302
		fi
		linux /vmlinuz-3.3.4-5.fc17.i686 root=/dev/sda2
		initrd /initramfs-3.3.4-5.fc17.i686.img
	}
}

### END /etc/grub.d/30_os-prober ###

### BEGIN /etc/grub.d/40_custom ###
# This file provides an easy way to add custom menu entries.  Simply type the
# menu entries you want to add after this comment.  Be careful not to change
# the 'exec tail' line above.
### END /etc/grub.d/40_custom ###

### BEGIN /etc/grub.d/41_custom ###
if [ -f  $prefix/custom.cfg ]; then
  source $prefix/custom.cfg;
fi
### END /etc/grub.d/41_custom ###



  • In another terminal, mount F14 on a directory.
[ajay@localhost ~]$ su -
Password: 

[root@localhost ~]# mkdir qq

[root@localhost ~]# mount -t ext4 /dev/sda6 qq

[root@localhost ~]# ls -l qq/boot
total 19064
-rw-r--r--. 1 root root   114968 Oct 18  2010 config-2.6.35.6-45.fc14.i686
drwxr-xr-x. 3 root root     4096 Oct 22  2010 efi
-rw-r--r--. 1 root root   166756 May 25  2010 elf-memtest86+-4.10
drwxr-xr-x. 2 root root     4096 Aug  5  2010 grub
-rw-r--r--. 1 root root 12562626 Jun 15 15:59 initramfs-2.6.35.6-45.fc14.i686.img
-rw-r--r--. 1 root root  1106254 Oct 22  2010 initrd-plymouth.img
-rw-r--r--. 1 root root   165080 May 25  2010 memtest86+-4.10
-rw-r--r--. 1 root root  1681526 Oct 18  2010 System.map-2.6.35.6-45.fc14.i686
-rwxr-xr-x. 1 root root  3696448 Oct 18  2010 vmlinuz-2.6.35.6-45.fc14.i686



  • Now, open the contents of "qq/boot/grub/menu.lst"
# grub.conf generated by anaconda
#
# Note that you do not have to rerun grub after making changes to this file
# NOTICE:  You do not have a /boot partition.  This means that
#          all kernel and initrd paths are relative to /, eg.
#          root (hd0,5)
#          kernel /boot/vmlinuz-version ro root=/dev/sda6
#          initrd /boot/initrd-[generic-]version.img
#boot=/dev/sda6
default=0
timeout=0
splashimage=(hd0,5)/boot/grub/splash.xpm.gz
hiddenmenu
title Fedora (2.6.35.6-45.fc14.i686)
	root (hd0,5)
	kernel /boot/vmlinuz-2.6.35.6-45.fc14.i686 ro root=UUID=333b5104-4f4a-41d9-856a-c7802677bec0 rd_NO_LUKS rd_NO_LVM rd_NO_MD rd_NO_DM LANG=en_US.UTF-8 SYSFONT=latarcyrheb-sun16 KEYBOARDTYPE=pc KEYTABLE=us rhgb quiet
	initrd /boot/initramfs-2.6.35.6-45.fc14.i686.img



  • Now, in the originally opened "/etc/grub2.cfg", add the entry for boot-option for Fedora-14. Take note that
    • Replace the UUID, with the UUID of F14 partition (as seen from contents of "qq/boot/grub/menu.lst".


    • The arguments to "initrd" should of the initramfs of F14 (As seen from the output of ls qq/boot).


    • hd0,msdos5 (corresponding to "/dev/sda5" for F17) is replaced by hd0,msdos6 (corresponding to "/dev/sda6" for F14).


    • Finally, the command kernel /boot/vmlinuz-2.6.35.6-45.fc14.i686 ro root=UUID=333b5104-4f4a-41d9-856a-c7802677bec0 rd_NO_LUKS rd_NO_LVM rd_NO_MD rd_NO_DM LANG=en_US.UTF-8 SYSFONT=latarcyrheb-sun16 KEYBOARDTYPE=pc KEYTABLE=us rhgb quiet (as seen in qq/boot/grub/menu.lst, used to boot up kernel vis F14's grub) is replaced by linux /boot/vmlinuz-2.6.35.6-45.fc14.i686 ro root=UUID=333b5104-4f4a-41d9-856a-c7802677bec0 rd_NO_LUKS rd_NO_LVM rd_NO_MD rd_NO_DM LANG=en_US.UTF-8 SYSFONT=latarcyrheb-sun16 KEYBOARDTYPE=pc KEYTABLE=us rhgb quiet (in /etc/grub2.cfg, since we intend to boot F14 via F17's grub2).


#
# DO NOT EDIT THIS FILE
#
# It is automatically generated by grub2-mkconfig using templates
# from /etc/grub.d and settings from /etc/default/grub
#

### BEGIN /etc/grub.d/00_header ###
if [ -s $prefix/grubenv ]; then
  load_env
fi
set default="${saved_entry}"

if [ x"${feature_menuentry_id}" = xy ]; then
  menuentry_id_option="--id"
else
  menuentry_id_option=""
fi

export menuentry_id_option

if [ "${prev_saved_entry}" ]; then
  set saved_entry="${prev_saved_entry}"
  save_env saved_entry
  set prev_saved_entry=
  save_env prev_saved_entry
  set boot_once=true
fi

function savedefault {
  if [ -z "${boot_once}" ]; then
    saved_entry="${chosen}"
    save_env saved_entry
  fi
}

function load_video {
  if [ x$feature_all_video_module = xy ]; then
    insmod all_video
  else
    insmod efi_gop
    insmod efi_uga
    insmod ieee1275_fb
    insmod vbe
    insmod vga
    insmod video_bochs
    insmod video_cirrus
  fi
}

if [ x$feature_default_font_path = xy ] ; then
   font=unicode
else
insmod part_msdos
insmod ext2
set root='hd0,msdos5'
if [ x$feature_platform_search_hint = xy ]; then
  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
else
  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
fi
    font="/usr/share/grub/unicode.pf2"
fi

if loadfont $font ; then
  set gfxmode=auto
  load_video
  insmod gfxterm
  set locale_dir=$prefix/locale
  set lang=en_US
  insmod gettext
fi
terminal_output gfxterm
set timeout=5
### END /etc/grub.d/00_header ###

### BEGIN /etc/grub.d/10_linux ###
menuentry 'Fedora Linux' --class fedora --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-simple-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
	load_video
	set gfxpayload=keep
	insmod gzio
	insmod part_msdos
	insmod ext2
	set root='hd0,msdos5'
	if [ x$feature_platform_search_hint = xy ]; then
	  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
	else
	  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
	fi
	echo	'Loading Linux 3.3.4-5.fc17.i686 ...'
	linux	/boot/vmlinuz-3.3.4-5.fc17.i686 root=UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 ro rd.md=0 rd.lvm=0 rd.dm=0 SYSFONT=True  KEYTABLE=us rd.luks=0 LANG=en_US.UTF-8 rhgb quiet 
	echo	'Loading initial ramdisk ...'
	initrd	/boot/initramfs-3.3.4-5.fc17.i686.img
}
### [STARTS] OPTION TO ADD BOOT-UP OPTION FOR F14 ###
menuentry 'Fedora Linux 14' --class fedora --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-simple-333b5104-4f4a-41d9-856a-c7802677bec0' {
	load_video
	set gfxpayload=keep
	insmod gzio
	insmod part_msdos
	insmod ext2
	set root='hd0,msdos6'
	if [ x$feature_platform_search_hint = xy ]; then
	  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos6 --hint-efi=hd0,msdos6 --hint-baremetal=ahci0,msdos6 --hint='hd0,msdos6'  333b5104-4f4a-41d9-856a-c7802677bec0
	else
	  search --no-floppy --fs-uuid --set=root 333b5104-4f4a-41d9-856a-c7802677bec0
	fi
	echo	'Loading Linux 14 waala ...'
	linux /boot/vmlinuz-2.6.35.6-45.fc14.i686 ro root=UUID=333b5104-4f4a-41d9-856a-c7802677bec0 rd_NO_LUKS rd_NO_LVM rd_NO_MD rd_NO_DM LANG=en_US.UTF-8 SYSFONT=latarcyrheb-sun16 KEYBOARDTYPE=pc KEYTABLE=us rhgb quiet 
	echo	'Loading initial ramdisk ...'
	initrd	/boot/initramfs-2.6.35.6-45.fc14.i686.img
}
### [ENDS] OPTION TO ADD BOOT-UP OPTION FOR F14 ###
submenu 'Advanced options for Fedora Linux' $menuentry_id_option 'gnulinux-advanced-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
	menuentry 'Fedora Linux, with Linux 3.3.4-5.fc17.i686' --class fedora --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-3.3.4-5.fc17.i686-advanced-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
		load_video
		set gfxpayload=keep
		insmod gzio
		insmod part_msdos
		insmod ext2
		set root='hd0,msdos5'
		if [ x$feature_platform_search_hint = xy ]; then
		  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
		else
		  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
		fi
		echo	'Loading Linux 3.3.4-5.fc17.i686 ...'
		linux	/boot/vmlinuz-3.3.4-5.fc17.i686 root=UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 ro rd.md=0 rd.lvm=0 rd.dm=0 SYSFONT=True  KEYTABLE=us rd.luks=0 LANG=en_US.UTF-8 rhgb quiet 
		echo	'Loading initial ramdisk ...'
		initrd	/boot/initramfs-3.3.4-5.fc17.i686.img
	}
	menuentry 'Fedora Linux, with Linux 3.3.4-5.fc17.i686 (recovery mode)' --class fedora --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-3.3.4-5.fc17.i686-recovery-1ff89cae-60bc-40fb-9e3c-e16e4850caa3' {
		load_video
		set gfxpayload=keep
		insmod gzio
		insmod part_msdos
		insmod ext2
		set root='hd0,msdos5'
		if [ x$feature_platform_search_hint = xy ]; then
		  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos5 --hint-efi=hd0,msdos5 --hint-baremetal=ahci0,msdos5 --hint='hd0,msdos5'  1ff89cae-60bc-40fb-9e3c-e16e4850caa3
		else
		  search --no-floppy --fs-uuid --set=root 1ff89cae-60bc-40fb-9e3c-e16e4850caa3
		fi
		echo	'Loading Linux 3.3.4-5.fc17.i686 ...'
		linux	/boot/vmlinuz-3.3.4-5.fc17.i686 root=UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 ro single rd.md=0 rd.lvm=0 rd.dm=0 SYSFONT=True  KEYTABLE=us rd.luks=0 LANG=en_US.UTF-8 rhgb quiet
		echo	'Loading initial ramdisk ...'
		initrd	/boot/initramfs-3.3.4-5.fc17.i686.img
	}
}
if [ "x$default" = 'Fedora Linux, with Linux 3.3.4-5.fc17.i686' ]; then default='Advanced options for Fedora Linux>Fedora Linux, with Linux 3.3.4-5.fc17.i686'; fi;
### END /etc/grub.d/10_linux ###

### BEGIN /etc/grub.d/20_linux_xen ###
### END /etc/grub.d/20_linux_xen ###

### BEGIN /etc/grub.d/20_ppc_terminfo ###
### END /etc/grub.d/20_ppc_terminfo ###

### BEGIN /etc/grub.d/30_os-prober ###
menuentry 'Fedora release 17 (Beefy Miracle)' --class gnu-linux --class gnu --class os $menuentry_id_option 'osprober-gnulinux-simple-9a669232-ec18-4571-85da-904db5b24112' {
	insmod part_msdos
	insmod ext2
	set root='hd0,msdos1'
	if [ x$feature_platform_search_hint = xy ]; then
	  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos1 --hint-efi=hd0,msdos1 --hint-baremetal=ahci0,msdos1 --hint='hd0,msdos1'  f2a4fc34-1b1d-494e-903f-7481e6381302
	else
	  search --no-floppy --fs-uuid --set=root f2a4fc34-1b1d-494e-903f-7481e6381302
	fi
	linux /vmlinuz-3.3.4-5.fc17.i686 root=/dev/sda2
	initrd /initramfs-3.3.4-5.fc17.i686.img
}
submenu 'Advanced options for Fedora release 17 (Beefy Miracle)' $menuentry_id_option 'osprober-gnulinux-advanced-9a669232-ec18-4571-85da-904db5b24112' {
	menuentry 'Fedora release 17 (Beefy Miracle) (on /dev/sda2)' --class gnu-linux --class gnu --class os $menuentry_id_option 'osprober-gnulinux-/vmlinuz-3.3.4-5.fc17.i686--9a669232-ec18-4571-85da-904db5b24112' {
		insmod part_msdos
		insmod ext2
		set root='hd0,msdos1'
		if [ x$feature_platform_search_hint = xy ]; then
		  search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos1 --hint-efi=hd0,msdos1 --hint-baremetal=ahci0,msdos1 --hint='hd0,msdos1'  f2a4fc34-1b1d-494e-903f-7481e6381302
		else
		  search --no-floppy --fs-uuid --set=root f2a4fc34-1b1d-494e-903f-7481e6381302
		fi
		linux /vmlinuz-3.3.4-5.fc17.i686 root=/dev/sda2
		initrd /initramfs-3.3.4-5.fc17.i686.img
	}
}

### END /etc/grub.d/30_os-prober ###

### BEGIN /etc/grub.d/40_custom ###
# This file provides an easy way to add custom menu entries.  Simply type the
# menu entries you want to add after this comment.  Be careful not to change
# the 'exec tail' line above.
### END /etc/grub.d/40_custom ###

### BEGIN /etc/grub.d/41_custom ###
if [ -f  $prefix/custom.cfg ]; then
  source $prefix/custom.cfg;
fi
### END /etc/grub.d/41_custom ###


  • As a last step, change "/etc/fstab" from

#
# /etc/fstab
# Created by anaconda on Fri Jun 15 15:30:02 2012
#
# Accessible filesystems, by reference, are maintained under '/dev/disk'
# See man pages fstab(5), findfs(8), mount(8) and/or blkid(8) for more info
#
UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 /                       ext4    defaults        1 1
UUID=9d06cbba-57e6-4cb2-93be-61a430601a67 swap                    swap    defaults        0 0

to


#
# /etc/fstab
# Created by anaconda on Fri Jun 15 15:30:02 2012
#
# Accessible filesystems, by reference, are maintained under '/dev/disk'
# See man pages fstab(5), findfs(8), mount(8) and/or blkid(8) for more info
#
UUID=1ff89cae-60bc-40fb-9e3c-e16e4850caa3 /                       ext4    defaults        1 1
UUID=333b5104-4f4a-41d9-856a-c7802677bec0 /                       ext4    defaults        1 1
UUID=9d06cbba-57e6-4cb2-93be-61a430601a67 swap                    swap    defaults        0 0


  • Reboot. Now the option to boot into F14 should be present (in options via F17's grub).


Useful links