projekt kivitendo

<?xml version="1.0" encoding="utf-8"?>

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"

"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<chapter id="Aktuelle-Hinweise">

<title>Aktuelle Hinweise</title>

<para>Aktuelle Installations- und Konfigurationshinweise gibt es:</para>

<itemizedlist>

<listitem>

<para>auf der Lx-Office-Homepage unter <ulink

url="http://lx-office.org/index.php?id=dokumentation">http://lx-office.org/index.php?id=dokumentation</ulink></para>

</listitem>

<listitem>

<para>im Lx-Office-Wiki unter Dokumentation (<ulink

url="http://wiki.lx-office.org/index.php/Lx-Office_ERP">http://wiki.lx-office.org/index.php/Lx-Office_ERP</ulink>)</para>

</listitem>

<listitem>

<para>im Lx-Office-Forum: <ulink

url="http://www.lx-office.org/forum/">http://www.lx-office.org/forum/</ulink></para>

</listitem>

</itemizedlist>

</chapter>

<sect1 id="Benötigte-Software-und-Pakete">

<title>Benötigte Software und Pakete</title>

<sect2 id="Betriebssystem">

<title>Betriebssystem</title>

<para>Lx-Office ist für Linux konzipiert, und sollte auf jedem

unixoiden Betriebssystem zum Laufen zu kriegen sein. Getestet ist

diese Version im speziellen auf Debian und Ubuntu, grundsätzlich wurde

bei der Auswahl der Pakete aber darauf Rücksicht genommen, dass es

ohne große Probleme auf den derzeit aktuellen verbreiteten

Distributionen läuft.</para>

<itemizedlist>

<listitem>

<listitem>

<listitem>

<listitem>

<para>SuSE Linux Enterprice Server 11</para>

</listitem>

<listitem>

</itemizedlist>

<para>Ubuntu 8.04 LTS hat zusätzlich die Schwierigkeit, dass die

Module im Archiv recht alt sind, und das viele der benötigten Module

nicht einfach zu installieren sind. Dafür sollte es kurz nach dem

Release ein eigenes .deb geben.</para>

<para>Alternativ dazu kann die normale Installation durchgeführt

werden (siehe <xref

linkend="Manuelle-Installation-des-Programmpaketes"/>), wenn vorher

ein Kompatibilitätspaket installiert wird, das die fehlenden Pakete

bereitstellt. Das Paket ist auf <ulink

url="https://sourceforge.net/projects/lx-office/files/Lx-Office%20ERP/2.6.2/">Sourceforge</ulink>

unter dem Namen <filename>lx-erp-perl-libs-compat-v2.tar.gz</filename>

hinterlegt.</para>

<para>Zur Installation das Paket in das entpackte Lx-Office

Verzeichnis entpacken:</para>

<para>Zusätzlich müssen dann noch die folgenden Pakete installiert

weerden</para>

<para>Danach sollte der Installationscheck (siehe <xref

linkend="Pakete"/>) die enthaltenen Pakete erkennen.</para>

</sect2>

<sect2 id="Pakete" xreflabel="Pakete">

<title>Pakete</title>

<para>Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist

Apache) und ein Datenbankserver (PostgreSQL, mindestens v8.2)

benötigt.</para>

<para>Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die

nicht Bestandteil einer Standard-Perl-Installation sind:</para>

<itemizedlist>

<listitem>

<para>parent</para>

</listitem>

<listitem>

<para>Archive::Zip</para>

</listitem>

<listitem>

<para>Config::Std</para>

</listitem>

<listitem>

<para>DateTime</para>

</listitem>

<listitem>

<para>DBI</para>

</listitem>

<listitem>

<para>DBD::Pg</para>

</listitem>

<listitem>

<para>Email::Address</para>

</listitem>

<listitem>

<para>JSON</para>

</listitem>

<listitem>

<para>List::MoreUtils</para>

</listitem>

<listitem>

