Project

General

Profile

Actions

Task #5882

closed

Document the netboot setup

Added by Nico Schottelius about 6 years ago. Updated 11 months ago.

Status:
Rejected
Priority:
Normal
Target version:
-
Start date:
10/23/2018
Due date:
% Done:

0%

Estimated time:
PM Check date:

Description

  • How we create it
  • How we deploy it

Introduction

The netboot images are basically a Devuan filesystem that is created by debootstrap. To be able to boot the servers, the kernel is extracted and the root filesystem is put into an cpio archive.

How to build / update a netboot image

  • Login to netboot-build.ungleich.ch
  • Go to /srv
  • /srv/devuan contains the current version
  • /srv/devuan-VERSION.gz contains the available root filesystem
  • /srv/kernel-VERSION

To update / make changes:

  • chroot /srv/devuan
  • [work work work]

VERSION=your-version-name
cd /srv/devuan
printf "\\\\n \\\\l: version $VERSION\\n\\n" > etc/issue
find . -print0 | cpio --null -ov --format=newc | gzip -9 > /srv/initramfs-${VERSION}
cp vmlinuz /srv/kernel-${VERSION}

How to deploy a new netboot image

  • Copy the rootfs and the kernel on the respective routers:
    • router{1..2}.placeY.ungleich.ch:/var/www/html/
    • initramfs.igz production image
    • kernel production kernel

Upcoming improvements / things to be checked

  • Use cdist preos for chroot building
  • Ensure that the image cannot be downloaded publicly
    • Our password hash is visible otherwise
  • Ensure that there is a menu for booting
    • production kernel selected by default
    • other kernels/setups for testing
Actions

Also available in: Atom PDF