Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
satellite:generisches_modul [2020/08/05 16:02 CEST] srittersatellite:generisches_modul [2024/02/21 13:06 CET] (aktuell) – [Generisches Modul / Konfigmodul] sritter
Zeile 2: Zeile 2:
  
 'Generische Module' ermöglichen es, beliebige Dateien in das Linux-Grundsystem der Clients einzubringen bzw. vorhandene Dateien zu überschreiben. Notwendig ist dies, wenn Sie z.B. spezielle iptables-Regeln, Druckkonfigurationen oder ähnliche Anpassungen innerhalb des Grundsystems vornehmen möchten.  'Generische Module' ermöglichen es, beliebige Dateien in das Linux-Grundsystem der Clients einzubringen bzw. vorhandene Dateien zu überschreiben. Notwendig ist dies, wenn Sie z.B. spezielle iptables-Regeln, Druckkonfigurationen oder ähnliche Anpassungen innerhalb des Grundsystems vornehmen möchten. 
 +
 +<note warning>Wenn Sie bestehende Systemdateien des Grundsystems mit Hilfe eines generischen Moduls überschreiben, können Inkompatibilitäten mit neueren Versionen des Grundsystems auftreten. Dies sollte daher nur für spezielle Fälle und lediglich temporär erfolgen. Prüfen Sie in jedem Fall beim Update auf eine neuere Version, ob Ihr generisches Modul noch notwendig ist und entfernen Sie dieses ggf. wieder!</note>
 +
  
 Um Generische Module anzulegen sind folgende Schritte nötig: Um Generische Module anzulegen sind folgende Schritte nötig:
Zeile 48: Zeile 51:
 Dieses tgz-Archiv kann dann im nächsten Schritt als Generisches Modul auf den Satellitenserver geladen werden. Dieses tgz-Archiv kann dann im nächsten Schritt als Generisches Modul auf den Satellitenserver geladen werden.
  
-<note important>Das Archiv wird im MiniLinux über das Rootverzeichnis entpackt. Achten Sie darauf, dass Sie für Ihre Ordner und Dateien korrekte Berechtigungen setzen.\\ \\ Sie können Archive wie oben beschrieben auch unter Windows erstellen. Beachten Sie jedoch unbedingt, daß manche Windows-Packer dazu tendieren, bei Erstellung eines Archives im .tar- oder .tar.gz-Format, die Datei- und Verzeichnisberechtigungen („Permissions“) innerhalb des Archivs unerwünscht zu setzen((Beispiel: Ein mit 7zip erstelltes Archiv zur etc-Hierarchie enthielt (/)etc mit den Berechtigungen 777, was für SSH störende Auswirkungen hat (Schlüsselablehnung). )). Überprüfen Sie daher im Zweifelsfall resultierende Verzeichnis- und Dateirechte per Archivansicht oder auf einem Clientrechner!</note>+<note important>Das Archiv wird im Dateisystem des Clientrechner über das Rootverzeichnis (/) entpackt. Achten Sie darauf, dass Sie für Ihre Ordner und Dateien korrekte Berechtigungen setzen.\\ \\ Sie können Archive wie oben beschrieben auch unter Windows erstellen. Beachten Sie jedoch unbedingt, daß manche Windows-Packer dazu tendieren, bei Erstellung eines Archives im .tar- oder .tar.gz-Format, die Datei- und Verzeichnisberechtigungen („Permissions“) innerhalb des Archivs unerwünscht zu setzen((Beispiel: Ein mit 7zip erstelltes Archiv zur etc-Hierarchie enthielt (/)etc mit den Berechtigungen 777, was für SSH störende Auswirkungen hat (Schlüsselablehnung). )). Überprüfen Sie daher im Zweifelsfall resultierende Verzeichnis- und Dateirechte per Archivansicht oder auf einem Clientrechner!</note>
  
  
Zeile 57: Zeile 60:
 Erzeugen Sie zuerst die nötigen Unterverzeichnisse, wie oben auf Ihr Arbeitsverzeichnis gen_modul bezogen: Erzeugen Sie zuerst die nötigen Unterverzeichnisse, wie oben auf Ihr Arbeitsverzeichnis gen_modul bezogen:
 <code bash> <code bash>