<para>Params::Validate</para>

</listitem>

<listitem>

<para>PDF::API2</para>

</listitem>

<listitem>

<para>Rose::Object</para>

</listitem>

<listitem>

<para>Rose::DB</para>

</listitem>

<listitem>

<para>Rose::DB::Object</para>

</listitem>

<listitem>

<para>Template</para>

</listitem>

<listitem>

<para>Text::CSV_XS</para>

</listitem>

<listitem>

<para>Text::Iconv</para>

</listitem>

<listitem>

<para>URI</para>

</listitem>

<listitem>

<para>XML::Writer</para>

</listitem>

<listitem>

<para>YAML</para>

</listitem>

</itemizedlist>

<para>Gegenüber Version 2.6.0 sind zu dieser Liste 2 Pakete

hinzugekommen, <literal>URI</literal> und

<literal>XML::Writer</literal> sind notwendig. Ohne startet Lx-Office

nicht.</para>

<para>Gegenüber Version 2.6.1 sind <literal>parent</literal>,

<literal>DateTime</literal>, <literal>Rose::Object</literal>,

<literal>Rose::DB</literal> und <literal>Rose::DB::Object</literal>

neu hinzugekommen. <literal>IO::Wrap</literal> wurde entfernt.</para>

<para>Gegenüber Version 2.6.3 ist <literal>JSON</literal> neu

hinzugekommen.</para>

<para><literal>Email::Address</literal> und

<literal>List::MoreUtils</literal> sind schon länger feste

Abhängigkeiten, wurden aber bisher mit Lx-Office mitgeliefert. Beide

sind auch in 2.6.1 weiterhin mit ausgeliefert, wurden in einer

zukünftigen Version aber aus dem Paket entfernt werden. Es wird

empfohlen diese Module zusammen mit den anderen als Bibliotheken zu

installieren.</para>

<para>Die zu installierenden Pakete können in den verschiedenen

Distributionen unterschiedlich heißen.</para>

<para>Für Debian oder Ubuntu benötigen Sie diese Pakete:</para>

libdatetime-perl libdbi-perl libdbd-pg-perl libpg-perl \

libemail-address-perl liblist-moreutils-perl libpdf-api2-perl \

librose-object-perl librose-db-perl librose-db-object-perl \

libtemplate-perl libtext-csv-xs-perl libtext-iconv-perl liburi-perl \

libxml-writer-perl libyaml-perl libconfig-std-perl \

libparams-validate-perl libjson-perl</programlisting>

<para>Für Fedora Core benötigen Sie diese Pakete:</para>

perl-DBI perl-DBD-Pg perl-Email-Address perl-List-MoreUtils \

perl-PDF-API2 perl-Rose-Object perl-Rose-DB perl-Rose-DB-Object \

perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv perl-URI \

perl-XML-Writer perl-YAML</programlisting>

<para>Für OpenSuSE benötigen Sie diese Pakete:</para>

perl-DateTime perl-DBI perl-DBD-Pg perl-MailTools perl-List-MoreUtils \

perl-PDF-API2 perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv \

perl-URI perl-XML-Writer perl-YAML</programlisting>

<para>Bei openSuSE 11 ist <literal>parent</literal> bereits enthalten,

und braucht nicht nachinstalliert werden. Die

<literal>Rose::*</literal> Pakete sind derzeit nicht für SuSE gepackt,

und müssen anderweitig nachinstalliert werden.</para>

<para>Lx-Office enthält ein Script, mit dem überprüft werden kann, ob

alle benötigten Perl-Module installiert sind. Der Aufruf lautet wie

folgt:</para>

<programlisting>./scripts/installation_check.pl</programlisting>

</sect2>

</sect1>

<sect1 id="Manuelle-Installation-des-Programmpaketes"

xreflabel="Manuelle Installation des Programmpaketes">

<title>Manuelle Installation des Programmpaketes</title>

