* added troubleshooting for wlan cards with linbo according to

source/clients/use_linbo/index.rst

@@ -908,6 +908,55 @@ Hast Du die Eintragungen hingegen in der Schulkonsole vorgenommen, so must Du nu
 * Der Download größer Betriebssystem-Images beeinträchtigt Deine WLAN-Performance. Dies solltest Du vermeiden werden.
 * Du solltest zudem überlegen, ob Du ein gesichertes WLAN für das LINBO-Management einrichtest, um den Zugriff auf das WLAN zu beschränken.
 
+
+Fehlerbehebung
+--------------
+
+Sollte die WLAN-Karte des Clients Probleme bereiten, obwohl Du Dich, wie zuvor beschrieben, mit ``linbo-ssh`` auf den Client aufgeschaltet und auch mit ``dmesg | grep -i firmware`` keine WLAN-Fehler angezeigt bekommst, dann kannst Du weitere Befehle zur Eingrenzung des Fehlers auf dem Client absetzen:
+
+.. code::
+
+   ip link set dev wlan0 up
+   wpa_supplicant -B -c/etc/wpa_supplicant.conf -iwlan0
+   udhcpc -O nisdomain -n -i wlan0
+
+.. hint::
+
+   Sollten bei o.g. Befehlen keine Fehler ausgegeben werden, dann funktioniert die WLAN-Hardware. Diese wird allerdings zu langsam initialisiert.
+
+Um eine langsame Initialisierung zu korrigieren, erstellst Du auf dem Server im Verzeichnis ``/var/lib/linuxmuster/hooks/update-linbofs.pre.d`` eine neue ausführbare Datei, die ein Bash-Skript enthält.
+
+Führe dazu folgende Befehle aus:
+
+.. code::
+
+   sudo -i
+   touch /var/lib/linuxmuster/hooks/update-linbofs.pre.d/10_warte-wegen-wlan.sh
+   chmod +x /var/lib/linuxmuster/hooks/update-linbofs.pre.d/10_warte-wegen-wlan.sh
+
+Danach änderst Du den Inhalt der Datei mit:
+
+.. code::
+
+   sudo nano /var/lib/linuxmuster/hooks/update-linbofs.pre.d/10_warte-wegen-wlan.sh
+
+
+Füge nun folgenden Inhalt ein, speichere den Inhalt (``strg + o``) und beende danach die Bearbeitung (``strg + x``):
+
+.. code::
+
+   #!/bin/bash
+   set -eu
+   sed -i '/local ipaddr/a sleep 1' init.sh
+   echo "- Mein Hook gelaufen - 1 Sek. Wartezeit für Mediatek-WLAN hinzugefügt -"
+
+Ggf. musst Du bei Deiner WLAN-Karte die Wartezeit zwischen 1 bis 10 Sekunden anpassen. Ob die Karte erkannt wird, kannst Du auf dem Client mit folgendem Befehl prüfen:
+
+.. code::
+
+   sed -i '/local ipaddr/a cat /proc/net/dev' init.sh
+
+
 LINBO: Client-Anpassungen
 =========================
 

source/installation/install-from-scratch/basis_file_server.rst

@@ -8,15 +8,11 @@ Anlegen und Installieren des Fileservers
 
 .. sectionauthor:: `@cweikl <https://ask.linuxmuster.net/u/cweikl>`_
 
-.. todo::
-
-   Kapitel muss noch überarbeitet werden. btrfs, subvolumes - Anpassungen an neues lmn74 setup etc.
-
 .. hint::
 
     Der Fileserver für linuxmuster.net 7.4 kann optional installiert werden (Drei-Server-Lösung). Es kann aber weiterhin wie bisher auch ein Weiterbetrieb als Zwei-Server-Lösung erfolgen. Wir empfehlen den Fileserver z.B. in einer eigenen VM zu installieren, da hierdurch deutliche Performancesteigerungen in Verbindung mit Samba erreicht werden. Dies empfehlen wir insbesondere mittleren bis größeren Schulen. Kleinere Schulen können problemlos linuxmuster.net 7.4 als Zwei-Server-Lösung weiterbetreiben.
 
-    Grundsätzlich kann linuxmuster.net 7.4 weiterhin als Zwei-Server-Lösung betrieben werden und es kann jederzeit später eine Erweiterung / Umstellung auf den zusätzlichen File-Server erfolgen. Die Migration/ das Update von v7.2 erfolgt zunächst immer als Zwei-Server-Lösung und es erfolgt danach eine Erweiterung um den Fileserver. 
+    Grundsätzlich kann linuxmuster.net 7.4 weiterhin als Zwei-Server-Lösung betrieben werden und es kann jederzeit später eine Erweiterung / Umstellung auf den zusätzlichen File-Server erfolgen.
 
 In Samba-Umgebungen ist es inzwischen üblich, den Domänencontroller und den Fileserver getrennt voneinander zu betreiben, da dies Performancevorteile hat: Selbst wenn der Fileserver auf dem gleichen Host virtualisiert wird, wie der Server und auf dem gleichen Storage läuft. Das ist für große Schulen mit vielen Clients von Vorteil.
 
