{"id":326,"date":"2009-04-21T18:26:32","date_gmt":"2009-04-21T12:56:32","guid":{"rendered":"http:\/\/brainstorms.in\/?p=326"},"modified":"2009-04-24T22:05:13","modified_gmt":"2009-04-24T16:35:13","slug":"building-an-ubuntu-live-cd-from-scratch","status":"publish","type":"post","link":"https:\/\/brainstorms.in\/?p=326","title":{"rendered":"Building an Ubuntu Live CD from Scratch"},"content":{"rendered":"

( This document was written in connection with the one day Live Cd workshop held at college of Engineering Attingal. )<\/p>\n

1. Introduction<\/strong><\/span><\/p>\n

This document describes how to build a minimal live CD based on ubuntu 8.10.. The most recent version of this document can be found at http:\/\/brainstorms.in.<\/p>\n

2. System Requirements<\/strong><\/span><\/p>\n

    \n
  1. A Host System with ubuntu 8.10 installed. ( Other \tversions will also work)<\/li>\n
  2. Plenty of Disk space.<\/li>\n
  3. A steady Internet connection or access to ubuntu \trepositories.<\/li>\n
  4. Root access on the host system.<\/li>\n<\/ol>\n

    3 Exploring an existing ubuntu CD.<\/strong><\/span><\/p>\n

    In order to understand the working of a live CD, let us look at an existing ubuntu CD<\/p>\n

    If you have the CD with you , put it into your CD drive. If you have an image , mount it on the loop device.<\/p>\n

    # mount -o loop ubuntu-8.10-desktop-i386.iso \/cdrom<\/p>\n

    \n

    The directory structure of a typical ubuntu CD look as below.<\/p>\n

    \n\n<\/col>\n\n\n
    \n

    autorun.inf dists isolinux pics preseed \t\t\t ubuntu wubi.exe<\/p>\n

    casper install md5sum.txt pool \t\t\tREADME.diskdefines umenu.exe<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    \n

    The exe files and autorun.inf are for installing under MS Windows. Some of the other files are self explanatory. Our main focus will be on isolinux and casper directories..<\/p>\n

    The isolinux directory contains files needed to boot from the live CD, Infact, isolinux belongs to a set of bootloaders written by Peter. H Anwin. The home page is here. As I mentioned isolinux , is the bootloader.. If you look at isolinux subdirectory, you will find several files. Some of them will be as shown below.<\/p>\n\n<\/col>\n\n\n
    \n

    isolinux.bin isolinuc binary<\/p>\n

    isolinux.cfg Configuration File<\/p>\n

    boot.cat boot catlogue<\/p>\n

    bootlogo Logo<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    \n

    There are several other files. They are mainly for providing language support. ( Please feel free to look at some of them). The isolinux.cfg includes several other configuration files corresponding to differnt boot options. We will write a simple isolinux.cfg later.<\/p>\n

    \n

    The casper directory contains the following.<\/p>\n

    \n\n<\/col>\n\n\n
    \n

    filesystem.manifest filesystem.squashfs \t\t\tvmlinuz<\/p>\n

    filesystem.manifest-desktop initrd.gz<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    \n

    vmlinuz and initrd.gz are the kernel and ram image from which isolinux will boot the system.<\/p>\n

    The filesystem.squashfs contains a compressed image of the filesystem. When we boot the live CD, this image will be uncompressed and moounted as the root filesystem.. All remastering programs and custom distros try to rebuild this image.. Filesystem,manifest and filesystem.manifest-desktop are text files which contain a list of packages inside the squashfs image.<\/p>\n

    The squashfs image can be loop mounted like an iso image.<\/p>\n

    # mount -o loop filesystem.squashfs \/mnt \/tmp<\/p>\n

    \n

    4 Preparing the host system.<\/strong><\/span><\/p>\n

    Ensure that the Ubuntu 8.10 is installed on the host system. Log to the host system and update the system using apt. (I am assuming that you have direct access to Internet..)<\/p>\n

    a) Install necessary packages<\/p>\n

    apt-get install syslinux squashfs-tools mkisofs sbm<\/p>\n

    b) Prepare a working directory<\/p>\n

    Open a terminal on the host system, Become root.<\/p>\n

    $sudo su<\/p>\n

    #<\/p>\n

    Create a temporary work directory.<\/p>\n

    # mkdir work<\/p>\n

    Inside work create the following.<\/p>\n

    # mkdir work\/filesys<\/p>\n

    #mkdir work\/image<\/p>\n

    #mkdir work\/image\/casper<\/p>\n

    #mkdir work\/image\/isolinux<\/p>\n

    #mkdir work\/image\/install<\/p>\n

    We will be building the iso image from the image directory. We will populate the image directory one by one and finally build a CD image. The filesys directory is a temporary area where we will build the root filesystem of the Live CD.<\/p>\n

    \n

    \n

    \n

    \n

    5 Building a Squashfs image<\/strong><\/span><\/p>\n

    \n

    For building the compressed root image,<\/p>\n

    we will build a bare minimum filesystem under filesys directory and then convert it into squashfs.<\/p>\n

    Step 1.<\/p>\n

    Install debootstrap on the host system<\/p>\n

    # apt-get install debootstrap.<\/p>\n

    Debootstrap is a program to bootstrap a basic debian system.<\/p>\n

    # cd work<\/p>\n

    # debootstrap –arch i386 intrepid filesys<\/p>\n

    This will create a bare minimum filesystem inside the filesys directory. If you look inside the filesys directory, you can see that the structure resembles root directory as shown below.<\/p>\n\n<\/col>\n\n\n
    bin dev home lib mnt proc sbin sys usr vmlinuz
    \nboot etc initrd.img media opt root srv tmp var<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Step 2<\/p>\n

    Copy the \/etc\/resolv.conf and \/etc\/apt\/sources.list to the corresponding locations inside the filesys directrory.<\/p>\n

    # cp \/etc\/resolv.conf filesys\/etc\/resolv.conf<\/p>\n

    # cp \/etc\/apt\/sources.list filesys\/etc\/apt\/sources.list
    \nStep 3<\/p>\n

    Now, we will use chroot command to change the root directory to filesys.<\/p>\n

    # chroot filesys<\/p>\n

    You will get back the # prompt. However inside this terminal you will be referring to filesys directory as \/ .
    \nNow run the following ( You are inside chroot )
    \n# mount \/proc<\/p>\n

    # mount \/sys<\/p>\n

    # mount -t devpts none \/dev\/pts
    \nThe above commands mount the respective directories inside chroot.
    \nStep 4<\/p>\n

    Update the system. (Note that we are inside the chroot jail not on your host system.)<\/p>\n

    # apt-get update<\/p>\n

    To avoid locale issues and in order to import GPG keys set the following shell variables.<\/p>\n

    #export HOME=\/root<\/p>\n

    #export LC_ALL=C
    \nStep 5<\/p>\n

    Install packages needed for Live System:<\/p>\n

    #apt-get install –yes ubuntu-standard casper<\/p>\n

    #apt-get install –yes discover\u00a0 laptop-detect os-prober<\/p>\n

    #apt-get install –yes linux-generic<\/p>\n

    The package ubuntu-standard will install most of the packages needed for a working installation.<\/p>\n

    The other packages are mainly for hardware detection. Linux generic will install the kernel..<\/p>\n

    Step 6<\/p>\n

    Install additional\u00a0 packages.<\/p>\n

    You can get the list of currently installed packages with<\/p>\n

    # dpkg -l<\/p>\n

    You can remove some of the packages and try to save space.<\/p>\n

    Step 7<\/p>\n

    Cleanup the unwanted files.<\/p>\n

    #apt-get clean
    \n#rm -rf \/tmp\/*
    \n#rm \/etc\/resolv.conf
    \n#umount -l -f \/proc<\/p>\n

    #umount -l -f \/sys<\/p>\n

    #umount \/dev\/pts<\/p>\n

    #exit<\/p>\n

    Now you are out of chroot and your filesys directoy is ready to be compressed into a squashfs image.<\/p>\n

    Step 8<\/p>\n

    # mksquashfs filesys image\/casper\/filesystem.squashfs -e filesys\/boot<\/p>\n

    Note: If the system you are building will only be used as a live system and you will never use it to install, you can exclude the \/boot folder. The live system boots from outside the chroot and so the \/boot folder is not used. If you will be using ubiquity to install the custom-built system, you will need to keep the \/boot folder. Use this instead of the previous command to preserve the \/boot folder.<\/p>\n

    # mksquashfs filesys image\/casper\/filesystem.squashfs.<\/p>\n

    6 Populate rest of the casper directory<\/strong><\/span><\/p>\n

    Step 1<\/p>\n

    Copy kernel and initrd image.<\/p>\n

    #cp filesys\/boot\/vmlinuz-2.6.**-**-generic image\/casper\/vmlinuz<\/p>\n

    # cp filesys\/boot\/initrd.img-2.6.**-**-generic image\/casper\/initrd.gz<\/p>\n

    Step 2<\/p>\n

    Create manifest:<\/p>\n

    Run the following commands.<\/p>\n

    # chroot filesys  dpkg-query -W --showformat='${Package} ${Version}\\n' |  tee image\/casper\/filesystem.manifest<\/pre>\n
    #cp -v image\/casper\/filesystem.manifest{,-desktop}
    \n# REMOVE=’ubiquity casper live-initramfs user-setup discover\u00a0 xresprobe os-prober libdebian-installer4′
    \n# for i in $REMOVE<\/p>\n
    do<\/p>\n
    sed -i “\/${i}\/d” image\/casper\/filesystem.manifest-desktop<\/p>\n
    done<\/p>\n
    Now all the files in the Casper directory are ready.<\/p>\n
    7 Building  the isolinux directory<\/strong><\/span><\/p>\n
    The isolinux directory contains files needed for booting the live CD.<\/p>\n
    Step 1<\/p>\n
     Copy isolinux and  memtest to isolinux directory<\/span>
    \n#cp \/usr\/lib\/syslinux\/isolinux.bin image\/isolinux\/<\/span><\/p>\n
    #cp \/boot\/memtest86+.bin image\/install\/memtest<\/span>
    \n#cp \/boot\/sbm.img image\/install\/<\/span>
    \nStep 2<\/span><\/p>\n
    Create an isolinux.txt file in image\/isolinux to display at boot time.<\/p>\n
    Eg.<\/p>\n
    \n\n<\/col>\n\n\n
    This is a Live CD created at College of Engineering Attingal.For the default live system, enter “live”.
    \nTo verify the CD for errors, enter “check”.
    \nTo run memtest86+, enter “memtest”<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n
    Step 2a  (optional)<\/p>\n
    If you put the name of a speacilly encoded image file file in the beginning of isolinux.txt ,it will be displayed when we boot up.<\/p>\n
    ^Xsplash.rle<\/p>\n
    The filename should be preceded by  ^X .<\/p>\n
    ( To enter ^X in  vi editor, do ctrl-V and follow with ctrl-X). <\/span><\/tt><\/p>\n
    To create the splash.rle file, create an image 480 pixels wide, and convert it to 15 colors, indexed, using the gimp. Save it as .bmp.<\/tt><\/p>\n
    Install the netpbm package.<\/tt><\/p>\n
    #apt-get install netpbm<\/tt><\/p>\n
    #bmptoppm splash.bmp > splash.ppm   #ppmtolss16 '#ffffff=7' < splash.ppm > splash.rle<\/span><\/tt><\/p>\n
    Step 3<\/tt><\/p>\n
    Create an isolinux.cfg file in image\/isolinux\/\u00a0 \/usr\/share\/doc\/syslinux\/syslinux.doc is an idea place to start\u00a0 looking for information on\u00a0 various\u00a0 configuration options. Here is an example\u00a0 that you can use as a starting point.
    \n<\/tt><\/p>\n\n\n\n
    DEFAULT live
    \nLABEL live
    \nmenu label ^Start or install Ubuntu
    \nkernel \/casper\/vmlinuz
    \nappend  file=\/cdrom\/preseed\/ubuntu.seed boot=casper initrd=\/casper\/initrd.gz quiet splash —
    \nLABEL check
    \nmenu label ^Check CD for defects
    \nkernel \/casper\/vmlinuz
    \nappend  boot=casper integrity-check initrd=\/casper\/initrd.gz quiet splash —
    \nLABEL memtest
    \nmenu label ^Memory test
    \nkernel \/install\/memtest
    \nappend –
    \nLABEL hd
    \nmenu label ^Boot from first hard disk
    \nlocalboot 0x80
    \nappend –
    \nDISPLAY isolinux.txt
    \nTIMEOUT 300
    \nPROMPT 1<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n
    8 Create miscellaneous  files<\/strong><\/tt><\/span><\/p>\n
    Step 1<\/tt><\/p>\n
    Create a diskdefines:<\/tt><\/p>\n
    vi  image\/README.diskdefines<\/tt><\/p>\n
    example:<\/tt><\/p>\n\n<\/col>\n\n\n
    #define DISKNAME  Ubuntu 8.10 “Intrepid” – Release i386 **Remix**<\/p>\n
    #define TYPE  binary<\/p>\n
    #define TYPEbinary  1<\/p>\n
    #define ARCH  i386<\/p>\n
    #define ARCHi386  1<\/p>\n
    #define DISKNUM  1<\/p>\n
    #define DISKNUM1  1<\/p>\n
    #define TOTALNUM  0<\/p>\n
    #define TOTALNUM0  1<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    Step 2<\/tt><\/p>\n
    Calculate MD5<\/tt><\/p>\n
    # cd image && find . -type f -print0 | xargs -0 md5sum > md5sum.txt<\/tt><\/p>\n
    9 Create and Test the CD image<\/tt><\/strong><\/p>\n
    Create iso image using the following command<\/tt><\/p>\n
    \n

    \n<\/tt><\/p>\n
    #mkisofs -r -V \"MyUbuntu\" -cache-inodes -J -l -b isolinux\/isolinux.bin -c isolinux\/boot.cat -no-emul-boot -boot-load-size 4 -boot-info-table -o ..\/ubuntu-remix.iso .<\/tt><\/p>\n
    # cd ..<\/tt><\/p>\n
    The boot.cat file will be automatically created.<\/tt><\/p>\n
    Now, the image is ready for testing. You can install virtual box and mount the image as a cdrom and try booting from it.<\/tt><\/p>\n
    \n
    10 To Do<\/tt><\/h2>\n
    Installing the live CD  into a hard disk<\/tt><\/p>\n
    Ubiquity.<\/tt><\/p>\n","protected":false},"excerpt":{"rendered":"
    ( This document was written in connection with the one day Live Cd workshop held at college of Engineering Attingal. ) 1. Introduction This document describes how to build a minimal live CD based on ubuntu 8.10.. The most recent version of this document can be found at http:\/\/brainstorms.in. 2. System Requirements A Host System… Continue reading Building an Ubuntu  Live CD from Scratch<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3,6],"tags":[],"class_list":["post-326","post","type-post","status-publish","format-standard","hentry","category-computers","category-gnulinux"],"_links":{"self":[{"href":"https:\/\/brainstorms.in\/index.php?rest_route=\/wp\/v2\/posts\/326","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/brainstorms.in\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/brainstorms.in\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/brainstorms.in\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/brainstorms.in\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=326"}],"version-history":[{"count":22,"href":"https:\/\/brainstorms.in\/index.php?rest_route=\/wp\/v2\/posts\/326\/revisions"}],"predecessor-version":[{"id":345,"href":"https:\/\/brainstorms.in\/index.php?rest_route=\/wp\/v2\/posts\/326\/revisions\/345"}],"wp:attachment":[{"href":"https:\/\/brainstorms.in\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=326"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/brainstorms.in\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=326"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/brainstorms.in\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=326"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}