In this repository you will find all the steps and extra files used to create the bookworm image for the B3 platform.
Given the fact that image creation is not done every day there is no scripted/automated method to create it ; instead all the steps needed (and taken) to create the released image will be described in this README. It will be updated with each release.
The current version for the excito bookworm image is 1.0
- This README.md file, the "image create manual"
- interfaces.tpl, used for network template generation (TODO: should be moved to the installer repository)
first-boot
which contains first-boot scripts run ... on the first boot; Currently these scripts:- Generate new ssh host keys
- Remove themselves
In order to create an image you need a B3 running whatever standard Linux OS you wish, ~1GiB free space and an internet connection; The only software needed on the host is the debootstrap package and the debian archive keyring.
The released image are created from the install/rescue system which provides all the necessary tools.
Everything must be run as root
.
- Create a directory that will host the image (it doesn't have to be a mounted partition):
mkdir /mnt/target
- Debootstrap bookworm:
debootstrap --arch=armel bookworm /mnt/target http://deb.debian.org/debian
- Mount the kernel filesystems:
mount -t proc none /mnt/target/proc
mount -t sysfs none /mnt/target/sys
mount -o bind /dev /mnt/target/dev
mount -t devpts none /mnt/target/dev/pts
mount -t tmpfs none /mnt/target/dev/shm
- Create the
policy-rc.d
file which will prevent the daemons to be run inside the chroot:
cat > /mnt/target/usr/sbin/policy-rc.d << EOF
#!/bin/sh
exit 101
EOF
chmod 755 /mnt/target/usr/sbin/policy-rc.d
- Download the
excito-release-bookworm
package for later install:
wget -O/mnt/target/root/excito-release-bookworm.deb http://repo.excito.org/excito-release-bookworm.deb
- Chroot into the system and setup the environment:
chroot /mnt/target /bin/bash
source /etc/profile
cd /root
export PS1="(chroot) $PS1"
- Add security repository to
sources.list
:
cat >> /etc/apt/sources.list << EOF
deb http://deb.debian.org/debian-security bookworm-security main
EOF
- Install the
excito-release-bookworm
package:
dpkg -i excito-release-bookworm.deb
rm excito-release-bookworm.deb
- Update apt cache and ugprade the system:
apt-get update
apt-get -y dist-upgrade
- Install kernel and b3 utils:
apt-get -y install bubba3-kernel b3-utils
- Install locales and standard system tools:
apt-get -y install locales
tasksel install --new-install standard ssh-server
Released images provide fw_setenv
and fw_printenv
which allows access and modification of the platform bootloader. These tools are only 'nice to have'. Beware that misuse can prevent the system from booting.
- Create the
fw_env.config
file:
cat > /etc/fw_env.config << EOF
# MTD definition for Bubba|3
# MTD device name Device offset Env. size Flash sector size Number of sectors
/dev/mtd1 0x000000 0x010000 0x010000
EOF
- Install the
u-boot-tools
and themtd-utils
package:
apt-get -y install libubootenv-tool mtd-utils
- Set the root password ('excito' without quotes on the released images):
passwd
- Create the
excito
user and set its password ('excito' without quotes on the released images):
useradd -m -U -s /bin/bash excito
passwd excito
- Configure the network:
cat >> /etc/network/interfaces << EOF
allow-hotplug eth0
iface eth0 inet dhcp
allow-hotplug eth1
iface eth1 inet dhcp
EOF
- Create
/etc/fstab
:
cat > /etc/fstab << EOF
/dev/sda1 / ext3 noatime 0 1
EOF
- Set the hostname:
echo "b3" > /etc/hostname
- Set the default systemd target to
multi-user
:
systemctl set-default multi-user.target
- Empty apt cache:
apt-get clean
- Remove previously created ssh keys and disable the SSH server (
first-boot
will re-create keys and re-enable the server):
rm /etc/ssh/*key*
systemctl disable ssh
- Exit the chroot:
exit
- Remove the shell history file and the previously created
policy-rc.d
file:
rm /mnt/target/usr/sbin/policy-rc.d /mnt/target/root/.bash_history
- Unmount kernel filesystem:
umount /mnt/target/dev/shm
umount /mnt/target/dev/pts
umount /mnt/target/dev
umount /mnt/target/sys
umount /mnt/target/proc
- Download and extract the first-boot release tarball into target:
wget -O/mnt/target/first-boot.txz https://github.com/Excito/bookworm-image/releases/download/v1.0/first-boot-1.0.txz
( cd /mnt/target; tar -xvf first-boot.txz )
rm /mnt/target/first-boot.txz
- Now that the image files are ready, go ahead and create the final tarball:
( cd /mnt/target; tar -cJvf /root/bookworm-image.txz --numeric-owner .)