2.6. Der Task-Server

Der Task-Server ist ein Prozess, der im Hintergrund l�uft, in regelm��igen Abst�nden nach abzuarbeitenden Aufgaben sucht und diese zu festgelegten Zeitpunkten abarbeitet (�hnlich wie Cron). Dieser Prozess wird bisher nur f�r die Erzeugung der wiederkehrenden Rechnungen benutzt, wird aber in Zukunft deutlich mehr Aufgaben �bertragen bekommen.

2.6.1. Verf�gbare und notwendige Konfigurationsoptionen

Die Konfiguration erfolgt �ber den Abschnitt [task_server] in der Datei config/lx_office.conf. Die dort verf�gbaren Optionen sind:

login

g�ltiger Lx-Office-Benutzername, der benutzt wird, um die zu verwendende Datenbankverbindung auszulesen. Der Benutzer muss in der Administration angelegt werden. Diese Option muss angegeben werden.

run_as

Wird der Server vom Systembenutzer root gestartet, so wechselt er auf den mit run_as angegebenen Systembenutzer. Der Systembenutzer muss dieselben Lese- und Schreibrechte haben, wie auch der Webserverbenutzer (siehe see Manuelle Installation des Programmpaketes). Daher ist es sinnvoll, hier denselben Systembenutzer einzutragen, unter dem auch der Webserver l�uft.

debug

Schaltet Debug-Informationen an und aus.

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

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

Kopieren Sie die Datei scripts/boot/system-v/lx-office-task-server nach /etc/init.d/lx-office-task-server. Passen Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile DAEMON=....). Binden Sie das Script in den Boot-Prozess ein. Dies ist distributionsabh�ngig:

  • Debian-basierende Systeme:

    update-rc.d lx-office-task-server defaults
    # Nur bei Debian Squeeze und neuer:
    insserv lx-office-task-server
  • OpenSuSE und Fedora Core:

    chkconfig --add lx-office-task-server

Danach kann der Task-Server mit dem folgenden Befehl gestartet werden: /etc/init.d/lx-office-task-server start

2.6.2.2. Upstart-basierende Systeme (z.B. Ubuntu)

Kopieren Sie die Datei scripts/boot/upstart/lx-office-task-server.conf nach /etc/init/lx-office-task-server.conf. Passen Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile exec ....).

Danach kann der Task-Server mit dem folgenden Befehl gestartet werden: service lx-office-task-server start

2.6.3. Wie der Task-Server gestartet und beendet wird

Der Task-Server wird wie folgt kontrolliert:

./scripts/task_server.pl Befehl

Befehl ist dabei eine der folgenden Optionen:

  • start startet eine neue Instanz des Task-Servers. Die Prozess-ID wird innerhalb des users-Verzeichnisses abgelegt.

  • stop beendet einen laufenden Task-Server.

  • restart beendet und startet ihn neu.

  • status berichtet, ob der Task-Server l�uft.

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