<filename>/var/www/html/</filename>,

<filename>/srv/www/htdocs</filename> oder

<filename>/var/www/</filename>) entpackt:</para>

<programlisting>cd /var/www tar xvzf

lxoffice-erp-2.6.2.tgz</programlisting>

<para>Verändern Sie evtl. noch den Namen des Verzeichnisses mit</para>

<programlisting>mv lxoffice-erp/ lx-erp/</programlisting>

<para>Alternativ können Sie auch einen Alias in der

Webserverkonfiguration benutzen, um auf das tatsächliche

Installationsverzeichnis zu verweisen.</para>

<para>Die Verzeichnisse <filename>users</filename>,

<filename>spool</filename> und <filename>webdav</filename> müssen für

den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die

restlichen Dateien müssen für diesen Benutzer lesbar sein. Der

Benutzername ist bei verschiedenen Distributionen unterschiedlich (z.B.

bei Debian/Ubuntu <constant>www-data</constant>, bei Fedora core

<constant>apache</constant> oder bei OpenSuSE

<constant>wwwrun</constant>).</para>

<para>Der folgende Befehl ändert den Besitzer für die oben genannten

Verzeichnisse auf einem Debian/Ubuntu-System:</para>

<programlisting>chown -R www-data lx-office-erp/users lx-office-erp/spool lx-office-erp/webdav</programlisting>

<para>Weiterhin muss der Webserver-Benutzer im Verzeichnis

<filename>templates</filename> Verzeichnisse für jeden neuen Benutzer,

der in lx-office angelegt wird, anlegen dürfen:</para>

<programlisting>chgrp www-data lx-office-erp/templates

chmod g+w lx-office-erp/templates</programlisting>

</sect1>

<sect1 id="config.config-file">

<title>Lx-Office-Konfigurationsdatei</title>

<sect2 id="config.config-file.introduction" xreflabel="Einführung in die Konfigurationsdatei">

<title>Einführung</title>

<para>

Seit Lx-Office 2.6.3. gibt es nur noch eine Konfigurationsdatei die benötigt wird: <filename>config/lx_office.conf</filename> (kurz:

"die Hauptkonfigurationsdatei"). Diese muss bei der Erstinstallation von Lx-Office bzw. der Migration von älteren Versionen angelegt

werden.

</para>

<para>

Als Vorlage dient die Datei <filename>config/lx_office.conf.default</filename> (kurz: "die Default-Datei"):

</para>

<programlisting>$ cp config/lx_office.conf.default config/lx_office.conf</programlisting>

<para>

Die Default-Datei wird immer zuerst eingelesen. Werte, die in der Hauptkonfigurationsdatei stehen, überschreiben die

Werte aus der Default-Datei. Die Hauptkonfigurationsdatei muss also nur die Abschintte und Werte

enthalten, die von denen der Default-Datei abweichen.

</para>

<para>

Diese Hauptkonfigurationsdatei ist dann eine installationsspezifische Datei, d.h. sie enthält bspw. lokale Passwörter und wird auch

nicht im Versionsmanagement (git) verwaltet.

</para>

<para>

Die Konfiguration ist ferner serverabhängig, d.h. für alle Mandaten, bzw. Datenbanken gleich.

</para>

</sect2>

<sect2 id="config.config-file.sections-parameters">

<title>Abschnitte und Parameter</title>

<para>

Die Konfigurationsdatei besteht aus mehreren Teilen, die entsprechend kommentiert sind:

</para>

<itemizedlist>

<listitem><para><literal>authentication</literal></para></listitem>

<listitem><para><literal>authentication/database</literal></para></listitem>

<listitem><para><literal>authentication/ldap</literal></para></listitem>

<listitem><para><literal>system</literal></para></listitem>

<listitem><para><literal>features</literal></para></listitem>

<listitem><para><literal>paths</literal></para></listitem>

<listitem><para><literal>applications</literal></para></listitem>

