## page was renamed from Core/InstallationExample
== Installation of Ubuntu Base ==

The following is an example deployment of Ubuntu Base in an x86 virtual machine.  Please note that these instructions are meant to use as a guide for getting started and are not necessarily suited for deployment in a production system.

=== 1. Boot ===
Boot the target hardware from an Ubuntu Live CD.  For this example I used the 32-bit Ubuntu 11.10 Desktop CD, but the version used does not matter as this is used only as a working environment to prepare the target system.

During the boot process you will be prompted to install or try Ubuntu.  Select the "Try Ubuntu" option.

=== 2. Create filesystems ===
Create two filesystems on the disk of the target device, one for boot purposes and one to hold the Ubuntu Base filesystem.  For this example I used the graphical disk utility that is included on the Ubuntu 11.10 Desktop CD:

{{attachment:1 - palimpsest.png}}

The first filesystem will be the "boot" filesystem.  This should be created at the beginning of the disk as a FAT filesystem.  This filesystem will not need much space, as it will hold only the kernel and initrd.  (I used 100MB in this example but smaller filesystems are certainly possible.)

{i} You '''must''' mark this filesystem as bootable after creating it by clicking "Edit partition" and checking the "Bootable" checkbox.

{{attachment:2 - boot.png}}

The second filesystem will be the Ubuntu Base root filesystem.  This should be one of EXT2, EXT3, or EXT4 and take the remainder of the available space.

{{attachment:3 - root.png}}

=== 3. Mount filesystems ===
Mount the filesystems you have created so that they will be accessible.  E.g.

{{{
$ sudo mkdir /mnt/boot /mnt/root
$ sudo mount /dev/sda1 /mnt/boot
$ sudo mount /dev/sda2 /mnt/root
}}}

=== 4. Create the root filesystem ===
You will need to have the Ubuntu Base root filesystem in an accessible path.

{{{
$ cd /mnt/root
$ sudo tar zxvf $path_to_root_fs
}}}

=== 5. Download kernel ===
Download an appropriate kernel (and any dependencies).  Packages can be found at [[http://packages.ubuntu.com|packages.ubuntu.com]].  For this example I chose a 12.04 "Precise Pangolin" development kernel, which required the 'wireless-crda' package.

Copy the kernel and any dependencies to the target root filesystem, e.g.
{{{
cp $path_to_kernel/*deb /mnt/root/tmp
}}}

=== 6. Install the kernel ===
Open a chroot session into the target root filesystem.  This will allow you to install packages and configure the target system before it is bootable.
{{{
$ sudo chroot /mnt/root
}}}

Install the kernel:
{{{
# dpkg -i /tmp/$dependencies
# dpkg -i /tmp/$kernel
}}}

For example:

{{attachment:4 - dpkg.png}}

=== 7. Configure target environment ===
Create a user account in the target environment, and then perform any other required pre-boot configuration you may need.

{{{
# adduser ubuntu
# addgroup ubuntu adm
# addgroup ubuntu sudo
}}}

When you are finished, exit the chroot session.

{{{
# exit
}}}

=== 8. Copy the necessary boot files to the boot partition ===
Copy the kernel and initrd to the boot partition.
{{{
$ cd /mnt/boot
$ sudo cp ../root/boot/vmlinuz* .
$ sudo cp ../root/boot/initrd* .
}}}

Make a note of the filenames of the kernel (vmlinuz) and initrd.

=== 9. Install the bootloader ===
Install the syslinux bootloader to the boot filesystem.
{{{
$ sudo syslinux -i /dev/sda1
}}}

=== 10. Configure the bootloader ===
Create a syslinux configuration file pointing at the kernel (vmlinuz) and initrd.
{{{
$ cd /mnt/boot
$ sudo nano syslinux.cfg
}}}

This configuration file will look something like this:
{{{
PROMPT 0
TIMEOUT 1
DEFAULT Base

LABEL Base
	LINUX $vmlinuz
	APPEND root=/dev/sda2 ro
	INITRD $initrd
}}}

{i} Be sure to replace ''$vmlinuz'' with the name of your kernel and ''$initrd'' with the name of your initrd.  E.g.:

{{attachment:5 - syslinux.png}}

=== 11. Reboot ===
Shut down your target system and remove the CD (or other temporary boot media).  Start your target system and enjoy Ubuntu Base!

{{attachment:6 - booted.png}}