+<!-- -->
+<div class="node">
+<a name="Der-Task-Server"></a>
+<a name="Der-Task_002dServer"></a>
+<p><hr>
+nächstes: <a rel="next" accesskey="n" href="#Benutzerauthentifizierung-und-Administratorpasswort">Benutzerauthentifizierung und Administratorpasswort</a>,
+voriges: <a rel="previous" accesskey="p" href="#Apache_002dKonfiguration">Apache-Konfiguration</a>,
+aufwärts: <a rel="up" accesskey="u" href="#Top">Top</a>
+
+</div>
+
+<h2 class="chapter">6 Der Task-Server</h2>
+
+<p>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.
+
+<ul class="menu">
+<li><a accesskey="1" href="#Konfiguration-des-Task_002dServers">Konfiguration des Task-Servers</a>: Verfügbare und notwendige Konfigurationsoptionen
+<li><a accesskey="2" href="#Prozesskontrolle">Prozesskontrolle</a>: Wie der Task-Server gestartet und beendet wird
+<li><a accesskey="3" href="#Einbinden-in-den-Boot_002dProzess">Einbinden in den Boot-Prozess</a>: Automatisches Starten des Task-Servers beim Booten
+</ul>
+
+<div class="node">
+<a name="Konfiguration-des-Task-Servers"></a>
+<a name="Konfiguration-des-Task_002dServers"></a>
+<p><hr>
+nächstes: <a rel="next" accesskey="n" href="#Prozesskontrolle">Prozesskontrolle</a>,
+aufwärts: <a rel="up" accesskey="u" href="#Der-Task_002dServer">Der Task-Server</a>
+
+</div>
+
+<h3 class="section">6.1 Verfügbare und notwendige Konfigurationsoptionen</h3>
+
+<p>Die Konfiguration erfolgt über den Abschnitt <code>[task_server]</code> in
+der Datei <samp><span class="file">config/lx_office.conf</span></samp>. Die dort verfügbaren Optionen
+sind:
+
+ <ul>
+<li><code>login</code>: 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.
+<li><code>run_as</code>: Wird der Server vom Systembenutzer <code>root</code> gestartet, so wechselt er auf den mit <code>run_as</code> angegebenen Systembenutzer. Der Systembenutzer muss dieselben Lese- und Schreibrechte haben, wie auch der Webserverbenutzer (siehe see <a href="#Manuelle-Installation-des-Programmpaketes">Manuelle Installation des Programmpaketes</a>). Daher ist es sinnvoll, hier denselben Systembenutzer einzutragen, unter dem auch der Webserver läuft.
+<li><code>debug</code>: Schaltet Debug-Informationen an und aus.
+</ul>
+
+<div class="node">
+<a name="Einbinden-in-den-Boot-Prozess"></a>
+<a name="Einbinden-in-den-Boot_002dProzess"></a>
+<p><hr>
+voriges: <a rel="previous" accesskey="p" href="#Prozesskontrolle">Prozesskontrolle</a>,
+aufwärts: <a rel="up" accesskey="u" href="#Der-Task_002dServer">Der Task-Server</a>
+
+</div>
+
+<h3 class="section">6.2 Automatisches Starten des Task-Servers beim Booten</h3>
+
+<p>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.
+
+ <p>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.
+
+<h4 class="subsection">6.2.1 SystemV-basierende Systeme (z.B. Debian, OpenSuSE, Fedora Core)</h4>
+
+<p>Kopieren Sie die Datei
+<samp><span class="file">scripts/boot/system-v/lx-office-task-server</span></samp> nach
+<samp><span class="file">/etc/init.d/lx-office-task-server</span></samp>. Passen Sie in der kopierten
+Datei den Pfad zum Task-Server an (Zeile <code>DAEMON=....</code>). Binden
+Sie das Script in den Boot-Prozess ein. Dies ist distributionsabhängig:
+
+ <ul>
+<li>Debian-basierende Systeme:
+<br>
+<code>update-rc.d lx-office-task-server defaults
+<br>
+# Nur bei Debian Squeeze und neuer:
+<br>
+insserv lx-office-task-server</code>
+<li>OpenSuSE und Fedora Core:
+<br>
+<code>chkconfig --add lx-office-task-server</code>
+</ul>
+
+ <p>Danach kann der Task-Server mit dem folgenden Befehl gestartet werden:
+<code>/etc/init.d/lx-office-task-server start</code>
+
+<h4 class="subsection">6.2.2 Upstart-basierende Systeme (z.B. Ubuntu)</h4>
+
+<p>Kopieren Sie die Datei
+<samp><span class="file">scripts/boot/upstart/lx-office-task-server.conf</span></samp> nach
+<samp><span class="file">/etc/init/lx-office-task-server.conf</span></samp>. Passen Sie in der kopierten
+Datei den Pfad zum Task-Server an (Zeile <code>exec ....</code>).
+
+ <p>Danach kann der Task-Server mit dem folgenden Befehl gestartet werden:
+<code>service lx-office-task-server start</code>
+
+<div class="node">
+<a name="Prozesskontrolle"></a>
+<p><hr>
+nächstes: <a rel="next" accesskey="n" href="#Einbinden-in-den-Boot_002dProzess">Einbinden in den Boot-Prozess</a>,
+voriges: <a rel="previous" accesskey="p" href="#Konfiguration-des-Task_002dServers">Konfiguration des Task-Servers</a>,
+aufwärts: <a rel="up" accesskey="u" href="#Der-Task_002dServer">Der Task-Server</a>
+
+</div>
+
+<h3 class="section">6.3 Wie der Task-Server gestartet und beendet wird</h3>
+
+<p>Der Task-Server wird wie folgt kontrolliert:
+
+ <p><code>./scripts/task_server.pl Befehl</code>
+
+ <p><code>Befehl</code> ist dabei eine der folgenden Optionen:
+
+ <ul>
+<li><code>start</code> startet eine neue Instanz des Task-Servers. Die Prozess-ID wird innerhalb des <samp><span class="file">users</span></samp>-Verzeichnisses abgelegt.
+<li><code>stop</code> beendet einen laufenden Task-Server.
+<li><code>restart</code> beendet und startet ihn neu.
+<li><code>status</code> berichtet, ob der Task-Server läuft.
+</ul>
+
+ <p>Der Task-Server wechselt beim Starten automatisch in das Lx-Office-Installationsverzeichnis.
+
+ <p>Dieselben Optionen können auch für die SystemV-basierenden
+Runlevel-Scripte benutzt werden (siehe oben).
+
projects / kivitendo-erp.git / blobdiff