@@ -51,16 +47,16 @@ Vorteile:
 Installation Ubuntu-Server
 ==========================
 
-Führe die Installation des für den File-Server benötigten Ubuntu 24.04 LTS Servers so aus, wie zuvor im Kapitel :ref:`basis_server-label` beschrieben. Nutze die zuvor bereitgestellten zwei HDDs. Passe die Partitionierung und Formatierung der Festplatten ggf. entsprechend an die Bedürfnisse der Schule an. Zudem musst Du eine statische IP-Adresse aus dem LAN dem File-Server zuweisen.
+Führe die Installation des für den File-Server benötigten Ubuntu 26.04 LTS Servers so aus, wie zuvor im Kapitel :ref:`basis_server-label` beschrieben. Nutze die zuvor bereitgestellten zwei HDDs. Passe die Partitionierung und Formatierung der Festplatten ggf. entsprechend an die Bedürfnisse der Schule an. Zudem musst Du eine statische IP-Adresse aus dem LAN dem File-Server zuweisen.
 
 Nutze die Daten gemäß Deines IP-Adresskonzeptes oder gib nachstehende Daten ein, die in der Dokumentation durchgängig für das LAN verwendet werden:
 
 - Netzbereich: 10.0.0.0/16
 - IP-Adresse:  10.0.0.2
-- Netzmaske:   10.0.0.254
-- Gateway:     10.0.0.254
-- DNS:         10.0.0.254
-- Domäne:      <lasse diese leer>
+- Netzmaske:   255.255.0.0
+- Gateway:     10.0.0.254 (Firewall)
+- DNS:         10.0.0.1 (AD/DC-Server)
+- Domäne:      <leer lassen bitte>
 
 Lasse die Domäne des FQDN in den Dateien
 
@@ -188,11 +184,11 @@ Aktualisiere den Server und installiere die linuxmuster.net File-Server-Pakete:
 
    sudo apt update && sudo apt install linuxmuster-fileserver
 
-Bei der Paketinstallation wird für die Kerberos-Authentifizierung ein sog. Realm abgefragt. Dieser bleibt zu diesem Zeitpunkt frei. Bei der späteren Integration des File-Servers in den AD/DC wird dies dann automatisch angepasst.
-
 .. hint::
 
-   Für Anwender einer Virtualisierungslösung empfehlen wir an dieser Stelle einen Snapshot zu erstellen!
+   Bei der Paketinstallation wird für die Kerberos-Authentifizierung ein sog. Realm abgefragt. Dieser bleibt zu diesem Zeitpunkt frei. Bei der späteren Integration des File-Servers in den AD/DC wird dies dann automatisch angepasst.
+
+   Für Anwender einer Virtualisierungslösung empfehlen wir an dieser Stelle einen ``Snapshot`` zu erstellen!
 
 Weiteres Vorgehen
 =================

source/setup/setup-file-server.rst

@@ -8,15 +8,11 @@ Setup File-Server
 
 .. sectionauthor:: `@cweikl <https://ask.linuxmuster.net/u/cweikl>`_,
 
-.. todo::
-
-   Kapitel muss noch vollständig neu überarbeitet werden. Es stehen noch Infos und Tests aus.
-
 .. hint::
 
     Der Fileserver für linuxmuster.net 7.4 kann optional installiert werden (Drei-Server-Lösung). Es kann aber weiterhin wie bisher auch ein Weiterbetrieb als Zwei-Server-Lösung erfolgen. Wir empfehlen den Fileserver z.B. in einer eigenen VM zu installieren, da hierdurch deutliche Performancesteigerungen in Verbindung mit Samba erreicht werden. Dies empfehlen wir insbesondere mittleren bis größeren Schulen. Kleinere Schulen können problemlos linuxmuster.net 7.4 als Zwei-Server-Lösung weiterbetreiben.
 
-    Grundsätzlich kann linuxmuster.net 7.4 weiterhin als Zwei-Server-Lösung betrieben werden und es kann jederzeit später eine Erweiterung / Umstellung auf den zusätzlichen File-Server erfolgen. Die Migration/ das Update von v7.2 erfolgt zunächst immer als Zwei-Server-Lösung und es erfolgt danach eine Erweiterung um den Fileserver.                
+    Grundsätzlich kann linuxmuster.net 7.4 weiterhin als Zwei-Server-Lösung betrieben werden und es kann jederzeit später eine Erweiterung / Umstellung auf den zusätzlichen File-Server erfolgen.
 
 File-Server aufnehmen
 =====================