<listitem><para><literal>environment</literal></para></listitem>

<listitem><para><literal>print_templates</literal></para></listitem>

<listitem><para><literal>task_server</literal></para></listitem>

<listitem><para><literal>periodic_invoices</literal></para></listitem>

<listitem><para><literal>console</literal></para></listitem>

<listitem><para><literal>debug</literal></para></listitem>

</itemizedlist>

<para>

Die üblicherweise wichtigsten Parameter, die am Anfang einzustellen oder zu kontrollieren sind, sind:

</para>

<programlisting>[authentication]

admin_password = geheim

[authentication/database]

host = localhost

port = 5432

db = lxerp_auth

user = postgres

password =

[system]

eur = 1

dbcharset = UTF-8</programlisting>

<para>

</para>

<para>

<para>

</sect2>

<sect2 id="config.config-file.prior-versions">

<title>Versionen vor 2.6.3</title>

<para>

In älteren Lx-Office Versionen gab es im Verzeichnis <filename>config</filename> die Dateien <filename>authentication.pl</filename>

und <filename>lx-erp.conf</filename>, die jeweils Perl-Dateien waren. Es gab auch die Möglichkeit, eine lokale Version der

</para>

<para>

Beim Update von einer Lx-Office-Version vor 2.6.3 auf 2.6.3 oder jünger müssen die Einstellungen aus den alten Konfigurationsdateien

manuell übertragen und die alten Konfigurationsdateien anschließend gelöscht oder verschoben werden. Ansonsten zeigt Lx-Office eine

entsprechende Fehlermeldung an.

</para>

</sect2>

</sect1>

<sect1 id="Anpassung-der-PostgreSQL-Konfiguration">

<title>Anpassung der PostgreSQL-Konfiguration</title>

<para>PostgreSQL muss auf verschiedene Weisen angepasst werden.</para>

<sect2 id="Zeichensätze-die-Verwendung-von-UTF-8">

<title>Zeichensätze/die Verwendung von UTF-8</title>

<para>Lx-Office kann komplett mit UTF-8 als Zeichensatz verwendet

werden. Dabei gibt es zwei Punkte zu beachten: PostgreSQL muss in

angelegt worden sein.</para>

betrieben werden. Andernfalls ist es notwendig, einen neuen Datenbankcluster mit UTF-8-Encoding anzulegen und diesen zu

verwenden. Unter Debian und Ubuntu kann dies z.B. für PostgreSQL 8.2 mit dem folgenden Befehl getan werden:</para>

<para>Unter anderen Distributionen gibt es ähnliche Methoden.</para>

<para>Wurde PostgreSQL nicht mit UTF-8 als Encoding initialisiert und

ist ein Neuanlegen eines weiteren Clusters nicht möglich, so kann

Lx-Office mit ISO-8859-15 als Encoding betrieben werden.</para>

<sect2 id="Änderungen-an-Konfigurationsdateien">

<title>Änderungen an Konfigurationsdateien</title>

<filename>/etc/postgresql/</filename>, muss sichergestellt werden, dass

<literal>localhost</literal> verwendet werden. Andernfalls müssen

Datenbankverbindungen auch von anderen Rechnern aus zugelassen werden,

Verzeichnis wie die <filename>postgresql.conf</filename> zu finden sein

Hier gibt es mehrere Möglichkeiten. Eine besteht darin, lokale

host all all 127.0.0.1 255.0.0.0 trust</programlisting>

<para>Besser ist es, für eine bestimmte Datenbank Zugriff nur per

Passwort zuzulassen. Beispielsweise:</para>

host all lxoffice 127.0.0.1 255.255.255.255 password</programlisting>

<sect2 id="Erweiterung-für-servergespeicherte-Prozeduren">

<title>Erweiterung für servergespeicherte Prozeduren</title>

<para>In der Datenbank <literal>template1</literal> muss die

