iankelling.org Git - automated-distro-installer/blob - README

   1 PXE install w multi-boot, btrfs & Libreboot support
   2
   3 Some things are specific to my home network, and uses files with secrets
   4 that are not in this repo. Uses pxe or pxe-kexec (on libreboot, I have
   5 not added a pxe rom, I use a minimal debian stable subvolume which acts
   6 like a pxe rom). I use this for bare metal and vms, and two scripts
   7 which can run post boot so I use them on vps distributed image as well.
   8
   9 Features people may find useful: installs encrypted trisquel belenos, ,
  10 debian jessie, debian stretch, ubuntu 16.04, and arch (havne't done
  11 recently, probably a bit broken), in a multi-boot setup using multiple
  12 subvolumes of a single btrfs filesystem.  Utilizes multiple disks, with
  13 scripts to automatically decrypt on intentional reboots, but not after
  14 shutdown or power loss.
  15
  16 The partititioning and filesystem script is at
  17 fai/config/hooks/partition.DEFAULT. Other debian based distros at least
  18 as new as ubuntu 14.04 should work fine, and I'm planning to add Fedora
  19 support. Disks are grouped as ssd or hdd and raided in raid 1 or raid 0
  20 per configuration. The base partitions are divided into boot, swap, and
  21 root, (only boot is unencrypted). There are scripts to resize those
  22 partitions post-provision and while the system is running.
  23
  24 People who use fai may find these things as useful examples: it uses
  25 dnsmasq (on a openwrt machine) for dhcp instead of the isc
  26 dhcp. fai-wrapper is a small script to use basic fai classes outside of
  27 fai. It does not use the fai partitioning tool, but the script is
  28 inspired from it and works outside of fai. It supports running a fai
  29 server on debian within android via Maru.
  30
  31 It also automates configuration of an openwrt router after manual
  32 initial installation.
  33
  34 After provisionining is done, I sync files using btrfs, or unison for
  35 vps, then automate further setup using a different set of scripts,
  36 https://iankelling.org/git/?p=distro-setup;a=tree.
  37
  38 My network is a wndr3700v2 router with openwrt on it and a few pcs/laptops.
  39
  40 Since fai requires a debian server as the fai server, there are also
  41 scripts to automate a debian install using pxe and preseeding, which can
  42 be done from any distro.
  43
  44 Some of the scripts have dependencies for some simple obvious utility
  45 scripts from https://iankelling.org/git, and of course there are some
  46 hostnames that are specific to my network.
  47
  48 All scripts meant to be used directly are listed here:
  49
  50
  51 # Scripts to setup the environment for the install
  52
  53 arch-pxe # Setup arch pxe boot server from an arch base image
  54 fai-redep # Deploy fai configuration to host "faiserver"
  55 faiserver-revm # using pxe & preseed, create a vm which is a fai server
  56 faiserver-uninstall # uninstall fai-server
  57 faiserver-setup # install fai-server on the current machine
  58 myfai-chboot # setup fai tftp and nfs. useful with pxe-kexec
  59 pxe-server # disable/enable pxe dhcp, tfp, and nfs
  60 wrt-setup-remote  # setup my router in general: dhcp, dns, etc.
  61
  62
  63 # Script to do a distro install
  64
  65 dsfull # install & post-install a new fai distro
  66 arch-init-remote # install arch after it's been booted into it's setup env
  67 fai-kexec # Kexec this or a remote machine using host faiserver
  68 live-kexec # fai kexec from upstream live cds, e.g. curl live-kexec|bash
  69
  70
  71 # Test scripts
  72
  73 arch-revm # test arch install on a fresh vm
  74 fai-revm  # test fai install on a fresh vm
  75
  76
  77 # Scripts to call after a distro install for various reasons
  78
  79 chboot # Set grub to boot into a different distro (installed earlier)
  80 install-chboot # reinstall chboot to /boot subvols, for chboot updates.
  81 eboot # reboot without automatic disk decryption
  82 fai-wrapper # use fai classes outside of fai. sourced, not called.
  83 faiserver-disable # Disable the fai nfs server exports
  84 fresize # resize swap or boot partitions in a host
  85
  86
  87 License stuff:
  88 The license for the project is GPLv2 or later, mostly because fai is and
  89 I periodically rebase off their example config, which contains small
  90 scripts. Also, there is a modified encrypt.upstream, which is from the
  91 cryptsetup package in arch, which is under the same license.