Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung |
satellite:satellitenserver_handbuch [2021/06/22 18:00 CEST] – [Weiteres] chr | satellite:satellitenserver_handbuch [2024/02/21 11:09 CET] (aktuell) – [Einstellungen (Client)] sritter |
---|
====== Satellitenserver-Handbuch ====== | ====== Satellitenserver-Handbuch ====== |
| |
English: [[en:satellite:satellitenserver_handbuch|Satellite server user's (admin's) manual]] | |
| |
===== Installation ===== | ===== Installation ===== |
| |
Eine Anleitung zur Installation des Satellitenservers ist [[satellite:satellitenserver_installation|hier]]; wollen Sie lediglich ein Update eines bestehenden Satellitenservers ausführen, finden Sie Informationen auf [[satellite:satelliteserver_update|dieser Seite]]. | Eine Anleitung zur **Erstinstallation des Satellitenservers** finden Sie unter: |
| * [[satellite:satellitenserver_installation|Satellitenserver-Installation]] |
| |
| Wollen Sie lediglich ein **Update eines bestehenden Satellitenservers** durchführen? |
| * [[satellite:satelliteserver_update|Satellitenserver aktualisieren]]. |
| |
===== Die Admin-Schnittstelle ===== | ===== Die Admin-Schnittstelle ===== |
| |
[{{:satellite:handbuch:sat_startbildschirm_webinterface.png?300 |Startanzeige der Adminschnittstelle}}]Die Adminschnittstelle ist per http://[IP-Adresse oder Servername] bzw. https://[IP-Adresse oder Servername] erreichbar. Sie benötigt Javascript und Cookies. | [{{:satellite:handbuch:sat_startbildschirm_webinterface.png?300 |Startanzeige der Adminschnittstelle}}]Die Adminschnittstelle ist per http://[IP-Adresse oder Servername] bzw. https://[IP-Adresse oder Servername] erreichbar. |
| |
Mitunter werden hier Hinweise oder sonstige Meldungen angezeigt. | Mitunter werden hier Hinweise oder sonstige Meldungen angezeigt. |
===== Erstkonfiguration ===== | ===== Erstkonfiguration ===== |
| |
[{{:satellite:handbuch:sat_admininterface_willkommen.png?400 |Erstregistrierung Adminzugang}}]Die [[satellite:satellitenserver_erstkonfiguration|Erstkonfiguration]] des Satellitenservers sollte direkt nach erfolgter Installation erfolgen.<note important>Insbesondere die Erstregistrierung des Adminzuganges sollte sofort direkt nach der Installation geschehen.</note> | [{{:satellite:handbuch:sat_admininterface_willkommen.png?400 |Erstregistrierung Adminzugang}}]Die [[satellite:satellitenserver_erstkonfiguration|Erstkonfiguration]] des Satellitenservers sollte direkt nach erfolgter Installation erfolgen.<note important>Insbesondere die Erstregistrierung des Adminzuganges sollte sofort direkt nach der Erstinstallation geschehen.</note> |
| |
===== Konfigurationsoptionen ===== | ===== Konfigurationsoptionen ===== |
| |
Unter [Einstellungen], [Konfigurationsvariablen] können das [[satellitenserver_konfigvariablen|Clientverhalten beeinflussende Variablen]] gesetzt werden. Dies ist auch für einzelne Clientrechner möglich. | Unter [Einstellungen], [Konfigurationsvariablen] können das [[satellitenserver_konfigvariablen|Clientverhalten beeinflussende Variablen]] gesetzt werden. Dies ist auch für einzelne Clientrechner möglich. |
<note tip>Hier können neben vielem anderen die Client-Passwörter für 'root' und 'demo' gesetzt werden. Hier gesetzte Grundwerte können für Unterräume bzw. Raumhierarchien in der [[satellite/raeume_orte#raumkonfiguration|Raumkonfiguration]] überschrieben werden.</note> | <note tip>Hier können neben vielem anderem (lokales Caching [[dnbd3_lokales_caching|hier]]) die Client-Passwörter für 'root' und 'demo' gesetzt werden, Einstellungen zum Energiesparverhalten der Clientrechner getroffen werden usw. Hier gesetzte Grundwerte können für Unterräume bzw. Raumhierarchien in der [[satellite/raeume_orte#raumkonfiguration|Raumkonfiguration]] überschrieben werden. </note> |
| |
| |
=== Netboot Grundsystem === | === Netboot Grundsystem === |
| |
Bitte vergleichen Sie das Kapitel „[[satellitenserver_erstkonfiguration#fehlende_dateien_der_minilinux-installion|Fehlende Dateien der MiniLinux-Installion]]“. | Bitte vergleichen Sie das Kapitel „[[satellitenserver_erstkonfiguration#fehlende_dateien_der_netboot_grundsystem_-_installation|Fehlende Dateien der Netboot Grundsystem - Installation]]“. |
| |
<note important>Doku nachführen</note> | <note important>Doku nachführen</note> |
Sie können beispielsweise auch Verzweigungen auf bestehende Systeme wie WDS, Zenwork oder andere PXE-Dienste angeben. | Sie können beispielsweise auch Verzweigungen auf bestehende Systeme wie WDS, Zenwork oder andere PXE-Dienste angeben. |
| |
Nutzen Sie ... | Weitere Informationen finden Sie unter [[satellite:ipxe_bootmenu|iPXE Bootmenü]]. |
* noch einen älteren Satellitenserver (Version <3.7) bzw. haben nicht auf iPXE umgestellt, finden Sie Informationen zur Konfiguration des Bootmenüs unter [[satellite:pxe_bootmenu|PXE Bootmenü (alt)]]. | |
* einen Satellitenserver WS18/19 (Version 3.8) oder neuer und haben auf iPXE umgestellt haben, gehen Sie zu [[satellite:ipxe_bootmenu|iPXE Bootmenü (neu)]]. | |
| |
[{{:client:bwlehrpool_1_bootmenu.png?direct&200|Altes Bootmenü (PXE)}}] | |
[{{:client:bwlehrpool_1_bootmenu_ipxe.png?direct&200|Neues Bootmenü (iPXE)}}] | [{{:client:bwlehrpool_1_bootmenu_ipxe.png?direct&200|iPXE Bootmenü}}] |
| |
| |
=== Sichern / Wiederherstellen === | === Sichern / Wiederherstellen === |
| |
Die Möglichkeiten zum Sichern und Wiederherstellen einer Konfiguration sind unter [Einstellungen], [Backup/Restore] zu finden. Eine Sicherung beinhaltet die Datenbankeinträge der Arbeitsumgebungen und Veranstaltungen, die Konfiguration des VM-Stores und die Konfiguration des MiniLinux. <note important>Achtung: Der Inhalt des VM-Stores wird hierbei nicht mitgesichert.</note> | Die Möglichkeiten zum Sichern und Wiederherstellen einer Konfiguration sind unter [Einstellungen], [Backup/Restore] zu finden. Eine Sicherung beinhaltet die Datenbankeinträge der Arbeitsumgebungen und Veranstaltungen, die Konfiguration des VM-Stores und die Konfiguration des MaxiLinux. <note important>Achtung: Der Inhalt des VM-Stores wird hierbei nicht mitgesichert.</note> |
| |
== Sichern der Konfiguration == | == Sichern der Konfiguration == |
=== Betriebsmodus === | === Betriebsmodus === |
| |
[{{:satellite:weiteres:weiteres_betriebsmodus_liste.png|sfsfsdf}}]Unter dem Menupunkt „Betriebsmodus“ | [{{ :satellite:handbuch:weiteres:weiteres_betriebsmodus_liste.png?500|Betriebsmodus: Je ein Beispiel der verschiedenen Modi.}}]Unter dem Menupunkt „Betriebsmodus“ werden alle Rechner aufgelistet, die nicht im normalen Clientmodus betrieben werden. Derzeit existieren folgende Sonderbetriebsmodi: |
| |
| * Infoscreen: Hier sind alle Clients aufgeführt, die in einem eingeschränkten Modus laufen oder die Möglichkeit eines eingeschränkten Modus bieten. Darunter fallen Infotafeln (Panels), aber auch Rechner, die auf die eine oder andere Art als Kioskcomputer eingesetzt werden. Mehr Informationen dazu finden Sie unter [[:satellite:satellitenserver_infoscreen|Infoscreen]]. Das Papierkorbsymbol löscht den jeweiligen Eintrag. |
| * Raumplaner: Rechner, die als [[:client:poolvideoswitch|PVS]]-Stationen eingesetzt werden. Das Editiersymbol führt hier zu dem der betr. PVS-Station zugrunde liegenden [[:satellite:raumplaner|Raumplaner]] - daher auch der Name. Anm.: Dieser zugrundeliegende Raumplaner wird üblicherweise über den Menupunkt „[[:satellite:raeume_orte|Räume/Orte]]“ erreicht. |
| * DNBD3: Computer, die als [[:satellite:dnbd3|dnbd3]]-Proxies genutzt werden. Editieren führt zu den Einstellungen des betreffenden dnbd3-Proxies. |
| |
====== Anhang ====== | ====== Anhang ====== |
| |
* Aktivieren Sie im BIOS der Lehrpoolrechner (CMOS-Einstellungen) unbedingt die Option „Intel Virtualization Technology (VT-x) und, wenn vorhanden, auch VT-d (Intel Virtualization Technology for Directed I/O). Es können keine 64bit-Virtuelle Maschinen gestartet werden, wenn diese Optionen nicht aktiviert oder vom jeweiligen Rechner nicht unterstützt sind. | * Aktivieren Sie im BIOS der Lehrpoolrechner (CMOS-Einstellungen) unbedingt die Option „Intel Virtualization Technology (VT-x) und, wenn vorhanden, auch VT-d (Intel Virtualization Technology for Directed I/O). Es können keine 64bit-Virtuelle Maschinen gestartet werden, wenn diese Optionen nicht aktiviert oder vom jeweiligen Rechner nicht unterstützt sind. |
* Es ist empfehlenswert, von UEFI auf BIOS bzw. Legacy-Boot umzustellen, da UEFI derzeit nicht unterstützt wird. Achtung: Dies kann dazu führen, dass lokale Betriebssysteme eventuell neu installiert werden müssen bzw. der verwendete Bootloader angepasst werden muss. | * Für AMD-Rechner lauten diese Optionen AMD-V/SVM und AMD-Vi |
* Bei der Bootreihenfolge sollte an erster Stelle PXE/Netzwerk eingestellt sein. | * Falls möglich empfehlen wir, von UEFI auf BIOS bzw. Legacy-Boot umzustellen ([[ipxe-pxe#uefi|Weitere Informationen zur UEFI-Unterstützung]]) |
| * Bei der Bootreihenfolge sollte an erster Stelle PXE/Netzwerk eingestellt sein |
| |
==== Partitionierung ==== | ==== Partitionierung ==== |
Das bwLehrpool-System ist prinzipiell bei ausreichend RAM auch auf festplattenlosen Rechnern lauffähig. Dennoch wird empfohlen, zur temporären Speicherung eine Partition anzulegen. Folgende Partitionstypen werden automatisch als. temp. Speicher erkannt und eingebunden: | Das bwLehrpool-System ist prinzipiell bei ausreichend RAM auch auf festplattenlosen Rechnern lauffähig. Dennoch wird empfohlen, zur temporären Speicherung eine Partition anzulegen. Folgende Partitionstypen werden automatisch als. temp. Speicher erkannt und eingebunden: |
| |
* MBR-Partitionen der ID 44 (hex), oder | * MBR-Partitionen mit der ID 44 (hex) |
* GPT-Partitionen, die das Label „OpenSLX-ID44“ tragen. | * GPT-Partitionen, die das Label „OpenSLX-ID44“ tragen |
| * GPT-Partitionen, die die GUID 87f86132-ff94-4987-b250-444444444444 haben |
| |
* Die empfehlenswerte Größe dieser Partitionen beträgt 20-50 GB. | * Die empfehlenswerte Größe dieser Partitionen beträgt 20-50 GB. |
* Optimale Partitionsgröße: 50-70 GB oder so groß wie das größte in Verwendung befindliche virtuelle Abbild. | * Optimale Partitionsgröße: 50-70 GB oder so groß wie das größte in Verwendung befindliche virtuelle Abbild. |
| |
Weitere Informationen zur Verwendung temp. Partitionen finden Sie [[wiki:id44|hier]]; eine Kurzübersicht zur Client-PC-Hardware [[client:client_hardware|hier]]. | Weitere Informationen zur Partitionierung finden Sie unter [[wiki:Spezialpartitionen]]. |
| |
===== Troubleshooting ===== | ===== Troubleshooting ===== |
Falls der dem Satellitenserver zur Verfügung gestellte Plattenplatz sich als zu klein erweisen sollte, finden Sie [[satellite:dateisystemvergroesserung|hier]] eine Kurzanleitung zur Vergrößerung. Dies sollte natürlich hauptsächlich bei interner Speicherung der Virtuellen Maschinen vorkommen können. | Falls der dem Satellitenserver zur Verfügung gestellte Plattenplatz sich als zu klein erweisen sollte, finden Sie [[satellite:dateisystemvergroesserung|hier]] eine Kurzanleitung zur Vergrößerung. Dies sollte natürlich hauptsächlich bei interner Speicherung der Virtuellen Maschinen vorkommen können. |
| |
===== Satellitenserver Entwicklungsversion ===== | |
| |
Sollten Sie selbst einen Satellitenserver aufbauen wollen, besteht die Möglichkeit, eine Testversion mit den neuesten zur Verfügung stehenden Quellen selbst aufzubauen. Als Grundlage benötigen Sie ein Debian 7.7 oder 7.8 entweder physikalisch oder in Form einer Virtuellen Maschine (virt. Maschine empfohlen). Wir halten ca. 5-6 GB Platz für die Systempartition zuzüglich einer Swappartition für ausreichend (vergl. Anhang Kap. 3.1, Systemvoraussetzungen). Die Verwendung eines 64bit-Debians sollte problemlos möglich sein, wurde von uns jedoch nicht im Einzelfall getestet. | |
| |
Bitte beachten Sie, dass wir natürlich für Eigenbau-Satelliten schwieriger Hilfe leisten können als im Fall eines von uns ausgelieferten, überprüften Images. | |
| |
==== Vorgefertigtes Debian-Basissystem ==== | |
| |
Es steht ein vorgefertigtes Basissystem zur Verfügung (vmware-Image, nicht preallocated, root-Passwort „aendermichsofort“)(([[http://files.bwlp.ks.uni-freiburg.de/satellit/debian_base_image_raw_current.tar.gz]])). Bitte beachten Sie jedoch, dass wir weder die Aktualität noch die Verwendbarkeit allgemein noch überhaupt die Verfügbarkeit dieses Images garantieren– setzen Sie im Zweifelsfall lieber ein eigenes Image auf. | |
| |
==== Das automatische Buildskript ==== | |
| |
Das automatische Buildskript kann per git heruntergeladen werden. Wechseln Sie in ein Verzeichnis Ihrer Wahl, da root-Rechte zum Bau vonnöten sind, empfiehlt sich die Hierarchie unter /root. Gehen Sie sicher, dass git installiert ist, und führen den Befehl ''git clone git:/ /git.openslx.org/bwlp/setup-scripts.git'' aus. | |
| |
==== Start des Buildskripts ==== | |
| |
Wechseln Sie nach Ausführung des git-Befehls in das entstandene Verzeichnis setup-scripts/satellit_installer, und führen dort das Shellskript satellit_installer mit der Option –version „Versionsstring“ aus. Die Angabe eines Versionsstrings ist obligatorisch. Triggern Sie nach Ablauf des Skriptes einen Reboot, und fahren bei Kapitel 2, Einrichtung und Betrieb des Satellitenservers, fort. | |
| |
===== Kontakt ===== | |
| |
Das bwLehrpool-Team (bwEKlausuren) freut sich über Rückmeldungen, Anmerkungen, Kritik, Bugberichte und Komplimente nicht nur bezüglich dieses Handbuchs. | |
| |
Bitte wenden Sie sich bezüglich dieses Handbuchs an das Projektteam bwLehrpool / bwEKlausuren, [[support@bwlehrpool.de]]. | |
| |