custom-ubuntu-server-iso

Remastering the Ubuntu Desktop ISO is easy considering the existing graphical tools but did you ever wanted to build your custom Ubuntu Server Edition ISO ?

Preparing the Environment
You’ll need a clean copy of the Ubuntu Server ISO that you want to customize. Since 10.04 is the latest Ubuntu version I will write down my examples using it but everything should work pretty much unchanged for older or newer versions.

After you have you have the original iso image downloaded, make a copy it’s contents so we can later apply our patching there.

1
2
3
4
5
6
7
8
9
cd /home/rgavril/Work

mkdir original-iso custom-iso
mount -o loop ./ubuntu-10.04-server-i386.iso ./original-iso

cp -r ./original-iso/* ./custom-iso/
cp -r ./original-iso/.disk/ ./custom-iso/

umount ./original-iso/

Adding a Boot Menu Option
For start let’s add a option to the cd boot menu. You’ll need to modify isolinux/text.cfg and insert the next lines between default install and label install:

1
2
3
4
label custom
menu label ^Install Custom Ubuntu Server
kernel /install/vmlinuz
append file=/cdrom/preseed/ubuntu-custom.seed initrd=/install/initrd.gz quiet ks=cdrom:/isolinux/ks-custom.cfg --

This newly added block is very similar to the label install one. The two important additions being the file and ks boot options that I will later explain.

If you want to make your menu option the default one, you only need to change the default install to default custom or whatever you used as a label.

Kickstart-ing
KickStart is a unattended installation method developed by Red Hat and later adopted and adapted by Debian and Ubuntu. To keep it short, the Ubuntu installer can read an external file and figure out how to configure the system (create partitions, set timezones and keyboard layouts ..) without asking the user.

There’s no need to write everything using a text editor as we have a powerful tool to create such configuration files:

1
apt-get install system-config-kickstart ksconfig

After creating your ks.cfg file, you will need to move it on the custom-iso/ at the path specified in text.cfg. That’s the location where the ubuntu installer will look for it.

1
cp ks.cfg custom-iso/isolinux/ks-custom.cfg

Preseeding Packages
The installer in not the only one that may present questions to the user. When installed, some package rely on the user to explicitly set different parameters.

Preseeding is the action of setting, in advance, this kind of package parameters. It’s a very powerful method that you can use even for replacing kickstart. In this article, I’ll use it as a addition to kickstart as is more harder to tune the ubuntu installer, mostly because it lacks a gui.

The params can be set trough a configuration file specified by the file in text.cfg. I recommend starting with the existing preseed file from the original cd:

1
cp custom-iso/preseed/ubuntu-server.seed custom-iso/preseed/ubuntu-custom.seed

Using debconf-get-selections from the debconf-utils package you can look over a running ubuntu system to figure out what parameters you can tune. For example here are the possible configuration settings for the openssh-server together with their values :

1
2
3
4
5
root@xps1330:~/work# debconf-get-selections | grep openssh
openssh-server ssh/vulnerable_host_keys note
openssh-server ssh/use_old_init_script boolean true
openssh-server ssh/encrypted_host_key_but_no_keygen note
openssh-server ssh/disable_cr_auth boolean false

Adding Extra Packages
Ubuntu’s ksconfig utility does’n provide a way to select extra packages as the Package Selection is not working. In order to specify what extra packages you want to install you’ll need to modify the kickstart configuration file by hand.

1
vim custom-iso/isolinux/ks-custom.cfg

Depending on the extra packages that you want to install by default, add some similar lines to the end of the file :

1
2
3
4
%packages
openssh-server
asterisk
asterisk-mysql

Offline Installation
When having additional packages installed by default, there’s a big chance are that those particular packages may not be on the default iso. If you have an active internet connection during the install, the packages will be automatically fetched from the online repositories. But if you’re internet connection is not working, the install process will fail. In order to prevent the problem and create a offline installable cd, you’ll need to perform some extra steps.

You’ll need to downloading and copying the extra debs and all their dependencies on your iso. Please note that in doing so you may increase the iso size a lot and be forced to use a dvd.

It’s very hard to figure out what debs are missing from your iso. In order to make a list of needed debs I use the following steps:

On a virtual machine, install a ubuntu server using the original cd image.
Boot the newly installed ubuntu server, make sure the cd is mountable and cdrom directive is available in sources.list
Do an apt-get install of the extra packages that I want to have installed by default
Make a backup of the debs located in /var/cache/apt/archives as this are the missing ones that need to be on the iso
Considering that you downloaded the extra packages, and that they are located in the extradebs/ directory within the current folder. You will need to copy them on the cd and create a repository by running this commands:

1
2
3
4
5
6
7
8
9
mkdir -p custom-iso/dists/stable/extras/binary-i386
mkdir -p custom-iso/pool/extras/

cp ./extradebs/*.deb custom-iso/pool/extras/

pushd custom-iso
apt-ftparchive packages ./pool/extras/ > dists/stable/extras/binary-i386/Packages
gzip -c ./dists/stable/extras/binary-i386/Packages | tee ./dists/stable/extras/binary-i386/Packages.gz > /dev/null
popd

Generating the new ISO
All you need to do now is build you new iso and give it a test drive to see how it works:

1
mkisofs -J -l -b isolinux/isolinux.bin -no-emul-boot -boot-load-size 4 -boot-info-table -z -iso-level 4 -c isolinux/isolinux.cat -o ./ubuntu-10.04-custom-i386.iso custom-iso/