Administration und Konfiguration unter Linux: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Start-Script
Dateien in
Werkzeuge in
Sed (Diskussion | Beiträge) |
Sed (Diskussion | Beiträge) |
||
| Zeile 1: | Zeile 1: | ||
__TOC__ | __TOC__ | ||
| − | Unter Linux sind keine graphischen Werkzeuge vorgesehen, da Linuxserver i.d.R. lediglich über die Console administriert werden. Typischerweise gibt es hier zum einen ein | + | Unter Linux sind keine graphischen Werkzeuge vorgesehen, da Linuxserver i.d.R. lediglich über die Console administriert werden. Typischerweise gibt es hier zum einen ein Start-Script, sowie einen Ordner mit Konfigurationen unter <code>/etc</code>. |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| + | ===Start-Script <code>$SITEPARK_HOME/bin/ies-sysd</code>=== | ||
Ist der IES-Prozess erfolgreich gestartet, wird in die Datei <code>/etc/sitepark/ies.pid</code> die PID des IES-Prozesses geschrieben. | Ist der IES-Prozess erfolgreich gestartet, wird in die Datei <code>/etc/sitepark/ies.pid</code> die PID des IES-Prozesses geschrieben. | ||
| − | Das | + | Das Start-Script dient zum Starten und Stoppen des IES-Prozesses. Es kann aber auch zur Abfrage weiterer Informationen verwendet werden. |
| − | Standardmäßig wird der [[IES]] mit der Konfigurationsdatei <code>$SITEPARK_HOME/conf/ies-server.xml</code> und der Lizenz-Datei <code>$SITEPARK_HOME/conf/ies-key.xml</code> gestartet | + | Standardmäßig wird der [[IES]] mit der Konfigurationsdatei <code>$SITEPARK_HOME/conf/ies-server.xml</code> und der Lizenz-Datei <code>$SITEPARK_HOME/conf/ies-key.xml</code> gestartet. |
| − | |||
| − | |||
| − | |||
| − | Folgende Steuer-Parameter stehen für das | + | Folgende Steuer-Parameter stehen für das Start-Script zur Verfügung: |
| − | ; | + | ;run: Startet den IES-Prozess nicht im Hintergrund. Die Standard-Ausgabe wird in der Konsole angezeigt. Der Prozess lässt sich mit Strg-C beenden. |
;start: Startet den IES-Prozess im Hintergrund. Das Script wird dennoch erst beendet, wenn der Server gestartet ist. Ein Abbrechen des Init-Scriptes mit Strg-C beendet nur das Script, nicht aber den IES-Prozess. | ;start: Startet den IES-Prozess im Hintergrund. Das Script wird dennoch erst beendet, wenn der Server gestartet ist. Ein Abbrechen des Init-Scriptes mit Strg-C beendet nur das Script, nicht aber den IES-Prozess. | ||
;stop: Stoppt den IES-Prozess. | ;stop: Stoppt den IES-Prozess. | ||
| Zeile 46: | Zeile 37: | ||
| Der IES-Prozess ist gestartet. Es ist aber ein Fehler aufgetreten | | Der IES-Prozess ist gestartet. Es ist aber ein Fehler aufgetreten | ||
|} | |} | ||
| − | ; | + | ;check: Gibt die aktuellen Parameter des Prozesses aus |
;pid: Liefert die PID des IES-Prozesses. | ;pid: Liefert die PID des IES-Prozesses. | ||
;kill: Schickt das <code>KILL</code> Signal an den IES-Prozess | ;kill: Schickt das <code>KILL</code> Signal an den IES-Prozess | ||
| − | ; | + | ;jstack: Sichert den Java-Stack des IES-Prozesses nach <code>$SITEPARK_HOME/ies.jstack</code> |
| − | |||
| − | |||
| − | |||
===Dateien in <code>/etc/sitepark</code>=== | ===Dateien in <code>/etc/sitepark</code>=== | ||
Version vom 21. September 2022, 08:52 Uhr
Unter Linux sind keine graphischen Werkzeuge vorgesehen, da Linuxserver i.d.R. lediglich über die Console administriert werden. Typischerweise gibt es hier zum einen ein Start-Script, sowie einen Ordner mit Konfigurationen unter /etc.
Start-Script $SITEPARK_HOME/bin/ies-sysd
Ist der IES-Prozess erfolgreich gestartet, wird in die Datei /etc/sitepark/ies.pid die PID des IES-Prozesses geschrieben.
Das Start-Script dient zum Starten und Stoppen des IES-Prozesses. Es kann aber auch zur Abfrage weiterer Informationen verwendet werden.
Standardmäßig wird der IES mit der Konfigurationsdatei $SITEPARK_HOME/conf/ies-server.xml und der Lizenz-Datei $SITEPARK_HOME/conf/ies-key.xml gestartet.
Folgende Steuer-Parameter stehen für das Start-Script zur Verfügung:
- run
- Startet den IES-Prozess nicht im Hintergrund. Die Standard-Ausgabe wird in der Konsole angezeigt. Der Prozess lässt sich mit Strg-C beenden.
- start
- Startet den IES-Prozess im Hintergrund. Das Script wird dennoch erst beendet, wenn der Server gestartet ist. Ein Abbrechen des Init-Scriptes mit Strg-C beendet nur das Script, nicht aber den IES-Prozess.
- stop
- Stoppt den IES-Prozess.
- restart
- Stoppt den IES-Prozess und startet ihn danach im Hindergrund neu. Wird das Init-Script während der Stop-Phase mit Strg-C beendet, wird das Stoppen des IES-Prozesses abgeschlossen ohne den IES-Prozess neu zu starten. Bei einem Stop in der Start-Phase wird nur das Init-Script beendet, nicht der IES-Prozess.
- status
- Liefert den aktuellen Status des IES. Folgende Stati sind möglich:
Status Beschreibung stopped Der IES oder der gesamte IES-Prozess ist gestoppt started Der IES ist gestartet busy Der IES ist zur Zeit nicht in der Lage den Status zurückzugeben unknown Der Status des IES ist unbekannt error: <message> Der IES-Prozess ist gestartet. Es ist aber ein Fehler aufgetreten
- check
- Gibt die aktuellen Parameter des Prozesses aus
- pid
- Liefert die PID des IES-Prozesses.
- kill
- Schickt das
KILLSignal an den IES-Prozess - jstack
- Sichert den Java-Stack des IES-Prozesses nach
$SITEPARK_HOME/ies.jstack
Dateien in /etc/sitepark
Im Folgenden wird die Bedeutung der im Verzeichnis /etc/sitepark liegenden Dateien beschrieben. Hierbei handelt es sich um einen sog. Symlink auf das Konfigurationsverzeichnis $SITEPARK_HOME/conf.
- ies-key.xml
- Verschlüsselte XML-Datei, die die Lizenz dieser IES-Instanz beinhaltet
- ies.pid
- Enthält die PID des gestarteten IES-Prozesses. Diese Datei wird nach einem erfolgreichen Aufruf von
/etc/init.d/ies stopgelöscht - ies-server.xml
- Zentrale Konfigurationsdatei des IES. Bei manuellen Änderungen dieser Datei muss sie über IES-Admin neu eingelesen werden
- Eine beispielhafte Konfiguration kann hier eingesehen werden.
- sitepark.conf
- Enthält Konfigurationen für das Systemd-Script:
- SITEPARK_HOME
- Installations-Verzeichnis des IES
- JAVA_HOME
- Vom IES verwendete Java-Installation
- IES_PID_FILE
- Name und Pfad der Datei, in der die PID des IES-Prozesses geschrieben werden soll
- IES_MEM_MAX
- Maximaler Speicher, der für den Java-Heap angefordert werden darf
- IES_MEM_INIT
- Speicher, der Initial für den Java-Heap angefordert wird
- IES_PERM_MAX
- Maximaler Speicher, der für den Java-Non-Heap angefordert werden darf
- IES_MIN_HEAD_RATIO
- Steuerung des Speicherverhaltens der JVM
- IES_MAX_HEAD_RATIO
- Steuerung des Speicherverhaltens der JVM
- IES_USER
- Nutzer, unter dem der IES gestartet wird
- IES_LANG
- Standard-Sprache, mit der der IES läuft
- IES_UMASK
- umask Setzungen für den Nutzer des IES
- IES_BIND_ADDRESS
- Die IP, auf die der IES gebunden werden soll. Standardmäßig ist dort
localhostkonfiguriert, um das System von Außen zu schützen. Wird dort0.0.0.0konfiguriert, so ist der Zugriff über das Netzwerk möglich. Informationen hierzu finden Sie auch unter Kategorie:Installation - IES_IMGFILE_DEFAULT_PROVIDER
- Konfiguration der Bildberechnungsroutine. Mögliche Werte sind
gfx(Standard unter Linux; Eigenentwicklung von Sitepark),gfxcmdAufruf der Bibliothek in einem eigenen Prozess (gfx muss konfiguriert sein),imagemagick
- version.properties
- Enthält die aktuelle Versionsnummer des IES
Werkzeuge in $SITEPARK_HOME/bin
Für die Administration und Steuerung des IES stehen unter $SITEPARK_HOME/bin noch einzelne BASH-Skripte zur Verfügung. Diese waren bis zum Release 2.5 in /usr/bin/ verlinkt. Dies ist aus Sicherheitsgründen umgestellt worden. Nun stehen die Skripte über die $PATH Variable zur Verfügung.
Damit diese auch über einen sudo Aufruf gefunden werden empfiehlt sich die Erweiterung der Datei /etc/sudoers um den folgenden Eintrag:
Defaults !secure_path
Der Aufruf ist grundsätzlich nur als Nutzer root oder ies erlaubt. Die Scripte selber setzen nur notwendige JAVA-Parameter zusammen. Die eigentliche Ausführung erfolgt in einem Java-Prozess.
Folgende Scripte sind verfügbar:
- iesadmin
- Standard-Werkzeug zur Administration des IES. Weitere Informationen gibt die Option
-hoder folgende Dokumentation: Kategorie:IES-Admin (commandline) - iesclient
- Werkzeug zu Steuerung von Eingaben in der Console. Es können beliebige Klassen zur Ausführung angegeben werden.
- iesxip
- Werkzeug für XIP-Importe und -Exporte; basiert auf iesclient