Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A simpler way to install and setup FAI
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
approx
bin
fai
isc-dhcp-server
nfs-kernel-server
tftpd-hpa
Makefile
README.md

README.md

NAME

fai-simple - A simpler way to install and setup FAI

DESCRIPTION

fai-simple is a minimalist's approach to installing and setting up FAI. It defines the bare minimum config and services to get FAI up and running.

FAI does a fantastic job at automating Debian installations, but it's not easy to get right. There are a lot of moving parts (i.e. DHCP server, TFTP server, NFS settings, APT caching proxy server, and FAI itself) and the FAI documentation is out of date making it inherently wrong. In fact, if you have successfully setup FAI 4.x before, that's probably because you've poured through the source code... that bare return in copy_fai_files() will haunt your dreams forever :)

Use and build on fai-simple as a basis for your future Debian installs.

INSTALLATION

Installing fai-simple on the FAI server

In an ideal world, all that would be needed is:

make install

This will install the following:

  • approx - APT caching proxy to FAI clients

  • /etc/exports - mount /srv/fai via NFS to FAI clients

  • fai-quickstart - install FAI base packages

  • isc-dhcp-server - provide DHCP to FAI clients

  • tftpd-hpa - provide bootloader to FAI clients

Configuration for the above services are bare minimum. I encourage you to look at the contents of each file (it's quite small in total) in order to get a feel for what it's doing, and to be able to make changes (for security or otherwise) where appropriate.

The FAI config space that gets installed by default is from fai-quickstart (copied from /usr/share/doc/fai-doc/examples/simple). If you would rather start out with a simpler FAI config space, I encourage you to look at fai-simple-config. This can be installed by the following:

make install-fai-simple-config

As for the underlying network, fai-simple assumes a few things. The network configuration is located in a handful of tiny Perl scripts under bin/. They should be self-explanatory and will need to be changed accordingly if they don't match reality.

Installing Debian via network boot

To install Debian via FAI clients:

reboot

SUPPORT

For general FAI issues, please use the FAI mailing list:

Please report any bugs or feature requests at:

Watch the repository and keep up with the latest changes:

Feel free to fork the repository and submit pull requests :)

DEPENDENCIES

  • Debian Jessie

The follow are dependencies for fai-simple, but 'make install' should install them without any fuss:

  • approx

  • fai-quickstart

  • isc-dhcp-server

  • tftpd-hpa

SEE ALSO

AUTHOR

Alfie John alfie@alfie.wtf

WARRANTY

IT COMES WITHOUT WARRANTY OF ANY KIND.

COPYRIGHT AND LICENSE

Copyright (C) 2015 by Alfie John

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Something went wrong with that request. Please try again.