Live-Build

Differences between revisions 1 and 8 (spanning 7 versions)
⇤ ← Revision 1 as of 2017-03-23 16:27:03 →
Size: 195
Editor: randall
Comment: initialized page
← Revision 8 as of 2017-03-24 00:17:37 → ⇥
Size: 4048
Editor: debmc
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
If you want to build a custom ISO, IMG or Netboot tarball with a custom linux kernel please follow these instructions which explain how to use the Debian Live-Build tools: <<TableOfContents()>>
Line 3: Line 3:
-- Instructions -- = Live-Build Steps for building a custom ISO, IMG or Netboot tarball with a custom kernel =

Live-Build is a Debian based infrastructure -> [[https://debian-live.alioth.debian.org/live-manual/unstable/manual/html/live-manual.en.html|Debian Live-Build Manual]]

== Build Host Requirements ==

ppc64el images are built on a ppc64el host

== Setting up Live-Build with Patches ==

There are two patches needed to build and install ppc64el ISO's, IMG's and Netboot tarball's.

As of March 23, 2017, you will need to clone and build grub2 on the build machine to include a patch for the ieee1275 chrp grub install

[[https://wiki.ubuntu.com/ppc64el/grub2|How To Build and Install Grub2]]

=== Install pre-req's ===

{{{
myuser@ppc64el:~ $ sudo apt-get install debootstrap debhelper kpartx gdisk devscripts dh-systemd live-build isolinux
}}}

=== Clone the live-build tree ===


{{{
myuser@ppc64el:~ $ git clone git://anonscm.debian.org/git/debian-live/live-build.git
myuser@ppc64el:~ $ cd live-build
}}}

=== Apply the Patches ===

{{{
myuser@ppc64el:~/live-build $ git am 0001-live-build-binary_hdd-enablement-for-ppc64el.patch
myuser@ppc64el:~/live-build $ git am 0001-live-build-installer-enablement-for-ppc64el.patch
}}}

[[attachment:0001-live-build-binary_hdd-enablement-for-ppc64el.patch]]

[[attachment:0001-live-build-installer-enablement-for-ppc64el.patch]]

=== Build Live-Build ===

{{{
myuser@ppc64el:~/live-build $ sudo dpkg-buildpackage -b -uc -us
myuser@ppc64el:~/live-build $ sudo make install
myuser@ppc64el:~/live-build $ lb -v
1:20161216 <- This should reflect the current level of the git tree
}}}

== Sample Live-Build Configuration ==

This tutorial is based on a pre-configured setup for ppc64el.

=== Download the tar file ===

[[attachment:Mar-2017-fwts-installer-live-v5-ppc64el-config.tar.gz]]

=== Setup and Build ===

{{{
myuser@ppc64el:~ $ sudo mkdir lb-setup <- lb-setup directory can be named anything you want
}}}

{{{
myuser@ppc64el:~ $ sudo cp Mar-2017-fwts-installer-live-v5-ppc64el-config.tar.gz ~/lb-setup

myuser@ppc64el:~ $ cd lb-setup

myuser@ppc64el:~/lb-setup $ sudo tar -xvf Mar-2017-fwts-installer-live-v5-ppc64el-config.tar.gz

myuser@ppc64el:~/lb-setup $ sudo lb clean --all

myuser@ppc64el:~/lb-setup $ sudo lb build 2>&1 | tee /home/myuser/build.log

myuser@ppc64el:~/lb-setup $ ls -al live-image-ppc64el.iso <- This is the ISO output file
}}}

== Running the ISO ==

=== Install pre-req's ===

{{{

myuser@ppc64el:~/lb-setup $ sudo apt-get install qemu-kvm qemu-utils

}}}

=== Run the Live Image and Optional Install ===

{{{

myuser@ppc64el:~/lb-setup $ sudo kvm -cdrom live-image-ppc64el.iso -m 2G -nographic -nodefaults -serial stdio

}}}

== Advanced Customizations ==

=== Add a proxy for APT during the live-build process ===

config/common -> LB_APT_HTTP_PROXY="http://proxy:3128" <=== Replace with your proxy server and port name

=== Remove the preseed.cfg ===

To remove the preseed.cfg to allow the install to ask all the guided questions, remove the preseed.cfg and re-build the IMG, ISO or Netboot tar ball.

config/includes.installer/preseed.cfg <=== Remove this file completely and re-build

=== Update the Custom Kernel used to build Live Images ===

=== Update the Custom Kernel used to install a new OS with the Installer Images ===

=== Update the Root or Default User ID used for Live Images ===

=== Update the Root or Default User ID used for Installer Images ===

=== Add Packages for the Live Images ===

Create or edit the file with packages you want installed:

# cat ~/lb-setup/config/package-lists/live-list.chroot
openssh-client
openssh-server

=== Add Packages for the Installer Images ===

Create or edit the file with packages you want installed, sample d-i below:

d-i pkgsel/include string vim openssh-server build-essential

[[https://www.debian.org/releases/stable/amd64/apbs02.html.en|Debian Preseeding]]

Contents

  1. Live-Build Steps for building a custom ISO, IMG or Netboot tarball with a custom kernel
    1. Build Host Requirements
    2. Setting up Live-Build with Patches
      1. Install pre-req's
      2. Clone the live-build tree
      3. Apply the Patches
      4. Build Live-Build
    3. Sample Live-Build Configuration
      1. Download the tar file
      2. Setup and Build
    4. Running the ISO
      1. Install pre-req's
      2. Run the Live Image and Optional Install
    5. Advanced Customizations
      1. Add a proxy for APT during the live-build process
      2. Remove the preseed.cfg
      3. Update the Custom Kernel used to build Live Images
      4. Update the Custom Kernel used to install a new OS with the Installer Images
      5. Update the Root or Default User ID used for Live Images
      6. Update the Root or Default User ID used for Installer Images
      7. Add Packages for the Live Images
      8. Add Packages for the Installer Images

Live-Build Steps for building a custom ISO, IMG or Netboot tarball with a custom kernel

Live-Build is a Debian based infrastructure -> Debian Live-Build Manual

Build Host Requirements

ppc64el images are built on a ppc64el host

Setting up Live-Build with Patches

There are two patches needed to build and install ppc64el ISO's, IMG's and Netboot tarball's.

As of March 23, 2017, you will need to clone and build grub2 on the build machine to include a patch for the ieee1275 chrp grub install

How To Build and Install Grub2

Install pre-req's

myuser@ppc64el:~ $ sudo apt-get install debootstrap debhelper kpartx gdisk devscripts dh-systemd live-build isolinux

Clone the live-build tree

myuser@ppc64el:~ $ git clone git://anonscm.debian.org/git/debian-live/live-build.git
myuser@ppc64el:~ $ cd live-build

Apply the Patches

myuser@ppc64el:~/live-build $ git am 0001-live-build-binary_hdd-enablement-for-ppc64el.patch
myuser@ppc64el:~/live-build $ git am 0001-live-build-installer-enablement-for-ppc64el.patch

0001-live-build-binary_hdd-enablement-for-ppc64el.patch

0001-live-build-installer-enablement-for-ppc64el.patch

Build Live-Build

myuser@ppc64el:~/live-build $ sudo dpkg-buildpackage -b -uc -us
myuser@ppc64el:~/live-build $ sudo make install
myuser@ppc64el:~/live-build $ lb -v
1:20161216 <- This should reflect the current level of the git tree

Sample Live-Build Configuration

This tutorial is based on a pre-configured setup for ppc64el.

Download the tar file

Mar-2017-fwts-installer-live-v5-ppc64el-config.tar.gz

Setup and Build

myuser@ppc64el:~ $ sudo mkdir lb-setup  <- lb-setup directory can be named anything you want

myuser@ppc64el:~ $ sudo cp Mar-2017-fwts-installer-live-v5-ppc64el-config.tar.gz ~/lb-setup

myuser@ppc64el:~ $ cd lb-setup

myuser@ppc64el:~/lb-setup $ sudo tar -xvf Mar-2017-fwts-installer-live-v5-ppc64el-config.tar.gz

myuser@ppc64el:~/lb-setup $ sudo lb clean --all

myuser@ppc64el:~/lb-setup $ sudo lb build 2>&1 | tee /home/myuser/build.log

myuser@ppc64el:~/lb-setup $ ls -al live-image-ppc64el.iso  <- This is the ISO output file

Running the ISO

Install pre-req's

myuser@ppc64el:~/lb-setup $ sudo apt-get install qemu-kvm qemu-utils

Run the Live Image and Optional Install

myuser@ppc64el:~/lb-setup $ sudo kvm -cdrom live-image-ppc64el.iso -m 2G -nographic -nodefaults -serial stdio

Advanced Customizations

Add a proxy for APT during the live-build process

config/common -> LB_APT_HTTP_PROXY="http://proxy:3128" <=== Replace with your proxy server and port name

Remove the preseed.cfg

To remove the preseed.cfg to allow the install to ask all the guided questions, remove the preseed.cfg and re-build the IMG, ISO or Netboot tar ball.

config/includes.installer/preseed.cfg <=== Remove this file completely and re-build

Update the Custom Kernel used to build Live Images

Update the Custom Kernel used to install a new OS with the Installer Images

Update the Root or Default User ID used for Live Images

Update the Root or Default User ID used for Installer Images

Add Packages for the Live Images

Create or edit the file with packages you want installed:

# cat ~/lb-setup/config/package-lists/live-list.chroot openssh-client openssh-server

Add Packages for the Installer Images

Create or edit the file with packages you want installed, sample d-i below:

d-i pkgsel/include string vim openssh-server build-essential

Debian Preseeding

Live-Build (last edited 2017-10-04 01:41:58 by debmc)