Clientinstallation
===================

Wenn dein Netboot-Server fertig eingerichtet ist und du einen Rechner hast, dessen Hardwareklasse den PXE Boot an den Netboot-Server 
weiter delegieren kann, kannst du einen ersten Client installieren.

.. attention::

  * Der Client muss via UEFI booten. Legacy Bios Clients werden nicht unterstützt.
  * Derzeit wird ein Client mit KDE-Plasma installiert, andere Desktopumgebungen sind prinzipiell möglich, dafür gibt es aber (noch)
    keine fertigen ansible-Rollen.

Konfiguration
-------------

  * Bearbeite den Abschnitt ``vars`` im Playbook ``lmn-desktop.yml`` und passse deine Domain und Hostnamen an.
  * Wenn du die Option für die mscorefonts aktivierst - was angeraten ist, weil diese sonst bei jedem Installationsvorgang 
    aus dem Internet geholt werden - musst du die Fonts einmalig auf deinem Netboot Server ablegen. Das geht am einfachsten mit dem Skript 
    ``get-msttcorefonts.sh``. ``sudo ./get-msttcorefonts.sh`` legt die Fonts im Verzeichnis ``/var/www/html/mscorefonts`` ab, so dass 
    diese für die Clients unter der Adresse ``http://netboot.linuxmuster.lan/mscorefonts/`` verfügbar sind - 
    Hostname und Domain in der ``vars``-Sektion anpassen!
  * Um die Funktion zu testen, solltest du zunächst darauf achten, dass im Abschnitt ``roles`` nur die ersten Rollen bis 
    einschließlich ``lmn_mount`` ausgeführt werden. Die Rollen weiter unten sollten zunächst auskommentiert bleiben. Hintergrund ist, 
    dass das Playbook mit den Rollen erst spät im Installationsprozess aufgerufen wird - wenn es dann wegen eines Fehlers abbricht 
    ist das schwer zu debuggen und es dauert lang, bis man dorthin gelangt. Spätere Erweiterungen der Konfiguration kann man 
    am laufenden Client testen und dann nach und nach in das Installationsplaybook einfügen. 
  * Committe deine Änderungen: ``git add . && git commit -m "Angepasst für MySchool"``
  * Starte den Client vom Netz und wähle den Eintrag ``Chainload Menu from Netboot-Box`` aus, den du im vorigen Schritt angelegt hast.
  * Wähle im Grub-Menü des Netboot-Clients den Eintrag ``Installer Debian bookworm (amd64) + preseed + lmn-desktop.yml``
  * Je nach Hardware dauert es etwas 10-15 Minuten, bis die Installation abgeschlossen ist und der Client zur KDE Anmeldung startet.  

  .. hint::

    Nun muss man etwa 10 Minuten warten, bis man sich als Domänenbenutzer anmelden kann - niemand weiß genau, warum. Die Verzögerung tritt nur nach der Neuinstallation eines Clients auf, bei späteren Reboots ist eine Anmeldung sofort möglich. 

Während man wartet, kann man einige Tests durchführen: 

  * Melde dich als lokaler Benutzer ``ansible`` an. Das sollte mit dem bei der Installation der Netboot-Box vergebenen Passwort 
    möglich sein - oder unter Verwendung des bei der Konfiguration hinterlegten GPG-Keys auch via ssh.
  * Öffne eine Konsole, werde root (``sudo -i``). 
    * ``adcli testjoin linuxmuster.lan`` sollte dir die erfolgreiche Verbindung des Clients zur Domäne anzeigen (Domainname anpassen).
    * ``getent passwd domaenennutzer``: Sobald eine Anmeldung an der Domäne möglich ist, wird mit diesem Befehl ein Eintrag für das Konto 
    ``domaenennutzer`` gefunden. Dann kannst du dich als ansible abmelden und als Domäenenutzer anmelden. Nun sollte das klappen, 
    mitunter gibt es noch eine Fehlermeldung des Akonadi-Dienstes, diese kann man ignorieren.

Wenn das alles soweit funktioniert, kannst du die Rolle ``lmn_kde`` im Playbook ``lmn-desktop.yml`` aktivieren, indem du das 
Kommentarzeichen entfernst, damit wird ein vollständiger debian-edu Client mit einigen Optimierungen installiert, das dauert dann etwas länger. 
Um das zu testen boote und installiere den Client erneut.

Jetzt legt man am besten eine weitere Rolle für weitere Anpassungen für die eigene Schule an. FIXME