-mkdir -p etc/systemd/system/multi-user.target+mkdir -p etc/systemd/system/multi-user.target.wants
 </code> </code>
  
Zeile 69: Zeile 72:
 Type=oneshot Type=oneshot
 ExecStart=/Pfad/zu/Ihrem/Programm ExecStart=/Pfad/zu/Ihrem/Programm
- +RemainAfterExit=true
-[Install] +
-WantedBy=multi-user.target+
 </code> </code>
  
Zeile 77: Zeile 78:
  
 <code bash> <code bash>
-cd etc/systemd/system/multi-user.target+cd etc/systemd/system/multi-user.target.wants
 ln -s ../programmstart.service ln -s ../programmstart.service
 cd - cd -
Zeile 87: Zeile 88:
 ===== 2. Neues Modul hochladen ===== ===== 2. Neues Modul hochladen =====
  
-Das Archiv muss anschließend über das Webinterface Ihres Satellitenservers hochgeladen werden. Wechseln Sie dazu zur Seite 'Lokalisierung + Integration' und wählen 'Neues Modul'Dort können Sie als letzten Punkt ein 'Generisches Modulhinzufügen. Wählen Sie dort Ihr vorbereitetes Archiv aus und vergeben einen eindeutigen Namen. Nach dem Hochladen wird zur Kontrolle der Inhalt des Archivs angezeigt.+[{{ :satellite:handbuch:wizards:sat_systemkonfig_konfigmodul_gen_modul_rechte.png?300|Modulname und Anzeige Datei-Benutzerrechte}}] 
 +[{{ :satellite:handbuch:wizards:sat_systemkonfig_konfigmodul_gen_modul_zuordnung.png?300|Vorschläge Systemkonfigurationen}}] 
 +Das Archiv muss anschließend über das Webinterface Ihres Satellitenservers hochgeladen werden. Wechseln Sie dazu zur Unterseite „Lokalisierung + Integratio„“ und klicken rechts unten unter der Spalte „Verfügbare Konfigurationsmodule“ auf die Schaltfläche „Neues ModulIn der folgenden Anzeige „Modul hinzufügen“ erscheint als letzter Punkt Generisches Modul“. Klicken Sie dort auf „hinzufügen. Wählen Sie dort per „Durchsuchen…“ Ihr vorbereitetes Archiv aus drücken anschließend auf „Hochladen.
  
-<note important>Denken Sie darandass Sie das Modul noch der aktiven Systemkonfiguration zuweisen müssenAnsonsten wird dieses nicht verwendet!</note>+Nach dem Hochladen erscheint eine mit dem Archivdateinamen vorausgefüllte Eingabemöglichkeit für den Modulnamen; vergeben Sie einen sprechendeneindeutigen Namen. Darunter erhalten Sie zur Kontrolle den Inhalt des Archivs angezeigt. Falls die Dateien des Archivs nicht dem User root und der Gruppe root zugehörig sind, erscheint eine Warnmeldung und die vorausgewählte Option, die Besitzrechte der Dateien auf root:root zu setzen. Da anderen User/Gruppe zugeordnete Dateien sind nur in seltenen Fällen angebracht sind, ist im Allgemeinen empfohlen, die Rechte so zu übertragen. 
 + 
 +Nach Klick auf „Weiter“ werden die bereits bestehenden Systemkonfigurationen aufgelistet. Sie können das soeben erzeugte generische Modul bequem mit einem Klick der Systemkonfiguration Ihrer Wahl zuweisen. Eine Zuordnung ist jedoch nicht obligatorisch; Sie können das gen. Modul auch später noch zuweisen. 
 + 
 +<note important>Vergessen Sie jedoch die Zuordnung zu einer Systemkonfiguration nicht - ein nicht zugeordnetes Modul wird nicht ausgeliefert!</note>
 ===== 3. Client neustarten und überprüfen ===== ===== 3. Client neustarten und überprüfen =====
  
Zeile 98: Zeile 105:
  
  
 +([[satellitenserver_erstkonfiguration#konfigurationsmodule_erstellen|zurück zur Systemkonfiguration]])
Drucken/exportieren