fai-simple - A simpler way to install and setup FAI
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.
Installing fai-simple on the FAI server
In an ideal world, all that would be needed is:
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:
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:
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 :)
- Debian Jessie
The follow are dependencies for fai-simple, but 'make install' should install them without any fuss:
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/.