Unterstützung für servergespeicherte Prozeduren eingerichet werden.

Melden Sie sich dafür als Benutzer “postgres” an der Datenbank an, und

führen Sie die folgenden Kommandos aus:</para>

<sect2 id="Datenbankbenutzer-anlegen">

<title>Datenbankbenutzer anlegen</title>

<para>Wenn Sie nicht den Datenbanksuperuser “postgres” zum Zugriff

benutzen wollen, so sollten Sie bei PostgreSQL einen neuen Benutzer

anlegen. Ein Beispiel, wie Sie einen neuen Benutzer anlegen

können:</para>

<para>Wenn Sie später einen Datenbankzugriff konfigurieren, verändern

Sie den evtl. voreingestellten Benutzer “postgres” auf “lxoffice” bzw.

den hier gewählten Benutzernamen.</para>

</sect2>

</sect1>

<sect1 id="Apache-Konfiguration">

<title>Webserver-Konfiguration</title>

<sect2>

<title>Grundkonfiguration mittels CGI</title>

<note>

<para>Für einen deutlichen Performanceschub sorgt die Ausführung

mittels FastCGI/FCGI. Die Einrichtung wird ausführlich im Abschnitt

<xref linkend="Apache-Konfiguration.FCGI"/> beschrieben.</para>

</note>

<para>Der Zugriff auf das Programmverzeichnis muss in der Apache

Webserverkonfigurationsdatei <literal>httpd.conf</literal> eingestellt

werden. Fügen Sie den folgenden Abschnitt dieser Datei oder einer

anderen Datei hinzu, die beim Starten des Webservers eingelesen

wird:</para>

Alias /lx-erp/ /var/www/lx-erp/

&lt;Directory /var/www/lx-erp&gt;

Options ExecCGI

Includes FollowSymlinks

&lt;/Directory&gt;

&lt;Directory /var/www/lx-erp/users&gt;

Order Deny,Allow

Deny from All

&lt;/Directory&gt;</programlisting>

<para>Ersetzen Sie dabei die Pfade durch diejenigen, in die Sie vorher

das Lx-Office-Archiv entpacket haben.</para>

<para>Vor den einzelnen Optionen muss bei einigen Distributionen ein Plus ‘<literal>+</literal>’ gesetzt werden.</para>

</note>

<para>Auf einigen Webservern werden manchmal die Grafiken und

Style-Sheets nicht ausgeliefert. In solchen Fällen hat es oft

geholfen, die folgende Option in die Konfiguration aufzunehmen:</para>

<sect2 id="Apache-Konfiguration.FCGI"

xreflabel="Konfiguration für FastCGI/FCGI">

<title>Konfiguration für FastCGI/FCGI</title>

<sect3 id="Apache-Konfiguration.FCGI.WasIstEs">

<title>Was ist FastCGI?</title>

<para>Direkt aus <ulink

url="http://de.wikipedia.org/wiki/FastCGI">Wikipedia</ulink>

kopiert:</para>

<para><citation> FastCGI ist ein Standard für die Einbindung

externer Software zur Generierung dynamischer Webseiten in einem

Webserver. FastCGI ist vergleichbar zum Common Gateway Interface

(CGI), wurde jedoch entwickelt, um dessen Performance-Probleme zu

umgehen. </citation></para>

</sect3>

<sect3 id="Apache-Konfiguration.FCGI.Warum">

<title>Warum FastCGI?</title>

<para>Perl Programme (wie Lx-Office eines ist) werden nicht statisch

kompiliert. Stattdessen werden die Quelldateien bei jedem Start

übersetzt, was bei kurzen Laufzeiten einen Großteil der Laufzeit

ausmacht. Während SQL Ledger einen Großteil der Funktionalität in

einzelne Module kapselt, um immer nur einen kleinen Teil laden zu

müssen, ist die Funktionalität von Lx-Office soweit gewachsen, dass