@@ -38,7 +34,7 @@ Im Terminal wirst Du mit dem Erstbildschirm von linuxmuster.net v7.4 begrüßt u
 
    Welcome to lmn.net
 
-Wechsel im Terminal zum Benutzer root mit
+Wechsel im Terminal zum Benutzer ``root`` mit
 
 .. code::
 
@@ -135,14 +131,14 @@ Das Setup benötigt folgende Optionen, die bei Aufruf anzugeben sind:
 
 Der vollständige Befehlsaufruf für das Setup lautet z.B. für die
 
-a) Domain: schule.willie-wichtig.org (wie beim Setup des AD/DC angegeben)
-b) Admin: global-admin
-c) -p auslassen, dann wird das Kennwort interaktiv abgefragt
-d) Schulname: wird -s ausgelassen, wird default-school genutzt
+ - *Domäne*: schule.willie-wichtig.org (wie beim Setup des AD/DC angegeben)
+ - *Benutzername des Admins*: global-admin
+ - *Kennwort des Admins*: ``-p`` auslassen, dann wird das Kennwort interaktiv abgefragt
+ - *Schulname für Freigaben*: Wird ``-s`` ausgelassen, wird default-school genutzt
 
 .. hint::
 
-   Hast Du zuvor das Setup des linuxmuster.net AD/DC Server durchlaufen, dann nutzt Du dort den Share default-school - unabhängig davon, wie Du beim Setup Deine Schule genannt hast. Du musst also für den File-Server daher diese angeben bzw. den Parameter -s weglassen.
+   Hast Du zuvor das Setup des linuxmuster.net AD/DC - Server durchlaufen, dann nutzt Du dort den Share ``default-school`` - unabhängig davon, wie Du beim Setup Deine Schule genannt hast. Du musst also für den File-Server diesen Share angeben oder den Parameter ``-s`` weglassen.
 
 .. code::
 
@@ -171,48 +167,49 @@ Freigaben übertragen
 3. Du lässt mit sophomorix die Berechtigungen im AD anpassen.
 4. Auf dem File-Server passt Du die ACLs an.
 
+``Schritt 1``
 
-Übertrage zuerst den ssh_key des Benutzer root vom linuxmuster.net AD/DC Server auf den File-Server. Bislang kannst Du Dich nur als Benutzer linuxadmin auf dem File-Server via ssh anmelden.
+Übertrage zuerst vom linuxmuster.net AD/DC Server den ssh-key des Benutzer root auf den File-Server. Bislang kannst Du Dich nur als Benutzer linuxadmin auf dem File-Server via ssh anmelden. Du musst also nach der Übertragung den übertragenen ssh-key dem Benutzer root auf dem File-Server zuweisen.
 
-Gib daher auf dem AD in der Konsole folgenden Befehle ein:
+Gib daher auf dem AD/DC Server zur Übertragung des ssh-keys in der Konsole folgenden Befehle ein:
 
 .. code::
 
    root@server:~# ssh-copy-id -i .ssh/id_rsa.pub linuxadmin@10.0.0.2
-
-Der Key wurde nun auf dem File-Server dem User linuxadmin in ``~.ssh/authorized_keys hinzugefügt``.
-
-Öffne nun die Konsole auf dem AD und wechsel zum Benutzer root. 
 
-Kopiere nun die Datei authorized_keys des Benutzers linuxadmin:
+- Der Key wurde nun auf dem File-Server dem User linuxadmin in ``~.ssh/authorized_keys`` hinzugefügt.
+- Verbinde Dich nun vom AD/DC-Server via ssh auf den File-Server.
 
 .. code::
 
-   cp /home/linuxadmin/.ssh/authorized_keys /root/.ssh/
-
-Teste nun, ob Du vom AD via SSH auf den File-Server gelangst. Dies sollte mit
+   ssh root@10.0.0.2
+
+- Wechsel auf dem File-Server in der Konsole zum Benutzer ``root``.
+- Kopiere nun die Datei ``authorized_keys`` des Benutzers ``linuxadmin``:
 
 .. code::
 
-   ssh root@10.0.0.2
-   
-direkt erfolgen.
+   cp /home/linuxadmin/.ssh/authorized_keys /root/.ssh/
+
+``Schritt 2``
 
 Danach installierst Du rsync jeweils auf dem ``AD/DC Server`` und auf dem ``File-Server`` mit
 
 .. code::
 
    sudo apt install -y rsync
 
-Jetzt kannst Du den Inhalt des Freigabeordners auf dem AD zum File-Server synchronisieren.
+``Schritt 3``
 
-Hierzu gibst Du als Benutzer root auf dem AD folgenden Befehl ein:
+Jetzt kannst Du den Inhalt des Freigabeordners auf dem AD/DC-Server zum File-Server synchronisieren.
+
+Hierzu gibst Du als Benutzer root auf dem AD/DC-Server folgenden Befehl ein:
 
 .. code::
 
    rsync -av --delete -e ssh /srv/samba/schools/default-school/ root@10.0.0.2:/srv/samba/schools/default-school/
 
