2 # Copyright (C) 2018 Ian Kelling
4 # This program is free software; you can redistribute it and/or
5 # modify it under the terms of the GNU General Public License
6 # as published by the Free Software Foundation; either version 2
7 # of the License, or (at your option) any later version.
9 # This program is distributed in the hope that it will be useful,
10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 # GNU General Public License for more details.
14 # You should have received a copy of the GNU General Public License
15 # along with this program; if not, write to the Free Software
16 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 x
="$(readlink -f "$BASH_SOURCE")"; source "${x%/*}/bash-trace"
20 [[ $EUID == 0 ]] ||
exec sudo
-i "${BASH_SOURCE}" "$@"
24 usage: ${0##*/} [-h|--help] [BASE_CODENAME]
25 install fai-server on the current machine
27 Initial setup of a fai server. works on localhost. Set's the current ip
28 as the tftp server. I vaguely remember that using a hostname does not
29 work. Separate from running this, faiserver needs to be setup in dns to
30 point to whatever host this is run on.
32 Default BASE_CODENAME is stretch, and it expects corresponding
33 $BASEFILE_DIR/${UPCASED_BASE_CODENAME}64.tar.gz to exist, and it must have been
34 generated around the same time as the nfsroot, at least so it has the
45 e
() { echo "$@"; "$@"; }
49 basefile
=$BASEFILE_DIR/${base^^}64.
tar.gz
50 sed="sed -ri --follow-symlinks"
52 if [[ ! -e $basefile ]]; then
53 printf "%s\n" "$0: error BASEFILE_DIR=$BASEFILE_DIR does not exist"
58 if ! type -p wget
&>/dev
/null
; then
59 apt-get
install -y wget
63 [[ $
(dpkg
--print-architecture) == armhf
]]
67 if apt-cache policy |
grep o
=Debian
,a
=testing
,n
=stretch
&>/dev
/null
; then
68 cat >/etc
/apt
/sources.list.d
/testing.list
<<'EOF'
69 deb http://http.us.debian.org/debian testing main contrib non-free
70 deb-src http://http.us.debian.org/debian testing main contrib non-free
72 deb http://security.debian.org/ testing/updates main contrib non-free
73 deb-src http://security.debian.org/ testing/updates main contrib non-free
75 deb http://http.us.debian.org/debian testing-updates main contrib non-free
76 deb-src http://http.us.debian.org/debian testing-updates main contrib non-free
79 cat >/etc
/apt
/preferences.d
/fai
<<'EOF'
80 Package: fai-server fai-client fai-doc
81 Pin: release a=testing
85 Pin: release a=testing
89 elif grep -xFq 'VERSION="8 (jessie)"' /etc
/os-release
; then
90 gpg
-a --recv-keys 2BF8D9FE074BCDE4
; gpg
-a --export 2BF8D9FE074BCDE4 | apt-key add
-
91 cat >/etc
/apt
/sources.list.d
/fai.list
<<'EOF'
92 deb https://fai-project.org/download jessie koeln
94 elif grep -xFq 'VERSION="9 (stretch)"' /etc
/os-release ||
grep -iE 'flidas|xenail' /etc
/os-release
; then
95 # fai on ubuntu only has official support using the universe repo, but newer
96 # tends to have less bugs.
97 gpg
--keyserver hkp
://pool.sks-keyservers.net
-a --recv-keys 2BF8D9FE074BCDE4
; gpg
-a --export 2BF8D9FE074BCDE4 | apt-key add
-
101 cat >/etc
/apt
/sources.list.d
/fai.list
<<'EOF'
102 deb https://fai-project.org/download stretch koeln
106 cat >/etc
/apt
/sources.list.d
/fai.list
<<'EOF'
107 deb https://fai-project.org/download buster koeln
112 rm -f /etc
/apt
/sources.list.d
/fai.list
117 # Relevant packages from fai-quickstart depends and fai-server recommends.
118 # I especially do not wait isc-dhcp-server or an inetd. Also excludes
119 # nfs-kernel-server. On an android chroot, we don\'t have nfs in the
120 # kernel, or the ability to install it.
121 # xorriso is for running fai-cd -a, not strictly need for fai-server
122 # perl-tk is for fai-monitor-gui
123 pkgs
=(fai-doc tftpd-hpa
tar reprepro squashfs-tools binutils xorriso
)
124 if modprobe nfsd
&>/dev
/null
; then
125 pkgs
+=(nfs-kernel-server
)
131 apt-get
install -y ${pkgs[@]}
132 # confnew since we edit /etc/fai/NFSROOT in an automated way
133 # fai-client is already a fai-server dependency, but make sure it gets upgraded
134 apt-get
install --no-install-recommends -y -o Dpkg
::Options
::="--force-confnew" fai-server fai-client
136 r
=http
://http.us.debian.org
/debian
137 # like default, but scrap httpredir, and nonfree.
138 # All my systems should be able to get along without nonfree
139 # for a base working system afaik.
140 cat >/etc
/fai
/apt
/sources.list
<<EOF
141 deb $r $base main contrib
142 deb http://security.debian.org/debian-security $base/updates main contrib
147 jessie|stretch|buster
)
148 cat >>/etc
/fai
/apt
/sources.list
<<EOF
149 # use fai repo. it's commented in the defaults. it's got bug fixes.
150 # and may contain newer packages.
151 deb http://fai-project.org/download $base koeln
156 if [[ $base == jessie
]]; then
157 cat >>/etc
/fai
/apt
/sources.list
<<'EOF'
158 # fix tar https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=819978
159 deb http://ftp.debian.org/debian jessie-backports main
161 # note, fai doesn\'t look at /etc/fai/apt/preferences.d
162 cat >/etc
/fai
/apt
/preferences
<<'EOF'
164 Pin: release a=jessie-backports
170 $sed -f - /etc
/fai
/nfsroot.conf
<<EOF
171 $ a FAI_ROOTPW='$(</q/root/shadow/standard)'
173 $ a SSH_IDENTITY=/root/.ssh/home.pub
175 s,^( *FAI_DEBOOTSTRAP=).*,\1"$base $r",
176 # add --arch amd64. this is needed on arm system which is
177 # used to install amd64 clients. On amd64 servers, it's redundant.
178 # disabled for now, since creating fai nfsroot on my arm machine
180 #/--arch amd64/!s/^(\s*FAI_DEBOOTSTRAP_OPTS=")/\1--arch amd64 /
183 $sed 's/#LOGUSER/LOGUSER/' /etc
/fai
/fai.conf
184 $sed -i '/^FAI_FLAGS=/d' /etc
/fai
/fai.conf
185 echo "FAI_FLAGS=verbose" >>/etc
/fai
/fai.conf
187 # from man fai-make-nfsroot,
188 # figured out after partitioning ignored my crypt partition
191 if ! grep cryptsetup
/etc
/fai
/NFSROOT
&>/dev
/null
; then
192 cat >>/etc
/fai
/NFSROOT
<<'EOF'
193 # inserted by faserver-setup
203 # background: Can't build the nfsroot on my arm system now. First,
204 # fai-make-nfsroot won't work out of the box. One idea to make it work
205 # is by installing qemu-user-static, then copying qemu-x86_64-static
206 # into the nfsroot, and prepending it to chroot commands in
207 # fai-make-nfsroot, but that fails in odd ways. ls has permissions
208 # problems on reading directories, various programs segfault
209 # immediately, cat can't open a file, etc.
211 NFSROOT
=/srv
/fai
/nfsroot
212 TFTPROOT
=/srv
/tftp
/fai
214 # test if our copy of setup_tftp has changed in fai-make-nfsroot,
215 # and if not, run it.
222 if [ -f $NFSROOT/usr
/lib
/PXELINUX
/pxelinux
.0 ]; then
223 pxebin
=$NFSROOT/usr
/lib
/PXELINUX
/pxelinux
.0
226 pxebin
=$NFSROOT/usr
/lib
/syslinux
/pxelinux
.0
229 rm -f $NFSROOT/boot
/*.bak
230 mkdir
-p $TFTPROOT/pxelinux.cfg
231 if ! chmod a
+r
$NFSROOT/boot
/initrd.img-
*; then
232 echo "$0: error: No initrd was created. Check the package name of the linux-image package in /etc/fai/NFSROOT."
235 cp -p $v $NFSROOT/boot
/vmlinu?
-* $NFSROOT/boot
/initrd.img-
* $TFTPROOT
236 cp -u $pxebin $TFTPROOT
237 if [ -f $NFSROOT/usr
/lib
/syslinux
/modules
/bios
/ldlinux.c32
]; then
238 cp -u $NFSROOT/usr
/lib
/syslinux
/modules
/bios
/ldlinux.c32
$TFTPROOT
240 if [ X
$verbose = X1
]; then
241 echo "TFTP environment prepared. Enable DHCP and start the TFTP daemon on root $TFTPROOT."
244 diff -u <(type setup_tftp
) <(cat <(sed -n '/^setup_tftp(){/,/^}/p' $
(which fai-make-nfsroot
) ) - <<'EOF' |bash
250 # -g causes skipping set_root_pw() in fai-make-nfsroot, -ag
251 # is the only way to make it run without chrooting. the options
252 # seem contradictory, but it works.
256 # note, this copies the -B arg to
257 # /srv/fai/nfsroot/var/tmp/base.tar.xz
258 e fai-setup
-evf -B $basefile
259 # fai-setup expert mode avoids writing to /var/log/fai/variables
260 # at least config_src is needed for autodiscover
261 $sed '/^FAI_CONFIGDIR|^FAI_CONFIG_SRC|^LOGUSER/d' /var
/log
/fai
/variables
262 tee -a /var
/log
/fai
/variables
<<'EOF'
264 FAI_CONFIGDIR=/srv/fai/config
265 FAI_CONFIG_SRC=nfs://faiserver/srv/fai/config
267 # make the faiserver also the apt proxy server
268 apt-get
-y install apt-cacher-ng
271 rm -f /srv
/fai
/nfsroot
/root
/.ssh
/known_hosts
272 key
=$
(ssh-keyscan localhost |
& grep -o "ecdsa-sha2-nistp256.*")
273 for ip
in faiserver $
(ip addr show up|
grep -w '^ *inet' |
awk '{print $2}'| cut
-d / -f 1 |
grep -vF 127.0.0.1); do
274 echo "$ip $key" >>/srv
/fai
/nfsroot
/root
/.ssh
/known_hosts
280 # https://wiki.archlinux.org/index.php/working_with_the_serial_console
281 # at runtime, running this from ssh worked:
282 # https://unix.stackexchange.com/questions/242778/what-is-the-easiest-way-to-configure-serial-port-on-linux
283 # stty -F /dev/ttyS0 115200 cs8 -cstopb -parenb
284 # /sbin/agetty 115200 ttyS0 linux
285 # dated info, but validation that this might work on debian:
286 # https://help.ubuntu.com/community/SerialConsoleHowto
287 # note in the nfsroot, systemd is not running.
288 echo "c0:2345:respawn:/sbin/agetty 115200 ttyS0 linux" >>/srv
/fai
/nfsroot
/etc
/inittab
290 # initially did the basic fai-chboot -Iv $std_arg default
291 # but found in console that it wanted to mount nfsroot
292 # to be the same as my dhcp server.
293 # Figured out to change the root= parameter from googling,
294 # and seeing fai-chboot -L
295 # using hostname failed.
296 # for -f, combined the 2 defaults so it will reboot and print to screen.
298 # Add debug to -f flag for more verbose output.
301 # background on choosing apt-cacher-ng:
302 # googling around a bit finds 2 main solutions:
303 # http://askubuntu.com/questions/3503/best-way-to-cache-apt-downloads-on-a-lan
304 # apt-cacher-ng doesn\'t have zeroconf.
305 # It touts having minimal dependencies, but I don\'t care.
306 # The downside to squid-deb-proxy is that it\'s config is for specific repos,
307 # you have to add all the repos you use.
308 # That is the main reason I use apt-cacher-ng.
309 # It has a web portal, at http://faiserver:3142/acng-report.html
312 # random fai note: as far as I can tell, profiles are just for putting
313 # in a selectable boot menu, which I don\'t want.
315 # the logsave prompted because the hostname faiserver was uknown.
316 # Here it was faiserver.lan when running from a faiserver vm.
317 # When running from a normal host with faiserver alias, it was the normal hosts name.
318 $sed 's/(^[^,]+,)\S+/\1faiserver/' /srv
/fai
/nfsroot
/root
/.ssh
/known_hosts
319 # ditch the logo banner up top which screws with less.
320 touch /srv
/fai
/nfsroot
/.nocolorlogo