immer mehr Module auf den Rest des Programms zugreifen. Zusätzlich

benutzen wir umfangreiche Bibliotheken um Funktionaltät nicht selber

entwickeln zu müssen, die zusätzliche Ladezeit kosten. All dies

führt dazu dass ein Lx-Office Aufruf der Kernmasken mittlerweile

deutlich länger dauert als früher, und dass davon 90% für das Laden

der Module verwendet wird.</para>

<para>Mit FastCGI werden nun die Module einmal geladen, und danach

wird nur die eigentliche Programmlogik ausgeführt.</para>

</sect3>

<sect3 id="Apache-Konfiguration.FCGI.WebserverUndPlugin">

<title>Getestete Kombinationen aus Webservern und Plugin</title>

<para>Folgende Kombinationen sind getestet:</para>

<itemizedlist>

<listitem>

<para>Apache 2.2.11 (Ubuntu) und mod_fcgid.</para>

</listitem>

<listitem>

<para>Apache 2.2.11 (Ubuntu) und mod_fastcgi.</para>

</listitem>

</itemizedlist>

<para>Dabei wird mod_fcgid empfohlen, weil mod_fastcgi seit geraumer

Zeit nicht mehr weiter entwickelt wird. Im Folgenden wird auf

mod_fastcgi nicht mehr explizit eingegangen.</para>

<para>Als Perl Backend wird das Modul <filename>FCGI.pm</filename>

verwendet.</para>

<warning>

FCGI 0.69 und höher ist extrem strict in der Behandlung von Unicode, und verweigert bestimmte Eingaben von Lx-Office. Falls es

Probleme mit Umlauten in Ihrere Installation gibt, muss auf die Vorgängerversion FCGI 0.68 ausgewichen werden.

</para>

Mit CPAN lässt sie sich die Vorgängerversion wie folgt installieren:

</para>

</warning>

<sect3 id="Apache-Konfiguration.FCGI.Konfiguration">

<title>Konfiguration des Webservers</title>

<para>Bevor Sie versuchen, eine Lx-Office Installation unter FCGI

laufen zu lassen, empfliehlt es sich die Installation ersteinmal

unter CGI aufzusetzen. FCGI macht es nicht einfach Fehler zu

debuggen die beim ersten aufsetzen auftreten können. Sollte die

Installation schon funktionieren, lesen Sie weiter.</para>

<para>Zuerst muss das FastCGI-Modul aktiviert werden. Dies kann

unter Debian/Ubuntu z.B. mit folgendem Befehl geschehen:</para>

<programlisting>a2enmod fcgid</programlisting>

<para>Die Konfiguration für die Verwendung von Lx-Office mit FastCGI

erfolgt durch Anpassung der vorhandenen <function>Alias</function>-

und <function>Directory</function>-Direktiven. Dabei wird zwischen

dem Installationspfad von Lx-Office im Dateisystem

("<filename>/path/to/lx-office-erp</filename>") und der URL

unterschieden, unter der Lx-Office im Webbrowser erreichbar ist

<para>Folgender Konfigurationsschnipsel funktioniert mit

mod_fastcgi:</para>

Alias /url/for/lx-office-erp/ /path/to/lx-office-erp/

&lt;Directory /path/to/lx-office-erp&gt;

AllowOverride All

Options ExecCGI Includes FollowSymlinks

Order Allow,Deny

Allow from All

&lt;/Directory&gt;

&lt;DirectoryMatch /path/to/lx-office-erp/users&gt;

Order Deny,Allow

Deny from All

&lt;/DirectoryMatch&gt;</programlisting>

<para>Seit mod_fcgid-Version 2.6.3 gelten sehr kleine Grenzen für

die maximale Größe eines Requests. Diese sollte wie folgt

hochgesetzt werden:</para>

<programlisting>FcgidMaxRequestLen 10485760</programlisting>

<para>Das ganze sollte dann so aussehen:</para>

