Project

General

Profile

Task #5882

Document the netboot setup

Added by Nico Schottelius almost 3 years ago. Updated almost 3 years ago.

Status:
In Progress
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

History

#1

Updated by Nico Schottelius almost 3 years ago

  • Status changed from New to In Progress
  • Description updated (diff)
#2

Updated by Nico Schottelius almost 3 years ago

  • Description updated (diff)
#3

Updated by Nico Schottelius almost 3 years ago

  • Description updated (diff)
#4

Updated by Nico Schottelius almost 3 years ago

  • Description updated (diff)
#5

Updated by Nico Schottelius almost 3 years ago

  • Description updated (diff)
#6

Updated by Nico Schottelius almost 3 years ago

  • Description updated (diff)
#7

Updated by Nico Schottelius almost 3 years ago

  • Description updated (diff)

Also available in: Atom PDF