diff --git a/source/about/about.rst b/source/about/about.rst index 279898dca..98645294e 100644 --- a/source/about/about.rst +++ b/source/about/about.rst @@ -10,14 +10,14 @@ Was ist linuxmuster.net? linuxmuster.net ist eine Komplettlösung für den digital unterstützten Unterricht für Schüler:innen und Lehrer:innen einer zeitgemäßen Bildungseinrichtung. -Die langjährigen Erfahrungen aller Beteiligten aus der linuxmuster.net Gemeinde haben gezeigt, dass sich ein Firnmennetzwerk fundamental von den Anforderungen an ein -heutige Schulnetz unterscheiden. +Die langjährigen Erfahrungen aller Beteiligten aus der linuxmuster.net Gemeinde haben gezeigt, dass sich ein Firmennetzwerk fundamental von den Anforderungen an ein +heutiges Schulnetz unterscheidet. Die Entwicklung von linuxmuster.net greift all diese Anforderungen auf und stellt eine modulare Lösung für ein Schulnetz zur Verfügung. Diese kann von einer Ein-Server-Lösung (mit drei virtuellen Maschinen - VMs) bis hin zu einer Mehr-Server-Lösung mit Cloud-Anbindung und BYOD-Integration und mehreren physikalischen Servern skaliert werden. -Die Anforderungen, die heute an ein Schulnetz gestellt werden, erklären wir im nachfolgenden Abschnitten detailliert. Im Anschluss zeigen wir auf, wie linuxmuster.net diese umsetzt. +Die Anforderungen, die heute an ein Schulnetz gestellt werden, erklären wir in den nachfolgenden Abschnitten detailliert. Im Anschluss zeigen wir auf, wie linuxmuster.net diese umsetzt. Schulnetzwerk vs. "normales" Netzwerk ===================================== @@ -68,13 +68,13 @@ Im Prinzip gibt es vier große Merkmale, die auffallen: Zum Schuljahreswechsel verlässt eine große Anzahl an Schüler:innen die Einrichtung und neue Schüler:innen müssen in das System eingepflegt werden. Die Zusammensetzung der Klassen, Kurse und Arbeitsgruppen werden zu großen Teilen neu formiert, so dass Änderungen an bestehenden Schüler:innen erforderlich sind. - Solch ein administrativen Aufwand ergibt sich in einer Firma selten. + Solch ein administrativer Aufwand ergibt sich in einer Firma selten. 4. Der Umgang mit den Arbeitsmitteln Schüler:innen teilen sich ein und dasselbe Arbeitsmittel im schulischen Alltag. Dabei ist es für die nächste Unterrichtseinheit entscheidend, dass zum Start immer eine einheitliche und funktionsfähige Umgebung auf den Rechnern vorhanden ist. Die zeitliche Taktung zwischen den Wechseln kann sehr kurz sein. - Dies ist in einer Firma so nicht gegeben. Wenn ein User seinen Rechner verlässt, findet er ihn der Regel immer genauso wieder. + Dies ist in einer Firma so nicht gegeben. Wenn ein User seinen Rechner verlässt, findet er ihn in der Regel immer genauso wieder. Aus diesen Gründen sprechen wir von einem @@ -99,7 +99,7 @@ Unser Anspruch liegt dabei auf der Bereitstellung eines Systems, das folgende Pu :name: structure-over-all :alt: gesamte Struktur -Ein Augenmerk liegt dabei auf der Unabhängigkeit eingesetzter Hard- und Software. Dieses wird unter anderem an dem Umfang der unterstützten Betriebssysteme für die Arbeitsstationen erkennbar. +Ein Augenmerk liegt dabei auf der Unabhängigkeit eingesetzter Hard- und Software. Dies wird unter anderem an dem Umfang der unterstützten Betriebssysteme für die Arbeitsstationen erkennbar. Proprietäre Betriebssysteme, |zb| aus dem Hause Microsoft |reg|, können aufgrund der Lizenzpolitik der Hersteller nicht von uns vorbereitet ausgeliefert werden. Diese lassen sich aber ebenso leicht in unsere Infrastruktur integrieren, wie solche, die als Open-Source erhältlich sind. @@ -141,7 +141,7 @@ Die Benutzer- und Gruppenverwaltung orientiert sich an den Bedürfnissen, die de * Schüler:innen bekommen mit der Einschulung ihren persönlichen Benutzer-Account. * Dieser bleibt ihnen bis zum Ende ihrer Laufbahn an der Schule erhalten. - * Die Gruppenzugehörigkeit der einzelnen Schüler:innen werden in Klassen, Kursen und Projekten abgebildet. + * Die Gruppenzugehörigkeit der einzelnen Schüler:innen wird in Klassen, Kursen und Projekten abgebildet. * Zu Beginn eines Schuljahres können diese Daten und Abhängigkeiten aus der Schulverwaltung mittels Import der Daten eingespielt bzw. fortgeschrieben werden. Gleiches gilt selbstverständlich auch für Veränderungen während eines laufenden Schuljahres. * Für Lehrer:innen gilt dies ebenso. @@ -195,10 +195,10 @@ Für weitergehende Informationen `siehe opnsense.org `_. Bestehende Firewall ^^^^^^^^^^^^^^^^^^^ -Es kann auch eine bestehende Firewall weiter genutzt und vollständig in linuxmuster.net integriert werden. Da diese Intergration von deren verwendeten Betriebssystem abhängt und unterschiedliche Schritte erfordert, können wir nicht eine datailierte Anleitung hier aufzeigen. Geben aber Hinweise dazu im Kapitel `Anpassbar`_. +Es kann auch eine bestehende Firewall weiter genutzt und vollständig in linuxmuster.net integriert werden. Da diese Integration von deren verwendeten Betriebssystem abhängt und unterschiedliche Schritte erfordert, können wir nicht eine detaillierte Anleitung hier aufzeigen. Geben aber Hinweise dazu im Kapitel `Anpassbar`_. -Selbstheilende Arbeitsstationen durch LINBO 4.3 +Selbstheilende Arbeitsstationen durch LINBO 7.4 +++++++++++++++++++++++++++++++++++++++++++++++ .. image:: media/structure_of_version_7_client.svg @@ -216,7 +216,7 @@ Das Konzept der Selbstheilenden Arbeitsstationen (SheilA) ermöglicht einheitlic * Möglichkeit sich via VNC auf den LINBO-Client aufzuschalten. * mit sogenannten Postsync-Scripten kann der Administrator für einzelne, raumweite oder für alle Geräte notwendige Konfigurationsänderungen beim Systemstart einpflegen. -Nähere Information sind im Kapitel "Clientverwaltung" beschrieben. +Nähere Informationen sind im Kapitel "Clientverwaltung" beschrieben. Integration unterschiedlicher Geräte (BYOD) +++++++++++++++++++++++++++++++++++++++++++ diff --git a/source/about/what-is-new.rst b/source/about/what-is-new.rst index c0c398104..13d291ca4 100644 --- a/source/about/what-is-new.rst +++ b/source/about/what-is-new.rst @@ -2,27 +2,77 @@ .. _`what-is-new-label`: =================== -Was ist neu in 7.3? +Was ist neu in 7.4? =================== .. sectionauthor:: `@cweikl `_, `@MachtDochNix `_ -Linuxmuster.net 7.3 ist das Release-Update der linuxmuster.net v7.2. Es erfolgt eine Aktualisierung der bisher eingesetzten Ubuntu LTS Version auf die Ubuntu Server LTS Version 24.04. Die Kernpakete der linuxmuster.net Lösung erhalten alle ein Update und stellen viele Verbesserungen und neue Features bereit. +Linuxmuster.net 7.4 ist das Release-Update der linuxmuster.net v7.3. Es erfolgt eine Aktualisierung der bisher eingesetzten Ubuntu LTS Version 24.04 auf die Ubuntu Server LTS Version 26.04. Die Kernpakete der linuxmuster.net Lösung erhalten alle ein Update und stellen viele Verbesserungen und neue Features bereit. -Neue Funktionalitäten ---------------------- -Verbesserte Skalierbarkeit +Neuerungen +---------- + +Version 7.4 ist eine umfangreiche Wartungs- und Refactoring-Version. Der gesamte Python-Code wurde auf die Debian Python Policy (PEP 517/518) umgestellt, kritische Sicherheitslücken wurden geschlossen und die OPNsense |reg| - Anbindung wurde auf die REST-API migriert. Daneben wurden zahlreiche Fehler behoben und Sicherheitsverbesserungen eingeführt. + + +**Neue Python-Paketstruktur (Debian Python Policy)** + +Der gesamte Python-Code wurde in ein reguläres Python-Paket überführt und folgt nun der Debian Python Policy: + + - Neues Paket-Layout unter src/linuxmuster_base7/ mit den Untermodulen cli/ und setup/ + - Alle CLI-Werkzeuge sind jetzt reguläre Python-Module im Paket pyproject.toml (PEP 621) als zentrale Projektkonfiguration. + - Die alten monolithischen Skripte unter sbin/ und lib/ wurden entfernt + - Alle Skripte werden nun nach /usr/sbin/ statt /usr/bin/ installiert + +**Sicherheitsfixes** + +Mehrere kritische Sicherheitslücken wurden geschlossen: + + - Shell-Injection in SSH-Funktionen beseitigt. + - Passwort-Leak in opnsense_reset.py behoben. + - Shell-Injection in catFiles() behoben. + - Alle verbleibenden os.popen()-, os.system()- und subProc()-Aufrufe wurden durch sicheres subprocess.run() ersetzt. + +**OPNsense-Anbindung auf REST-API migriert** + +import_subnets.py verwaltet statische Routen in der OPNsense-Firewall jetzt ausschließlich über die REST-API (HTTP/HTTPS) statt über SSH-Kommandos. Dadurch entfällt die Abhängigkeit von SSH-Zugangsdaten für diese Operation und die Anbindung ist robuster und besser zu warten. + +**Verbesserter Ablauf bei linuxmuster-import-devices** + +Vor dem eigentlichen ``sophomorix-device --sync`` wird jetzt zwingend ``sophomorix-device --dry-run`` ausgeführt. Nur wenn der dry-run fehlerfrei durchläuft, wird mit dem Sync fortgefahren. Schlägt der dry-run fehl, bricht das Skript mit einer Fehlermeldung ab. + +**Setup-Verbesserungen** + + - Hostname-Änderungen werden bei der Samba-Provisionierung jetzt korrekt übernommen (bisher wurde ein geänderter Hostname ignoriert) + - isc-dhcp-server6.service wird während des Setups deaktiviert, um Konflikte zu vermeiden. + - Keytab-Erstellung wird übersprungen, wenn das Firewall-Setup deaktiviert ist (skipfw = True) + - NTP wird nur dann deaktiviert, wenn es tatsächlich aktiv ist. + - Versionsnummer in der Setup-Dialoganzeige korrigiert. + +**LINBO - Neuerungen** + + - Komplette Überarbeitung des Build-Systems + - Refaktorierung der Kernel-Bereitstellung + - Ersatz von ctorrent durch aria2c + - Aufräumen und Entfernen veralteter Komponenten + - Natives Windows-Treiberprofil-Management + - Weitere Fehlerbehebungen und Verbesserungen + +Funktionalitäten +---------------- + +Skalierbarkeit * Mehrschulfähigkeit: Konsolidierung mehrerer Schulinstanzen möglich * Gruppenorientierte Abbildung der Schule und flexible, regelbasierte Steuerung * Moderne Bereitstellung zusätzlicher IT-Dienste der Schule innerhalb der Schullösung Moderne Betriebssystembasis und Steuerung - * Aktuelle Betriebssysteme für die Server (Ubuntu Server 24.04 LTS) - * **Optionale** Firewall OPNsense |reg| ab v25.1 + * Aktuelle Betriebssysteme für die Server (Ubuntu Server 26.04 LTS) + * **Optionale** Firewall OPNsense |reg| ab v26.1 * Verbesserung der Performance des Samba-Dateiservers durch automatische Verlagerung der Shares auf eine zweite VM, die nur den Dateiserver aufnimmt. Nutzung von DFS als Dateisystem. - * Mit LINBO 4.3: aktuellste Linux-Kernels für aktuelle Hardware, differentielle Images, ntfs3 Kernel-Treiber, VNC-Server, mit neuem Namensschema zur einheitlichen Partitionierung + * Mit LINBO 7.4: aktuelle Linux-Kernels für aktuelle Hardware, differentielle Images, ntfs3 Kernel-Treiber, VNC-Server, mit neuem Namensschema zur einheitlichen Partitionierung * Webbasierte Steuerung der pädagogischen Funktionen mit einem **responsive design** (passt sich an alle Bildschirmgrößen und -auflösungen an). * WebUI mit vielen neuen administrativen Möglichkeiten wie die Verwaltung von Schulpersonal und Eltern * Bereitstellung von linuxmuster-tools, linuxmuster-api und linuxmuster-cli mit erweiterten Möglichkeiten zur Administration und Anbindung externer webbasierter Systeme @@ -54,14 +104,15 @@ Netzwerkverwaltung auf Single-Sign-On Basis - anstelle eines transparenten Proxy Selbstheilende Arbeitsstationen - * LINBO ist weiterhin das zentrale Softwareverteilungssystem. + * LINBO ist das zentrale Softwareverteilungssystem. * Weitere Neuerungen in LINBO sind u.a.: - * Aktuelle Linux-Kernel ab 6.12.* und einem nativen NTFS-Kernel Treiber - * Neues einheitliches Partitionsschema mit neuem Namenschemata + * Aktuelle Linux-Kernel und einem nativen NTFS-Kernel Treiber + * Neues einheitliches Partitionsschema mit neuem Namensschema * Konsolidierung der Start-Parameter * VNC-Server auf den Clients für Remote-Zugriff * Inventarisierung der Clients mit hwinfo + * Verbesserungen bei der Software-Verteilung mit Torrent diff --git a/source/classroom/access-control.rst b/source/classroom/access-control.rst index 8f346a306..c7ada996a 100644 --- a/source/classroom/access-control.rst +++ b/source/classroom/access-control.rst @@ -7,7 +7,7 @@ In einer Klasse und einem Kurs kann einzelnen Personen oder dem gesamten Kurs / der Klasse die Berechtigung zu Drucken oder der Zugriff auf WLAN und Internet gegeben oder genommen werden. Voraussetzung für diese Funktionen ist die :ref:`Aufnahme des Schülers ` in einen Kurs. -Öffne in der Schulkonsole unter ``KLASSENZIMMER -> Kurse`` wähle die geünschte Klasse oder den gewünschten Kurs. +Öffne in der Schulkonsole unter ``KLASSENZIMMER -> Kurse`` wähle die gewünschte Klasse oder den gewünschten Kurs. .. figure:: media/webui-teachers-select-session.png :align: center @@ -15,7 +15,7 @@ In einer Klasse und einem Kurs kann einzelnen Personen oder dem gesamten Kurs / Wähle die Klasse / Gruppe aus -Es wird Liste mit Schülern des Kurses bzw. der Klasse angezeigt. +Es wird eine Liste mit Schülern des Kurses bzw. der Klasse angezeigt. .. figure:: media/webui-teachers-list-session.png :align: center @@ -36,7 +36,7 @@ Für jeden einzelnen und für alle Schüler können folgende Funktionen aktivier Spalten mit den zu-/abschaltbaren Funktionen pro Schüler -Soll eine Funktion für alle Schüler aktiviert werden, klickst Du nur auf das Symbol des Spaltenkopfen (z.B. WLAN). +Soll eine Funktion für alle Schüler aktiviert werden, klickst Du nur auf das Symbol des Spaltenkopfes (z.B. WLAN). .. figure:: media/webui-teachers-session-columns-wlan-activated.png :align: center diff --git a/source/classroom/exam-and-transfer.rst b/source/classroom/exam-and-transfer.rst index 205fdb3c4..9344c48c1 100644 --- a/source/classroom/exam-and-transfer.rst +++ b/source/classroom/exam-and-transfer.rst @@ -24,7 +24,7 @@ in einen Kurs/Klasse. Starte die Session für die Klasse -Hast Du einen Kurse / eine Klasse ausgewählt, wird Dir die Liste mit Schülern des Kurses / der Klasse angezeigt. +Hast Du einen Kurs / eine Klasse ausgewählt, wird Dir die Liste mit Schülern des Kurses / der Klasse angezeigt. .. figure:: media/webui-teachers-session-members.png :align: center @@ -34,7 +34,7 @@ Hast Du einen Kurse / eine Klasse ausgewählt, wird Dir die Liste mit Schülern Du kannst den Prüfungsmodus entweder für alle zusammen über das Prüfungssymbol im Spaltenkopf aktivieren. -Alternativ kannst Du für einzelne Prüflingen den Prüfungsmodus starten, indem Du in der Zeile des Prüflings das Prüfungssymbol klikcst. +Alternativ kannst Du für einzelne Prüflingen den Prüfungsmodus starten, indem Du in der Zeile des Prüflings das Prüfungssymbol klickst. .. figure:: media/exam-icon.png :align: center @@ -116,7 +116,7 @@ Danach erscheint eine Rückfrage zur Bestätigung: Bestätige das Beenden des Prüfungsmodus -Du erhälst ein Fenster mit der Nachfrage, ob Du den Prüfungsmodus wirklich beenden möchstest. Hast Du alle gewünschten Daten der Prüflinge zuvor eingesammelt, bestätige diesen Vorgang mit ``PRÜFUNGSMODUS BEENDEN``. +Du erhältst ein Fenster mit der Nachfrage, ob Du den Prüfungsmodus wirklich beenden möchtest. Hast Du alle gewünschten Daten der Prüflinge zuvor eingesammelt, bestätige diesen Vorgang mit ``PRÜFUNGSMODUS BEENDEN``. .. figure:: media/webui-teachers-session-members.png :align: center @@ -136,7 +136,7 @@ Ablauf der Prüfung 1. Der Lehrer meldet sich an der Schulkonsole an. 2. Der Lehrer wählt unter KLASSENzimmer -> Kurs -> Klasse die gewünschte Klasse aus. 3. Der Lehrer aktiviert mit dem Prüfungssymbol den Prüfungsmodus. -4. Der Lehrer teilt den Prüflingen im Raum mit wie diese sich am PC für die Prüfung anmelden müssen (+"-exam" & bisheriges Kennwort). +4. Der Lehrer teilt den Prüflingen im Raum mit wie diese sich am PC für die Prüfung anmelden müssen (+"-exam" & bisheriges Kennwort). 5. Der Lehrer teilt die Prüfungen und ggf. weitere Vorlagen an die Prüfungsteilnehmer aus. 6. Die Dateien liegen für die Prüfungsteilnehmer im Verzeichnis ``transfer/LEHRER/``. 7. Schüler nutzen die bereitgestellten Daten und erstellen ihre Lösungen. @@ -322,7 +322,7 @@ Der Lehrer sieht in der Schulkonsole die abgegebenen Dateien. Um die Liste mit d Prüfung: abgegebene Dateien einsehen Um vor Abschluss der Prüfung alle Abgaben einzusammeln, klickst Du unten links auf ``Von allen einsammeln``. -Klicke nun auf ``Move _collect cirectory from all members``. Es werden nun alle Abgaben in das Verzeichnis des Lehrers zum Einsammeln der Dateien verschoben. +Klicke nun auf ``Move _collect directory from all members``. Es werden nun alle Abgaben in das Verzeichnis des Lehrers zum Einsammeln der Dateien verschoben. .. figure:: media/webui-exam-collect-all-files.png :align: center @@ -338,17 +338,17 @@ Klicke nun auf ``Move _collect cirectory from all members``. Es werden nun alle Prüfung beenden ^^^^^^^^^^^^^^^ -Nachdem alle Dateien eingsammelt wurden, beendet der Lehrer den Prüfungsmodus. +Nachdem alle Dateien eingesammelt wurden, beendet der Lehrer den Prüfungsmodus. Hierzu klickst Du auf das rot hinterlegte Prüfungssymbol im Spaltenkopf, um für alle Prüflingen den Prüfungsmodus zu beenden. -Sollten für Prüflinge untzerschiedliche Prüfungszeiten gelten, so beendest Du pro Prüfling deren Prüfung zeilenweise einzeln. +Sollten für Prüflinge unterschiedliche Prüfungszeiten gelten, so beendest Du pro Prüfling deren Prüfung zeilenweise einzeln. Abgaben einsehen ^^^^^^^^^^^^^^^^ Du kannst als Lehrer wähend der Prüfung bereits eingesammelte Ordner und Dateien einsehen. Gehe hierzu unten auf ``Eingesammelte Dateien durchschauen`` -Es öffnet sich ein Fenster mit den einsammelten Ordnern und Dateien. +Es öffnet sich ein Fenster mit den eingesammelten Ordnern und Dateien. .. figure:: media/webui-exam-check-collected-directories.png :align: center @@ -357,7 +357,7 @@ Es öffnet sich ein Fenster mit den einsammelten Ordnern und Dateien. Prüfung: Prüfe Dateiabgaben -Die aktuelle Prüfung ist am Klassennamen und an dem Zeistempel zu erkennen. Klicke auf das Ordnersymbol, um diesen zu öffnen. +Die aktuelle Prüfung ist am Klassennamen und an dem Zeitstempel zu erkennen. Klicke auf das Ordnersymbol, um diesen zu öffnen. .. figure:: media/webui-exam-check-collected-directories-of-users.png :align: center diff --git a/source/classroom/webui-basics/index.rst b/source/classroom/webui-basics/index.rst index f862f378a..590765939 100644 --- a/source/classroom/webui-basics/index.rst +++ b/source/classroom/webui-basics/index.rst @@ -109,7 +109,7 @@ Klassenzimmer Kurs ---- -In dem Menüpunkt Kurs werden der aktuelle Raum, Deine zugeordneten Klassen, Deine Gruppenund Projekte aufgelistet. +In dem Menüpunkt Kurs werden der aktuelle Raum, Deine zugeordneten Klassen, Deine Gruppen und Projekte aufgelistet. .. figure:: media/10_webui-basics_my-classes.png :align: center @@ -176,7 +176,7 @@ Um Schüler einer Gruppe hinzuzufügen, wählst Du die gewünschte Gruppe via Kl :align: center :alt: seclected course - Ausgwählter Kurs + Ausgewählter Kurs In den oberen Zeilen gibt es nun die Möglichkeit über ``Schüler hinzufügen`` einzelne Schüler hinzuzufügen oder über ``Klasse hinzufügen`` eine ganze Schulklasse dem Kurs hinzuzufügen. Klickst Du in das Feld ``Schüler hinzufügen`` und gibst dort die **ersten beiden Buchstaben des Schülernamens** ein, erscheint eine Liste mit Schülern, deren Nachnamen mit diesen Buchstaben beginnen. @@ -184,7 +184,7 @@ In den oberen Zeilen gibt es nun die Möglichkeit über ``Schüler hinzufügen`` :align: center :alt: add pupils to course - Ausgwählter Kurs: Schüler hinzufügen + Ausgewählter Kurs: Schüler hinzufügen Wähle einen einzelnen Schüler aus, der zur Gruppe hinzugefügt werden soll. Wiederhole diesen Vorgang für alle weiteren Schüler. @@ -200,9 +200,9 @@ Die Gruppe ist nun erstellt. .. hint:: - Bei einzelnen Schülern siehst Du noch einen roten Button in der Spalte Arbeitsverzeichnis. Dies liegt daran, dass für diese Schüler in Deinem Transferorrdner noch keine Verzeichnisse angelegt wurden. + Bei einzelnen Schülern siehst Du noch einen roten Button in der Spalte Arbeitsverzeichnis. Dies liegt daran, dass für diese Schüler in Deinem Transferordner noch keine Verzeichnisse angelegt wurden. - Sollte dies so sein, klicke danach im Menü links auf ``Kurs`` -> ``Meine Gruppen`` -> ``Neu erstellte Gruppe``. Danach erscheinen alle Schüler, die der Gruppe hinzugefügt wurden. Schließe die Einrichtung des Kurses mithilfe des Klicks auf den roten Button ab, der alle Schüler auflistest, für die noch kein Verzeichnis im Transferordner angelegt wurde. Zur Bestätigung musst Du Dein Anmeldekennwort angeben. + Sollte dies so sein, klicke danach im Menü links auf ``Kurs`` -> ``Meine Gruppen`` -> ``Neu erstellte Gruppe``. Danach erscheinen alle Schüler, die der Gruppe hinzugefügt wurden. Schließe die Einrichtung des Kurses mithilfe des Klicks auf den roten Button ab, der alle Schüler auflistet, für die noch kein Verzeichnis im Transferordner angelegt wurde. Zur Bestätigung musst Du Dein Anmeldekennwort angeben. Klickst Du nun auf Kurs, siehst Du folgende Ansicht: @@ -310,7 +310,7 @@ Das Absolventenkappen-Symbol Prüfungsmodus -stellt den Prüfungsmodus dar. Ausgewählte Schüler oder alle Schüler einer Klasse eines Kurses können dadurch in diesen Modus gesetzt werden. Um alle Schüler des Kurses in den Prüfungsmodus zu versetzen, klickst Du auf das Icon für den Prüfungsmodus im Spaltenkopf. Sollen nur einzelne Schüler in den Prüfungsmodus versetzt werden, wäjlst Du dies Symbol bei dem jeweiligen Schüler aus. +stellt den Prüfungsmodus dar. Ausgewählte Schüler oder alle Schüler einer Klasse eines Kurses können dadurch in diesen Modus gesetzt werden. Um alle Schüler des Kurses in den Prüfungsmodus zu versetzen, klickst Du auf das Icon für den Prüfungsmodus im Spaltenkopf. Sollen nur einzelne Schüler in den Prüfungsmodus versetzt werden, wählst Du dies Symbol bei dem jeweiligen Schüler aus. Im aktivierten Prüfungsmodus wird die Seite wie folgt angezeigt: @@ -334,12 +334,12 @@ Im Menü ``Einschreiben`` findest Du nachstehende drei Rubriken. Schulklassen ^^^^^^^^^^^^ -Hier werden alle Schulklassen der Schule aufgelistet. Durch Klick auf den Klassennamen werden Dir weitere Informationen angezeigt, wie etwa alle Schüler der Klasse. Um Dir eine schulklasse zuzuordnen aktivierst Du den Haken vor der Klasse und bestätigst dann die Ausführung oben auf der Seite mit ``Jetzt ausführen``. +Hier werden alle Schulklassen der Schule aufgelistet. Durch Klick auf den Klassennamen werden Dir weitere Informationen angezeigt, wie etwa alle Schüler der Klasse. Um Dir eine Schulklasse zuzuordnen aktivierst Du den Haken vor der Klasse und bestätigst dann die Ausführung oben auf der Seite mit ``Jetzt ausführen``. Drucker ^^^^^^^ -Hier werden alle Drucker aufgelistet. Durch Anklicken werden weitere Informationen angezeigt. Drucker müssen zuvor vom Administrator angelegt und eingerichtet worden sein, damit diese hier erscheinen.. +Hier werden alle Drucker aufgelistet. Durch Anklicken werden weitere Informationen angezeigt. Drucker müssen zuvor vom Administrator angelegt und eingerichtet worden sein, damit diese hier erscheinen. Ein Auswählen ist nur erforderlich, wenn man den Drucker auch außerhalb des zugehörigen Raumes nutzen möchte. @@ -352,7 +352,7 @@ Projekte - Gruppe: Eine Gruppe hat kein Netzlaufwerk (keine Shares), um Dateien gemeinsam abzulegen und auszutauschen. Zudem kann diesen keine E-Mail zugeordnet werden. Insofern ist es nur eine Liste mit Benutzer für einen Kurs (z.B. eine einmalige Schulung). - - Projekt: Ist ein Zusammenschluss mehrerer Benutzer aus verswchiedenen Gruppen, mit einem gemeinsamen Projektlaufwerk (also mit Shares) und der Möglichkeit, hiermit einen Projektverteiler zu erstellen, um via E-Mail Infos weiterzugeben. Letzters erfordert aber eine Konfiguration des SMTP-Relais und ggf. der Edulution UI. + - Projekt: Ist ein Zusammenschluss mehrerer Benutzer aus verschiedenen Gruppen, mit einem gemeinsamen Projektlaufwerk (also mit Shares) und der Möglichkeit, hiermit einen Projektverteiler zu erstellen, um via E-Mail Infos weiterzugeben. Letzters erfordert aber eine Konfiguration des SMTP-Relais und ggf. der Edulution UI. Hier werden alle Deine Projekte aufgelistet. Um ein neues Projekt anzulegen, klicke auf ``Neues Projekt`` und trage den Projektnamen ein. @@ -384,7 +384,7 @@ Klickst Du auf das Projekt - hier ``P_netzwerkguide`` siehst Du alle Einstellung Um dem neu angelegten Projekt Projektmitglieder hinzuzufügen, klickst Du wie oben dargestellt auf den Button ``Benutzer oder Gruppe hinzufügen``. -Um einzelne Benutzer hinzuzufügen, klikcst Du in das Feld ``Nach einem Benutzer suchen`` und gibst dort einige Buchstaben des Names des Benutzers ein. Es werden alle gefundenden Einträge in einer Liste angezeigt. Aus dieser kannst Du einen gewünschten Benutzer auswählen. +Um einzelne Benutzer hinzuzufügen, klickst Du in das Feld ``Nach einem Benutzer suchen`` und gibst dort einige Buchstaben des Names des Benutzers ein. Es werden alle gefundenen Einträge in einer Liste angezeigt. Aus dieser kannst Du einen gewünschten Benutzer auswählen. .. figure:: media/23_webui-basics_new_project_add_project_members.png :align: center @@ -392,7 +392,7 @@ Um einzelne Benutzer hinzuzufügen, klikcst Du in das Feld ``Nach einem Benutzer Projektmitglieder hinzufügen -Diesen Vorgang wiederholst Du für alle gewünschten Benutzer, Schüler aus einer Klasse oder Projektmitglieder anderer Projekte. Alle ausgewählten Benutzer werden ann unter ``Hinzufügen`` aufgelistet. +Diesen Vorgang wiederholst Du für alle gewünschten Benutzer, Schüler aus einer Klasse oder Projektmitglieder anderer Projekte. Alle ausgewählten Benutzer werden dann unter ``Hinzufügen`` aufgelistet. .. figure:: media/23_webui-basics_new_project_add_project_members2.png :align: center diff --git a/source/clients/client_templates/hardware_category/index.rst b/source/clients/client_templates/hardware_category/index.rst index 0368a5ce1..badbe7819 100644 --- a/source/clients/client_templates/hardware_category/index.rst +++ b/source/clients/client_templates/hardware_category/index.rst @@ -30,7 +30,7 @@ Nun klickst Du unten links auf ``+ERSTELLEN``. Es öffnet sich ein Kontextmenü. Du kannst entweder ein leere ``start.conf`` nutzen, oder ein bereits vordefiniertes Template für Dein gewünschtes Betriebssystem auswählen. Hierbei kannst Du Templates für ein oder mehrere Betriebssysteme mit oder ohne UEFI-BIOS auswählen und diese ggf. nach Deinen Vorstellungen anpassen. -LINBO nutzt zur Bezeichnung der Festplatte ab v4.3 eine einheitliche Bezeichnung (unified block device name), was die Pflege eines einheitlichen Images bei unterschiedlicher Hardware vereinfacht: +LINBO nutzt zur Bezeichnung der Festplatte eine einheitliche Bezeichnung (unified block device name), was die Pflege eines einheitlichen Images bei unterschiedlicher Hardware vereinfacht: 1. Die erste HDD wird als /dev/disk0 bezeichnet 2. Die erste Partition auf der ersten HDD wird dann als /dev/disk0p1 bezeichnet. diff --git a/source/clients/client_templates/index.rst b/source/clients/client_templates/index.rst index f546f97dc..2b6f10b1e 100644 --- a/source/clients/client_templates/index.rst +++ b/source/clients/client_templates/index.rst @@ -56,20 +56,3 @@ Im letzten Schritt wird nun das eigentliche Betriebssystem auf dem Muster-Client hardware_registration/index os_installation/index -.. hint:: - - Damit Clients in die Domäne aufgenommen werden können, muss auf dem Server vorher die Standard-GPO erzeugt werden. Dies ist auch ``notwendig``, wenn ausschließlich Linux-Clients eingesetzt werden. - -Die Standard-GPO wird auf dem Server erzeugt durch: - -.. code:: - - # sophomorix-school --gpo-create default-school - -Anschließend den Samba-Dienst noch neu starten: - -.. code:: - - # systemctl restart samba-ad-dc.service - - diff --git a/source/clients/client_templates/os_installation/index.rst b/source/clients/client_templates/os_installation/index.rst index daa3941b2..e5c5d35c0 100644 --- a/source/clients/client_templates/os_installation/index.rst +++ b/source/clients/client_templates/os_installation/index.rst @@ -34,35 +34,56 @@ Danach kannst Du das gewünschte Betriebssystem auf dem Client installieren. Das beschrieben. -**Muster-Client als NoProxy Gerät** +**Muster-Client Zugriff ohne Proxy ermöglichen** Für den Zeitraum der Installation und Aktualisierung des Muster-Clients ist es wichtig, dass dieser Internet-Zugriff hat, um Aktualisierungen laden zu können. -Dazu ist es erforderlich, dass nachdem der Client als Gerät importiert wurde, Du die IP-Adresse des Gerätes in der sog. ``NoProxy`` Gruppe in der Firewall der OPNsense aufnimmst. -Dazu meldet Du Dich an der OPNsense als Benutzer ``root`` an und wählst links im Menü unter ``Firewall -> Aliase`` aus. +Beim Setup von linuxmuster.net wurde in der OPNsense |reg| eine ``NoProxy`` Gruppe als sog. Alias angelegt. Für diese wurde eine Firewall-Regel erstellt, die den IPs ``10.0.0.1 bis 10.0.0.20`` den Internet-Zugriff ohne Proxy ermöglicht. + +Damit der Muster-Client Zugriff auf das Internet erhält, erstellst Du einen neuen Alias-Eintrag, in dem die IP des Muster-Client als Host eingetragen ist. -Du siehst dann anchstehende Firewall: Aliase. +Dazu meldet Du Dich an der OPNsense als Benutzer ``root`` an und wählst links im Menü unter ``Firewall -> Aliase`` aus. +Lege mit dem ``+``-Zeichen einen neuen Alias an. .. figure:: media/08-opnsense-alias-definition.png :align: center :alt: OPNsense Alias definition :width: 80% - NoProxy aufrufen + Neuen Alias anlegen -Klicke rechts neben dem Eintrag der Alias-Gruppe ``NoProxy`` das Stift-Symbol zum Editieren der Gruppe. Trage hier im Feld ``Inhalt`` nun die IP-Adresse des Muster-Clients ein. +Trage hier im Feld ``Inhalt`` nun die IP-Adresse des Muster-Clients ein. Übernimm die Einstellungen. +Du siehst Deinen neuen Alias dann in der Liste. .. figure:: media/09-opnsense-alias-added.png :align: center :alt: OPNsense Alias definition :width: 80% - IP des Clients in die NoProxy Gruppe eintragen + Alias-Liste + +Lege danach eine neue Firewall-Regel an. Klicke hierzu auf ``Firewall -> Riles -> + - Zeichen``. Mit dem +``+ - Zeichen`` legst Du eine neue Regel an. +Gib folgende Werte ein: + +.. figure:: media/10-opnsense-new-rule.png + :align: center + :alt: OPNsense new rule + :width: 80% -Bestätige die IP mit ENTER, so dass der Eintrag grau hinterlegt wird. Klicke zum Abschluss auf ``Speichern`` und anschließend auf ``Anwenden``, um die Einstellungen zu speichern und zu übernehmen. + Anlegen einer neuen Firewall-Regeln + + +Überimm diese Regel. Danach siehst Du die neue Gesamtliste der aktuellen Firewall-Regeln: + + +.. figure:: media/11-opnsense-overview-rules.png + :align: center + :alt: OPNsense overview rules + :width: 80% -Nach Abschluss der Installation und Konfiguration des Muster-Clients kannst Du diesen wieder aus der NoProxy - Gruppe entfernen. Es sei denn, Du nutzt exklusiv immer den identischen Client zur Weiterentwicklung des Muster-Clients. + Übersicht der Firewall-Regel .. toctree:: @@ -72,6 +93,5 @@ Nach Abschluss der Installation und Konfiguration des Muster-Clients kannst Du format_hdd_with_linbo linux-clients/index - linux-clients/installation-popos windows11clients/index diff --git a/source/clients/client_templates/os_installation/linux-clients/index.rst b/source/clients/client_templates/os_installation/linux-clients/index.rst index 5c51f3277..6919cedcf 100644 --- a/source/clients/client_templates/os_installation/linux-clients/index.rst +++ b/source/clients/client_templates/os_installation/linux-clients/index.rst @@ -6,12 +6,11 @@ Linux-Client ============ -.. sectionauthor:: `@cweikl `_, - `@dorian `_ +.. sectionauthor:: `@cweikl `_ linuxmuster.net stellt für Ubuntu basierte Clients das Paket ``linuxmuster-linuxclient7`` bereit. Es führt automatisiert den Domänenbeitritt aus und vereinheitlicht das Management von Linux- und Windows-Clients durch Auslesen der GPO-Konfigurationen im Active Directory. -Offiziell wird derzeit Ubuntu 24.04 und Pop!_OS 22.04 mit gdm3 und Gnome unterstützt. Andere Ubuntu basierte Distributionen mit gdm3 und Gnome funktionieren i.d.R. ebenfalls. +Offiziell wird derzeit Ubuntu 26.04 LTS unterstützt. Andere Debian basierte Distributionen funktionieren i.d.R. ebenfalls. Voraussetzung ============= @@ -60,8 +59,6 @@ Starte nun den PC / die VM mit den neuen Einstellungen, sodass Ubuntu vom ISO-Im Nachstehend findest Du die Beschreibung zur Installation von Ubuntu. -Möchtest Du pop!os installieren, so folge dieser Beschreibung :ref:`install-linux-clients-popos-label` - Installation Ubuntu ------------------- @@ -69,7 +66,7 @@ Installation Ubuntu .. hint:: Bei Ubuntu sollte man darauf achten, dass der Firefox nicht als Snap-Paket installiert wird, da damit SSO nicht funktioniert! Möglicherweise trifft das auch auf andere Distributionen zu! -Hast Du den PC / die VM von vom ISO-Image / der Installations-DVD gestartet, siehst Du zunächst folgenden Start-Bildschirm: +Hast Du den PC / die VM vom ISO-Image / der Installations-DVD gestartet, siehst Du zunächst folgenden Start-Bildschirm: .. figure:: media/00-linux-client-ubu-grub-start.png :align: center @@ -184,11 +181,11 @@ Klicke auf ``ok`` und es werden nochmals alle Einstellungen angezeigt: Übersicht der Partitionen -Sind diese Einstellungen korrekt, prüfe noch, ob das Gerät für die Bootloader-Installation die Ubuntu-Parition ist bzw. bei UEFI-Geräte EFI-Partition (z.B. /dev/vda1 hier mit dem Einhängepunkt /boot/efi). Falls nicht passe dies an. Der Bootloader sollte **nicht** auf den MBR der Festplatte installiert werden. +Sind diese Einstellungen korrekt, prüfe noch, ob das Gerät für die Bootloader-Installation die Ubuntu-Parition ist bzw. bei UEFI-Geräten EFI-Partition (z.B. /dev/vda1 hier mit dem Einhängepunkt /boot/efi). Falls nicht passe dies an. Der Bootloader sollte **nicht** auf den MBR der Festplatte installiert werden. Setze die Installation mit dem Button ``weiter`` fort. -Im weiteren INstallationsverlauf wirst Du nach dem Namen für den Computer und dem Benutzernamen und Kennwort für den neuen Administrator gefragt. Gib hier als Benutzernamen ``linuxadmin`` ein. Beim Namen des Rechners musst Du den Namen des PCs / der VM angeben, wie Du ihn in der Gerätekonfiguration festgelegt hast. +Im weiteren Installationsverlauf wirst Du nach dem Namen für den Computer und dem Benutzernamen und Kennwort für den neuen Administrator gefragt. Gib hier als Benutzernamen ``linuxadmin`` ein. Beim Namen des Rechners musst Du den Namen des PCs / der VM angeben, wie Du ihn in der Gerätekonfiguration festgelegt hast. .. figure:: media/05-linux-client-ubu-install.png :align: center @@ -217,14 +214,7 @@ Vor der eigentlichen Installation werden Dir die Einstellungen nochmals als Übe Entsprechen die angezeigten Einstellungen den von Dir gewünschten Einstellungen, dann starte die Installation mit dem Button ``Installieren``. -Während der Installation wir Dir der Status des Vorgangs dargestellt. - -.. figure:: media/05-linux-client-ubu-installation-status.png - :align: center - :alt: Ubuntu Installation: Installation status - :width: 80% - - Status der laufenden Installation +Während der Installation wird Dir der Status des Vorgangs dargestellt. Am Ende der Installation wirst Du aufgefordert, den Rechner neu zu starten. @@ -241,7 +231,7 @@ Fahre den PC / die VM herunter und werfe das ISO-Image / die Installations-DVD a Erstimage erstellen ------------------- -Passe die Boot-Reihenfolge für den PC / die VM jetzt so an, dass diese wieder via PXE bootet. Du siehst dann die Startoptionen in Linbo für das installierte Ubuntu 24.04. +Passe die Boot-Reihenfolge für den PC / die VM jetzt so an, dass diese wieder via PXE bootet. Du siehst dann die Startoptionen in Linbo für das installierte Ubuntu 26.04. .. figure:: media/06-linux-client-ubu-install.png :align: center @@ -256,7 +246,7 @@ Klicke nun unten rechts auf das Werkzeug-Symbol, um zum Menü für die Imageerst :align: center :alt: Ubuntu Installation: Menue Tools - Wekzeug-Symbol + Werkzeug-Symbol Du wirst nach dem Linbo-Passwort gefragt. Gib dieses ein. @@ -324,7 +314,7 @@ Zum Abschluss erscheint die Meldung, dass das Image erfolgreich hochgeladen wurd Gehe durch einen Klick auf das Zeichen ``<`` zurück und klicke im nächsten Bildschirm das obere Symbol auf der rechten Seite an, um Dich abzumelden. -Du siehst nun drei Start-Symbole. Das grosse Symbol started das Image sychronisiert, während das grüne Icon das lokale Image aus dem Cache ohne Synchronisation startet. +Du siehst nun drei Start-Symbole. Das große Symbol startet das Image synchronisiert, während das grüne Icon das lokale Image aus dem Cache ohne Synchronisation startet. .. figure:: media/06-linux-client-ubu-install.png :align: center @@ -339,7 +329,7 @@ Starte nun Ubuntu synchronisiert. Paket linuxmuster-linuxclient7 installieren -------------------------------------------- -Melde Dich an dem gestarteten Ubuntu 24.04 als Benutzer ``linuxadmin`` an. +Melde Dich an dem gestarteten Ubuntu als Benutzer ``linuxadmin`` an. .. figure:: media/14-linux-client-ubu-install.png :align: center @@ -374,6 +364,14 @@ Importiere nun den GPG-Schlüssel des linuxmuster.net Repository, indem Du nachs Trage das linuxmuster.net Repository in die Paketquellen des Clients ein: +.. hint:: + + Für linuxmuster.net v7.4 gibt es noch kein eigenes Client-Paket in dem v7.4 Repository. + +.. attention:: + + Der Domänen-Beitritt weist derzeit noch Fehler auf. + .. code:: sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/linuxmuster.net.gpg] https://deb.linuxmuster.net/ lmn73 main" > /etc/apt/sources.list.d/lmn73.list' diff --git a/source/clients/client_templates/os_installation/linux-clients/installation-popos.rst b/source/clients/client_templates/os_installation/linux-clients/installation-popos.rst deleted file mode 100644 index 766b75bce..000000000 --- a/source/clients/client_templates/os_installation/linux-clients/installation-popos.rst +++ /dev/null @@ -1,640 +0,0 @@ -.. include:: /guided-inst.subst - -.. _install-linux-clients-popos-label: - -===================== -Linux-Client: pop!os -===================== - -.. sectionauthor:: `@cweikl `_ - -Hast Du alle Vorarbeiten wie im Kapitel :ref:`install-linux-clients-current-label` ausgeführt, startetst Du nun den PC/die VM von CD/DVD/USB-Stick mit pop!os. - -.. hint:: - - Die ISO-Datei zur Erstellung des Installationsmediums findest Du unter: https://pop.system76.com - - z.B. https://iso.pop-os.org/22.04/amd64/intel/35/pop-os_22.04_amd64_intel_35.iso - - -Zur Erinnerung - folgende Vorarbeiten sollten bereits erledigt sein: - -1. Lege in der WebUI unter LINBO4 eine neue Hardwareklasse (HWK) an. - -.. figure:: media/popos/client-install-01.png - :align: center - :alt: popos HWK erstellen - :width: 80% - - Hardwareklasse hinzufügen - -2. Vergebe für die HWK einen eindeutigen Namen. - -.. figure:: media/popos/client-install-02.png - :align: center - :alt: HWK Name festlegen - :width: 80% - - Name der HWK festlegen - -3. Editiere die Eintragungen für die HWK, in dem Du auf das Stift-Symbol klickst. - -.. figure:: media/popos/client-install-03.png - :align: center - :alt: HWK editieren - :width: 80% - - HWK editieren - -4. Trage unter der Reiterkarte ``Allgemein`` die Server IP sowie den Systemtyp ein. - -.. figure:: media/popos/client-install-04.png - :align: center - :alt: HWK allgemeine Einstellungen - -5. Gebe auf der Reiterkarte ``Partitionen`` die erforderlichen Partitionen EFI (für UEFI-Systeme - mind 1 GiB), pop!os, cache und swap an. Die Größenangaben richten sich nach Deinen Anforderungen und sollten i.d.R. größer sein als auf der Abbildung. - -.. figure:: media/popos/client-install-05.png - :align: center - :alt: HWK Partitionen erstellen - :width: 80% - - Allgemeine Einstellungen der HWK - -.. hint:: - - Bei pop!os sollte darauf geachtet werden, dass bei UEFI-System die EFI-Partition eine Größe von mind. 1 GiB aufweist! - - -6. Bearbeite die Partition pop!os mit dem Stift und gebe auf der Reiterkarte ``OS`` einen eindeutigen Namen an. Lege den Namen für das Basisimage fest. Dies erreichst Du über das ``+``-Symbol und der Angabe eines neuen Namens, der auf .qcow2 enden muss. Danach kannst Du diesen aus der Dropdown-Liste auswählen. - -.. figure:: media/popos/client-install-06.png - :align: center - :alt: Basisimage festlegen - :width: 80% - - Partitionen festlegen - -Nutzt Du ein UEFI-System, so musst Du für pop!os die Einträge für Kernel und initrd anpassen, die auf das Verzeichnis ``boot/`` verweisen, das auf der EFI-Partition liegt. - -.. figure:: media/popos/client-hwk-pop-os-settings.png - :align: center - :alt: Startoptionen EFI - :width: 80% - -7. Gebe in der WebUI für diesen PC als Gruppe die neu angelegte HWK - hier pop-os-22-04-lts - an und klicke auf ``Spechern & importieren``. - -.. figure:: media/popos/client-install-07.png - :align: center - :alt: Gerät mit neuer HWK importieren - - Gerät der HWK zuordnen und importieren - -8. Starte danach den Client via PXE und LINBO. - -.. figure:: media/popos/client-install-08.png - :align: center - :alt: Starte HWK via PXE/Linbo - :width: 80% - - LINBO Startbildschirm pop!os - -9. Klicke auf das Werkzeugsymbol, authentifiziere Dich mit dem Kennwort das LINBO-Admins (dieses siehst Du bei der Eingabe nicht - auch keine Sternchen). - -10. In der sich öffnenden Anzeige klicke auf den Eintrag ``Festplatte partitionieren``. - -.. figure:: media/popos/client-install-09.png - :align: center - :alt: Linbo - Werkzeugleiste - :width: 80% - - LINBO Werkzeugleiste - Menüeinträge für pop!os - -11. Gehe nach erfolgreicher Ausführung mit dem Pfeil-Symbol zurück und schalte danach den Client aus. - -12. Stelle die Bootreihenfolge auf dem Client so um, dass dieser nun vom pop!os Installationsmedium startet. - - -Installation pop!os -------------------- - -Nach dem Start von dem Installationsmedium erhälst Du den Hinweis, dass pop!os gestartet wird. Es kann einige Zeit dauern, bis Du den grafischen Installations-Bildschirm siehst. - -.. figure:: media/popos/client-install-11.png - :align: center - :alt: Sprache festlegen - :width: 80% - - Sprache auswählen - -Wähle die gewünschte Sprache und bestätige dies mit ``Select``. - -.. figure:: media/popos/client-install-12.png - :align: center - :alt: Sprache festlegen - :width: 80% - - Tastaturlayout festlegen - -Wähle die gewünschte Tastaturbelegung. Diese kannst Du im Eingabefeld testen. Bestätige Deine Wahl mit ``Auswählen``. - -.. figure:: media/popos/client-install-13.png - :align: center - :alt: Custom Install - :width: 80% - - Installationsart wählen - -Die Partitionen auf Deinem Muster-Client sind bereits mit LINBO angelegt worden, so dass Du hier die Option ``Custom (Advanced)`` auswählst und bestätigst. - -Du gelangst zu nachstehendem Bildschirm, in dem Deine bisherigen Partitionen angezeigt werden. - -.. figure:: media/popos/client-install-14.png - :align: center - :alt: Übersicht der Partitionen - :width: 80% - - Partitionsübersicht - -Du hattest mit LINBO bereits die Festplatte partitioniert und formatiert. - -Es werden Dir die bereits vorhandenen Partitionen und Dateisysteme angezeigt. Je nach genutzter Virtualisierungsumgebung / Hardware können die Festplattenbezeichnungen hier auch als ``/dev/vda`` und die Partionen als ``/dev/vda1`` etc. angezeigt werden. - -Markiere zunächst Die EFI-Partition (gelb) und lege fest, dass diese Partition verwendet werden soll. - -.. figure:: media/popos/client-install-15.png - :align: center - :alt: EFI-Partition nutzen - :width: 80% - - EFI-Partition aktivieren - -Diese soll unter pop!os als /boot/efi Boot-Partition eingehangen, aber N I C H T formatiert werden. - -Klicke danach auf die pop!os-Partition und binde diese als Root-Partition ( / ) ein. Diese ist ebenfalls nicht zu formatieren. - -.. figure:: media/popos/client-install-16.png - :align: center - :alt: pop!os Partition einhängen - :width: 80% - - Partition für pop!os einhängen - -Klicke abschliessend auf die SWAP-Partition (rot) und binde diese als Swap ein. - -.. figure:: media/popos/client-install-17.png - :align: center - :alt: Swap Partition - :width: 80% - - SWAP-Partition einhängen - -Danach siehst Du Deine einegbundenden Partitionen, die jeweils mit einem Häkchen gekennzeichnet sind. - -.. figure:: media/popos/client-install-18.png - :align: center - :alt: Partitionsübersicht - :width: 80% - - ÜArtitionsübersicht - -Starte die Installation mit dem Button ``Löschen und installieren``. - -Danach musst Du noch einen neuen Benutzer ``linuxadmin`` festlegen. - -.. figure:: media/popos/client-install-19.png - :align: center - :alt: Neuer Benutzer - :width: 80% - - Neuen bentuzer linuxadmin anlegen - -Lege für den neuen Benutzer ein Kennwort fest, das mind. 8 Zeichen aufweist. - -.. figure:: media/popos/client-install-20.png - :align: center - :alt: Kennwort festlegen - :width: 80% - - Kennwort für linuxadmin festlegen - -Bestätige dies mit ``Next``. Danach startet die Installation. - -Gelangst Du nach erfolgreicher Installation zunm Abschluss-Bildschirm, so wähle hier ``Herunterfahren`` aus. - -Werfe das Installationsmedium aus. - -Erstimage erstellen -------------------- - -Passe die Boot-Reihenfolge für den PC / die VM jetzt so an, dass wieder via PXE/LINBO gebootet wird. Du siehst dann die Startoptionen in Linbo für das installierte pop!os. - -.. figure:: media/popos/client-pop-os-sync-local-start.png - :align: center - :alt: pop!os boot - :width: 80% - - LINBO Startbildschirm für pop!os - -Klicke nun unten rechts auf das Werkzeug-Icon, um zum Menü für die Imageerstellung zu gelangen. - -.. figure:: media/07-linux-client-ubu-install.png - :align: center - :alt: Menue Tools - :width: 40% - - Werkzeugleiste - -Du wirst nach dem Linbo-Passwort gefragt. Gib dieses ein. - -.. attention:: - - Deine Eingabe wird hierbei nicht angezeigt. - -.. figure:: media/popos/client-install-22.png - :align: center - :alt: Kennwort festlegen - :width: 80% - - LINBO Kennwort eingeben - -Klicke dann auf ``anmelden`` und Du gelangst zu folgender Ansicht: - -.. figure:: media/popos/client-install-23.png - :align: center - :alt: Tools Übersicht - :width: 80% - - Menü Werkzeugleiste - -Klicke auf das große Festplatten-Symbol, das in der Ecke rechts unten farblich markiert ist, um nun ein Image zu erstellen. Anstatt des Festplatten-Symbols wird bei Dir eventuell das Symbol des Betriebssystems angezeigt, dass Du in der WebUI festgelegt hast. - -Es wird ein neues Fenster geöffnet: - -.. figure:: media/popos/client-install-24.png - :align: center - :alt: Image erstellen - :width: 80% - - Image erstellen - -Starte den Vorgang mit ``erstellen & hochladen``. - -Gibt es das Image noch nicht, so wird ein neues Image mit dem zuvor in der WebUI festgelegten Namen erstellt. Ansonsten wir das bestehende Image überschrieben. - -Während des Vorgangs siehst Du nachstehenden Bildschirm: - -.. figure:: media/popos/client-install-25.png - :align: center - :alt: Uploading Image - :width: 80% - - Uploading Image - - -Zum Abschluss erscheint die Meldung, dass das Image erfolgreich hochgeladen wurde. - -.. figure:: media/popos/client-install-26.png - :align: center - :alt: Finished - :width: 80% - - Image erfolgreich hochgeladen - -Gehe durch einen Klick auf das Zeichen ``<`` zurück und melde Dich ab. - -Rufst Du mit der WebUI denMenüpunkt ``Geräteverwaltung --> LINBO4`` auf, siehst Du Deine HWK. -Klickst Du hier auf die Reiterkarte ``Abbilder``, wird das soeben erstellte Image angezeigt. - -.. figure:: media/popos/client-install-27.png - :align: center - :alt: Abbilder - :width: 80% - - Schulkonsole Abbilder - -Klickst Du hier auf das Zahnrad-Symbol siehst Du weitere Informationen zu dem erstellten Image. - -.. figure:: media/popos/client-install-28.png - :align: center - :alt: Image Details - :width: 80% - - Informationen zum Image - -Wichtige Hinweise ------------------ - -pop!os versucht während der Installation für die EFI-Partition und für die SWAP-Partition diese mithile von UUIDs einzubinden. Startest Du das synchronisierte Image, so wird es einige Zeit bei einem grauen Bildschirm hängen bleiben. Danach erscheinen Fehlerhinweise und eine Notfallkonsole. - -In der Notfallkonsole musst Du nun folgende Dateien - -.. code:: - - /etc/fstab - /etc/crypttab - -auf dem Client korrigieren. - -Die Datei ``/etc/fstab`` sollte folgende Einträge aufweisen: - -.. code:: - - # /etc/fstab: static file system information. - # - # Use 'blkid' to print the universally unique identifier for a - # device; this may be used with UUID= as a more robust way to name devices - # that works even if disks are added and removed. See fstab(5). - # - # - /dev/sda1 /boot/efi vfat umask=0077 0 0 - /dev/sda2 / ext4 noatime,errors=remount-ro 0 0 - /dev/mapper/cryptswap none swap defaults 0 0 - -Ersetze hierbei Einträge wie ``PARTUUID=61bb910e-54ce-45e3-bd81-18f6f445d1d0`` durch den Partitionseintrag ``/dev/sda1``. - -Die Datei ``/etc/crypttab`` sollte folgende Einträge aufweisen: - -.. code:: - - cryptswap /dev/sda4 /dev/urandom swap,plain,offset=1024,cipher=aes-xts-plain64,size=512 - -Hier musst Du ebenfalls UUID-Einträge durch die Angabe der SWAP-Partition ersetzen. - -Fahre das System herunter. Starte den Client und starte diesen mithilfe der ``grünen Pfeiltaste``, so dass nur das lokale System mit den soeben durchgeführten Anpassungen gestartet wird. - -Danach solltest Du bis zum Login-Bildschirm kommen. - -Paket linuxmuster-linuxclient7 installieren --------------------------------------------- - -Melde Dich an dem gestarteten pop!os 22.04 als Benutzer ``linuxadmin`` an. - -.. figure:: media/popos/client-install-29.png - :align: center - :alt: Login as linuxadmin - :width: 80% - - Anmelden als Benutzer linuxadmin - -Installiere das Paket ``linuxmuster-linuxclient7`` wie folgt: - -1. Importiere den GPG-Schlüssel des linuxmuster.net Respository. -2. Trage das linuxmuster.net Repository ein. -3. Installiere eine Library und das Paket - -1. Schritt -^^^^^^^^^^ - -Öffne ein Terminal unter Ubuntu mit ``strg`` + ``T`` oder klicke unten links auf die Kacheln und gib in der Suchzeile als Anwendung ``Terminal`` ein. - -Importiere nun den GPG-Schlüssel des linuxmuster.net Repository: - -.. code:: - - sudo sh -c 'wget -qO- "https://deb.linuxmuster.net/pub.gpg" | gpg --dearmour -o /usr/share/keyrings/linuxmuster.net.gpg' - -2. Schritt -^^^^^^^^^^ - -Trage das linuxmuster.net Repository in die Paketquellen des Clients ein: - -.. code:: - - sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/linuxmuster.net.gpg] https://deb.linuxmuster.net/ lmn71 main" > /etc/apt/sources.list.d/lmn71.list' - -Aktualisiere die Paketinformationen mit ``sudo apt update``. - -3. Schritt -^^^^^^^^^^ - -Installiere vorab eine Library mit ``sudo apt install libsss-sudo -y``. -Führe danach die Installation des Pakets mit ``sudo apt install linuxmuster-linuxclient7 -y`` durch. - -Setup ------ - -Um den Domänenbeitritt auszuführen, rufe das Setup des linuxmuster-linuxclient7 auf: - -.. code:: - - sudo linuxmuster-linuxclient7 setup - -Für den Domänenbeitritt wird das Kennwort des Domänen-Admins ``global-admin`` abgefragt. - -Am Ende des Domänenbeitritts erfolgt eine Bestätigung, dass dieser erfolgreich durchgeführt wurde. Falls nicht, musst Du das Setup für den linuxmuster-linuxclient7 erneut durchlaufen. - -Image vorbereiten ------------------ - -Der Linux-Client muss nun für die Erstellung des Images vorbereitet werden. -Rufe hierzu den Befehl auf: - -.. code:: - - sudo linuxmuster-linuxclient7 prepare-image -y - -Der Client erhält daruch Aktualisierungen und es werden einige Dateien (journalctl & apt-caches) aufgeräumt, um Speicherplatz im Image zu sparen. - -.. attention:: - - Danach unbedingt S O F O R T ein neues Image mit Linbo erstellen. Beim Neustart via PXE darf Ubuntu N I C H T gestartet werden. - -Image erstellen ---------------- - -Führe einen Neustart des Linux-Client durch, sodass die VM via PXE in Linbo bootet. - -Nun erstellst Du in Linbo - genauso wie zuvor unter **Erstimage erstellen** beschrieben - das Image des neuen Muster-Clients für Linux. - -Wurde der Vorgang erfolgreich beendet, kannst Du Dich wieder abmelden und den vorbereiteten Linux-Client synchronisiert starten. Nun sollte die Anmeldung mit jedem in der Schulkonsole eingetragenen Benutzer funktionieren. - -Eigene Anpassungen im Image ---------------------------- - -Um den Linux-Client als Mustervorlage zu aktualisieren und Anpassungen vorzunehmen, startest Du den Client synchronisiert und meldest Dich mit dem Benutzer ``linuxadmin`` an. - -Danach installierst Du die benötigte Software und nimmst die gewünschten Einstellungen vor. - -Beispielsweise installierst Du auf dem Linux-Client zuerst Libre-Office: - -.. code:: - - sudo apt update - sudo apt install libreoffice - -Hast Du alle Anpassungen vorgenommen, musst Du den Linux-Client noch zur Erstellung des Images vorbereiten. - -Das machst Du mit folgendem Befehl: - -.. code:: - - sudo linuxmuster-linuxclient7 prepare-image - -.. attention:: - - Falls Du die history Deines Terminals nutzt um Befehle wieder zu nutzen, dann achte darauf das Du den Parameter ``-y`` entfernst. - -Sollte während des Updates oder der Image-Vorbereitung die Meldung erscheinen, dass lokale Änderungen der PAM-Konfiguration außer Kraft gesetzt werden sollen, wähle hier immer ``Nein`` (siehe Abb.), da sonst der konfigurierte Login nicht mehr funktioniert. - -.. figure:: media/15-linux-client-ubu-update-pam.png - :align: center - :alt: Linux-Client: Update - PAM Settings - :width: 80% - - PAM-Settings - -Solltest Du versehentlich ``ja`` ausgewählt haben, kannst Du die Anmeldung mit folgendem Befehl reparieren: - -.. code:: - - sudo linuxmuster-linuxclient7 upgrade - -Im Anschluss startest Du Deinen Linux-Client neu und erstellst wiederum, wie zuvor beschrieben, ein neues Image. - - -Serverseitige Anpassungen -------------------------- - -Damit der Linux-Client die Drucker automatisch ermittelt und der Proxy korrekt eingerichtet wird, ist es erforderlich, dass auf dem linuxmuster.net Server einige Anpassungen vorgenommen werden. - -Proxy-Einstellungen -------------------- - -Bei der Anmeldung vom Linux-Client werden sog. ``Hook-Skripte`` ausgeführt. - -Diese finden sich auf dem linuxmuster.net Server im Verzeichnis: ``/var/lib/samba/sysvol/gshoenningen.linuxmuster.lan/scripts/default-school/custom/linux/``. - -.. hint:: - - Ersetze ``gshoenningen.linuxmuster.lan`` durch den von Dir beim Setup festgelegten Domänennamen. - -Hier findet sich das Logon-Skript (``logon.sh``). Es wird immer dann ausgeführt, wenn sich ein Benutzer am Linux-Client anmeldet. - -In diesem Logon-Skript musst Du die Einstellungen für den zu verwenden Proxy-Server festlegen, sofern dieser von den Linux-Clients verwendet werden soll. - -Editiere die Datei ``/var/lib/samba/sysvol/gshoenningen.linuxmuster.lan/scripts/default-school/custom/linux/logon.sh`` und füge folgende Zeilen hinzu. Passe die ``PROXY_DOMAIN`` für Dein Einsatzszenario an. - -.. code:: - - PROXY_DOMAIN=gshoenningen.linuxmuster.lan #change it to your DOMAIN - PROXY_HOST=http://firewall.$PROXY_DOMAIN - PROXY_PORT=3128 - - # set proxy via env (for Firefox) - lmn-export no_proxy=127.0.0.0/8,10.0.0.0/8,192.168.0.0/16,172.16.0.0/12,localhost,.local,.$PROXY_DOMAIN - lmn-export http_proxy=$PROXY_HOST:$PROXY_PORT - lmn-export ftp_proxy=$PROXY_HOST:$PROXY_PORT - lmn-export https_proxy=$PROXY_HOST:$PROXY_PORT - - # set proxy gconf (for Chrome) - gsettings set org.gnome.system.proxy ignore-hosts "['127.0.0.0/8','10.0.0.0/8','192.168.0.0/16','172.16.0.0/12','localhost','.local','.$PROXY_DOMAIN']" - gsettings set org.gnome.system.proxy mode "manual" - gsettings set org.gnome.system.proxy.http port "$PROXY_PORT" - gsettings set org.gnome.system.proxy.http host "$PROXY_HOST" - gsettings set org.gnome.system.proxy.https port "$PROXY_PORT" - gsettings set org.gnome.system.proxy.https host "$PROXY_HOST" - gsettings set org.gnome.system.proxy.ftp port "$PROXY_PORT" - gsettings set org.gnome.system.proxy.ftp host "$PROXY_HOST" - - -Drucker vorbereiten -------------------- - -.. hint:: - - Dies sind nur kurze allgemeine Hinweise. Im Kapitel :ref:`configure-printers-label` findet sich eine ausführliche Anleitung. - -Damit die Drucker richtig gefunden und via GPO administriert werden können, ist es erforderlich, dass jeder Drucker im CUPS-Server als Namen exakt seinen Hostnamen aus der Geräteverwaltung bekommt. - -Die Zuordnung von Druckern zu Computern geschieht auf Basis von Gruppen im Active Directory. Im Kapitel :ref:`configure-printers-label` gibt es weitere Informationen dazu. - -Damit auf jedem Rechner nur die Drucker angezeigt werden, die ihm auch zugeordnet wurden, muss auf dem Server in der Datei ``/etc/cups/cupsd.conf`` der Eintrag ``Browsing On`` auf ``Browsing Off`` umgestellt werden. Andernfalls werden auf jedem Rechner ALLE Drucker angezeigt, nicht nur die ihm zugeteilten. - -Appendix --------- - -Die HWK wird auf dem Server unter ``/srv/linbo/start.conf.pop-os-22-04-lts`` (Name für die hier dargestellte HWK) abgelegt. - -Für die dargestellte Beispiel-HWK weist diese folgenden Inhalt auf: - -.. code:: - - [LINBO] - Server = 10.0.0.1 - Group = pop-os-22-04-lts - Cache = /dev/sda3 - RootTimeout = 600 - AutoPartition = no - AutoFormat = no - AutoInitCache = no - GuiDisabled = no - UseMinimalLayout = no - Locale = de-DE - DownloadType = torrent - SystemType = efi64 - KernelOptions = quiet splash - clientDetailsVisibleByDefault = yes - - [Partition] - Dev = /dev/sda1 - Label = efi - Size = 1G - Id = ef - FSType = vfat - Bootable = yes - - [Partition] - Dev = /dev/sda2 - Label = popos - Size = 30G - Id = 83 - FSType = ext4 - Bootable = no - - [Partition] - Dev = /dev/sda3 - Label = cache - Size = 30G - Id = 83 - FSType = ext4 - Bootable = no - - [Partition] - Dev = /dev/sda4 - Label = swap - Size = 8G - Id = 82 - FSType = swap - Bootable = no - - [OS] - Name = Pop!OS - Version = 22.04 LTS - Description = Ubuntu 20.04 - IconName = debian.svg - Image = - BaseImage = popos2204.qcow2 - Boot = /dev/sda2 - Root = /dev/sda2 - Kernel = boot/vmlinuz - Initrd = boot/initrd.img - Append = ro splash - StartEnabled = yes - SyncEnabled = yes - NewEnabled = yes - Autostart = no - AutostartTimeout = 5 - DefaultAction = sync - Hidden = yes - -In der WebUI kannst Du unter ``Geräteverwaltung --> Linbo-Synchronisierung`` die PC und die HWK Gruppen einsehen und hier sog. ``linbo-remote`` Befehle vom Server aus absetzen, die z.B. bewirken, dass der PC a00101 ausgeschaltet (Halt) wird. - -.. figure:: media/popos/client-install-30.png - :align: center - :alt: WebUI linbo-remote - :width: 80% - - WebUI LINBO-Synchronisierung - - diff --git a/source/clients/client_templates/os_installation/linux-clients/media/05-linux-client-ubu-installation-finished.png b/source/clients/client_templates/os_installation/linux-clients/media/05-linux-client-ubu-installation-finished.png index 861a30c7e..4824abc32 100644 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/05-linux-client-ubu-installation-finished.png and b/source/clients/client_templates/os_installation/linux-clients/media/05-linux-client-ubu-installation-finished.png differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/10-linux-client-ubu-install.png b/source/clients/client_templates/os_installation/linux-clients/media/10-linux-client-ubu-install.png index c0db351dc..ddbca171f 100644 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/10-linux-client-ubu-install.png and b/source/clients/client_templates/os_installation/linux-clients/media/10-linux-client-ubu-install.png differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/11-linux-client-ubu-install.png b/source/clients/client_templates/os_installation/linux-clients/media/11-linux-client-ubu-install.png index 476423427..ff667ba6b 100644 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/11-linux-client-ubu-install.png and b/source/clients/client_templates/os_installation/linux-clients/media/11-linux-client-ubu-install.png differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-hwk-pop-os-settings.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-hwk-pop-os-settings.png deleted file mode 100644 index 1f7a49b45..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-hwk-pop-os-settings.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-01.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-01.png deleted file mode 100644 index d44383d7d..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-01.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-02.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-02.png deleted file mode 100644 index 7812f6c4c..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-02.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-03.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-03.png deleted file mode 100644 index bd5bd433f..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-03.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-04.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-04.png deleted file mode 100644 index 6cd143e37..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-04.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-05.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-05.png deleted file mode 100644 index 8d942e8ad..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-05.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-06.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-06.png deleted file mode 100644 index 6c0fccb40..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-06.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-07.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-07.png deleted file mode 100644 index 4361a7423..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-07.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-08.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-08.png deleted file mode 100644 index 913f0c9b5..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-08.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-09.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-09.png deleted file mode 100644 index f9c46d608..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-09.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-10.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-10.png deleted file mode 100644 index d9128b46d..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-10.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-11.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-11.png deleted file mode 100644 index 731f60ac6..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-11.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-12.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-12.png deleted file mode 100644 index 6c60bb755..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-12.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-13.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-13.png deleted file mode 100644 index fd90b2d79..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-13.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-14.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-14.png deleted file mode 100644 index b2c1e5390..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-14.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-15.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-15.png deleted file mode 100644 index 95570b438..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-15.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-16.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-16.png deleted file mode 100644 index 776bc1278..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-16.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-17.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-17.png deleted file mode 100644 index f977dfb26..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-17.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-18.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-18.png deleted file mode 100644 index d87f435d6..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-18.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-19.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-19.png deleted file mode 100644 index 8bec5f2dd..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-19.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-20.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-20.png deleted file mode 100644 index 4cc560f73..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-20.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-21.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-21.png deleted file mode 100644 index ddbfd3a94..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-21.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-22.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-22.png deleted file mode 100644 index e330ed3ff..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-22.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-23.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-23.png deleted file mode 100644 index 3bcf23d7e..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-23.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-24.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-24.png deleted file mode 100644 index 64bb592bd..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-24.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-25.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-25.png deleted file mode 100644 index d350d3b03..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-25.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-26.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-26.png deleted file mode 100644 index 8cfebd548..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-26.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-27.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-27.png deleted file mode 100644 index 8ce9c0eff..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-27.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-28.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-28.png deleted file mode 100644 index 19bfa0945..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-28.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-29.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-29.png deleted file mode 100644 index df8d2592f..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-29.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-30.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-30.png deleted file mode 100644 index f06641a3c..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-install-30.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-pop-os-sync-local-start.png b/source/clients/client_templates/os_installation/linux-clients/media/popos/client-pop-os-sync-local-start.png deleted file mode 100644 index 61992e6bf..000000000 Binary files a/source/clients/client_templates/os_installation/linux-clients/media/popos/client-pop-os-sync-local-start.png and /dev/null differ diff --git a/source/clients/client_templates/os_installation/media/01-pxe-start-screen.png b/source/clients/client_templates/os_installation/media/01-pxe-start-screen.png index 3e9d013d3..edf76c5e1 100644 Binary files a/source/clients/client_templates/os_installation/media/01-pxe-start-screen.png and b/source/clients/client_templates/os_installation/media/01-pxe-start-screen.png differ diff --git a/source/clients/client_templates/os_installation/media/04-linbo-tools-menue.png b/source/clients/client_templates/os_installation/media/04-linbo-tools-menue.png index 0ece1a7ee..63039d4c4 100644 Binary files a/source/clients/client_templates/os_installation/media/04-linbo-tools-menue.png and b/source/clients/client_templates/os_installation/media/04-linbo-tools-menue.png differ diff --git a/source/clients/client_templates/os_installation/media/08-opnsense-alias-definition.png b/source/clients/client_templates/os_installation/media/08-opnsense-alias-definition.png index 4d77e3247..804df48b7 100644 Binary files a/source/clients/client_templates/os_installation/media/08-opnsense-alias-definition.png and b/source/clients/client_templates/os_installation/media/08-opnsense-alias-definition.png differ diff --git a/source/clients/client_templates/os_installation/media/09-opnsense-alias-added.png b/source/clients/client_templates/os_installation/media/09-opnsense-alias-added.png index 2377c3893..13b1616c0 100644 Binary files a/source/clients/client_templates/os_installation/media/09-opnsense-alias-added.png and b/source/clients/client_templates/os_installation/media/09-opnsense-alias-added.png differ diff --git a/source/clients/client_templates/os_installation/media/10-opnsense-new-rule.png b/source/clients/client_templates/os_installation/media/10-opnsense-new-rule.png new file mode 100644 index 000000000..addb213eb Binary files /dev/null and b/source/clients/client_templates/os_installation/media/10-opnsense-new-rule.png differ diff --git a/source/clients/client_templates/os_installation/media/11-opnsense-overview-rules.png b/source/clients/client_templates/os_installation/media/11-opnsense-overview-rules.png new file mode 100644 index 000000000..3e769be59 Binary files /dev/null and b/source/clients/client_templates/os_installation/media/11-opnsense-overview-rules.png differ diff --git a/source/clients/index.rst b/source/clients/index.rst index 80f3ee0fd..6b651c22b 100644 --- a/source/clients/index.rst +++ b/source/clients/index.rst @@ -15,7 +15,11 @@ Die Bereitstellung und Pflege der schulischen Rechner für die Nutzer in einer l Es wurde ursprünglich im Auftrag des Landesmedienzentrums Baden-Württemberg von der Firma KNOPPER.NET in Zusammenarbeit mit den damaligen paedML-Linux- und heutigen linuxmuster.net-Entwicklern realisiert. -Die linuxmuster.net-Entwickler haben LINBO nun in der Version > 4.3 veröffentlicht. Der Sourcecode ist unter GNU General Public License 3.0 auf GitHub veröffentlicht. https://github.com/linuxmuster/linuxmuster-linbo7 +Die linuxmuster.net-Entwickler haben LINBO nun in der Version 7.4 veröffentlicht. Der Sourcecode ist unter GNU General Public License 3.0 auf GitHub veröffentlicht. https://github.com/linuxmuster/linuxmuster-linbo7 + +.. todo:: Alle LINBO Screenshots prüfen und ggf. aktualisieren! + + Funktionsweise ============== @@ -59,7 +63,7 @@ Deren Beschreibung ist im Unterkapitel :ref:`using-linbo-label` zu finden. In dem gezeigten Ablauf eines synchronisierten Betriebssystem-Starts wurde ersichtlich, dass sich auf dem Server mindestens ein Client-Image befinden muss. Dabei ist folgendes wesentlich: -In der linuxmuster.net 7 ist es für Clients, denen alle pädagogischen Funktionen im Netz zur Verfügung stehen sollen, erforderlich, dass diese im Active Directory (AD) des Servers (samba 4) einen sog. ``Domänenbeitritt`` ausführen. Hierbei werden Schlüssel erzeugt und ausgetauscht. Diese stellen sicher, dass der Client als berechtigtes Gerät erkannt wird. +In der linuxmuster.net ist es für Clients, denen alle pädagogischen Funktionen im Netz zur Verfügung stehen sollen, erforderlich, dass diese im Active Directory (AD) des Servers (samba 4) einen sog. ``Domänenbeitritt`` ausführen. Hierbei werden Schlüssel erzeugt und ausgetauscht. Diese stellen sicher, dass der Client als berechtigtes Gerät erkannt wird. Ziel ist es, dass alle PCs mit einem vordefinierten ``Muster-Image`` für Linux oder Windows genutzt werden, sodass nach Möglichkeit nur ein Image oder wenige raumbezogene Images gepflegt werden. diff --git a/source/clients/linbo/index.rst2delete b/source/clients/linbo/index.rst2delete deleted file mode 100644 index e278a40d4..000000000 --- a/source/clients/linbo/index.rst2delete +++ /dev/null @@ -1,383 +0,0 @@ -.. include:: /guided_inst.subst - -.. _add-computer-label: - -====== -LINBO4 -====== - -.. sectionauthor:: `@cweikl `_, - `@MachtDochNix `_ - - -LINBO steht für GNU/\ **Li**\ nux **N**\ etwork **Bo**\ ot. - -Es wurde ursprünglich im Auftrag des Landesmedienzentrums Baden-Württemberg von der Firma KNOPPER.NET in Zusammenarbeit mit den damaligen paedML-Linux- und heutigen linuxmuster.net-Entwicklern realisiert. - -Durch die letztgenannten ist es nun in der Version 4 erschienen. Der Sourcecode ist unter GNU General Public License 3.0 auf GitHub veröffentlicht. https://github.com/linuxmuster/linuxmuster-linbo7 - -Funktionsweise -============== - -Zum Verständnis erklären wir Dir einen - -Start eines Arbeitsplatzrechners --------------------------------- - -Über das Transport-Protokoll TFTP wird vom linuxmuster.net-Server und die PXE-Implementierung von Grub bootet es ein kleines Linux-System (linbofs) auf den Clients. Diese zeigen dann eine Benutzeroberfläche, mit der dann alle Imaging-Aufgaben auf dem Client gesteuert werden. - -Die steuerbaren Funktionen unterscheiden sich anhand der Berechtigungen der Nutzer und Nutzerinnen. - -Konsolen-Tools sind ebenfalls verfügbar, um Clients und Imaging aus der Ferne über den Server zu verwalten. - -Auswahl eines Betriebssystems ------------------------------ - -Die Funktionsweise wird am Beispiel eines Clients (rechts im Bild) beschrieben. -Auf dem Server (links im Bild) sind zwei Betriebssysteme für Clients dieses Typs komprimiert gespeichert. - -.. image:: media/linbo_functionality_detail.svg - :name: linbo-functionality - :alt: linbo-functionality - :height: 150px - :align: center - -* Der Benutzer wählt das erste Betriebssystem zum synchronisierten Start aus. -* Der Client überprüft, ob sein lokal gespeichertes Systemabbild identisch ist mit dem auf dem Server (1.). -* Ist dieses der Fall und entpackt der Client das erste Betriebssystem auf die eigentliche System-Partition und startet das System anschließend (3.). - Wäre das nicht der Fall gewesen, hätte dieser zuerst das Systemabbild vom Server heruntergeladen (2.), um dann mit (3.) fortzufahren. - -Der hier aufgezeigte Ablauf eines synchronisierten Startes ist einer von vielen und dient der Veranschaulichung. - - * Start wie in der vorherigen Sitzung - * Start mit erzwungener Formatierung der Betriebssystem-Partion - * Offline-Boot - * |ua| - -Deren Beschreibung ist im Unterkapitel "LINBO4 nutzen" zu finden. - -In dem gezeigten Ablauf eines synchroniesierten Betriebssystem-Starts wurde ersichtlich, das sich auf dem Server mindestens ein Client-Images befinden muss. Dieses musst Du nun anlegen, dabei ist folgendes von entscheidender Wichtigkeit: - -In der linuxmuster.net 7 ist es für Clients, denen alle pädagogischen Funktionen im Netz zur Verfügung stehen sollen, erforderlich, dass diese im Active Directory (AD) des Servers (samba 4) einen sog. ``Domänenbeitritt`` ausführen. Hierbei werden Schlüssel erzeugt und ausgetauscht. Diese stellen sicher, dass der Client als berechtigtes Gerät erkannt wird. - -Ziel ist es, dass alle PCs mit einem vordefinierten ``Muster-Image`` für Linux oder Windows genutzt werden, sodass nach Möglichkeit nur ein Image oder wenige raumbezogene Images gepflegt werden. - -Hierzu ist zunächst ein Rechner mit dem gewünschten Client-Betriebssystem und den gewünschten Programmen zu installieren und vorzukonfigurieren. Dieser ``Muster-Rechner`` muss dann mit dem jeweiligen Betriebssystem einen Domänenbeitritt ausführen, auch dieser wird im Image gespeichert. Erst danach kann dieses Image ebenfalls für alle anderen PCs genutzt werden. - -================================== -Muster-Clients und Rechneraufnahme -================================== - -Vorgehen -======== - -Prinzipiell kann jeder PC als Muster-PC für das jeweilige Betriebssystem genutzt werden. Besonders flexibel ist es aber, den Muster-PC vorab als virtuelle Maschine (VM) aufzubauen und für weitere Aktualisierungen zu nutzen. - -Wenn mehrere Betriebssysteme pro Rechner zum Einsatz kommen sollen, so wird jeweils ein separates Image genutzt. Für jedes Image muss ein eigener Domänenbeitritt ausgeführt werden. - -Es wird daher empfohlen, pro genutztem Betriebssystem einen eigenen Muster-Client (ggf. als VM) anzulegen und mit diesem den Domänenbeitritt durchzuführen. - -Die nötigen Schritte dafür sind hier beschrieben und lassen sich folgendermaßen zusammenfassen: - -1. Hardwareklasse für den PC/die VM konfigurieren -2. PC im Netz anschließen / VM anlegen und geeignete Netzwerkverbindung definieren -3. PC/VM als Rechner aufnehmen -4. PC/VM via PXE mit Linbo starten -5. Festplatte mit Linbo partitionieren und formatieren -6. PC/VM vom ISO-Image booten -7. Client OS installieren -8. Erstimage erstellen -9. Domänenbeitritt ausführen -10. Image erstellen - -Die Schritte 1-5 sind für Windows und Linux identisch, sie sind nachstehend beschrieben. Die Besonderheiten von Windows und Linux werden anschliessend in den Kapiteln ``Windows-Clients`` und ``Linux-Clients`` beschrieben. - -======================================= -Hardwareklasse (HWK) / Gruppe erstellen -======================================= - -Melde Dich als Benutzer ``global-admin`` an der Web-UI an. - -.. figure:: media/01-webui-login.png - :align: center - :alt: WebUI login - -Erstelle nun die Konfiguration für die neue Hardwareklasse. Dafür klickst Du links im Menü den Eintrag ``Geräteverwaltung --> Linbo4``. - -.. figure:: media/02-webui-menue-linbo.png - :align: center - :alt: WebUI menue linbo - -Nun klickst Du unten links auf ``+ERSTELLEN``. - -Es öffnet sich ein Kontextmenü. Du kannst entweder ein leere start.conf nutzen, oder ein bereits vordefiniertes Template für Dein gewünschtes Betriebssystem auswählen. - -.. figure:: media/03-webui-menue-linbo-create-start-template.png - :align: center - :alt: WebUI menue linbo create start template - -Es öffnet sich ein Fenster, in dem Du die Namen der neuen Hardwareklasse angibst. Diesen wirst Du später brauchen um Geräte dieser Hardwareklasse zuzuweisen. - -.. figure:: media/04-webui-menue-linbo-name-for-start-conf.png - :align: center - :alt: WebUI menue linbo hwc group name - -Danach gelangst Du zu den Einstellungen der Hardwareklasse. Dort gibt es die Reiterkarten ``Allgmein`` und ``Partitionen``. - -Unter ``Allgemein`` legst Du die IP des Servers fest, gibst das Startverhalten und ggf. Kernel-Optionen für den Boot bei besonderer Hardware an. - -.. figure:: media/05-webui-linbo-edit-new-group.png - :align: center - :alt: WebUI linbo edit new hwc group - -Unter ``Partitionen`` legst Du fest, welche Partitionen auf der Festplatte vorgesehen werden sollen. - -.. figure:: media/06-webui-linbo-edit-new-group-partition-scheme.png - :align: center - :alt: WebUI linbo edit new hwc group - partition scheme - -Löschst Du dort z.B. die Partitionen ``swap`` und ``data`` so sieht Deine Partitionierung wie folgt aus: - -.. figure:: media/07-webui-linbo-edit-new-group-partition-scheme-edited.png - :align: center - :alt: WebUI linbo edit new hwc group - partition scheme edited - -Um Einstellungen für das Betriebssystem vorzunehmen, klickst Du auf das Stift-Icon (hier für Ubuntu) und es öffnet sich ein weiteres Fenster, um Einstellungen für das Betriebssystem vorzunehmen. - -.. figure:: media/08-webui-linbo-edit-new-group-os-infos-edited.png - :align: center - :alt: WebUI linbo edit new hwc group - os edited - -Unter der Reiterkarte ``OS`` legst Du für das Betriebssystem (OS) die gewünschten Icons, die Start-Optionen und u.a. auch den Namen für das Basisimage fest. Zu Beginn bleibt hier der Eintrag ``None`` noch stehen und auch bei ``Start Optionen`` muss ``Autostart`` deaktiviert bleiben, da Du erst das Image für den Muster-Client erstellen musst. - -Auf dem linuxmuster.net Server werden die start.conf-Dateien im Verzeichnis ``/srv/linbo`` abgelegt. Jede Hardwareklasse hat eine eigene start.conf-Datei. Für die neu angelegte Hardwareklasse des Muster-Clients wurde dort nun eine Datei ``start.conf.`` erstellt. - -Diese Datei muss normalerweise nicht händisch editiert werden, da sich alle nötigen Einstellungen in der WebUI vornehmen lassen. Das folgende Beispiel dient nur dazu, zu zeigen, was "unter der Decke" passiert. - -Folgende Konfiguration zeigt ein mögliches Beispiel für die Hardwareklasse 20210426_focalfossa_base (hier als Linux-Client). Diese würde sich in der Datei ``/srv/linbo/start.conf.20210426_focalfossa_base`` befinden. Hierbei wird von einem Legacy-BIOS und Linux als Betriebssystem ausgegangen: - -.. code:: - - [LINBO] - Server = 10.0.0.1 - Group = 20210426_focalfossa_base #Hardwareklasse - Cache = /dev/sda2 - RootTimeout = 600 - AutoPartition = no - AutoFormat = no - AutoInitCache = no - DownloadType = torrent - GuiDisabled = no # disable gui - UseMinimalLayout = no # gui layout style - Locale = de-de # gui locale - BackgroundColor = 394f5e # hex code for gui background color - BackgroundFontColor = white # font color of status section (default: white) - ConsoleFontColorStdout = lightgreen # console font color (default: white) - ConsoleFontColorStderr = orange # console error font color (default: red) - SystemType = bios64 - KernelOptions = quiet splash - - [Partition] - Dev = /dev/sda1 - Label = ubuntu - Size = 30G - Id = 83 - FSType = ext4 - Bootable = yes - - [Partition] - Dev = /dev/sda2 - Label = cache - Size = # verbleibender Plattenplatz wird als Cache genutzt - Id = 83 - FSType = ext4 - Bootable = yes - - [OS] - Name = Ubuntu 20.04 LTS - Version = 20 - Description = Ubuntu 20.04 - IconName = ubuntu.png - Image = - BaseImage = 20210426_focalfossa_base.cloop - Boot = /dev/sda1 - Root = /dev/sda1 - Kernel = /boot/vmlinuz - Initrd = /boot/initrd.img - Append = ro splash - StartEnabled = yes - SyncEnabled = yes - NewEnabled = yes - Autostart = no - AutostartTimeout = 4 - DefaultAction = sync - RestoreOpsiState = no - ForceOpsiSetup = - Hidden = yes - -PC anschließen / VM anlegen -=========================== - -Der PC, der als Hardware zum Aufbau des Muster-Clients genutzt werden soll, ist via Kabel mit dem Netzwerk zu verbinden. - -Alternativ kann für den Aufbau des Muster-Clients eine VM in der Virtualisierungsumgebung angelegt werden. - -Nachstehende Angaben stellen ein Beispiel für die Rahmendaten einer solchen VM dar: - - * 4 GB vRAM - * mind. 1 vCPU mit 2 Kernen - * VGA mit 16GB Speicher - * 1x vNIC (ggf. im "richtigen" VLAN) - * PXE-Boot einstellen - * Boot Firmware: BIOS oder UEFI (je nach später genutzten PCs) - Achtung: start.conf von linbo ggf. anpassen -> siehe Hinweise bei den Client-Systemen - * 50GB HDD (20GB OS + 20GB Cache + ggf. SWAP oder andere Partitionen) - -==================================== -Rechneraufnahme mit der Schulkonsole -==================================== - -Nachdem Du nun die neue Hardwareklasse erstellt hast und der Client / die VM noch ausgeschaltet bereit steht, musst Du dessen MAC-Adresse in der Web-UI als Gerät anlegen. Dort weist Du dem Gerät dann die Hardwareklasse zu und wählst im Feld PXE den Eintrag ``Linbo PXE`` aus. - -Um einen Rechner mit der Schulkonsole anzulegen, gehst Du wie folgt vor: - -Wähle nach der Anmeldung links im Menü unter ``Geräteverwaltung --> Geräte``. - -.. figure:: media/09-webui-menue-devices.png - :align: center - :alt: WebUI menue devices - -Nun erscheint die Gerätekonfiguration. - -Als Spaltenköpfe siehst Du u.a. den Raum, den Hostnamen, ..., PXE. - -.. figure:: media/10-webui-devices-header.png - :align: center - :alt: WebUI devices column header - -Die konfigurierten Geräte werden hier angezeigt. Schon eingetragen sind die bereits konfigurierten Server mit der Rolle ``Server``. - -.. figure:: media/11-webui-devices-rows.png - :align: center - :alt: WebUI devices indicated - examples - -Um neue Geräte hinzuzufügen, klicke unten links auf die Schaltfläche ``Gerät hinzufügen``. - -.. figure:: media/12-webui-add-new-device.png - :align: center - :alt: WebUI menue item add devices - -Es wird eine neue Leerzeile hinzugefügt. - -.. figure:: media/13-webui-new-device.png - :align: center - :alt: WebUI add devices - -In diese neue Zeile gibst Du unter Raum den Namen des Raumes (hier ``server``) ein. Entsprechend verfährst Du mit den Spalten Hostname, MAC, IP und Sophomorix-Rolle. - -.. hint:: Verwende nicht eine IP-Adresse aus dem Bereich der Rechneraufnahme. - -Im Feld ``Gruppe`` trägst Du den Namen Deiner Hardwareklasse ein und im Feld ``PXE`` wählst Du ``Linbo PXE`` aus. - -Die Schaltfläche ``SPEICHERN`` überprüft die Eingabe. Mit ``SPEICHERN & IMPORTIEREN`` werden die neuen Geräte importiert. - -.. figure:: media/14-webui-save-and-add-devices.png - :align: center - :alt: WebUI add devices - -Danach erscheinen einige Log-Meldungen und - wenn der Import erfolgreich war - ``Import abgeschlossen``. - -.. figure:: media/15-webui-add-devices-log.png - :align: center - :alt: WebUI add devices - -.. attention:: Hinweise zur VM - - Die nachstehenden Hinweise sind nur in Ausnahmefällen bei Nutzung einer VM relevant. Durch diese Änderungen werden zudem Anpassungen in der Boot-Loader Konfiguration von Linbo für die Hardwareklasse nicht mehr bei einem ``linuxmuster-import-devices`` angewendet. Folge diesen Schritten NUR wenn Du XCP-ng als Virtualisierungsumgebung verwendest und den Muster-Client in einer VM anlegst. - - Sollte der Muster-Client als VM aufgebaut werden, so ist je nach eingesetzter Virtualisierungssoftware darauf zu achten, dass die VGA-Einstellungen eine geringe Auflösung und eine geringe Farbteife aufweisen. - - **VGA anpassen** - -.. attention:: - - Nachstehende Hinweise gelten nur für eine VM unter XCP-ng. - - Unter XCP-ng 8.2 sind nachstehende Anpassungen erforderlich, da sonst während des Linbo Boot-Vorgangs ein Hinweis erscheint, dass die Farbtiefe nicht dargestellt werden kann. Rufe auf dem Server die Datei Grub-Datei Deiner Hardwareklasse z.B. ``/srv/linbo/boot/grub/20210426_focalfossa_base.cfg`` auf. - - Ersetze dort den Eintrag - - .. code:: - - # if you don't want this file being overwritten by import_workstations remove the following line: - # ### managed by linuxmuster.net ### - - set gfxmode=auto - set gfxpayload=keep - - durch die Angabe für die Bildschirmauflösung und Farbtiefe: - - .. code:: - - # if you don't want this file being overwritten by import_workstations remove the following line: - - set gfxmode=800x600x16 - set gfxpayload=keep - - Die Kommentarzeile ``# ### managed by linuxmuster.net ###`` muss entfernt werden, damit beim nächsten ``linuxmuster-import-devices`` diese CFG-Datei nicht überschrieben wird. - - **Gerät importieren** - - Hast Du alle Einstellungen für die Geräte bzw. erneute Änderungen hier vorgenommen, klickst Du in der WebUI unter ``Geräteverwaltung --> Geräte`` erneut ``Speichern & Importieren``, damit diese Einstellungen angewendet werden. - - Alternativ kann auf dem Server in der Konsole als Benutzer ``root`` der Befehl ``linuxmuster-import-devices`` ausgeführt werden. - -PC / VM via PXE starten -======================= - -Mit o.g. Einstellungen startest Du nun den PC / die VM. Während des Boot-Vorgangs erhält der PC / die VM via PXE eine IP-Adresse und Linbo wird geladen. - -Wurde in der start.conf kein ``Autostart`` gewählt, startet Linbo mit folgendem Start-Bildschirm: - -.. figure:: media/17-linbo-webui-start-screen.png - :align: center - :alt: Linbo WebUI start screen - -Festplatte mit Linbo vorbereiten -================================ - -Klicke nun rechts auf das Icon für Einstellungen / Tools. Es erscheint ein Dialog und Du wirst aufgefordert das Kennwort für den Linbo-Benutzer anzugeben. - -.. figure:: media/18-linbo-webui-root-login.png - :align: center - :alt: Linbo WebUI root login - -Gib das Kennwort ein. Die Eingabe wird hierbei nicht angezeigt. Klicke dann auf ``anmelden``. - -Danach erscheint der Bildschirm für die Linbo - Einstellungen: - -.. figure:: media/19-linbo-webui-settings.png - :align: center - :alt: Linbo WebUI settings - -Klicke nun auf den Menüeintrag ``Festplatte partitionieren``. Es öffnet sich ein neues Fenster mit der Rückfrage, ob wirklich partitioniert werden soll. - -.. figure:: media/20-linbo-webui-partitioning.png - :align: center - :alt: Linbo WebUI paritioning - -Bestätige die Paritionierung und Formatierung mit: ``ja`` - -Nach erfolgreicher Formatierung siehst Du diese Bestätigung: - -.. figure:: media/21-linbo-webui-partitioned.png - :align: center - :alt: Linbo WebUI paritioned - -Klicke auf das Zeichen ``<`` und fahre danach den PC / die VM über das Icon ``Herunterfahren`` (unten rechts) herunter. - -.. figure:: media/22-linbo-webui-shutdown.png - :align: center - :alt: Linbo WebUI shutdown. - -Nun kannst Du mit der Installation des gewünschtem Betriebssystems (Linux oder Windows) fortfahren. Wähle für die entsprechenden Anleitungen links im Menü die entsprechenden Einträge aus. - diff --git a/source/clients/linbo/media/01-webui-login.png b/source/clients/linbo/media/01-webui-login.png deleted file mode 100644 index ff3041e3f..000000000 Binary files a/source/clients/linbo/media/01-webui-login.png and /dev/null differ diff --git a/source/clients/linbo/media/02-webui-menue-linbo.png b/source/clients/linbo/media/02-webui-menue-linbo.png deleted file mode 100644 index 61f1d85f6..000000000 Binary files a/source/clients/linbo/media/02-webui-menue-linbo.png and /dev/null differ diff --git a/source/clients/linbo/media/03-webui-menue-linbo-create-start-template.png b/source/clients/linbo/media/03-webui-menue-linbo-create-start-template.png deleted file mode 100644 index 023a53888..000000000 Binary files a/source/clients/linbo/media/03-webui-menue-linbo-create-start-template.png and /dev/null differ diff --git a/source/clients/linbo/media/04-webui-menue-linbo-name-for-start-conf.png b/source/clients/linbo/media/04-webui-menue-linbo-name-for-start-conf.png deleted file mode 100644 index 695a4259d..000000000 Binary files a/source/clients/linbo/media/04-webui-menue-linbo-name-for-start-conf.png and /dev/null differ diff --git a/source/clients/linbo/media/05-webui-linbo-edit-new-group.png b/source/clients/linbo/media/05-webui-linbo-edit-new-group.png deleted file mode 100644 index 426d7e4d6..000000000 Binary files a/source/clients/linbo/media/05-webui-linbo-edit-new-group.png and /dev/null differ diff --git a/source/clients/linbo/media/06-webui-linbo-edit-new-group-partition-scheme.png b/source/clients/linbo/media/06-webui-linbo-edit-new-group-partition-scheme.png deleted file mode 100644 index ade4bc213..000000000 Binary files a/source/clients/linbo/media/06-webui-linbo-edit-new-group-partition-scheme.png and /dev/null differ diff --git a/source/clients/linbo/media/07-webui-linbo-edit-new-group-partition-scheme-edited.png b/source/clients/linbo/media/07-webui-linbo-edit-new-group-partition-scheme-edited.png deleted file mode 100644 index ebb4244b1..000000000 Binary files a/source/clients/linbo/media/07-webui-linbo-edit-new-group-partition-scheme-edited.png and /dev/null differ diff --git a/source/clients/linbo/media/08-webui-linbo-edit-new-group-os-infos-edited.png b/source/clients/linbo/media/08-webui-linbo-edit-new-group-os-infos-edited.png deleted file mode 100644 index 51bf50583..000000000 Binary files a/source/clients/linbo/media/08-webui-linbo-edit-new-group-os-infos-edited.png and /dev/null differ diff --git a/source/clients/linbo/media/09-webui-menue-devices.png b/source/clients/linbo/media/09-webui-menue-devices.png deleted file mode 100644 index 0bb8e12a3..000000000 Binary files a/source/clients/linbo/media/09-webui-menue-devices.png and /dev/null differ diff --git a/source/clients/linbo/media/10-webui-devices-header.png b/source/clients/linbo/media/10-webui-devices-header.png deleted file mode 100644 index f9c8713e8..000000000 Binary files a/source/clients/linbo/media/10-webui-devices-header.png and /dev/null differ diff --git a/source/clients/linbo/media/11-webui-devices-rows.png b/source/clients/linbo/media/11-webui-devices-rows.png deleted file mode 100644 index 1d043b6df..000000000 Binary files a/source/clients/linbo/media/11-webui-devices-rows.png and /dev/null differ diff --git a/source/clients/linbo/media/12-webui-add-new-device.png b/source/clients/linbo/media/12-webui-add-new-device.png deleted file mode 100644 index e061c335b..000000000 Binary files a/source/clients/linbo/media/12-webui-add-new-device.png and /dev/null differ diff --git a/source/clients/linbo/media/13-webui-new-device.png b/source/clients/linbo/media/13-webui-new-device.png deleted file mode 100644 index c896a2813..000000000 Binary files a/source/clients/linbo/media/13-webui-new-device.png and /dev/null differ diff --git a/source/clients/linbo/media/14-webui-save-and-add-devices.png b/source/clients/linbo/media/14-webui-save-and-add-devices.png deleted file mode 100644 index d20a0cbee..000000000 Binary files a/source/clients/linbo/media/14-webui-save-and-add-devices.png and /dev/null differ diff --git a/source/clients/linbo/media/15-webui-add-devices-log.png b/source/clients/linbo/media/15-webui-add-devices-log.png deleted file mode 100644 index 919a43791..000000000 Binary files a/source/clients/linbo/media/15-webui-add-devices-log.png and /dev/null differ diff --git a/source/clients/linbo/media/17-linbo-webui-start-screen.png b/source/clients/linbo/media/17-linbo-webui-start-screen.png deleted file mode 100644 index fc94cbda1..000000000 Binary files a/source/clients/linbo/media/17-linbo-webui-start-screen.png and /dev/null differ diff --git a/source/clients/linbo/media/18-linbo-webui-root-login.png b/source/clients/linbo/media/18-linbo-webui-root-login.png deleted file mode 100644 index 571cbe490..000000000 Binary files a/source/clients/linbo/media/18-linbo-webui-root-login.png and /dev/null differ diff --git a/source/clients/linbo/media/19-linbo-webui-settings.png b/source/clients/linbo/media/19-linbo-webui-settings.png deleted file mode 100644 index 2ea72200a..000000000 Binary files a/source/clients/linbo/media/19-linbo-webui-settings.png and /dev/null differ diff --git a/source/clients/linbo/media/20-linbo-webui-partitioning.png b/source/clients/linbo/media/20-linbo-webui-partitioning.png deleted file mode 100644 index cfbe3d4ff..000000000 Binary files a/source/clients/linbo/media/20-linbo-webui-partitioning.png and /dev/null differ diff --git a/source/clients/linbo/media/21-linbo-webui-partitioned.png b/source/clients/linbo/media/21-linbo-webui-partitioned.png deleted file mode 100644 index 9fbf5a0a1..000000000 Binary files a/source/clients/linbo/media/21-linbo-webui-partitioned.png and /dev/null differ diff --git a/source/clients/linbo/media/22-linbo-webui-shutdown.png b/source/clients/linbo/media/22-linbo-webui-shutdown.png deleted file mode 100644 index fb419cb6c..000000000 Binary files a/source/clients/linbo/media/22-linbo-webui-shutdown.png and /dev/null differ diff --git a/source/clients/linbo/media/linbo_functionality_detail.svg b/source/clients/linbo/media/linbo_functionality_detail.svg deleted file mode 100644 index d70aadf42..000000000 --- a/source/clients/linbo/media/linbo_functionality_detail.svg +++ /dev/null @@ -1,4994 +0,0 @@ - -image/svg+xml - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - LINBO-Lokaler Datenspeicher -Lokale Daten -2. Betriebssystem -1. Betriebssystem -1. -2. -3. -Festplatte -Festplatte - \ No newline at end of file diff --git a/source/clients/use_linbo4/.tx/config b/source/clients/use_linbo/.tx/config similarity index 100% rename from source/clients/use_linbo4/.tx/config rename to source/clients/use_linbo/.tx/config diff --git a/source/clients/use_linbo4/index.rst b/source/clients/use_linbo/index.rst similarity index 82% rename from source/clients/use_linbo4/index.rst rename to source/clients/use_linbo/index.rst index a00464563..beeb03d69 100644 --- a/source/clients/use_linbo4/index.rst +++ b/source/clients/use_linbo/index.rst @@ -1,12 +1,12 @@ .. include:: /guided-inst.subst .. _using-linbo-label: -LINBO4 nutzen -============= +LINBO nutzen +============ LINBO steht für GNU/\ **Li**\ nux **N**\ etwork **Bo**\ ot. Es wurde ursprünglich im Auftrag des Landesmedienzentrums Baden-Württemberg von der Firma KNOPPER.NET in Zusammenarbeit mit den damaligen paedML-Linux- und heutigen linuxmuster.net-Entwicklern realisiert. -Die linuxmuster.net-Entwickler haben LINBO nun in der Version > 4.3 veröffentlicht. Der Sourcecode ist unter GNU General Public License 3.0 auf GitHub veröffentlicht. +Die linuxmuster.net-Entwickler haben LINBO nun in der Version 7.4 veröffentlicht. Der Sourcecode ist unter GNU General Public License 3.0 auf GitHub veröffentlicht. LINBO bietet @@ -17,41 +17,25 @@ LINBO bietet * Grafische Client-Oberfläche zur einfachen Bedienung durch Anwender und Netzwerkbetreuer * Vollständige Integration in linuxmuster.net -LINBO4, das von linuxmuster.net entwickelt wurde, weist einige Neuerungen auf: +LINBO, das von linuxmuster.net entwickelt wurde, weist einige Neuerungen auf: * Für neue Images wird nur noch das Format qcow2 unterstützt. Der Name des Basis-Images muss daher in der übernommenen start.conf angepasst werden (z.B. image.qcow2). -* Die Bennenung der zusätzlichen Image-Dateien postsync, prestart and reg ändert sich, so dass diese nur noch ohne dem Image-Format angegeben werden (z.B. image.postsync, image.prestart and image.reg, früher: image.cloop.postsync etc.). +* Die Benennung der zusätzlichen Image-Dateien postsync, prestart and reg ändert sich, so dass diese nur noch ohne dem Image-Format angegeben werden (z.B. image.postsync, image.prestart and image.reg). * qemu-img wird nun genutzt, um die Erstellung und Wiederherstellung der qcow2-Images durchzuführen. * Es wird nur noch 64 Bit Client-Hardware unterstützt. -* linuxmuster.net <=6.2 wird nicht mehr unterstützt. -* Ab LINBO v4.1 stehen differentielle Images zur Verfügung. -* Bisherige Images im cloop Format sind direkt in das neue qcow2 Format zu konvertieren. -* Ab LINBO v4.1.36 wird Kernel 6.5.3 verwendet und es können qcow2-Images mit Torrent verteilt werden, die > 52 GiB sind. Für ctorrent kann hierzu die sog. piece length konfiguriert werden. -* Ab LINBO v4.3 wird die Nutzung verschiedener Kernel bei den Clients ermöglicht: - • legacy - Kernel: 6.1.* - • longterm - Kernel: 6.12.* - • stable - Kernel: 6.14.* -* Es können auf den Clients Linux Firmware-Dateien genutzt werden. Firmware ist in Ubuntu 24.04 zst-komprimiert. Firmware-Dateien können in /etc/linuxmuster/linbo/firmware aber wie bisher ohne .zst-Extension angegeben werden. -* Ab LINBO 4.3 werden vereinheitlichte Partitionsnamen verwendet: - Unabhängig vom verbauten Festplattentyp (SATA, NVME etc.) können die Partitionen jetzt mit einheitlichen Namen angesprochen werden. - -Namensschema: - • 1. Platte: /dev/disk0 - • 2. Platte: /dev/disk1 - • ... - • 1. Partition: /dev/disk0p1 - • 2. Partition: /dev/disk0p2 - • … - - Linbo legt beim Bootvorgang entsprechende Symlinks zu den tatsächlichen Devices an. - Eine NVME-Disk wird immer als erste Platte (disk0) definiert. - Eine USB-Platte wird immer als letzte Platte definiert. +* Es stehen differentielle Images zur Verfügung. +* Ab LINBO 7.4 wird der Standardkernel von Ubuntu 26.04 verwendet (7.0.0). + +.. hint:: Bei der Image-Verteilung per torrent wurde ctorrent durch aria2 ersetzt. -Dieses Kapitel führt in die Nutzung von LINBO4 ein und erklärt die wesentlichen Schritte zur Imageverwaltung. + +Dieses Kapitel führt in die Nutzung von LINBO ein und erklärt die wesentlichen Schritte zur Imageverwaltung. .. hint:: Die meisten PC mit UEFI verwenden standardmäßig "SecureBoot". Dies muss deaktiviert werden, um Linbo booten zu können! +.. todo:: Alle LINBO Screenshots prüfen und ggf. aktualisieren! + Der LINBO Startbildschirm ------------------------- @@ -205,8 +189,8 @@ Nach Änderung des Passwortes musst Du auf dem Server noch die ``linbofs.lz`` ne update-linbofs -LINBO4 Imageverwaltung -====================== +LINBO Imageverwaltung +===================== LINBO Imageverwaltung am Client ------------------------------- @@ -291,7 +275,7 @@ Dialog: Image erstellen LINBO - Image erstellen -Ab der LINBO Version 4.1 kannst Du wählen, ob Du ein neues Basisimage oder ein differentielles Image erstellen möchtest. Sollte bereits ein Basisimage existieren, so wird dieses mit überschrieben. Es erfolgt keine weitere Rückfrage. +Du kannst wählen, ob Du ein neues Basisimage oder ein differentielles Image erstellen möchtest. Sollte bereits ein Basisimage existieren, so wird dieses dann überschrieben. Es erfolgt keine weitere Rückfrage. Lokal im Cache wir das aktuelle Image beim Erstellen überschrieben. Beim Hochladen des aktuellen Images mit demselben Namen wird auf dem Server zuvor ein Backup des vorherigen Images erstellt. @@ -370,7 +354,7 @@ LINBO Differenzielle Images .. hint:: - Seit der Version LINBO 4.1 ist es möglich, differentielle Images zu erstellen. + Es ist möglich, differentielle Images zu erstellen. ``Differentielle Images`` bauen auf einem vollständigen Image eines Client-Betriebssystems auf und legen alle Änderungen / Ergänzungen seit dem letzten Image ab. Diese werden dann bei einer Synchronisation des Clients vollständig angewendet. @@ -518,9 +502,9 @@ Imageverwaltung aufrufen :align: left :alt: LNBO Image Menue - LINBO4 Menü + LINBO Menü -Um zur Umageverwaltung in der WebUI zu gelangen, meldest Du Dich in der WebUI als ``global-admin`` an. Danach rufst Du links in der Menüspalte ``Geräteverwaltung -> LINBO4`` auf. +Um zur Umageverwaltung in der WebUI zu gelangen, meldest Du Dich in der WebUI als ``global-admin`` an. Danach rufst Du links in der Menüspalte ``Geräteverwaltung -> LINBO`` auf. .. figure:: media/linbo-diff-images/13-linbo-group-images.png :align: center @@ -665,14 +649,14 @@ Melde Dich an der Schulkonsole als Benutzer ``global-admin`` an. Login WebUI -Wähle danach links den Menüpunkt ``LINBO4`` aus. +Wähle danach links den Menüpunkt ``LINBO`` aus. .. figure:: media/linbo-bootscreen/linbo-iso-menue-linbo4.png :align: center :scale: 70% - :alt: LINBO4 Menue + :alt: LINBO Menue - LINBO4 Menüeintrag + LINBO Menüeintrag Rechts im Fenster erscheinen ganz unten zwei Buttons. Klicke nun den Button ``Linbo Boot herunterladen``. @@ -707,7 +691,7 @@ Mit ``Enter`` wird der Client gebootet Mit der Auswahl durch die Pfeiltasten der Tastatur ``Ersteinrichtung + Neustart`` wird Linbo eingerichtet und der Rechner mit Linbo gestartet. Nach dem Neustart stehen alle Linbo-Funktionen zur Verfügung. -LINBO4-Cache: Hinweise +LINBO-Cache: Hinweise ====================== Linbo4 nutzt auf jedem Client eine lokale Cache-Partition, um ein oder mehrere Image/s eine Betriebssystems lokal vorzuhalten. Es lassen sich so unterschiedliche Verhaltensweisen eines Clients entweder via start.conf Datei oder via linbo-remote steuern. @@ -762,9 +746,7 @@ In der Hardwareklasse (HWK) besteht für Linbo in der start.conf die Möglichkei [LINBO] # globale Konfiguration Cache = /dev/sda6 # lokale Cache Partition - Server = 10.0.0.1 # IP des Linbo-Servers, der das Linbo-Repository vorhaelt Group = r101 # Name der Rechnergruppe fuer die diese Konfigurationsdatei gilt - SystemType = efi64 # moeglich ist bios|bios64|efi32|efi64 (Standard: bios fuer bios 32bit) RootTimeout = 600 # automatischer Rootlogout nach 600 Sek. AutoPartition = no # automatische Partitionsreparatur beim LINBO-Start AutoFormat = no # kein automatisches Formatieren aller Partitionen beim LINBO-Start @@ -811,10 +793,10 @@ Dabei ist zu beachten: * ``start:<#>``: Startet das Betriebsyssystem, das in der start.conf an der angegebenen <#> Position eingetragen wurde. -LINBO4 mit WLAN nutzen -====================== +LINBO mit WLAN nutzen +===================== -Linbo4 unterstützt ab der Version 4.2 die Nutzung von LINBO via WLAN-Netzwerk. Hierzu wurde das Programm ``wpa_supplicant`` in LINBO integriert. +Linbo unterstützt die Nutzung von LINBO via WLAN-Netzwerk. Hierzu wurde das Programm ``wpa_supplicant`` in LINBO integriert. Vor der Nutzung solltest Du zuerst prüfen, ob LINBO für den eingebauten WLAN-Adapter die benötigte Firmware aufweist. Hierzu gehst Du wie folgt vor: @@ -926,11 +908,11 @@ 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. -LINBO4: Client-Anpassungen -========================== +LINBO: Client-Anpassungen +========================= -LINBO4: Hook-Skripte --------------------- +LINBO: Hook-Skripte +------------------- .. attention:: @@ -1007,12 +989,12 @@ Hook-Skripte müssen ausführbar sein und mit einem ``shebang`` beginnen. Es sin Weiterführende Hinweise zur Nutzung der Hook-Skripte findest Du hier: https://github.com/linuxmuster/linuxmuster-linuxclient7/wiki/Hook-scripts -LINBO4: Linux-Kernel +LINBO: Linux-Kernel ==================== -Linbo ab v4.2 nutzt als Standard den aktuellsten Linux-Kernel. Manchmal gibt es aber dennoch Probleme mit Hardware, die nicht richtig erkannt wird. Dann kann es sein, dass z.B. LINBO per PXE nicht korrekt startet oder das System *scheinbar hängen bleibt*. Solche Fälle widerspenstiger Hardware können mit LINBO 4.2 mit einigen Handgriffen vielfach erfolgreich gelöst werden. +Linbo nutzt als Standard den aktuellsten Linux-Kernel der jeweiligen Ubuntu LTS Version. Manchmal gibt es aber dennoch Probleme mit Hardware, die nicht richtig erkannt wird. Dann kann es sein, dass z.B. LINBO per PXE nicht korrekt startet oder das System *scheinbar hängen bleibt*. Solche Fälle widerspenstiger Hardware können mit LINBO mit einigen Handgriffen vielfach erfolgreich gelöst werden. -Mit LINBO 4.2 wird auf dem Client ein aktueller Linux-Kernel >= 6.6.x installiert und gestartet. Bei neuerer Hardware funktioniert dies i.d.R. problemlos. Bei einigen älteren Hardware-Modellen oder Modellen mit besonderer Hardware-Bestückung kann es vorkommen, dass der Client nicht startet. Dies kann schrittweise wie nachstehend beschrieben, zuerst eingegrenzt und dann behoben werden. +Mit LINBO wird auf dem Client ein aktueller Linux-Kernel installiert und gestartet. Bei neuerer Hardware funktioniert dies i.d.R. problemlos. Bei einigen älteren Hardware-Modellen oder Modellen mit besonderer Hardware-Bestückung kann es vorkommen, dass der Client nicht startet. Dies kann schrittweise wie nachstehend beschrieben, zuerst eingegrenzt und dann behoben werden. Es können 1. andere Kernel auf den LINBO-Clients genutzt werden. @@ -1023,53 +1005,28 @@ Es können LINBO-Kernel wechseln --------------------- -Auf dem Server befindet sich unter ``/etc/linuxmuster/linbo/custom_kernel.ex`` eine Beispieldatei, wie man den LINBO-Kernel wechselt. Die Kernel befinden sich unterhalb von ``/var/lib/linuxmuster/linbo/``. Es stehen drei verschiedene Versionen zu Verfügung: *legacy, longterm, stable* - -Kopiere die Datei Vorlage ``/etc/linuxmuster/linbo/custom_kernel.ex`` nach ``/etc/linuxmuster/linbo/custom_kernel``. Editiere diese Datei nun so, dass der gewünschte Kernel auf dem Client gebootet wird. Sind in der Datei alle Zeilen auskommentiert, dann startet der Client einen letzten stable Kernel. - -- Es kann alternativ der **5.15er Kernel (legacy)** genutzt werden. Dazu müssen einfach in der Datei ``/etc/linuxmuster/linbo/custom_kernel`` die folgenden Zeilen eingetragen werden. Es ist nur das Kommentarzeichen für die zweite Zeile zu entfernen. +- Es kann alternativ ein **anderer Kernel** genutzt werden. Dazu müssen einfach in der Datei ``/etc/linuxmuster/linbo/custom_kernel`` die folgenden Zeilen eingetragen werden. .. code:: - ## use Linbo's alternative legacy kernel - KERNELPATH="legacy" - ## use Linbo's alternative longterm kernel - #KERNELPATH="longterm" - - ## currently active kernel image and modules used by the server - ## path to kernel image - #KERNELPATH="/boot/vmlinuz-$(uname -r)" - ## path to the corresponding modules directory - #MODULESPATH="/lib/modules/$(uname -r)" + ## currently active kernel image and modules used by the server + ## path to kernel image + KERNELPATH="/boot/vmlinuz-$(uname -r)" + ## path to the corresponding modules directory + MODULESPATH="/lib/modules/$(uname -r)" - ## custom kernel image and modules - #KERNELPATH="/path/to/my/kernelimage" - ## path to the corresponding modules directory - #MODULESPATH="/path/to/my/lib/modules/n.n.n" + ## custom kernel image and modules + #KERNELPATH="/path/to/my/kernelimage" + ## path to the corresponding modules directory + #MODULESPATH="/path/to/my/lib/modules/n.n.n" -Danach ist der Befehl ``update-linbofs`` auf dem Server auszuführen. Danach bootet der Linbo-Client mit einem 5.15er-Kernel. +Kommentiere die Zeilen für den nicht mehr verwendeten Kenel und dessen Modules auf mit einem # - Zeichen. Nehme die Kommentarzeichen für den Kernel und die Module heraus, +die nun gestartet werden sollen. -- Anstelle des aktuellsten Linux-Kernel kann auch ein **6.1er LTS-Kernel** verwendet werden. Dazu müssen einfach in der Datei ``/etc/linuxmuster/linbo/custom_kernel`` die folgenden Zeilen eingetragen werden. Es ist nur in der vierten Zeile das Kommentarzeichen zu entfernen. +Das Kernelimage und die Kernel-Module müssen in dem angegebenen Pfad jeweils vorhanden sein. -.. code:: +Danach ist der Befehl ``update-linbofs`` auf dem Server auszuführen. Danach bootet der Linbo-Client mit einem anderen Kernel. - ## use Linbo's alternative legacy kernel - # KERNELPATH="legacy" - ## use Linbo's alternative longterm kernel - KERNELPATH="longterm" - - ## currently active kernel image and modules used by the server - ## path to kernel image - #KERNELPATH="/boot/vmlinuz-$(uname -r)" - ## path to the corresponding modules directory - #MODULESPATH="/lib/modules/$(uname -r)" - - ## custom kernel image and modules - #KERNELPATH="/path/to/my/kernelimage" - ## path to the corresponding modules directory - #MODULESPATH="/path/to/my/lib/modules/n.n.n" - -Danach ist der Befehl ``update-linbofs`` auf dem Server auszuführen. Danach bootet der Linbo-Client mit einem 6.1er-Kernel. Netzwerkkarten-Treiber ersetzen @@ -1106,7 +1063,7 @@ Gibt dmesg folgenden Fehler aus: i915 0000:00:02.0: [drm] Failed to load DMC firmware i915/kbl_dmc_ver1_04.bin. Disabling runtime power management. i915 0000:00:02.0: [drm] DMC firmware homepage: https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/tree/i915 -Dann passe die Datei wir folgt an: +Dann passe die Datei wie folgt an: .. code:: @@ -1125,14 +1082,14 @@ Führe anschließend den Befehl ``update-linbofs`` auf dem linuxmuster Server au .. hint:: - Sollte ein geladener Wifi Treiber dazu führen, dass die Wifi NIC nicht nach einem LINBO Reboot funktioniert, dann nutze die Kerneloption ``nowarmstart``. + Sollte ein geladener Wifi-Treiber dazu führen, dass die Wifi-NIC nicht nach einem LINBO Reboot funktioniert, dann nutze die Kerneloption ``nowarmstart``. Kernel-Options verwenden ------------------------ Auf dem Server findet sich pro Hardwareklasse eine start.conf Datei unter: ``/srv/linbo/start.conf.`` -Um Besonderheiten einzelner Hardwareklassen anzupassen, gibt es den Eintrag **KernelOptions_**. +Um Besonderheiten einzelner Hardwareklassen anzupassen, gibt es den Eintrag **KernelOptions**. .. code:: @@ -1143,7 +1100,7 @@ Um Besonderheiten einzelner Hardwareklassen anzupassen, gibt es den Eintrag **Ke # Modul realtek r8168 laden, aber den Aufruf des Moduls realtek r8169 unterbinden KernelOptions = loadmodules=r8168 modprobe.blacklist=r8169 - # lade noche keine Grafikkarten-Treiber, bis das System gestartet wurde und lade diese erst danach. + # lade noch keine Grafikkarten-Treiber, bis das System gestartet wurde und lade diese erst danach. KernelOptions = nomodeset # linbo soll nach dem herunterladen eines neuen LINBO-Kernels keinen Warmstart ausführen @@ -1165,7 +1122,7 @@ Dazu wechselst Du wieder mit ``linbo-ssh `` auf die LINBO-Konsol Sämtliche Befehle, die linuxmuster-linbo7 (next generation) beherrscht, werden hier aufgelistet: https://github.com/linuxmuster/linuxmuster-linbo7/issues/72#issuecomment-1156633508 -LINBO4: VNCServer nutzen +LINBO: VNCServer nutzen ======================== Wird für den Cient der LINBO Kernel-Parameter ``vncserver`` gesetzt, dann wird während des Bootvorgangs von LINBO ein VNC-Server auf dem Client gestartet. Dieser Dienst akzeptiert nur Verbindungen, die von der Server-IP ausgehend auf Port 9999 kommen. Hierdurch ist es möglich, von einem PC im Netzwerk via VNCViewer auf die grafische LINBO-Oberfläche eines LINBO-Clients zuzugreifen. @@ -1173,7 +1130,7 @@ Wird für den Cient der LINBO Kernel-Parameter ``vncserver`` gesetzt, dann wird Kernel-Parameter setzen ----------------------- -Wähle in der WebUI im Menü unter ``Geräteverwaltung -> LINBO4 -> Gruppen`` die gewünschte Hardwareklasse aus, bearbeite diese mit dem Stift Symbol und ergänze unter ``Allgemein -> Kernel-Optionen`` in der Eingabezeile als Start-Parameter manuell ``vncviewer``. +Wähle in der WebUI im Menü unter ``Geräteverwaltung -> LINBO -> Gruppen`` die gewünschte Hardwareklasse aus, bearbeite diese mit dem Stift Symbol und ergänze unter ``Allgemein -> Kernel-Optionen`` in der Eingabezeile als Start-Parameter manuell ``vncviewer``. .. figure:: media/01-linbo-start-vncserver.png :align: center @@ -1204,11 +1161,11 @@ Dies kann auf dem PC wie folgt in der Linux-Konsole definiert werden: ssh -L 9999::9999 root@ -Der Server fordert zur Eingabe des Kennwortes für den Benutzer root auf. Wurde dies erfolgreich ausgeführt, so ist die Konsole es Server zu sehen. +Der Server fordert zur Eingabe des Kennwortes für den Benutzer root auf. Wurde dies erfolgreich ausgeführt, so ist die Konsole des Servers zu sehen. Auf dem Client kann nach dem LINBO-Bootvorgang in der LINBO-Konsole kontrolliert werden, ob der VNCServer gestartet wurde. Wähle in LINBO dazu rechts das Werkzeug aus und wähle den Eintrag LINBO-Konsole aus. -Gib hier den Befehl ``ps`` ein und Du erhälst die Ausgabe der derzeit unter LINBO auf dem Client laufende Prozesse. +Gib hier den Befehl ``ps`` ein und Du erhältst die Ausgabe der derzeit unter LINBO auf dem Client laufende Prozesse. Dies kann z.B. wie folgt aussehen: @@ -1244,14 +1201,14 @@ Wie in nachstehender Abb. erhälst Du dann Zugriff auf den LINBO-Client vom PC a LINBO Zugriff via VNCViewer -LINBO4: Live-System von ISO booten +LINBO: Live-System von ISO booten ================================== -Mit LINBO >= v4.3 ist es möglich via LINBO ein Live-System wie z.B. Ubuntu 24.04 Desktop oder Systemrescue 12.01 mithilfe der zugehörigen ISO-Datei, die auf dem Server liegt zu starten. +Mit LINBO ist es möglich via LINBO ein Live-System wie z.B. Ubuntu 24.04 Desktop oder Systemrescue 12.01 mithilfe der zugehörigen ISO-Datei, die auf dem Server liegt zu starten. Um im Fehlerfall auf bestimmten Clients diesen auch mithilfe eines Live-System zu booten, kann z.B. für eine Hardwareklasse ein zusätzlicher Boot-Eintrag bereitgestellt werden, der auf eine ISO-Datei verweist. -Hierdurch kannst Du via LINBO auf dem Client das Live-System vom Server aus starten und so die Fehler auf dem Client anaylsieren, oder auch einfach nur das Live-System auf dem Client testen. +Hierdurch kannst Du via LINBO auf dem Client das Live-System vom Server aus starten und so die Fehler auf dem Client analysieren, oder auch einfach nur das Live-System auf dem Client testen. Vorgehen -------- @@ -1273,7 +1230,7 @@ Pro ISO-Datei ist unterhalb des o.g. Verzeichnisses ein gleichnamiges Unterverz **Beispiel**: -Sollen die ISO-Dateien ``ubuntu-24.04.2-desktop-amd64.iso`` und ``systemrescue-12.01-amd64.iso`` bereitgestellt werden, so sind zunächst folge unterverzeichnisse anzulegen: +Sollen die ISO-Dateien ``ubuntu-24.04.2-desktop-amd64.iso`` und ``systemrescue-12.01-amd64.iso`` bereitgestellt werden, so sind zunächst folgende Unterverzeichnisse anzulegen: .. code:: @@ -1301,7 +1258,7 @@ Dies erfolgt bezogen auf o.g. Beispiel mit nachstehenden Befehlen: linbo-torrent create /srv/linbo/images/ubuntu-24.04.2-desktop-amd64/ubuntu-24.04.2-desktop-amd64.iso linbo-torrent create /srv/linbo/images/systemrescue-12.01-amd64/systemrescue-12.01-amd64.iso -Es finden sich in in dem jeweiligen Unterverzeichnis dann drei Dateien (z.B.): +Es finden sich in dem jeweiligen Unterverzeichnis dann drei Dateien (z.B.): .. code:: @@ -1312,7 +1269,7 @@ Es finden sich in in dem jeweiligen Unterverzeichnis dann drei Dateien (z.B.): Pfade für Kernel und Initrd ermitteln ------------------------------------- -In der Hardwareklasse sind später die Pfade für Kernel und Initd anzugeben, wie diese in der ISO-Datei gültig sind. Daher sind in den ISO-Dateien zunächst deren Pfade zu ermitteln. +In der Hardwareklasse sind später die Pfade für Kernel und Initrd anzugeben, wie diese in der ISO-Datei gültig sind. Daher sind in den ISO-Dateien zunächst deren Pfade zu ermitteln. 1. Mounte die ISO-Datei auf dem PC 2. Suche für den Kernel nach der Datei ``vmlinuz``. Notiere Dir den Pfad. @@ -1326,7 +1283,7 @@ Für systemrescue-12.01-amd64.iso liegt die Datei ``vmlinuz`` im Verzeichnis ``s Kernel-Append-Parameter ermitteln --------------------------------- -Für die ISO-Dateien musst Du noch ermitteln, welche Kernel-Parameter angefügt werden können2, die dann in der Hardwareklasse für die start.conf angegeben werden können. +Für die ISO-Dateien musst Du noch ermitteln, welche Kernel-Parameter angefügt werden können, die dann in der Hardwareklasse für die start.conf angegeben werden können. 1. Öffne die gemountete ISO-Datei auf dem PC. 2. Suche die Dateien ``boot/grub/grub.cfg`` oder ``isolinux.cfg``. Die Parameter splash, quiet, findiso und iso-scan können weggelassen werden, da sie automatisch erzeugt werden. @@ -1364,83 +1321,31 @@ Abschließend musst Du in der Konsole auf dem Server den Befehl ``linuxmuster-im Live-CD starten --------------- -Starte nun den Client via LINBO. Im Startmenü von LINBO findest Du nun den zur angelegten Eintrag zur Live-CD. Starte diese nun durch einen Klick auf das grosse Symbol für das Betriebssystem. - - -im Fehlerfall -============= +Starte nun den Client via LINBO. Im Startmenü von LINBO findest Du nun den angelegten Eintrag zur Live-CD. Starte diese nun durch einen Klick auf das große Symbol für das Betriebssystem. -Torrent-Fehler --------------- +LINBO: Image-Verteilung +======================= -Nutzt Du sehr große Images, so kann es passieren, dass bei der Verteilung der qcow2-Images mit Torrent-Fehler auftreten und die Synchronisation auf ``rsync`` zurückfällt. Hierbei kommt es zum Einbruch bei den Datenübertragungsraten. +LINBO nutzt für die Image-Verteilung via Torrent **aria2**. -Ab LINBO v4.1.36 können für ``ctorrent`` Parameter angepasst werden, um dies zu verhindern. - -Die Konfigurationsdati für ctorrent befindet sich +In ``/etc/default/linbo-torrent`` können jetzt die aria2-Optionen angepasst werden (für die Optionen siehe https://aria2.github.io/manual/en/html/aria2c.html): .. code:: - /etc/default/linbo-torrent - -Die Paketgrößen können nun als Parameter ``piece length`` angepasst werden. Dazu kannst Du in o.g. Konfigurationsdatei den Parameter wie folgt setzen: + # /etc/default/linbo-torrent + # + # aria2c options, only change that if you know exactly what you're doing. + # + # thomas@linuxmuster.net + # 20260625 + # -.. code:: + # used for both purposes + ARIA2C_GLOBAL_OPTS="--enable-color=false --enable-dht=false --disable-ipv6=true" - # Piece length (torrent file option) - ECELEN="524288" - -Hast Du den Wert angepasst, musst Du Torrent neu startebn: + # used for torrent downloads + ARIA2C_DWNLD_OPTS="-c --console-log-level=notice --show-console-readout=true --summary-interval=3 --seed-time=0" -.. code:: - - linbo-torrent restart - -Wurde die Option in der Konfigurationsdatei nicht explizit gesetzt, so wird ein Standardwert (default value) von ``262144`` verwendet. - -Mit der Erhöhung des Wertes können o.g. Probleme behoben werden. - -Zum Vergleich findet sich nachstehende Konfigurationsdatei ``/etc/default/linbi-torrent``: - -.. code:: - - # default values for linbo-torrenthelper service provided by ctorrent - # thomas@linuxmuster.net - # 20230918 - # - # note: you have to invoke 'linbo-torrent restart' after you have changed any values - # - - # Exit while seed hours later (default 72 hours) - SEEDHOURS="100000" - - # Max peers count (default 100) - MAXPEERS="100" - - # Min peers count (default 1) - MINPEERS="1" - - # Download slice/block size, unit KB (default 16, max 128) - SLICESIZE="128" - - # Max bandwidth down (unit KB/s, default unlimited) - MAXDOWN="" - - # Max bandwidth up (unit KB/s, default unlimited) - MAXUP="" - - # Supplemental ctorrent options, separated by space (-v: Verbose output for debugging) - #OPTIONS="-v" - - # Timeout in seconds until rsync fallback (client only) - TIMEOUT="300" - - # user to run ctorrent (server only) - CTUSER="nobody" - - # Piece length (torrent file option) - PIECELEN="524288" - - - + # used to seed torrents + ARIA2C_SEED_OPTS="-V --seed-ratio=0.0" diff --git a/source/clients/use_linbo4/media/01-linbo-start-vncserver.png b/source/clients/use_linbo/media/01-linbo-start-vncserver.png similarity index 100% rename from source/clients/use_linbo4/media/01-linbo-start-vncserver.png rename to source/clients/use_linbo/media/01-linbo-start-vncserver.png diff --git a/source/clients/use_linbo4/media/02-linbo-vncserver-process.png b/source/clients/use_linbo/media/02-linbo-vncserver-process.png similarity index 100% rename from source/clients/use_linbo4/media/02-linbo-vncserver-process.png rename to source/clients/use_linbo/media/02-linbo-vncserver-process.png diff --git a/source/clients/use_linbo4/media/03-linbo-vncviewer-access.png b/source/clients/use_linbo/media/03-linbo-vncviewer-access.png similarity index 100% rename from source/clients/use_linbo4/media/03-linbo-vncviewer-access.png rename to source/clients/use_linbo/media/03-linbo-vncviewer-access.png diff --git a/source/clients/use_linbo4/media/linbo-bootscreen/linbo-ascii.png b/source/clients/use_linbo/media/linbo-bootscreen/linbo-ascii.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-bootscreen/linbo-ascii.png rename to source/clients/use_linbo/media/linbo-bootscreen/linbo-ascii.png diff --git a/source/clients/use_linbo4/media/linbo-bootscreen/linbo-group.png b/source/clients/use_linbo/media/linbo-bootscreen/linbo-group.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-bootscreen/linbo-group.png rename to source/clients/use_linbo/media/linbo-bootscreen/linbo-group.png diff --git a/source/clients/use_linbo4/media/linbo-bootscreen/linbo-iso-download.png b/source/clients/use_linbo/media/linbo-bootscreen/linbo-iso-download.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-bootscreen/linbo-iso-download.png rename to source/clients/use_linbo/media/linbo-bootscreen/linbo-iso-download.png diff --git a/source/clients/use_linbo4/media/linbo-bootscreen/linbo-iso-login-school-console.png b/source/clients/use_linbo/media/linbo-bootscreen/linbo-iso-login-school-console.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-bootscreen/linbo-iso-login-school-console.png rename to source/clients/use_linbo/media/linbo-bootscreen/linbo-iso-login-school-console.png diff --git a/source/clients/use_linbo4/media/linbo-bootscreen/linbo-iso-menue-linbo4.png b/source/clients/use_linbo/media/linbo-bootscreen/linbo-iso-menue-linbo4.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-bootscreen/linbo-iso-menue-linbo4.png rename to source/clients/use_linbo/media/linbo-bootscreen/linbo-iso-menue-linbo4.png diff --git a/source/clients/use_linbo4/media/linbo-bootscreen/linbo-tftp.png b/source/clients/use_linbo/media/linbo-bootscreen/linbo-tftp.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-bootscreen/linbo-tftp.png rename to source/clients/use_linbo/media/linbo-bootscreen/linbo-tftp.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/01-linbo-gui.png b/source/clients/use_linbo/media/linbo-diff-images/01-linbo-gui.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/01-linbo-gui.png rename to source/clients/use_linbo/media/linbo-diff-images/01-linbo-gui.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/02-tools-icon.png b/source/clients/use_linbo/media/linbo-diff-images/02-tools-icon.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/02-tools-icon.png rename to source/clients/use_linbo/media/linbo-diff-images/02-tools-icon.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/03-linbo-password.png b/source/clients/use_linbo/media/linbo-diff-images/03-linbo-password.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/03-linbo-password.png rename to source/clients/use_linbo/media/linbo-diff-images/03-linbo-password.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/04-linbo-tools-menue.png b/source/clients/use_linbo/media/linbo-diff-images/04-linbo-tools-menue.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/04-linbo-tools-menue.png rename to source/clients/use_linbo/media/linbo-diff-images/04-linbo-tools-menue.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/05-icon-new-image.png b/source/clients/use_linbo/media/linbo-diff-images/05-icon-new-image.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/05-icon-new-image.png rename to source/clients/use_linbo/media/linbo-diff-images/05-icon-new-image.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/06-menue-new-image.png b/source/clients/use_linbo/media/linbo-diff-images/06-menue-new-image.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/06-menue-new-image.png rename to source/clients/use_linbo/media/linbo-diff-images/06-menue-new-image.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/07-image-create-and-upload.png b/source/clients/use_linbo/media/linbo-diff-images/07-image-create-and-upload.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/07-image-create-and-upload.png rename to source/clients/use_linbo/media/linbo-diff-images/07-image-create-and-upload.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/08-finished-uploading-new-image.png b/source/clients/use_linbo/media/linbo-diff-images/08-finished-uploading-new-image.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/08-finished-uploading-new-image.png rename to source/clients/use_linbo/media/linbo-diff-images/08-finished-uploading-new-image.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/09-reboot-linbo.png b/source/clients/use_linbo/media/linbo-diff-images/09-reboot-linbo.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/09-reboot-linbo.png rename to source/clients/use_linbo/media/linbo-diff-images/09-reboot-linbo.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/10-linbo-boot-icons.png b/source/clients/use_linbo/media/linbo-diff-images/10-linbo-boot-icons.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/10-linbo-boot-icons.png rename to source/clients/use_linbo/media/linbo-diff-images/10-linbo-boot-icons.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/11-sync-image.png b/source/clients/use_linbo/media/linbo-diff-images/11-sync-image.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/11-sync-image.png rename to source/clients/use_linbo/media/linbo-diff-images/11-sync-image.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/12-gui-images-menue-left.png b/source/clients/use_linbo/media/linbo-diff-images/12-gui-images-menue-left.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/12-gui-images-menue-left.png rename to source/clients/use_linbo/media/linbo-diff-images/12-gui-images-menue-left.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/13-linbo-group-images.png b/source/clients/use_linbo/media/linbo-diff-images/13-linbo-group-images.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/13-linbo-group-images.png rename to source/clients/use_linbo/media/linbo-diff-images/13-linbo-group-images.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/14-group-images-overview.png b/source/clients/use_linbo/media/linbo-diff-images/14-group-images-overview.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/14-group-images-overview.png rename to source/clients/use_linbo/media/linbo-diff-images/14-group-images-overview.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/15-basic-image-menue.png b/source/clients/use_linbo/media/linbo-diff-images/15-basic-image-menue.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/15-basic-image-menue.png rename to source/clients/use_linbo/media/linbo-diff-images/15-basic-image-menue.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/16-basic-image-info.png b/source/clients/use_linbo/media/linbo-diff-images/16-basic-image-info.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/16-basic-image-info.png rename to source/clients/use_linbo/media/linbo-diff-images/16-basic-image-info.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/17-basic-image-backups-history.png b/source/clients/use_linbo/media/linbo-diff-images/17-basic-image-backups-history.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/17-basic-image-backups-history.png rename to source/clients/use_linbo/media/linbo-diff-images/17-basic-image-backups-history.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/18-diff-images-menue.png b/source/clients/use_linbo/media/linbo-diff-images/18-diff-images-menue.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/18-diff-images-menue.png rename to source/clients/use_linbo/media/linbo-diff-images/18-diff-images-menue.png diff --git a/source/clients/use_linbo4/media/linbo-diff-images/19-diff-image-infos.png b/source/clients/use_linbo/media/linbo-diff-images/19-diff-image-infos.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-diff-images/19-diff-image-infos.png rename to source/clients/use_linbo/media/linbo-diff-images/19-diff-image-infos.png diff --git a/source/clients/use_linbo4/media/linbo-imagingscreen/button-create-image.png b/source/clients/use_linbo/media/linbo-imagingscreen/button-create-image.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-imagingscreen/button-create-image.png rename to source/clients/use_linbo/media/linbo-imagingscreen/button-create-image.png diff --git a/source/clients/use_linbo4/media/linbo-imagingscreen/cache.png b/source/clients/use_linbo/media/linbo-imagingscreen/cache.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-imagingscreen/cache.png rename to source/clients/use_linbo/media/linbo-imagingscreen/cache.png diff --git a/source/clients/use_linbo4/media/linbo-imagingscreen/console-dialog.png b/source/clients/use_linbo/media/linbo-imagingscreen/console-dialog.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-imagingscreen/console-dialog.png rename to source/clients/use_linbo/media/linbo-imagingscreen/console-dialog.png diff --git a/source/clients/use_linbo4/media/linbo-imagingscreen/console.png b/source/clients/use_linbo/media/linbo-imagingscreen/console.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-imagingscreen/console.png rename to source/clients/use_linbo/media/linbo-imagingscreen/console.png diff --git a/source/clients/use_linbo4/media/linbo-imagingscreen/create-image-dialog.png b/source/clients/use_linbo/media/linbo-imagingscreen/create-image-dialog.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-imagingscreen/create-image-dialog.png rename to source/clients/use_linbo/media/linbo-imagingscreen/create-image-dialog.png diff --git a/source/clients/use_linbo4/media/linbo-imagingscreen/image-os.png b/source/clients/use_linbo/media/linbo-imagingscreen/image-os.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-imagingscreen/image-os.png rename to source/clients/use_linbo/media/linbo-imagingscreen/image-os.png diff --git a/source/clients/use_linbo4/media/linbo-imagingscreen/linbo-imagingscreen.png b/source/clients/use_linbo/media/linbo-imagingscreen/linbo-imagingscreen.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-imagingscreen/linbo-imagingscreen.png rename to source/clients/use_linbo/media/linbo-imagingscreen/linbo-imagingscreen.png diff --git a/source/clients/use_linbo4/media/linbo-imagingscreen/partition.png b/source/clients/use_linbo/media/linbo-imagingscreen/partition.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-imagingscreen/partition.png rename to source/clients/use_linbo/media/linbo-imagingscreen/partition.png diff --git a/source/clients/use_linbo4/media/linbo-imagingscreen/register-dialog.png b/source/clients/use_linbo/media/linbo-imagingscreen/register-dialog.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-imagingscreen/register-dialog.png rename to source/clients/use_linbo/media/linbo-imagingscreen/register-dialog.png diff --git a/source/clients/use_linbo4/media/linbo-imagingscreen/register.png b/source/clients/use_linbo/media/linbo-imagingscreen/register.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-imagingscreen/register.png rename to source/clients/use_linbo/media/linbo-imagingscreen/register.png diff --git a/source/clients/use_linbo4/media/linbo-imagingscreen/update-cache-dialog.png b/source/clients/use_linbo/media/linbo-imagingscreen/update-cache-dialog.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-imagingscreen/update-cache-dialog.png rename to source/clients/use_linbo/media/linbo-imagingscreen/update-cache-dialog.png diff --git a/source/clients/use_linbo4/media/linbo-imagingscreen/upload-image-dialog.png b/source/clients/use_linbo/media/linbo-imagingscreen/upload-image-dialog.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-imagingscreen/upload-image-dialog.png rename to source/clients/use_linbo/media/linbo-imagingscreen/upload-image-dialog.png diff --git a/source/clients/use_linbo4/media/linbo-imagingscreen/upload.png b/source/clients/use_linbo/media/linbo-imagingscreen/upload.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-imagingscreen/upload.png rename to source/clients/use_linbo/media/linbo-imagingscreen/upload.png diff --git a/source/clients/use_linbo4/media/linbo-mainscreen/linbo-mainscreen-infos-f1.png b/source/clients/use_linbo/media/linbo-mainscreen/linbo-mainscreen-infos-f1.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-mainscreen/linbo-mainscreen-infos-f1.png rename to source/clients/use_linbo/media/linbo-mainscreen/linbo-mainscreen-infos-f1.png diff --git a/source/clients/use_linbo4/media/linbo-mainscreen/linbo-mainscreen-registered.png b/source/clients/use_linbo/media/linbo-mainscreen/linbo-mainscreen-registered.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-mainscreen/linbo-mainscreen-registered.png rename to source/clients/use_linbo/media/linbo-mainscreen/linbo-mainscreen-registered.png diff --git a/source/clients/use_linbo4/media/linbo-mainscreen/linbo-mainscreen-unregistered.png b/source/clients/use_linbo/media/linbo-mainscreen/linbo-mainscreen-unregistered.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-mainscreen/linbo-mainscreen-unregistered.png rename to source/clients/use_linbo/media/linbo-mainscreen/linbo-mainscreen-unregistered.png diff --git a/source/clients/use_linbo4/media/linbo-mainscreen/new-and-start.png b/source/clients/use_linbo/media/linbo-mainscreen/new-and-start.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-mainscreen/new-and-start.png rename to source/clients/use_linbo/media/linbo-mainscreen/new-and-start.png diff --git a/source/clients/use_linbo4/media/linbo-mainscreen/password-dialog.png b/source/clients/use_linbo/media/linbo-mainscreen/password-dialog.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-mainscreen/password-dialog.png rename to source/clients/use_linbo/media/linbo-mainscreen/password-dialog.png diff --git a/source/clients/use_linbo4/media/linbo-mainscreen/start.png b/source/clients/use_linbo/media/linbo-mainscreen/start.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-mainscreen/start.png rename to source/clients/use_linbo/media/linbo-mainscreen/start.png diff --git a/source/clients/use_linbo4/media/linbo-mainscreen/sync+start.png b/source/clients/use_linbo/media/linbo-mainscreen/sync+start.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-mainscreen/sync+start.png rename to source/clients/use_linbo/media/linbo-mainscreen/sync+start.png diff --git a/source/clients/use_linbo4/media/linbo-mainscreen/system-reboot.png b/source/clients/use_linbo/media/linbo-mainscreen/system-reboot.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-mainscreen/system-reboot.png rename to source/clients/use_linbo/media/linbo-mainscreen/system-reboot.png diff --git a/source/clients/use_linbo4/media/linbo-mainscreen/system-shutdown.png b/source/clients/use_linbo/media/linbo-mainscreen/system-shutdown.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-mainscreen/system-shutdown.png rename to source/clients/use_linbo/media/linbo-mainscreen/system-shutdown.png diff --git a/source/clients/use_linbo4/media/linbo-mainscreen/tools.png b/source/clients/use_linbo/media/linbo-mainscreen/tools.png similarity index 100% rename from source/clients/use_linbo4/media/linbo-mainscreen/tools.png rename to source/clients/use_linbo/media/linbo-mainscreen/tools.png diff --git a/source/clients/use_linbo4/media/linbo_screen1.png b/source/clients/use_linbo/media/linbo_screen1.png similarity index 100% rename from source/clients/use_linbo4/media/linbo_screen1.png rename to source/clients/use_linbo/media/linbo_screen1.png diff --git a/source/clients/use_linbo4/media/linbo_screen2.png b/source/clients/use_linbo/media/linbo_screen2.png similarity index 100% rename from source/clients/use_linbo4/media/linbo_screen2.png rename to source/clients/use_linbo/media/linbo_screen2.png diff --git a/source/clients/use_linbo4/media/linbo_screen4.png b/source/clients/use_linbo/media/linbo_screen4.png similarity index 100% rename from source/clients/use_linbo4/media/linbo_screen4.png rename to source/clients/use_linbo/media/linbo_screen4.png diff --git a/source/conf.py b/source/conf.py index ddd074f3d..b9ae85710 100644 --- a/source/conf.py +++ b/source/conf.py @@ -71,7 +71,7 @@ def setup(app): # General information about the project. project = u'linuxmuster.net' -copyright = u'2017-2025, linuxmuster.net' +copyright = u'2017-2026, linuxmuster.net' author = u'linuxmuster.net' # The version info for the project you're documenting, acts as replacement for @@ -79,9 +79,9 @@ def setup(app): # built documents. # # The short X.Y version. -version = u'latest' +version = u'v7.4' # The full version, including alpha/beta/rc tags. -release = u'latest' +release = u'v7.4 beta' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. diff --git a/source/external-services/_datenschutz-loeschung.rst b/source/external-services/_datenschutz-loeschung.rst new file mode 100644 index 000000000..3238380c3 --- /dev/null +++ b/source/external-services/_datenschutz-loeschung.rst @@ -0,0 +1,14 @@ +.. attention:: + + **Datenschutz: Löschung von Benutzerdaten in extern angebundenen Diensten** + + Wird ein/e Benutzer/in im AD der linuxmuster.net gelöscht, wirkt sich das nicht automatisch auf bereits dort + gespeicherte Daten in extern angebundenen Diensten aus. Je nach Konfiguration des jeweiligen Dienstes werden + entfernte Benutzer/innen beim nächsten LDAP-Sync ggf. nur gesperrt oder deaktiviert, ihre personenbezogenen + Daten (Kursinhalte, Dateien, Nachrichten etc.) bleiben aber bestehen. + + Aus datenschutzrechtlicher Sicht (Löschpflicht, Speicherbegrenzung) müssen Administrator/innen sicherstellen, + dass personenbezogene Daten gelöschter Benutzer/innen auch in den angebundenen externen Diensten zeitnah + entfernt werden. Unterstützt der angebundene Dienst keine automatische Löschung (sondern nur eine + Sperrung/Deaktivierung) gelöschter LDAP-Benutzer/innen, so müssen diese Konten samt ihrer Daten + **regelmäßig manuell** im jeweiligen Dienst gelöscht werden, um den Datenschutzanforderungen zu genügen. diff --git a/source/external-services/_ldap-vertrauen-keycloak.rst b/source/external-services/_ldap-vertrauen-keycloak.rst new file mode 100644 index 000000000..4a4f79efa --- /dev/null +++ b/source/external-services/_ldap-vertrauen-keycloak.rst @@ -0,0 +1,13 @@ +.. attention:: + + **Vertrauen bei direkter LDAP-Anbindung** + + Bei einer direkten LDAP-Anbindung gibt der Bind-User zwar keine Nutzerpasswörter preis, wohl aber geben die + Nutzer/innen selbst ihr AD-Passwort direkt auf der Weboberfläche des externen Dienstes ein. Diesem Dienst + (bzw. dessen Betreiber) muss man also entsprechend vertrauen, da er potenziell an die eingegebenen + Zugangsdaten gelangen könnte. + + Steht stattdessen ein Keycloak zur Verfügung (z.B. bei Edulution bereits integriert, oder selbst betrieben + und an die linuxmuster.net angebunden), ist es aus Datenschutz-/Sicherheitssicht vorzuziehen, Dienste über + Keycloak per SSO (OIDC/SAML) statt per direktem LDAP-Bind anzubinden: Die Passwörter/Secrets der Nutzer/innen + verbleiben dann stets auf der eigenen Infrastruktur und werden dem externen Dienst nie direkt mitgeteilt. diff --git a/source/external-services/aleksis/index.rst b/source/external-services/aleksis/index.rst index d836a981e..54cbcf5f4 100644 --- a/source/external-services/aleksis/index.rst +++ b/source/external-services/aleksis/index.rst @@ -68,9 +68,10 @@ Sind die benötigten LDAP Pakete installiert muss die LDAP Konfiguration in der Die ``uri`` muss natürlich auf die jeweilige Schule mit dem entsprechenden Domain Namen angepasst werden ebenso bei ``search`` -Sollte die Aleksis Instanz extern betrtrieben werden. Ist es dringend empfohlen den Port ``636`` für LDAPs zu verwenden außerdem bei ``uri`` -statt ``ldap:`` ebenfalls ``ldaps`` einzutragen. +Sollte die Aleksis Instanz extern betrtrieben werden. Ist es dringend empfohlen den Port ``636`` für LDAPs zu verwenden außerdem bei ``uri`` +statt ``ldap:`` ebenfalls ``ldaps`` einzutragen. +.. include:: /external-services/_ldap-vertrauen-keycloak.rst Als nächstes wechselt man in die Aleksis Weboberfläche und wechselt auf der linken Seite auf ``Admin`` und dann auf ``LDAP`` @@ -107,3 +108,5 @@ Alle anderen Felder sollten leer bleiben Am Ende die Einstellungen mit ``EINSTELLUNGEN SPEICHERN`` bestätigen. Jetzt sollte der Benutzer in der Lage sein sich anzumelden. Die LDAP Anbindung ist hiermit abgeschlossen. + +.. include:: /external-services/_datenschutz-loeschung.rst diff --git a/source/external-services/moodle/index.rst b/source/external-services/moodle/index.rst index c9ed2e14c..563627d02 100644 --- a/source/external-services/moodle/index.rst +++ b/source/external-services/moodle/index.rst @@ -70,7 +70,9 @@ Bind-Einstellungen .. attention:: - Grundsätzlich sollten alle externen Dienste, die via LDAP an das AD angebunden werden, mit einem eigens dafür angelegten Bind-User genutzt werden. Für Moodle sollte so z.B. ein Benutzer ``moodle-binduser`` angelegt werden, der für die Verbindung zum AD genutzt wird. Hinweise hierzu findest Du unter https://github.com/linuxmuster/sophomorix4/wiki/bindusers + Grundsätzlich sollten alle externen Dienste, die via LDAP an das AD angebunden werden, mit einem eigens dafür angelegten Bind-User genutzt werden. Für Moodle sollte so z.B. ein Benutzer ``moodle-binduser`` angelegt werden, der für die Verbindung zum AD genutzt wird. Hinweise hierzu findest Du unter https://github.com/linuxmuster/sophomorix4/wiki/bindusers + +.. include:: /external-services/_ldap-vertrauen-keycloak.rst **Vorgehen zur Anlage eines neuen Bind-Users** @@ -166,6 +168,8 @@ Weitere Einstellungen | Status von lokalen Nutzerkonten synchronisieren | Nein | +-------------------------------------------------+-----------------------------------------------+ +.. include:: /external-services/_datenschutz-loeschung.rst + **NTLM-SSO** +--------------------+----------------------------------------------------------------------------+ diff --git a/source/external-services/nextcloud/authentication.rst b/source/external-services/nextcloud/authentication.rst index 3d73bfea4..5589b5dde 100644 --- a/source/external-services/nextcloud/authentication.rst +++ b/source/external-services/nextcloud/authentication.rst @@ -43,7 +43,9 @@ Bind-User .. attention:: - Grundsätzlich sollten alle externen Dienste, die via LDAP an das AD angebunden werden, mit einem eigens dafür angelegten Bind-User genutzt werden. Für Nextcloud sollte so z.B. ein Benutzer ``nextcloud-binduser`` angelegt werden, der für die Verbindung zum AD genutzt wird. Hinweise hierzu findest Du unter https://github.com/linuxmuster/sophomorix4/wiki/bindusers + Grundsätzlich sollten alle externen Dienste, die via LDAP an das AD angebunden werden, mit einem eigens dafür angelegten Bind-User genutzt werden. Für Nextcloud sollte so z.B. ein Benutzer ``nextcloud-binduser`` angelegt werden, der für die Verbindung zum AD genutzt wird. Hinweise hierzu findest Du unter https://github.com/linuxmuster/sophomorix4/wiki/bindusers + +.. include:: /external-services/_ldap-vertrauen-keycloak.rst **Vorgehen zur Anlage eines neuen Bind-Users** @@ -198,3 +200,5 @@ Das ``"$home"Platzhalter-Feld`` brauchst Du, wenn Du die Home-Verzeichnisse auch So, das war's. Sicherheitshalber gehst Du nochmal auf den Reiter ``Experte`` und klicks auf ``Lösche LDAP-Benutzernamenzuordung`` und ``Lösche LDAP-Gruppennamenzuordung``. +.. include:: /external-services/_datenschutz-loeschung.rst + diff --git a/source/external-services/unifiwlan/index.rst b/source/external-services/unifiwlan/index.rst index fbded171e..995f457c9 100644 --- a/source/external-services/unifiwlan/index.rst +++ b/source/external-services/unifiwlan/index.rst @@ -7,7 +7,7 @@ Unifi-WLAN-Lösung für linuxmuster.net Die hier vorgestellte WLAN-Lösung spannt drei WLAN-Netze auf. - Das interne Netz für schuleigene Geräte, wie Laptops, Beamer oder Apple-TVs. -- Das eigentliche Schulnetz, in dem jenach Anmelgung ins VLAN für Lehrer oder für Schüler verbunden wird. +- Das eigentliche Schulnetz, in dem je nach Anmeldung ins VLAN für Lehrer oder für Schüler verbunden wird. - Das Gästenetz, in das man sich über Vouchers anmeldet. .. figure:: media/vlantopologie.png @@ -17,7 +17,7 @@ Es kommen Accesspoints von Unifi und der kostenlose Unifi-OS-Server zum Einsatz. Die Geräte im internen Netz werden in die Datei `/etc/linuxmuster/sophomorix/default-school/devices.csv` aufgenommen. Es ist ein Teil des Schulnetzes. Damit können sich beispielsweise Benutzer mit einem Schullaptop per WLAN wie gewohnt anmelden und auf ihre Daten zugreifen. -Die folgenden Vido-Tutorials zeigen Schritt für Schritt, wie unser WLAN-Netz aufgebaut wird. +Die folgenden Video-Tutorials zeigen Schritt für Schritt, wie unser WLAN-Netz aufgebaut wird. Überblick über den Ausgangszustand ---------------------------------- @@ -26,16 +26,16 @@ Die folgenden Vido-Tutorials zeigen Schritt für Schritt, wie unser WLAN-Netz au -Instalation eines Debian-Servers --------------------------------- +Installation eines Debian-Servers +--------------------------------- Der Unifi-OS-Server läuft in diesem Tutorial auf einem Debian-Server. Das folgende Video-Tutorial zeigt die Installation und Integration eines leeren Debian-Servers. .. raw:: html -Instalation und Grundeinrichtung des Unifi-OS-Servers ------------------------------------------------------ +Installation und Grundeinrichtung des Unifi-OS-Servers +------------------------------------------------------ Jetzt wird der eigentliche Unifi-OS-Server eingerichtet. .. raw:: html @@ -47,7 +47,7 @@ Migration eines bestehenden Unifi-Controllers --------------------------------------------- In diesem Tutorial wird gezeigt, wie ein bestehendes Unifi-Controller-System auf Unifi-OS-Server migriert werden kann. -Falls du kein bestehendes Unifi-Controller-System hast, kannst du diese Tutorial übersprinen. +Falls du kein bestehendes Unifi-Controller-System hast, kannst du dieses Tutorial überspringen. .. raw:: html @@ -55,7 +55,7 @@ Falls du kein bestehendes Unifi-Controller-System hast, kannst du diese Tutorial Anlegen von Schüler- und Lehrer-Netzwerke ----------------------------------------- -Jetzt legen wir für die Schüler und Lehrer eigene Netzwerke auf der OpnSense an. +Jetzt legen wir für die Schüler und Lehrer eigene Netzwerke auf der OPNsense an. .. raw:: html @@ -63,7 +63,7 @@ Jetzt legen wir für die Schüler und Lehrer eigene Netzwerke auf der OpnSense a WLAN-Netzwerke im Unifi-OS-Server einrichten -------------------------------------------- -Hier siehst du, wie man ein WLAN über WPA2 und über WPA2/WPA3-Enterprise einrichtet. Bei WPA2/WPA3-Enterprise wird das Lehrer- bzw. Schülernetzwerk jenach Anmeldenamen zugeordnet. +Hier siehst du, wie man ein WLAN über WPA2 und über WPA2/WPA3-Enterprise einrichtet. Bei WPA2/WPA3-Enterprise wird das Lehrer- bzw. Schülernetzwerk je nach Anmeldenamen zugeordnet. .. raw:: html @@ -71,7 +71,7 @@ Hier siehst du, wie man ein WLAN über WPA2 und über WPA2/WPA3-Enterprise einri Gäste-WLAN mit Voucher ---------------------- -Jetzt kommet noch das Gäste-WLAN. Für Gäste und Austauschklassen legen wir noch ein Gäste-Netz an. Und wir erstellen natürlich noch Voucher die passenden Voucher. +Jetzt kommt noch das Gäste-WLAN. Für Gäste und Austauschklassen legen wir noch ein Gäste-Netz an. Und wir erstellen natürlich noch die passenden Voucher. .. raw:: html @@ -79,7 +79,7 @@ Jetzt kommet noch das Gäste-WLAN. Für Gäste und Austauschklassen legen wir no Die InnerSpace-App ------------------ -InnerSpace ist eine App auf dem Unifi-OS-Server, mit der man Gebäudepläne verwalten und die Position der Unifi-Komponenten entragen kann. Das ist dann besonders interessant, wenn APs oder Switche hinter Wandverschalungen verbaut sind. So weiß man immer, wo sich die Geräte befinden. +InnerSpace ist eine App auf dem Unifi-OS-Server, mit der man Gebäudepläne verwalten und die Position der Unifi-Komponenten eintragen kann. Das ist dann besonders interessant, wenn APs oder Switche hinter Wandverschalungen verbaut sind. So weiß man immer, wo sich die Geräte befinden. Zusätzlich berechnet InnerSpace auch die aktuelle WLAN-Ausleuchtung. Man sieht also, wo noch Lücken in der Ausleuchtung sind oder ob ein anderer Ort für einen AP eine bessere WLAN-Ausleuchtung brächte. diff --git a/source/guided-inst.subst b/source/guided-inst.subst index 9d62859c5..a2f8517e4 100644 --- a/source/guided-inst.subst +++ b/source/guided-inst.subst @@ -31,7 +31,7 @@ .. Hier Ersetzungen die sich bei Versionsänderungen angepasst werden sollen -.. |lts_version| unicode:: 24.04 .. LTS Versionsnummer +.. |lts_version| unicode:: 26.04 .. LTS Versionsnummer .. Hier feststehende Konstanten: diff --git a/source/index.rst b/source/index.rst index b90f28f82..588678a26 100644 --- a/source/index.rst +++ b/source/index.rst @@ -2,7 +2,7 @@ Einführung ========== -Herzlich Willkommen zur Dokumentation von linuxmuster.net v7.3! +Herzlich Willkommen zur Dokumentation von linuxmuster.net v7.4! Diese beschreibt alle wichtigen Schritte ... @@ -32,7 +32,7 @@ Installation from Scratch ------------------------- Diese Dokumentation führt Dich durch eine Installation von Grund auf. Dies bedeutet, dass zunächst -die Vorbereitung der Virtualisierungslösungen - hier Proxmox - dokumentiert wird. Auf dem Virtualisierer sind sog. Virtuelle Maschinen (VM) anzulegen, um linuxmuster.net 7.3 installieren zu können. Hierzu gehört die spezifische Einrichtung des Netzwerks, des Speichers sowie die Vorbereitung der VMs. +die Vorbereitung der Virtualisierungslösungen - hier Proxmox - dokumentiert wird. Auf dem Virtualisierer sind sog. Virtuelle Maschinen (VM) anzulegen, um linuxmuster.net 7.4 installieren zu können. Hierzu gehört die spezifische Einrichtung des Netzwerks, des Speichers sowie die Vorbereitung der VMs. Weitere Hilfe ------------- @@ -41,12 +41,12 @@ Neben dieser Dokumentation steht Dir unsere Community in unserem Hilfeforum und Das Forum findest Du unter ``_. -Informationen zum Telefon-Support gibt es auf unser Projektseite ``_. +Informationen zum Telefon-Support gibt es auf unserer Projektseite ``_. .. hint:: - Suchst Du die Dokumentation zur Version linuxmuster.net 7.2 oder die Möglichkeit unsere Dokumentation herunterzuladen? + Suchst Du die Dokumentation zur Version linuxmuster.net 7.3 oder die Möglichkeit, unsere Dokumentation herunterzuladen? Dann schaue in die unten recht angezeigte - zusätzliche - Menüleiste. @@ -102,15 +102,9 @@ Nach einem Klick auf die Leiste eröffnen sich Dir dort noch weitere Möglichkei :caption: Upgrade :hidden: - migration/upgrade - -.. toctree:: - :maxdepth: 2 - :caption: Migration - :hidden: - - migration/index - migration/linbo-migration-to-4 + upgrade/index + upgrade/linbo-migration + upgrade/upgrade .. toctree:: :maxdepth: 4 @@ -119,14 +113,10 @@ Nach einem Klick auf die Leiste eröffnen sich Dir dort noch weitere Möglichkei clients/index clients/client_templates/index - clients/use_linbo4/index + clients/use_linbo/index clients/postsync/index clients/leoclient2/index -.. clients/linbo/index -.. clients/windows10clients/index -.. clients/linux-clients/index - .. toctree:: :maxdepth: 2 :caption: Benutzerverwaltung diff --git a/source/installation/install-from-scratch/basis_file_server.rst b/source/installation/install-from-scratch/basis_file_server.rst index 3bab563d6..3a08340b6 100644 --- a/source/installation/install-from-scratch/basis_file_server.rst +++ b/source/installation/install-from-scratch/basis_file_server.rst @@ -8,16 +8,20 @@ Anlegen und Installieren des Fileservers .. sectionauthor:: `@cweikl `_ +.. todo:: + + Kapitel muss noch überarbeitet werden. btrfs, subvolumes - Anpassungen an neues lmn74 setup etc. + .. hint:: - Der Fileserver für linuxmuster.net 7.3 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 Verbidnung mit Samba erreicht werden. Dies empfehlen wir insbesondere mittleren bis grösseren Schulen. Kleinere Schulen können problemlos linuxmuster.net 7.3 als Zwei-Server-Lösung weiterbetreiben. - - Grundsätzlich kann linuxmuster.net 7.3 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. + 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. 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. Es ist aber ohne Probleme möglich, den Fileserver später heraus zu trennen und auf eine eigene Maschine zu verlegen. -Man kann die Umgebung also zunächst ohne extra Fileserver installieren. Stellt man später fest, dass Dateizugriffe der Nutzer zu lange dauern, kann man jederzeit den Fileserver installieren und linuxmuster.net entsprechend auf eine Dri-Server-Lösung erweitern. +Man kann die Umgebung also zunächst ohne extra Fileserver installieren. Stellt man später fest, dass Dateizugriffe der Nutzer zu lange dauern, kann man jederzeit den Fileserver installieren und linuxmuster.net entsprechend auf eine Drei-Server-Lösung erweitern. Der Fileserver von linuxmuster.net wird vollständig in das AD des linuxmuster.net Servers integriert. Die Netzwerkfreigaben werden auf dem linuxmuster.net Server definiert und mithilfe einer DFS-Konfiguration für die konfigurierte Schule bereitgestellt. Es werden so alle persönlichen Netzlaufwerke, die Projektfreigaben, sowie die Klassenfreigaben auf diesem File-Server bereitgestellt. @@ -25,7 +29,7 @@ Vorteile: - Trennung der Dienste (AD Service, File Service) - verbesserte Backupstrategie (jeweils eigenständiges Backup für die Dateien als auch für das AD) -- verbesserte Sicherheit (bei einem Multi-School Setup kann jeweils ein eigenständier File-Server pro Schule eingesetzt werden.) +- verbesserte Sicherheit (bei einem Multi-School Setup kann jeweils ein eigenständiger File-Server pro Schule eingesetzt werden.) - einfache Wartung und vereinfachte Updates - deutliche Leistungsverbesserung - gerade bei grossen Schulinstallationen @@ -165,7 +169,7 @@ Nachdem Du als Benutzer ``linuxadmin`` am file-server angemeldet bist, wechselst .. code:: - sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/linuxmuster.net.gpg] https://deb.linuxmuster.net/ lmn73 main" > /etc/apt/sources.list.d/lmn73.list' + sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/linuxmuster.net.gpg] https://deb.linuxmuster.net/ lmn74 main" > /etc/apt/sources.list.d/lmn74.list' Fileserver Installation ======================= @@ -195,7 +199,7 @@ Weiteres Vorgehen 1. Nun muss der linuxmuster.net Server (AD/DC) im nächsten Schritt vorbereitet werden. 2. Proxmox muss in das interne Netz gebracht werden. -3. Es muss das Setup für lmnv7.3 (AD/DC) durchgeführt werden. +3. Es muss das Setup für lmnv7.4 (AD/DC) durchgeführt werden. 4. Der File-Server ist in das AD einzubinden und es sind die Freigaben/Shares auf dem lmn-Server zu definieren. diff --git a/source/installation/install-from-scratch/basis_opnsense.rst b/source/installation/install-from-scratch/basis_opnsense.rst index 0bf7b4fc2..85c325c7e 100644 --- a/source/installation/install-from-scratch/basis_opnsense.rst +++ b/source/installation/install-from-scratch/basis_opnsense.rst @@ -41,19 +41,17 @@ Nutze als Architektur ``amd64`` und als ``image type dvd``. Du erhältst dann ei .. hint:: - Die zuletzt freigegeben OPNsense Version für das Setup von linuxmuster.net v7.3 ist die Version 25.1 + Die zuletzt freigegeben OPNsense Version für das Setup von linuxmuster.net v7.4 ist die Version 26.7 - [Stand: Mai 25]. + [Stand: August 26]. - Version 25.7 befindet sich in der Testphase. Berichte über Erkenntnise der Zusammenarbeit mit linuxmuster.net bitte an das Forum oder an die oben genannten Personen. [Stand 06.08.25] - - wget https://mirror.informatik.hs-fulda.de/opnsense/releases/25.1/OPNsense-25.1-dvd-amd64.iso.bz2 + wget https://mirror.level66.network/opnsense-dist/releases/26.7/OPNsense-26.7-dvd-amd64.iso.bz2 Die heruntergladene Datei entpackst Du unter Linux mit folgendem Befehl: .. code:: - bunzip2 OPNsense-25.1-dvd-amd64.iso.bz2 + bunzip2 OPNsense-26.7-dvd-amd64.iso.bz2 In der Virtualisierungsumgebung lädst Du die ISO-Datei auf den ISO-Speicher. @@ -65,11 +63,11 @@ In der Virtualisierungsumgebung lädst Du die ISO-Datei auf den ISO-Speicher. - template - other install media, installation from ISO library, - Boot-Mode - UEFI (Achtung: xcp-ng: Boot/MBR), - 2 vCPU - - 4 GiB RAM - - storage 20 GiB + - 8 GiB RAM + - storage 50 GiB - 2 NIC mit Zuordnung zu vSwitch red, green. -Für den produktiven Betrieb müssen diese Hardware-Einstellungen **deutlich** angehoben werden (z.B.: 4 vCPU, 8 GiB RAM, 50 GiB SSD, 3 NIC). +Für den produktiven Betrieb müssen diese Hardware-Einstellungen **deutlich** angehoben werden (z.B.: 4 vCPU, 8 GiB RAM, 250 GiB SSD, 3 NIC). .. _first_start_firewall: @@ -103,7 +101,7 @@ Du gelangst direkt zum Installer und kannst das Layout der Tastatur festlegen. Installer: Tastaturlayout festlegen -Standardmäßig ist ein amerikanisches Tastaturlayout voreingestellt. Gehe mit den Pfeiltasten auf den Eintrag ``( ) German (no accent keys)``. Wählen diesen mit ```` aus. Teste danach das Tastaturlayout: @@ -113,17 +111,13 @@ Teste danach das Tastaturlayout: Teste das Tastaturlayout -Bei der deutschen Tastatur werden ggf. die Umlaute im Test noch nicht korrekt wiedergegeben. - Wähle die eingestellte deutsche Tastatur aus: .. figure:: media/basis_opnsense_004.png :align: center :alt: OPNsense: continue with keymap - Bestätige der Stataturlayout - -Wähle ``