<programlisting>AddHandler fcgid-script .fpl

Alias /url/for/lx-office-erp/ /path/to/lx-office-erp/

&lt;Directory /path/to/lx-office-erp&gt;

AllowOverride All

Options ExecCGI Includes FollowSymlinks

Order Allow,Deny

Allow from All

&lt;/Directory&gt;

&lt;DirectoryMatch /path/to/lx-office-erp/users&gt;

Order Deny,Allow

Deny from All

&lt;/DirectoryMatch&gt;</programlisting>

<para>Hierdurch wird nur ein zentraler Dispatcher gestartet. Alle

Zugriffe auf die einzelnen Scripte werden auf diesen umgeleitet.

Dadurch, dass zur Laufzeit öfter mal Scripte neu geladen werden,

gibt es hier kleine Performance-Einbußen.</para>

<para>Es ist möglich, die gleiche Lx-Office Version parallel unter

CGI und FastCGI zu betreiben. Dafür bleiben die Directorydirektiven

wie oben beschrieben, die URLs werden aber umgeleitet:</para>

<programlisting># Zugriff über CGI

# Zugriff mit mod_fcgid:

Alias /url/for/lx-office-erp-fcgid/ /path/to/lx-office-erp/</programlisting>

<para>Dann ist unter <filename>/url/for/lx-office-erp/</filename> die normale Version erreichbar, und unter

<constant>/url/for/lx-office-erp-fcgid/</constant> die FastCGI-Version.</para>

</sect2>

</sect1>

<para>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.</para>

<sect2 id="Konfiguration-des-Task-Servers">

<title>Verfügbare und notwendige Konfigurationsoptionen</title>

<para>Die Konfiguration erfolgt über den Abschnitt

<literal>[task_server]</literal> in der Datei

<filename>config/lx_office.conf</filename>. Die dort verfügbaren

Optionen sind:</para>

<varlistentry>

<term><varname>login</varname></term>

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.

</para>

<term><varname>run_as</varname></term>

Wird der Server vom Systembenutzer <literal>root</literal> gestartet, so wechselt er auf den mit <literal>run_as</literal>

angegebenen Systembenutzer. Der Systembenutzer muss dieselben Lese- und Schreibrechte haben, wie auch der Webserverbenutzer

(siehe see <xref linkend="Manuelle-Installation-des-Programmpaketes"/>). Daher ist es sinnvoll, hier denselben Systembenutzer

einzutragen, unter dem auch der Webserver läuft.

</para>

<term><varname>debug</varname></term>

Schaltet Debug-Informationen an und aus.

</para>

</variablelist>

<sect2 id="Einbinden-in-den-Boot-Prozess">

<title>Automatisches Starten des Task-Servers beim Booten</title>

<para>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.</para>

<para>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.</para>

<sect3>

<title>SystemV-basierende Systeme (z.B. Debian, OpenSuSE, Fedora

Core)</title>

<para>Kopieren Sie die Datei

<filename>scripts/boot/system-v/lx-office-task-server</filename>

nach <filename>/etc/init.d/lx-office-task-server</filename>. Passen

Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile

<literal>DAEMON=....</literal>). Binden Sie das Script in den

Boot-Prozess ein. Dies ist distributionsabhängig:</para>

<itemizedlist>

<listitem>

<para>Debian-basierende Systeme:</para>

# Nur bei Debian Squeeze und neuer:

insserv lx-office-task-server</programlisting>

<listitem>

<para>OpenSuSE und Fedora Core:</para>

</itemizedlist>

start</command></para>

<sect3>

<title>Upstart-basierende Systeme (z.B. Ubuntu)</title>

<para>Kopieren Sie die Datei

<filename>scripts/boot/upstart/lx-office-task-server.conf</filename>

nach <filename>/etc/init/lx-office-task-server.conf</filename>.

Passen Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile

<literal>exec ....</literal>).</para>

start</command></para>

</sect2>