projekt kivitendo

* Der Task-Server:: Konfiguration und Einrichtung des Task-Server-Dämonen

@node Der Task-Server

@chapter Der Task-Server

Der Task-Server ist ein Dämonen, der im Hintergrund läuft, in

regelmäßigen Abständen nach abzuarbeitenden Aufgaben sucht und diese

zu festgelegten Zeitpunkten abarbeitet (ähnlich wie Cron). Dieser

Dämon wird bisher nur für die Erzeugung der wiederkehrenden Rechnungen

benutzt, wird aber in Zukunft deutlich mehr Aufgaben übertragen

bekommen.

@menu

* Konfiguration des Task-Servers:: Verfügbare und notwendige Konfigurationsoptionen

* Prozesskontrolle:: Wie der Task-Server gestartet und beendet wird

* Einbinden in den Boot-Prozess:: Automatisches Starten des Task-Servers beim Booten

@end menu

@node Konfiguration des Task-Servers

@section Verfügbare und notwendige Konfigurationsoptionen

Die Konfiguration erfolgt über den Abschnitt @code{[task_server]} in

der Datei @file{config/lx_office.conf}. Die dort verfügbaren Optionen

sind:

@itemize

@item @code{login}: Benutzername, der benutzt wird, um die zu verwendende Datenbankverbindung auszulesen. Der Benutzer muss in der Administration angelegt werden. Diese Option muss angegeben werden.

@item @code{run_as}: Wird der Server von @code{root} gestartet, so wechselt er auf diesen Systembenutzer. Der Systembenutzer muss dieselben Lese- und Schreibrechte haben, wie auch der Webserverbenutzer (siehe @pxref{Manuelle Installation des Programmpaketes}). Daher ist es sinnvoll, hier denselben Systembenutzer einzutragen, unter dem auch der Webserver läuft.

@item @code{debug}: Schaltet Debug-Informationen an und aus.

@end itemize

@node Einbinden in den Boot-Prozess

@section Automatisches Starten des Task-Servers beim Booten

Der Task-Server verhält sich von seinen Optionen her wie ein reguläres

SystemV-kompatibles Boot-Script. Außerdem wechselt er beim Starten

automatisch in das Lx-Office-Installationsverzeichnis.

Deshalb ist es möglich, ihn durch Setzen eines symbolischen Links aus

einem der Runlevel-Verzeichnisse heraus in den Boot-Prozess

einzubinden. Da das bei neueren Linux-Distributionen aber nicht

zwangsläufig funktioniert, werden auch Start-Scripte mitgeliefert, die

anstelle eines symbolischen Links verwendet werden können.

@subsection SystemV-basierende Systeme (z.B. Debian, OpenSuSE, Fedora Core)

Kopieren Sie die Datei

@file{scripts/boot/system-v/lx-office-task-server} nach

@file{/etc/init.d/lx-office-task-server}. Passen Sie in der kopierten

Datei den Pfad zum Task-Server an (Zeile @code{DAEMON=....}). Binden

Sie das Script in den Boot-Prozess ein. Dies ist distributionsabhängig:

@itemize

@item Debian-basierende Systeme:

@*

@code{update-rc.d lx-office-task-server defaults

@*

# Nur bei Debian Squeeze und neuer:

@*

insserv lx-office-task-server}

@item OpenSuSE und Fedora Core:

@*

@code{chkconfig --add lx-office-task-server}

@end itemize

Danach kann der Task-Server mit dem folgenden Befehl gestartet werden:

@code{/etc/init.d/lx-office-task-server start}

@subsection Upstart-basierende Systeme (z.B. Ubuntu)

Kopieren Sie die Datei

@file{scripts/boot/upstart/lx-office-task-server.conf} nach

@file{/etc/init/lx-office-task-server.conf}. Passen Sie in der kopierten

Datei den Pfad zum Task-Server an (Zeile @code{exec ....}).

Danach kann der Task-Server mit dem folgenden Befehl gestartet werden:

@code{service lx-office-task-server start}

@node Prozesskontrolle

@section Wie der Task-Server gestartet und beendet wird

Der Task-Server wird wie folgt kontrolliert:

@code{./scripts/task_server.pl Befehl}

@code{Befehl} ist dabei eine der folgenden Optionen:

@itemize

@item @code{start} startet eine neue Instanz des Task-Servers. Die Prozess-ID wird innerhalb des @file{users}-Verzeichnisses abgelegt.

@item @code{stop} beendet einen laufenden Task-Server.

@item @code{restart} beendet und startet ihn neu.

@item @code{status} berichtet, ob der Task-Server läuft.

@end itemize

Der Task-Server wechselt beim Starten automatisch in das Lx-Office-Installationsverzeichnis.

Dieselben Optionen können auch für die SystemV-basierenden

Runlevel-Scripte benutzt werden (siehe oben).

@c ---------------------------------------------------------------

Konfigurationsdatei @file{config/lx_office.conf} festgelegt. Diese

@file{config/lx_office.conf.default} existiert, die als Vorlage

Nachdem alle Einstellungen in @file{config/lx_office.conf}

@file{config/lx_office.conf} eingetragen haben.

@file{config/lx_office.conf} die Variable @code{dbcharset} im

@file{config/lx_office.conf} die Variable @code{opendocument} im

Weiterhin muss in der Datei @file{config/lx_office.conf} die Variable

Nach der Installation müssen in der Datei @file{config/lx_config.conf}