-Als Ziel ist auf dem File-Server der Schulname anzugeben, wie Du diesen zuvor mit dem linuxmuster-fileserver setup eingerichtet hattest.
+Als Ziel ist auf dem ``File-Server`` der Schulname anzugeben, wie Du diesen zuvor mit dem linuxmuster-fileserver setup eingerichtet hattest.
 
 
 Aktualisierung der Freigaben
@@ -227,10 +224,6 @@ Wechsel im Terminal zum Benutzer root mit
    sudo -i
 
 Gib im Terminal zur Aktualisierung der Freigaben (Shares) folgende Befehle ein:
-
-.. hint::
-
-   Hast Du für den File-Server einen anderen Schulnamen als den Vorgabewert (default-school) angegeben, dann musst Du diesen hier angeben.
 
 .. attention::
 
@@ -249,16 +242,17 @@ Gib im Terminal zur Aktualisierung der Freigaben (Shares) folgende Befehle ein:
    net conf setparm $SCHOOL "msdfs proxy"  //$FQDN/$SCHOOL
    net conf setparm $SCHOOL "hide unreadable"  yes
 
+
 Abschluss
 =========
 
-Zum Abschluss der Integration führe noch folgenden Befehl auf dem linuxmuster.net AD/DC Server aus:
+Führe zum Abschluss der Integration noch folgenden Befehl auf dem linuxmuster.net ``AD/DC - Server`` aus:
 
 .. code::
 
    sophomorix-repair --all
 
-Danach wechselst Du zur Konsole auf dem File-Server und gibst dort als Benutzer root folgenden Befehl ein:
+Danach wechselst Du zur Konsole auf dem ``File-Server`` und gibst dort als Benutzer root folgenden Befehl ein:
 
 .. code::
 
@@ -276,14 +270,56 @@ Bei erfolgreicher Anwendung siehst Du diese Ausgabe:
    File-Server: Setze die ACLs
 
 
+Fehlerbehebung
+==============
 
+Sollten Fehler auftreten, können zur Behebung folgende Befehle hilfreich sein:
 
+1. Prüfe auf dem AD/DC-Server, ob der File-Server läuft:
 
-
+.. code::
+
+   linuxmuster-fileserver status
+
+2. Prüfe, ob Benutzer und Grupppen auf dem File-Server gelesen werden können:
+
+.. code::
+
+   # user
+   wbinfo -u
+   # group
+   wbinfo -g
+
+3. Prüfe, ob Clients vom File-Server aus erreicht werden können.
+
+Geschwindigkeitstests
+=====================
+
+Wurde der File-Server erfolgreich eingerichtet, kannst Du Tests zur Überprüfung der Geschwindigkeit durchführen. Dazu rufst Du auf dem AD/DC-Server eine Konsole auf und gibst folgenden Befehl an:
+
+.. code::
+
+   smbclient //<target>/<share> -U global-admin -k -c "put random-1G;rm random-1G"
+
+Es wird eine Datei mit zufälligem Inhalt und einer Dateigröße von 1GiB auf die Freigabe übertragen und danach direkt wieder gelöscht. Beobachte die dabei angegebene Übertragungszeit. Wiederhole den Test mehrfach.
+
+.. hint::
+
+   Passe <target> auf Deinen File-Server und <share> auf Deine Freigabe an.
+
+
+Samba DFS
+=========
 
+Das Distributed File System (DFS) arbeitet so, dass die Anfrage eines Client an eine DFS-PFad (z.B. \\server\default-school) von Samba mit einem DFS-Verweis beantwortet wird. Dieser Verweis teilt dem Client mit, wo sich aktuell die angefragten Daten befinden. Üblicherweise entspricht dies einem UNC - Pfad wie z.B. \\lmn-fileserver.linuxmuster.lan\default-school.
 
+Der Client verbindet sich direkt mit dem Zielserver und greift direkt auf die Dateien zu, so als wenn diese Bestandteil des ursprünglichen DFS-Pfads wären. Die Umleitung erfolgt nahtlos im Hintergrund, so dass ein Nutzer immer den einheitlichen DFS-Namensraum sieht.
 
+Kernaspekte:
 
+ - Clients greifen auf ein sog. virtuelles Root-Verzeichnis (``\domain\dfsroot``) anstelle auf ein Root-Verzeichnis ``/``  eines einzelnen Servers zu.
+ - Samba leitet den Client zu dem richtigen Server anhand des DFS-Verweises um.
+ - Nach der Umleitung des Clients erfolgt der Dateizugriff wie bei einer sonstigen Freigabe eines Samba-Shares.