Quelltext der Seite Administration und Konfiguration unter Linux

__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 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.

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.

Folgende Steuer-Parameter stehen für das Start-Script zur Verfügung:

;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:
:{| class="prettytable"
|- class="hintergrundfarbe1"
! 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 <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>===
Im Folgenden wird die Bedeutung der im Verzeichnis <code>/etc/sitepark</code> liegenden Dateien beschrieben. Hierbei handelt es sich um einen sog. Symlink auf das Konfigurationsverzeichnis <code>$SITEPARK_HOME/conf</code>.

;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 <code>/etc/init.d/ies stop</code> gelö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 [[IES_Konfiguration#Beispiel_einer_ies-server.xml|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 <code>localhost</code> konfiguriert, um das System von Außen zu schützen. Wird dort <code>0.0.0.0</code> konfiguriert, 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 <code>gfx</code> (Standard unter Linux; Eigenentwicklung von Sitepark), <code>gfxcmd</code> Aufruf der Bibliothek in einem eigenen Prozess (gfx muss konfiguriert sein), <code>imagemagick</code>
;version.properties: Enthält die aktuelle Versionsnummer des IES

===Werkzeuge in <code>$SITEPARK_HOME/bin</code>===
Für die Administration und Steuerung des [[IES]] stehen unter <code>$SITEPARK_HOME/bin</code> noch einzelne BASH-Skripte zur Verfügung. Diese waren bis zum Release 2.5 in <code>/usr/bin/</code> verlinkt. Dies ist aus Sicherheitsgründen umgestellt worden. Nun stehen die Skripte über die <code>$PATH</code> Variable zur Verfügung.

Damit diese auch über einen <code>sudo</code> Aufruf gefunden werden empfiehlt sich die Erweiterung der Datei <code>/etc/sudoers</code> um den folgenden Eintrag:
 Defaults !secure_path

Der Aufruf ist grundsätzlich nur als Nutzer <code>root</code> oder <code>ies</code> 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 <code>-h</code> oder 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''

<noinclude>
[[Kategorie:Administration und Konfiguration]]
</noinclude>