Revision 5fa26f9a
Von Moritz Bunkus vor mehr als 12 Jahren hinzugefügt
| doc/dokumentation.xml | ||
|---|---|---|
|
<?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">
|
||
|
<book id="lx-office-documentation" lang="de">
|
||
|
<title>Lx-Office: Installation, Konfiguration, Entwicklung</title>
|
||
|
<book id="kivitendo-documentation" lang="de">
|
||
|
<title>kivitendo: Installation, Konfiguration, Entwicklung</title>
|
||
|
|
||
|
<chapter id="Aktuelle-Hinweise">
|
||
|
<title>Aktuelle Hinweise</title>
|
||
| ... | ... | |
|
|
||
|
<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>
|
||
|
<para>im kivitendo-Forum: <ulink
|
||
|
url="https://forum.kivitendo.org/">https://forum.kivitendo.org/</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>
|
||
|
<para>im alten Lx-Office-Wiki unter Dokumentation (<ulink
|
||
|
url="http://wiki.lx-office.org/index.php?title=Installation_Lx-Office_ERP">http://wiki.lx-office.org/index.php?title=Installation_Lx-Office_ERP</ulink>)</para>
|
||
|
</listitem>
|
||
|
</itemizedlist>
|
||
|
</chapter>
|
||
| ... | ... | |
|
<sect2 id="Betriebssystem">
|
||
|
<title>Betriebssystem</title>
|
||
|
|
||
|
<para>Lx-Office ist für Linux konzipiert, und sollte auf jedem
|
||
|
<para>kivitendo 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>
|
||
|
|
||
|
<para>Anfang 2012 sind das folgende Systeme, von denen bekannt ist,
|
||
|
dass Lx-Office auf ihnen läuft:</para>
|
||
|
<para>Mitte 2012 sind das folgende Systeme, von denen bekannt ist,
|
||
|
dass kivitendo auf ihnen läuft:</para>
|
||
|
|
||
|
<itemizedlist>
|
||
|
<listitem>
|
||
|
<para>Ubuntu 8.04 LTS Hardy Heron, 10.04 LTS Lucid Lynx bis 11.10
|
||
|
Oneiric Ocelot</para>
|
||
|
<para>Ubuntu 10.04 LTS Lucid Lynx bis 12.04 Precise Pangolin</para>
|
||
|
</listitem>
|
||
|
|
||
|
<listitem>
|
||
| ... | ... | |
|
</listitem>
|
||
|
|
||
|
<listitem>
|
||
|
<para>Fedora 13 bis 15</para>
|
||
|
<para>Fedora 13 bis 16</para>
|
||
|
</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.3/">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>
|
||
|
|
||
|
<programlisting>tar xzf lx-erp-perl-libs-compat-v2.tar.gz /path/to/lx-office/</programlisting>
|
||
|
|
||
|
<para>Zusätzlich müssen dann noch die folgenden Pakete installiert
|
||
|
weerden</para>
|
||
|
|
||
|
<programlisting>apt-get install libbit-vector-perl libsub-exporter-perl libclone-perl \
|
||
|
libclass-factory-util-perl</programlisting>
|
||
|
|
||
|
<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
|
||
|
<para>Zum Betrieb von kivitendo 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
|
||
|
<para>Zusätzlich benötigt kivitendo die folgenden Perl-Pakete, die
|
||
|
nicht Bestandteil einer Standard-Perl-Installation sind:</para>
|
||
|
|
||
|
<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
|
||
|
<literal>XML::Writer</literal> sind notwendig. Ohne startet kivitendo
|
||
|
nicht.</para>
|
||
|
|
||
|
<para>Gegenüber Version 2.6.1 sind <literal>parent</literal>,
|
||
| ... | ... | |
|
|
||
|
<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
|
||
|
Abhängigkeiten, wurden aber bisher mit kivitendo 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
|
||
| ... | ... | |
|
<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
|
||
|
<para>kivitendo enthält ein Script, mit dem überprüft werden kann, ob
|
||
|
alle benötigten Perl-Module installiert sind. Der Aufruf lautet wie
|
||
|
folgt:</para>
|
||
|
|
||
| ... | ... | |
|
xreflabel="Manuelle Installation des Programmpaketes">
|
||
|
<title>Manuelle Installation des Programmpaketes</title>
|
||
|
|
||
|
<para>Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.6.3.tgz) wird
|
||
|
<para>Die kivitendo ERP Installationsdatei (kivitendo-erp-2.6.3.tgz) wird
|
||
|
im Dokumentenverzeichnis des Webservers (z.B.
|
||
|
<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.3.tgz</programlisting>
|
||
|
<programlisting>cd /var/www
|
||
|
tar xvzf kivitendo-erp-2.6.3.tgz</programlisting>
|
||
|
|
||
|
<para>Verändern Sie evtl. noch den Namen des Verzeichnisses und wechseln Sie in es:</para>
|
||
|
<para>Wechseln Sie in das entpackte Verzeichnis:</para>
|
||
|
|
||
|
<programlisting>mv lxoffice-erp/ lx-erp/
|
||
|
cd lx-erp</programlisting>
|
||
|
<programlisting>cd kivitendo-erp</programlisting>
|
||
|
|
||
|
<para>Alternativ können Sie auch einen Alias in der
|
||
|
Webserverkonfiguration benutzen, um auf das tatsächliche
|
||
| ... | ... | |
|
<programlisting>chown -R www-data users spool webdav</programlisting>
|
||
|
|
||
|
<para>Weiterhin muss der Webserver-Benutzer in den Verzeichnissen <filename>templates</filename> und <filename>users</filename>
|
||
|
Unterverzeichnisse für jeden neuen Benutzer anlegen dürfen, der in Lx-Office angelegt wird:</para>
|
||
|
Unterverzeichnisse für jeden neuen Benutzer anlegen dürfen, der in kivitendo angelegt wird:</para>
|
||
|
|
||
|
<programlisting>chown www-data templates users</programlisting>
|
||
|
</sect1>
|
||
|
|
||
|
<sect1 id="config.config-file">
|
||
|
<title>Lx-Office-Konfigurationsdatei</title>
|
||
|
<title>kivitendo-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:
|
||
|
<para>In kivitendo gibt es nur noch eine Konfigurationsdatei,
|
||
|
die benötigt wird: <filename>config/kivitendo.conf</filename> (kurz:
|
||
|
"die Hauptkonfigurationsdatei"). Diese muss bei der Erstinstallation
|
||
|
von Lx-Office bzw. der Migration von älteren Versionen angelegt
|
||
|
von kivitendo bzw. der Migration von älteren Versionen angelegt
|
||
|
werden.</para>
|
||
|
|
||
|
<para>Als Vorlage dient die Datei
|
||
|
<filename>config/lx_office.conf.default</filename> (kurz: "die
|
||
|
<filename>config/kivitendo.conf.default</filename> (kurz: "die
|
||
|
Default-Datei"):</para>
|
||
|
|
||
|
<programlisting>$ cp config/lx_office.conf.default config/lx_office.conf</programlisting>
|
||
|
<programlisting>$ cp config/kivitendo.conf.default config/kivitendo.conf</programlisting>
|
||
|
|
||
|
<para>Die Default-Datei wird immer zuerst eingelesen. Werte, die in
|
||
|
der Hauptkonfigurationsdatei stehen, überschreiben die Werte aus der
|
||
| ... | ... | |
|
Abschnitte und Werte enthalten, die von denen der Default-Datei
|
||
|
abweichen.</para>
|
||
|
|
||
|
<note>
|
||
|
<para>
|
||
|
Vor der Umbenennung in kivitendo hieß diese Datei noch <filename>config/lx_office.conf</filename>. Aus Gründen der Kompatibilität
|
||
|
wird diese Datei eingelesen, sofern die Datei <filename>config/kivitendo.conf</filename> nicht existiert.
|
||
|
</para>
|
||
|
</note>
|
||
|
|
||
|
<para>Diese Hauptkonfigurationsdatei ist dann eine
|
||
|
installationsspezifische Datei, d.h. sie enthält bspw. lokale
|
||
|
Passwörter und wird auch nicht im Versionsmanagement (git)
|
||
| ... | ... | |
|
[authentication/database]
|
||
|
host = localhost
|
||
|
port = 5432
|
||
|
db = lxerp_auth
|
||
|
db = kivitendo_auth
|
||
|
user = postgres
|
||
|
password =
|
||
|
|
||
| ... | ... | |
|
linkend="config.task-server">Taskserver</link> für <link
|
||
|
linkend="features.periodic-invoices">wiederkehrende Rechnungen</link>,
|
||
|
muss unter <varname>[task_server]</varname> ein Login eines Benutzers
|
||
|
angegeben werden, mit dem sich der Taskserver an Lx-Office bei der
|
||
|
angegeben werden, mit dem sich der Taskserver an kivitendo bei der
|
||
|
Datenbank anmeldet, die dem Benutzer zugewiesen ist.</para>
|
||
|
|
||
|
<para>Für Entwickler finden sich unter <varname>[debug]</varname>
|
||
| ... | ... | |
|
<sect2 id="config.config-file.prior-versions">
|
||
|
<title>Versionen vor 2.6.3</title>
|
||
|
|
||
|
<para>In älteren Lx-Office Versionen gab es im Verzeichnis
|
||
|
<para>In älteren kivitendo 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
|
||
| ... | ... | |
|
zu erstellen (<filename>lx-erp-local.conf</filename>). Dies ist ab
|
||
|
2.6.3 nicht mehr möglich, aber auch nicht mehr nötig.</para>
|
||
|
|
||
|
<para>Beim Update von einer Lx-Office-Version vor 2.6.3 auf 2.6.3 oder
|
||
|
<para>Beim Update von einer kivitendo-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
|
||
|
gelöscht oder verschoben werden. Ansonsten zeigt kivitendo eine
|
||
|
entsprechende Fehlermeldung an.</para>
|
||
|
</sect2>
|
||
|
</sect1>
|
||
| ... | ... | |
|
<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
|
||
|
<para>kivitendo kann komplett mit UTF-8 als Zeichensatz verwendet
|
||
|
werden. Dabei gibt es zwei Punkte zu beachten: PostgreSQL muss in
|
||
|
Version 8.2 oder neuer benutzt werden, und der
|
||
|
PostgreSQL-Datenbankcluster muss ebenfalls mit UTF-8 als Locale
|
||
|
angelegt worden sein.</para>
|
||
|
|
||
|
<para>Dieses ist kann überprüft werden: ist das Encoding der Datenbank
|
||
|
“template1” “UTF8”, so kann auch Lx-Office mit UTF-8 betrieben werden.
|
||
|
“template1” “UTF8”, so kann auch kivitendo mit UTF-8 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
|
||
| ... | ... | |
|
|
||
|
<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>
|
||
|
kivitendo mit ISO-8859-15 als Encoding betrieben werden.</para>
|
||
|
|
||
|
<para>Das Encoding einer Datenbank kann in <command>psql</command> mit
|
||
|
<literal>\l</literal> geprüft werden.</para>
|
||
| ... | ... | |
|
<filename>/etc/postgresql/</filename>, muss sichergestellt werden,
|
||
|
dass TCP/IP-Verbindungen aktiviert sind. Das Verhalten wird über den
|
||
|
Parameter <varname>listen_address</varname> gesteuert. Laufen
|
||
|
PostgreSQL und Lx-Office auf demselben Rechner, so kann dort der Wert
|
||
|
PostgreSQL und kivitendo auf demselben Rechner, so kann dort der Wert
|
||
|
<literal>localhost</literal> verwendet werden. Andernfalls müssen
|
||
|
Datenbankverbindungen auch von anderen Rechnern aus zugelassen werden,
|
||
|
was mit dem Wert <literal>*</literal> geschieht.</para>
|
||
| ... | ... | |
|
<para>Besser ist es, für eine bestimmte Datenbank Zugriff nur per
|
||
|
Passwort zuzulassen. Beispielsweise:</para>
|
||
|
|
||
|
<programlisting>local all lxoffice password
|
||
|
host all lxoffice 127.0.0.1 255.255.255.255 password</programlisting>
|
||
|
<programlisting>local all kivitendo password
|
||
|
host all kivitendo 127.0.0.1 255.255.255.255 password</programlisting>
|
||
|
</sect2>
|
||
|
|
||
|
<sect2 id="Erweiterung-für-servergespeicherte-Prozeduren">
|
||
| ... | ... | |
|
anlegen. Ein Beispiel, wie Sie einen neuen Benutzer anlegen
|
||
|
können:</para>
|
||
|
|
||
|
<programlisting>su - postgres createuser -d -P lxoffice</programlisting>
|
||
|
<programlisting>su - postgres createuser -d -P kivitendo</programlisting>
|
||
|
|
||
|
<para>Wenn Sie später einen Datenbankzugriff konfigurieren, verändern
|
||
|
Sie den evtl. voreingestellten Benutzer “postgres” auf “lxoffice” bzw.
|
||
|
Sie den evtl. voreingestellten Benutzer “postgres” auf “kivitendo” bzw.
|
||
|
den hier gewählten Benutzernamen.</para>
|
||
|
</sect2>
|
||
|
</sect1>
|
||
| ... | ... | |
|
wird:</para>
|
||
|
|
||
|
<programlisting>AddHandler cgi-script .pl
|
||
|
Alias /lx-erp/ /var/www/lx-erp/
|
||
|
Alias /kivitendo-erp/ /var/www/kiviteno-erp/
|
||
|
|
||
|
<Directory /var/www/lx-erp>
|
||
|
<Directory /var/www/kivitendo-erp>
|
||
|
Options ExecCGI Includes FollowSymlinks
|
||
|
</Directory>
|
||
|
|
||
|
<Directory /var/www/lx-erp/users>
|
||
|
<Directory /var/www/kivitendo-erp/users>
|
||
|
Order Deny,Allow
|
||
|
Deny from All
|
||
|
</Directory></programlisting>
|
||
|
|
||
|
<para>Ersetzen Sie dabei die Pfade durch diejenigen, in die Sie vorher
|
||
|
das Lx-Office-Archiv entpacket haben.</para>
|
||
|
das kivitendo-Archiv entpacket haben.</para>
|
||
|
|
||
|
<note>
|
||
|
<para>Vor den einzelnen Optionen muss bei einigen Distributionen ein
|
||
| ... | ... | |
|
<sect3 id="Apache-Konfiguration.FCGI.Warum">
|
||
|
<title>Warum FastCGI?</title>
|
||
|
|
||
|
<para>Perl Programme (wie Lx-Office eines ist) werden nicht statisch
|
||
|
<para>Perl Programme (wie kivitendo 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
|
||
|
müssen, ist die Funktionalität von kivitendo 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
|
||
|
führt dazu dass ein kivitendo Aufruf der Kernmasken mittlerweile
|
||
|
deutlich länger dauert als früher, und dass davon 90% für das Laden
|
||
|
der Module verwendet wird.</para>
|
||
|
|
||
| ... | ... | |
|
|
||
|
<warning>
|
||
|
<para>FCGI 0.69 und höher ist extrem strict in der Behandlung von
|
||
|
Unicode, und verweigert bestimmte Eingaben von Lx-Office. Falls es
|
||
|
Unicode, und verweigert bestimmte Eingaben von kivitendo. Falls es
|
||
|
Probleme mit Umlauten in Ihrere Installation gibt, muss auf die
|
||
|
Vorgängerversion FCGI 0.68 ausgewichen werden.</para>
|
||
|
|
||
| ... | ... | |
|
<sect3 id="Apache-Konfiguration.FCGI.Konfiguration">
|
||
|
<title>Konfiguration des Webservers</title>
|
||
|
|
||
|
<para>Bevor Sie versuchen, eine Lx-Office Installation unter FCGI
|
||
|
<para>Bevor Sie versuchen, eine kivitendo 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
|
||
| ... | ... | |
|
|
||
|
<programlisting>a2enmod fcgid</programlisting>
|
||
|
|
||
|
<para>Die Konfiguration für die Verwendung von Lx-Office mit FastCGI
|
||
|
<para>Die Konfiguration für die Verwendung von kivitendo 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
|
||
|
("<filename>/url/for/lx-office-erp</filename>").</para>
|
||
|
dem Installationspfad von kivitendo im Dateisystem
|
||
|
("<filename>/path/to/kivitendo-erp</filename>") und der URL
|
||
|
unterschieden, unter der kivitendo im Webbrowser erreichbar ist
|
||
|
("<filename>/url/for/kivitendo-erp</filename>").</para>
|
||
|
|
||
|
<para>Folgender Konfigurationsschnipsel funktioniert mit
|
||
|
mod_fastcgi:</para>
|
||
|
|
||
|
<programlisting>AliasMatch ^/url/for/lx-office-erp/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fcgi
|
||
|
Alias /url/for/lx-office-erp/ /path/to/lx-office-erp/
|
||
|
<programlisting>AliasMatch ^/url/for/kivitendo-erp/[^/]+\.pl /path/to/kivitendo-erp/dispatcher.fcgi
|
||
|
Alias /url/for/kivitendo-erp/ /path/to/kivitendo-erp/
|
||
|
|
||
|
<Directory /path/to/lx-office-erp>
|
||
|
<Directory /path/to/kivitendo-erp>
|
||
|
AllowOverride All
|
||
|
Options ExecCGI Includes FollowSymlinks
|
||
|
Order Allow,Deny
|
||
|
Allow from All
|
||
|
</Directory>
|
||
|
|
||
|
<DirectoryMatch /path/to/lx-office-erp/users>
|
||
|
<DirectoryMatch /path/to/kivitendo-erp/users>
|
||
|
Order Deny,Allow
|
||
|
Deny from All
|
||
|
</DirectoryMatch></programlisting>
|
||
| ... | ... | |
|
<para>Das ganze sollte dann so aussehen:</para>
|
||
|
|
||
|
<programlisting>AddHandler fcgid-script .fpl
|
||
|
AliasMatch ^/url/for/lx-office-erp/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fpl
|
||
|
Alias /url/for/lx-office-erp/ /path/to/lx-office-erp/
|
||
|
AliasMatch ^/url/for/kivitendo-erp/[^/]+\.pl /path/to/kivitendo-erp/dispatcher.fpl
|
||
|
Alias /url/for/kivitendo-erp/ /path/to/kivitendo-erp/
|
||
|
FcgidMaxRequestLen 10485760
|
||
|
|
||
|
<Directory /path/to/lx-office-erp>
|
||
|
<Directory /path/to/kivitendo-erp>
|
||
|
AllowOverride All
|
||
|
Options ExecCGI Includes FollowSymlinks
|
||
|
Order Allow,Deny
|
||
|
Allow from All
|
||
|
</Directory>
|
||
|
|
||
|
<DirectoryMatch /path/to/lx-office-erp/users>
|
||
|
<DirectoryMatch /path/to/kivitendo-erp/users>
|
||
|
Order Deny,Allow
|
||
|
Deny from All
|
||
|
</DirectoryMatch></programlisting>
|
||
| ... | ... | |
|
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
|
||
|
<para>Es ist möglich, die gleiche kivitendo 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
|
||
|
Alias /url/for/lx-office-erp /path/to/lx-office-erp
|
||
|
Alias /url/for/kivitendo-erp /path/to/kivitendo-erp
|
||
|
|
||
|
# Zugriff mit mod_fcgid:
|
||
|
AliasMatch ^/url/for/lx-office-erp-fcgid/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fpl
|
||
|
Alias /url/for/lx-office-erp-fcgid/ /path/to/lx-office-erp/</programlisting>
|
||
|
AliasMatch ^/url/for/kivitendo-erp-fcgid/[^/]+\.pl /path/to/kivitendo-erp/dispatcher.fpl
|
||
|
Alias /url/for/kivitendo-erp-fcgid/ /path/to/kivitendo-erp/</programlisting>
|
||
|
|
||
|
<para>Dann ist unter <filename>/url/for/lx-office-erp/</filename>
|
||
|
<para>Dann ist unter <filename>/url/for/kivitendo-erp/</filename>
|
||
|
die normale Version erreichbar, und unter
|
||
|
<constant>/url/for/lx-office-erp-fcgid/</constant> die
|
||
|
<constant>/url/for/kivitendo-erp-fcgid/</constant> die
|
||
|
FastCGI-Version.</para>
|
||
|
</sect3>
|
||
|
</sect2>
|
||
| ... | ... | |
|
|
||
|
<para>Die Konfiguration erfolgt über den Abschnitt
|
||
|
<literal>[task_server]</literal> in der Datei
|
||
|
<filename>config/lx_office.conf</filename>. Die dort verfügbaren
|
||
|
<filename>config/kivitendo.conf</filename>. Die dort verfügbaren
|
||
|
Optionen sind:</para>
|
||
|
|
||
|
<variablelist>
|
||
| ... | ... | |
|
<term><varname>login</varname></term>
|
||
|
|
||
|
<listitem>
|
||
|
<para>gültiger Lx-Office-Benutzername, der benutzt wird, um die
|
||
|
<para>gültiger kivitendo-Benutzername, der benutzt wird, um die
|
||
|
zu verwendende Datenbankverbindung auszulesen. Der Benutzer muss
|
||
|
in der Administration angelegt werden. Diese Option muss
|
||
|
angegeben werden.</para>
|
||
| ... | ... | |
|
|
||
|
<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>
|
||
|
Starten automatisch in das kivitendo-Installationsverzeichnis.</para>
|
||
|
|
||
|
<para>Deshalb ist es möglich, ihn durch Setzen eines symbolischen
|
||
|
Links aus einem der Runlevel-Verzeichnisse heraus in den Boot-Prozess
|
||
| ... | ... | |
|
</itemizedlist>
|
||
|
|
||
|
<para>Der Task-Server wechselt beim Starten automatisch in das
|
||
|
Lx-Office-Installationsverzeichnis.</para>
|
||
|
kivitendo-Installationsverzeichnis.</para>
|
||
|
|
||
|
<para>Dieselben Optionen können auch für die SystemV-basierenden
|
||
|
Runlevel-Scripte benutzt werden (siehe oben).</para>
|
||
| ... | ... | |
|
<sect2 id="Grundlagen-zur-Benutzerauthentifizierung">
|
||
|
<title>Grundlagen zur Benutzerauthentifizierung</title>
|
||
|
|
||
|
<para>Lx-Office verwaltet die Benutzerinformationen in einer
|
||
|
<para>kivitendo verwaltet die Benutzerinformationen in einer
|
||
|
Datenbank, die im folgenden “Authentifizierungsdatenbank” genannt
|
||
|
wird. Für jeden Benutzer kann dort eine eigene Datenbank für die
|
||
|
eigentlichen Finanzdaten hinterlegt sein. Diese beiden Datenbanken
|
||
|
können, müssen aber nicht unterschiedlich sein.</para>
|
||
|
|
||
|
<para>Im einfachsten Fall gibt es für Lx-Office nur eine einzige
|
||
|
<para>Im einfachsten Fall gibt es für kivitendo nur eine einzige
|
||
|
Datenbank, in der sowohl die Benutzerinformationen als auch die Daten
|
||
|
abgelegt werden.</para>
|
||
|
|
||
|
<para>Zusätzlich ermöglicht es Lx-Office, dass die Benutzerpasswörter
|
||
|
<para>Zusätzlich ermöglicht es kivitendo, dass die Benutzerpasswörter
|
||
|
entweder gegen die Authentifizierungsdatenbank oder gegen einen
|
||
|
LDAP-Server überprüft werden.</para>
|
||
|
|
||
|
<para>Welche Art der Passwortüberprüfung Lx-Office benutzt und wie
|
||
|
Lx-Office die Authentifizierungsdatenbank erreichen kann, wird in der
|
||
|
Konfigurationsdatei <filename>config/lx_office.conf</filename>
|
||
|
<para>Welche Art der Passwortüberprüfung kivitendo benutzt und wie
|
||
|
kivitendo die Authentifizierungsdatenbank erreichen kann, wird in der
|
||
|
Konfigurationsdatei <filename>config/kivitendo.conf</filename>
|
||
|
festgelegt. Diese muss bei der Installation und bei einem Upgrade von
|
||
|
einer Version vor v2.6.0 angelegt werden. Eine
|
||
|
Beispielkonfigurationsdatei
|
||
|
<filename>config/lx_office.conf.default</filename> existiert, die als
|
||
|
<filename>config/kivitendo.conf.default</filename> existiert, die als
|
||
|
Vorlage benutzt werden kann.</para>
|
||
|
</sect2>
|
||
|
|
||
| ... | ... | |
|
<term><literal>user</literal></term>
|
||
|
|
||
|
<listitem>
|
||
|
<para>Der Benutzername, mit dem sich Lx-Office beim
|
||
|
<para>Der Benutzername, mit dem sich kivitendo beim
|
||
|
Datenbankserver anmeldet (z.B.
|
||
|
"<literal>postgres</literal>")</para>
|
||
|
</listitem>
|
||
| ... | ... | |
|
</varlistentry>
|
||
|
</variablelist>
|
||
|
|
||
|
<para>Die Datenbank muss noch nicht existieren. Lx-Office kann sie
|
||
|
<para>Die Datenbank muss noch nicht existieren. kivitendo kann sie
|
||
|
automatisch anlegen (mehr dazu siehe unten).</para>
|
||
|
</sect2>
|
||
|
|
||
|
<sect2 id="Passwortüberprüfung">
|
||
|
<title>Passwortüberprüfung</title>
|
||
|
|
||
|
<para>Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen
|
||
|
<para>kivitendo unterstützt Passwortüberprüfung auf zwei Arten: gegen
|
||
|
die Authentifizierungsdatenbank und gegen einen externen LDAP- oder
|
||
|
Active-Directory-Server. Welche davon benutzt wird, regelt der
|
||
|
Parameter <varname>module</varname> im Abschnitt
|
||
| ... | ... | |
|
gespeichert werden, so muss der Parameter <varname>module</varname>
|
||
|
den Wert <literal>DB</literal> enthalten. In diesem Fall können sowohl
|
||
|
der Administrator als auch die Benutzer selber ihre Psaswörter in
|
||
|
Lx-Office ändern.</para>
|
||
|
kivitendo ändern.</para>
|
||
|
|
||
|
<para>Soll hingegen ein externer LDAP- oder Active-Directory-Server
|
||
|
benutzt werden, so muss der Parameter <varname>module</varname> auf
|
||
| ... | ... | |
|
<sect2 id="Name-des-Session-Cookies">
|
||
|
<title>Name des Session-Cookies</title>
|
||
|
|
||
|
<para>Sollen auf einem Server mehrere Lx-Office-Installationen
|
||
|
<para>Sollen auf einem Server mehrere kivitendo-Installationen
|
||
|
aufgesetzt werden, so müssen die Namen der Session-Cookies für alle
|
||
|
Installationen unterschiedlich sein. Der Name des Cookies wird mit dem
|
||
|
Parameter <varname>cookie_name</varname> im Abschnitt
|
||
| ... | ... | |
|
<title>Anlegen der Authentifizierungsdatenbank</title>
|
||
|
|
||
|
<para>Nachdem alle Einstellungen in
|
||
|
<filename>config/lx_office.conf</filename> vorgenommen wurden, muss
|
||
|
Lx-Office die Authentifizierungsdatenbank anlegen. Dieses geschieht
|
||
|
<filename>config/kivitendo.conf</filename> vorgenommen wurden, muss
|
||
|
kivitendo die Authentifizierungsdatenbank anlegen. Dieses geschieht
|
||
|
automatisch, wenn Sie sich im Administrationsmodul anmelden, das unter
|
||
|
der folgenden URL erreichbar sein sollte:</para>
|
||
|
|
||
|
<para><ulink
|
||
|
url="http://localhost/lx-erp/admin.pl">http://localhost/lx-erp/admin.pl</ulink></para>
|
||
|
url="http://localhost/kivitendo-erp/admin.pl">http://localhost/kivitendo-erp/admin.pl</ulink></para>
|
||
|
</sect2>
|
||
|
</sect1>
|
||
|
|
||
| ... | ... | |
|
folgender URL finden:</para>
|
||
|
|
||
|
<para><ulink
|
||
|
url="http://localhost/lx-erp/admin.pl">http://localhost/lx-erp/admin.pl</ulink></para>
|
||
|
url="http://localhost/kivitendo-erp/admin.pl">http://localhost/kivitendo-erp/admin.pl</ulink></para>
|
||
|
|
||
|
<para>Verwenden Sie zur Anmeldung das Password, dass Sie in der Datei
|
||
|
<filename>config/lx_office.conf</filename> eingetragen haben.</para>
|
||
|
<filename>config/kivitendo.conf</filename> eingetragen haben.</para>
|
||
|
|
||
|
<sect2 id="Zusammenhänge">
|
||
|
<title>Zusammenhänge</title>
|
||
|
|
||
|
<para>Lx-Office verwendet eine Datenbank zum Speichern all seiner
|
||
|
<para>kivitendo verwendet eine Datenbank zum Speichern all seiner
|
||
|
Informationen wie Kundendaten, Artikel, Angebote, Rechnungen etc. Um
|
||
|
mit Lx-Office arbeiten zu können, muss eine Person einen
|
||
|
mit kivitendo arbeiten zu können, muss eine Person einen
|
||
|
Benutzeraccount haben. Jedem Benutzeraccount wiederum wird genau eine
|
||
|
Datenbank zugewiesen, mit der dieser Benutzer arbeiten kann. Es ist
|
||
|
möglich und normal, dass mehreren Benutzern die selbe Datenbank
|
||
| ... | ... | |
|
eingegeben werden können, werden in einer zweiten Datenbank
|
||
|
gespeichert, der bereits erwähnten Authentifizierungsdatenbank. Diese
|
||
|
ist also den Produktivdaten enthaltenden Datenbanken vorgeschaltet.
|
||
|
Pro Lx-Office-Installation gibt es nur eine
|
||
|
Pro kivitendo-Installation gibt es nur eine
|
||
|
Authentifizierungsdatenbank, aber beliebig viele Datenbanken mit
|
||
|
Firmendaten.</para>
|
||
|
|
||
|
<para>Lx-Office kann seinen Benutzern Zugriff auf bestimmte
|
||
|
<para>kivitendo kann seinen Benutzern Zugriff auf bestimmte
|
||
|
Funktionsbereiche erlauben oder verbieten. Wird der Zugriff nicht
|
||
|
gestattet, so werden der entsprechenden Menüpunkte auch nicht
|
||
|
angezeigt. Diese Rechte werden ebenfalls in der
|
||
|
Authentifizierungsdatenbank gespeichert.</para>
|
||
|
|
||
|
<para>Um Rechte verteilen zu können, verwendet Lx-Office ein
|
||
|
<para>Um Rechte verteilen zu können, verwendet kivitendo ein
|
||
|
Gruppen-Prinzip. Einer Gruppe kann der Zugriff auf bestimmte Bereiche
|
||
|
erlaubt werden. Ein Benutzer wiederum kann Mitglied in einer oder
|
||
|
mehrerer Gruppen sein. Der Benutzer hat Zugriff auf alle diejenigen
|
||
| ... | ... | |
|
|
||
|
<para>Zuerst muss eine Datenbank angelegt werden. Verwenden Sie für
|
||
|
den Datenbankzugriff den vorhin angelegten Benutzer (in unseren
|
||
|
Beispielen ist dies ‘<literal>lxoffice</literal>’).</para>
|
||
|
Beispielen ist dies ‘<literal>kivitendo</literal>’).</para>
|
||
|
|
||
|
<para>Wenn Sie für die Lx-Office-Installation nicht den europäischen
|
||
|
Schriftsatz ISO-8859-15 sondern UTF-8 (Unicode) benutzen wollen, so
|
||
|
müssen Sie vor dem Anlegen der Datenbank in der Datei
|
||
|
<filename>config/lx_office.conf</filename> die Variable
|
||
|
<literal>dbcharset</literal> im Abschnitt <literal>system</literal>
|
||
|
auf den Wert ‘<literal>UTF-8</literal>’ setzen. Zusätzlich muss beim
|
||
|
Anlegen der Datenbank ‘<literal>UTF-8 Unicode</literal>’ als
|
||
|
Schriftsatz ausgewählt werden.</para>
|
||
|
<para>Wenn Sie für die kivitendo-Installation nicht Unicode (UTF-8) sondern den europäischen Schriftsatz ISO-8859-15 benutzen
|
||
|
wollen, so müssen Sie vor dem Anlegen der Datenbank in der Datei <filename>config/kivitendo.conf</filename> die Variable
|
||
|
<literal>dbcharset</literal> im Abschnitt <literal>system</literal> auf den Wert ‘<literal>ISO-8859-15</literal>’ setzen.</para>
|
||
|
|
||
|
<para>Bitte beachten Sie, dass alle Datenbanken den selben Zeichensatz
|
||
|
verwenden müssen, da diese Einstellungen momentan global in Lx-Office
|
||
|
verwenden müssen, da diese Einstellungen momentan global in kivitendo
|
||
|
vorgenommen wird und nicht nach Datenbank unterschieden werden kann.
|
||
|
Auch die Authentifizierungsdatenbank muss mit diesem Zeichensatz
|
||
|
angelegt worden sein.</para>
|
||
| ... | ... | |
|
<sect2 id="Migration-alter-Installationen">
|
||
|
<title>Migration alter Installationen</title>
|
||
|
|
||
|
<para>Wenn Lx-Office 2.6.3 über eine ältere Version installiert wird,
|
||
|
<para>Wenn kivitendo 2.6.3 über eine ältere Version installiert wird,
|
||
|
in der die Benutzerdaten noch im Dateisystem im Verzeichnis
|
||
|
<literal>users</literal> verwaltet wurden, so bietet Lx-Office die
|
||
|
<literal>users</literal> verwaltet wurden, so bietet kivitendo die
|
||
|
Möglichkeit, diese Benutzerdaten automatisch in die
|
||
|
Authentifizierungsdatenbank zu übernehmen. Dies geschieht, wenn man
|
||
|
sich nach dem Update der Installation das erste Mal im
|
||
|
Administrationsbereich anmeldet. Findet Lx-Office die Datei
|
||
|
Administrationsbereich anmeldet. Findet kivitendo die Datei
|
||
|
<literal>users/members</literal>, so wird der Migrationsprozess
|
||
|
gestartet.</para>
|
||
|
|
||
|
<para>Der Migrationsprozess ist nahezu vollautomatisch. Alle
|
||
|
Benutzerdaten können übernommen werden. Nach den Benutzerdaten bietet
|
||
|
Lx-Office noch die Möglichkeit an, dass automatisch eine
|
||
|
kivitendo noch die Möglichkeit an, dass automatisch eine
|
||
|
Benutzergruppe angelegt wird. Dieser Gruppe wird Zugriff auf alle
|
||
|
Funktionen von Lx-Office gewährt. Alle migrierten Benutzern werden
|
||
|
Mitglied in dieser Gruppe. Damit wird das Verhalten von Lx-Office bis
|
||
|
Funktionen von kivitendo gewährt. Alle migrierten Benutzern werden
|
||
|
Mitglied in dieser Gruppe. Damit wird das Verhalten von kivitendo bis
|
||
|
Version 2.4.3 inklusive wiederhergestellt, und die Benutzer können
|
||
|
sich sofort wieder anmelden und mit dem System arbeiten.</para>
|
||
|
</sect2>
|
||
|
</sect1>
|
||
|
|
||
|
<sect1 id="Drucken-mit-Lx-Office">
|
||
|
<title>Drucken mit Lx-Office</title>
|
||
|
<sect1 id="Drucken-mit-kivitendo">
|
||
|
<title>Drucken mit kivitendo</title>
|
||
|
|
||
|
<para>Das Drucksystem von Lx-Office benutzt von Haus aus LaTeX Vorlagen.
|
||
|
<para>Das Drucksystem von kivitendo benutzt von Haus aus LaTeX Vorlagen.
|
||
|
Um drucken zu können, braucht der Server ein geeignetes LaTeX System. Am
|
||
|
einfachsten ist dazu eine <literal>texlive</literal> Installation. Unter
|
||
|
Debianoiden Betriebssystemen sind das die Pakete:</para>
|
||
| ... | ... | |
|
<sect1 id="OpenDocument-Vorlagen">
|
||
|
<title>OpenDocument-Vorlagen</title>
|
||
|
|
||
|
<para>Lx-Office unterstützt die Verwendung von Vorlagen im
|
||
|
<para>kivitendo unterstützt die Verwendung von Vorlagen im
|
||
|
OpenDocument-Format, wie es OpenOffice.org ab Version 2 erzeugt.
|
||
|
Lx-Office kann dabei sowohl neue OpenDocument-Dokumente als auch aus
|
||
|
kivitendo kann dabei sowohl neue OpenDocument-Dokumente als auch aus
|
||
|
diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von
|
||
|
OpenDocument-Vorlagen zu aktivieren muss in der Datei
|
||
|
<filename>config/lx_office.conf</filename> die Variable
|
||
|
<filename>config/kivitendo.conf</filename> die Variable
|
||
|
<literal>opendocument</literal> im Abschnitt
|
||
|
<literal>print_templates</literal> auf ‘<literal>1</literal>’ stehen.
|
||
|
Dieses ist die Standardeinstellung.</para>
|
||
|
|
||
|
<para>Weiterhin muss in der Datei
|
||
|
<filename>config/lx_office.conf</filename> die Variable
|
||
|
<filename>config/kivitendo.conf</filename> die Variable
|
||
|
<literal>dbcharset</literal> im Abschnitt <literal>system</literal> auf
|
||
|
die Zeichenkodierung gesetzt werden, die auch bei der Speicherung der
|
||
|
Daten in der Datenbank verwendet wird. Diese ist in den meisten Fällen
|
||
| ... | ... | |
|
Andere Distributionen enthalten ihn in anderen Paketen.</para>
|
||
|
|
||
|
<para>Nach der Installation müssen in der Datei
|
||
|
<filename>config/lx_config.conf</filename> zwei weitere Variablen
|
||
|
<filename>config/kivitendo.conf</filename> zwei weitere Variablen
|
||
|
angepasst werden: <literal>openofficeorg_writer</literal> muss den
|
||
|
vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.
|
||
|
<literal>xvfb</literal> muss den Pfad zum “X virtual frame buffer”
|
||
|
enthalten. Beide stehen im Abschnitt
|
||
|
<literal>applications</literal>.</para>
|
||
|
|
||
|
<para>Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit
|
||
|
<para>Zusätzlich gibt es zwei verschiedene Arten, wie kivitendo mit
|
||
|
OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn die
|
||
|
Variable <literal>$openofficeorg_daemon</literal> gesetzt ist, startet
|
||
|
ein OpenOffice, das auch nach der Umwandlung des Dokumentes gestartet
|
||
| ... | ... | |
|
xreflabel="Einführung in die Konfiguration zur EUR">
|
||
|
<title>Einführung</title>
|
||
|
|
||
|
<para>Lx-Office besaß bis inklusive Version 2.6.3 einen
|
||
|
<para>kivitendo besaß bis inklusive Version 2.6.3 einen
|
||
|
Konfigurationsparameter namens <varname>eur</varname>, der sich in der
|
||
|
Konfigurationsdatei <filename>config/lx_office.conf</filename>
|
||
|
befindet. Somit galt er für alle Mandanten, die in dieser Installation
|
||
|
befand. Somit galt er für alle Mandanten, die in dieser Installation
|
||
|
benutzt wurden.</para>
|
||
|
|
||
|
<para>Mit der nachfolgenden Version wurde der Parameter zum Einen in
|
||
| ... | ... | |
|
<para>Die Konfiguration "<varname>eur</varname>" unter
|
||
|
<varname>[system]</varname> in der <link
|
||
|
linkend="config.config-file">Konfigurationsdatei</link>
|
||
|
<filename>config/lx_office.conf</filename> wird nun nicht mehr
|
||
|
<filename>config/kivitendo.conf</filename> wird nun nicht mehr
|
||
|
benötigt und kann entfernt werden. Dies muss manuell geschehen.</para>
|
||
|
</sect2>
|
||
|
|
||
| ... | ... | |
|
<title>Bemerkungen zu Bestandsmethode</title>
|
||
|
|
||
|
<para>Die Bestandsmethode ist eigentlich eine sehr elegante Methode,
|
||
|
funktioniert in Lx-Office aber nur unter bestimmten Bedingungen:
|
||
|
funktioniert in kivitendo aber nur unter bestimmten Bedingungen:
|
||
|
Voraussetzung ist, daß auch immer alle Einkaufsrechnungen gepflegt
|
||
|
werden, und man beim Jahreswechsel nicht mit einer leeren Datenbank
|
||
|
anfängt, da bei jedem Verkauf anhand der gesamten Rechnungshistorie
|
||
| ... | ... | |
|
|
||
|
<para>Die Umsatzsteuerumstellung auf 19% für SKR04 für die
|
||
|
Steuerschlüssel "EU ohne USt-ID Nummer" ist erst 2010 erfolgt.
|
||
|
Lx-Office beinhaltet ein Upgradeskript, das das Konto 3804 automatisch
|
||
|
kivitendo beinhaltet ein Upgradeskript, das das Konto 3804 automatisch
|
||
|
erstellt und die Steuereinstellungen korrekt einstellt. Hat der
|
||
|
Benutzer aber schon selber das Konto 3804 angelegt, oder gab es schon
|
||
|
Buchungen im Zeitraum nach dem 01.01.2007 auf das Konto 3803, wird das
|
||
| ... | ... | |
|
</sect2>
|
||
|
</sect1>
|
||
|
|
||
|
<sect1 id="Lx-Office-ERP-verwenden">
|
||
|
<title>Lx-Office ERP verwenden</title>
|
||
|
<sect1 id="kivitendo-ERP-verwenden">
|
||
|
<title>kivitendo ERP verwenden</title>
|
||
|
|
||
|
<para>Nach erfolgreicher Installation ist der Loginbildschirm unter
|
||
|
folgender URL erreichbar:</para>
|
||
|
|
||
|
<para><ulink
|
||
|
url="http://localhost/lx-office-erp/login.pl">http://localhost/lx-office-erp/login.pl</ulink></para>
|
||
|
url="http://localhost/kivitendo-erp/login.pl">http://localhost/kivitendo-erp/login.pl</ulink></para>
|
||
|
|
||
|
<para>Die Administrationsseite erreichen Sie unter:</para>
|
||
|
|
||
|
<para><ulink
|
||
|
url="http://localhost/lx-office-erp/admin.pl">http://localhost/lx-office-erp/admin.pl</ulink></para>
|
||
|
url="http://localhost/kivitendo-erp/admin.pl">http://localhost/kivitendo-erp/admin.pl</ulink></para>
|
||
|
</sect1>
|
||
|
</chapter>
|
||
|
|
||
| ... | ... | |
|
Informationen zu den erstellten Rechnungen verschickt werden.
|
||
|
Konfiguriert wird dies in der <link
|
||
|
linkend="config.config-file.sections-parameters">Konfigurationsdatei</link>
|
||
|
<filename>config/lx_office.conf</filename> im Abschnitt
|
||
|
<filename>config/kivitendo.conf</filename> im Abschnitt
|
||
|
<varname>[periodic_invoices]</varname>.</para>
|
||
|
</sect2>
|
||
|
|
||
| ... | ... | |
|
linkend="dokumentenvorlagen-und-variablen.tag-style" />).</para>
|
||
|
|
||
|
<para>Früher wurde hier nur über LaTeX gesprochen. Inzwischen
|
||
|
unterstützt Lx-Office aber auch OpenDocument-Vorlagen. Sofern es nicht
|
||
|
unterstützt kivitendo aber auch OpenDocument-Vorlagen. Sofern es nicht
|
||
|
ausdrücklich eingeschränkt wird, gilt das im Folgenden gesagte für
|
||
|
alle Vorlagenarten.</para>
|
||
|
|
||
| ... | ... | |
|
|
||
|
<programlisting>% config: tag-style=($ $)</programlisting>
|
||
|
|
||
|
<para>Dies würde Lx-Office dazu veranlassen, Variablen zu ersetzen,
|
||
|
<para>Dies würde kivitendo dazu veranlassen, Variablen zu ersetzen,
|
||
|
wenn sie wie folgt aussehen: <function>($customer$)</function>. Das
|
||
|
äquivalente Beispiel für HTML-Dokumentenvorlagen sieht so aus:</para>
|
||
|
|
||
| ... | ... | |
|
<title>Markup-Code zur Textformatierung innerhalb von
|
||
|
Formularen</title>
|
||
|
|
||
|
<para>Wenn der Benutzer innhalb von Formularen in Lx-Office Text
|
||
|
<para>Wenn der Benutzer innhalb von Formularen in kivitendo Text
|
||
|
anders formatiert haben möchte, so ist dies begrenzt möglich.
|
||
|
Lx-Office unterstützt die Textformatierung mit HTML-ähnlichen Tags.
|
||
|
kivitendo unterstützt die Textformatierung mit HTML-ähnlichen Tags.
|
||
|
Der Benutzer kann z.B. bei der Artikelbeschreibung auf einer Rechnung
|
||
|
Teile des Texts zwischen Start- und Endtags setzen. Dieser Teil wird
|
||
|
dann automatisch in Anweisungen für das ausgewählte Vorlagenformat
|
||
| ... | ... | |
|
brauchbares Tracing gebaut ist, "<function>log_time</function>", mit
|
||
|
der man die Wallclockzeit seit Requeststart loggen kann, sowie
|
||
|
"<function>message</function>" und "<function>dump</function>" mit
|
||
|
denen man flott Informationen ins Log (tmp/lx-office-debug.log)
|
||
|
denen man flott Informationen ins Log (tmp/kivitendo-debug.log)
|
||
|
packen kann.</para>
|
||
|
|
||
|
<para>Beispielsweise so:</para>
|
||
| ... | ... | |
|
|
||
|
<listitem>
|
||
|
<para>Repräsentation der
|
||
|
<filename>config/lx_office.conf[.default]</filename>-Dateien</para>
|
||
|
<filename>config/kivitendo.conf[.default]</filename>-Dateien</para>
|
||
|
</listitem>
|
||
|
</itemizedlist>
|
||
|
|
||
| ... | ... | |
|
verfügbar:</para>
|
||
|
|
||
|
<programlisting>[debug]
|
||
|
file = /tmp/lx-office-debug.log</programlisting>
|
||
|
file = /tmp/kivitendo-debug.log</programlisting>
|
||
|
|
||
|
<para>ist der Key <varname>file</varname> im Programm als
|
||
|
<varname>$::lx_office_conf->{debug}{file}</varname>
|
||
| ... | ... | |
|
<sect2 id="devel.fcgi.general">
|
||
|
<title>Allgemeines</title>
|
||
|
|
||
|
<para>Wenn Änderungen in der Konfiguration von Lx-Office gemacht
|
||
|
<para>Wenn Änderungen in der Konfiguration von kivitendo gemacht
|
||
|
werden, muss der Webserver neu gestartet werden.</para>
|
||
|
|
||
|
<para>Bei der Entwicklung für FastCGI ist auf ein paar Fallstricke zu
|
||
| ... | ... | |
|
Fehler), werden mit dem FastCGI Dispatcher abgefangen, um das Programm
|
||
|
am Laufen zu halten. Man kann mit <function>die</function>,
|
||
|
<function>confess</function> oder <function>carp</function> Fehler
|
||
|
ausgeben, die dann vom Dispatcher angezeigt werden. Die Lx-Office
|
||
|
ausgeben, die dann vom Dispatcher angezeigt werden. Die kivitendo
|
||
|
eigene <function>$::form-</function>error()> tut im Prinzip das
|
||
|
Gleiche, mit ein paar Extraoptionen. <function>warn</function> und
|
||
|
<function>exit</function> hingegen werden nicht abgefangen.
|
||
|
<function>warn</function> wird direkt nach STDERR, also in Server Log
|
||
|
eine Nachricht schreiben (sofern in der Konfiguration nicht die
|
||
|
Warnungen in das Lx-Office Log umgeleitet wurden), und
|
||
|
Warnungen in das kivitendo Log umgeleitet wurden), und
|
||
|
<function>exit</function> wird die Ausführung beenden.</para>
|
||
|
|
||
|
<para>Prinzipiell ist es kein Beinbruch, wenn sich der Prozess
|
||
| ... | ... | |
|
|
||
|
<para>Die kritischen Pfade des Programms sind die Belegmasken, und
|
||
|
unter diesen ganz besonders die Verkaufsrechnungsmaske. Ein Aufruf der
|
||
|
Rechnungsmaske in Lx-Office 2.4.3 stable dauert auf einem Core2duo mit
|
||
|
Rechnungsmaske in kivitendo 2.4.3 stable dauert auf einem Core2duo mit
|
||
|
4GB Arbeitsspeicher und Ubuntu 9.10 eine halbe Sekunde. In der 2.6.0
|
||
|
sind es je nach Menge der definierten Variablen 1-2s. Ab der
|
||
|
Moose/Rose::DB Version sind es 5-6s.</para>
|
||
| ... | ... | |
|
diese Versionsnummer sucht, schränkt sehr ein, z.B. was die parallele
|
||
|
Entwicklung im stable- und unstable-Baum betrifft.</para>
|
||
|
|
||
|
<para>Dieser Mechanismus wurde für Lx-Office 2.4.1 deutlich erweitert.
|
||
|
<para>Dieser Mechanismus wurde für kivitendo 2.4.1 deutlich erweitert.
|
||
|
Es werden weiterhin alle Scripte aus sql/Pg-upgrade ausgeführt.
|
||
|
Zusätzlich gibt es aber ein zweites Verzeichnis, sql/Pg-upgrade2. In
|
||
|
diesem Verzeichnis muss pro Datenbankupgrade eine Datei existieren,
|
||
| ... | ... | |
|
angelegt wurde), diese Reihenfolge aber so flexibel ist, dass man
|
||
|
keine Versionsnummern mehr braucht.</para>
|
||
|
|
||
|
<para>Lx-Office merkt sich dabei, welches der Upgradescripte in
|
||
|
<para>kivitendo merkt sich dabei, welches der Upgradescripte in
|
||
|
sql/Pg-upgrade2 bereits durchgeführt wurde und führt diese nicht
|
||
|
erneut aus. Dazu dient die Tabelle "schema_info", die bei der
|
||
|
Anmeldung automatisch angelegt wird.</para>
|
||
| ... | ... | |
|
|
||
|
<listitem>
|
||
|
<para>Optional. Eine mit Leerzeichen getrennte Liste von "tags",
|
||
|
von denen dieses Upgradescript abhängt. Lx-Office stellt sicher,
|
||
|
von denen dieses Upgradescript abhängt. kivitendo stellt sicher,
|
||
|
dass die in dieser Liste aufgeführten Scripte bereits
|
||
|
durchgeführt wurden, bevor dieses Script ausgeführt wird.</para>
|
||
|
|
||
| ... | ... | |
|
der Wert 1000 benutzt.</para>
|
||
|
|
||
|
<para>Dies ist reine Kosmetik. Für echte Reihenfolgen muss
|
||
|
"depends" benutzt werden. Lx-Office sortiert die auszuführenden
|
||
|
"depends" benutzt werden. kivitendo sortiert die auszuführenden
|
||
|
Scripte zuerst nach der Abhängigkeitstiefe (wenn "z" von "y"
|
||
|
abhängt und "y" von "x", so hat "z" eine Abhängigkeitstiefe von
|
||
|
2, "y" von 1 und "x" von 0. "x" würde hier zuerst ausgeführt,
|
||
| ... | ... | |
|
<para>Um die Arbeit mit den Abhängigkeiten etwas zu erleichtern,
|
||
|
existiert ein Hilfsscript namens
|
||
|
"<filename>scripts/dbupgrade2_tool.pl</filename>". Es muss aus dem
|
||
|
Lx-Office-ERP-Basisverzeichnis heraus aufgerufen werden. Dieses Tool
|
||
|
kivitendo-ERP-Basisverzeichnis heraus aufgerufen werden. Dieses Tool
|
||
|
liest alle Datenbankupgradescripte aus dem Verzeichnis
|
||
|
<filename>sql/Pg-upgrade2</filename> aus. Es benutzt dafür die
|
||
|
gleichen Methoden wie Lx-Office selber, sodass alle Fehlersituationen
|
||
|
gleichen Methoden wie kivitendo selber, sodass alle Fehlersituationen
|
||
|
von der Kommandozeile überprüft werden können.</para>
|
||
|
|
||
|
<para>Wird dem Script kein weiterer Parameter übergeben, so wird nur
|
||
| ... | ... | |
|
--list</command>"</para>
|
||
|
|
||
|
<para>Gibt eine Liste aller Scripte aus. Die Liste ist in der
|
||
|
Reihenfolge sortiert, in der Lx-Office die Scripte ausführen
|
||
|
Reihenfolge sortiert, in der kivitendo die Scripte ausführen
|
||
|
würde. Es werden neben der Listenposition der Tag, die
|
||
|
Abhängigkeitstiefe und die Priorität ausgegeben.</para>
|
||
|
</listitem>
|
||
| ... | ... | |
|
internationalen Übersetzern die Arbeit zu erleichtern.</para>
|
||
|
</note>
|
||
|
|
||
|
<para>This section describes how localization packages in Lx-Office
|
||
|
<para>This section describes how localization packages in kivitendo
|
||
|
are built. Currently the only language fully supported is German, and
|
||
|
since most of the internal messages are held in English the English
|
||
|
version is usable too.</para>
|
||
| ... | ... | |
|
xreflabel="File structure">
|
||
|
<title>File structure</title>
|
||
|
|
||
|
<para>The structure of locales in Lx-Office is:</para>
|
||
|
<para>The structure of locales in kivitendo is:</para>
|
||
|
|
||
|
<programlisting>lx-office/locale/<langcode>/</programlisting>
|
||
|
<programlisting>kivitendo/locale/<langcode>/</programlisting>
|
||
|
|
||
|
<para>where <langcode> stands for an abbreviation of the
|
||
|
language package. The builtin packages use two letter <ulink
|
||
| ... | ... | |
|
<term>special_chars</term>
|
||
|
|
||
|
<listitem>
|
||
|
<para>Lx-Office comes with a lot of interfaces to different
|
||
|
<para>kivitendo comes with a lot of interfaces to different
|
||
|
formats, some of which are rather picky with their accepted
|
||
|
charset. The <filename>special_chars</filename> file contains a
|
||
|
listing of chars not suited for different file format and
|
||
| ... | ... | |
|
<listitem>
|
||
|
<para>Sämtliche Kommentare und Sonstiges im Quellcode ist bitte
|
||
|
auf Englisch zu verfassen. So wie ich keine Lust habe,
|
||
|
französischen Quelltext zu lesen, sollte auch der Lx-Office
|
||
|
französischen Quelltext zu lesen, sollte auch der kivitendo
|
||
|
Quelltext für nicht-Deutschsprachige lesbar sein.
|
||
|
Beispiel:</para>
|
||
|
|
||
| ... | ... | |
|
<para><varname>STDERR</varname> ist tabu. Unkonditionale
|
||
|
Debugmeldungen auch.</para>
|
||
|
|
||
|
<para>Lx-Office bietet mit dem Modul <classname>LXDebug</classname>
|
||
|
<para>kivitendo bietet mit dem Modul <classname>LXDebug</classname>
|
||
|
einen brauchbaren Trace-/Debug-Mechanismus. Es gibt also keinen
|
||
|
Grund, nach <varname>STDERR</varname> zu schreiben.</para>
|
||
|
|
||
| ... | ... | |
|
<para>Bei <productname>DocBook</productname> ist Prinzip, dass
|
||
|
ausschließlich die XML-Quelldatei bearbeitet wird. Aus dieser werden
|
||
|
dann mit entsprechenden Stylesheets andere Formate wie PDF oder HTML
|
||
|
erzeugt. Bei Lx-Office übernimmt diese Aufgabe das Shell-Script
|
||
|
erzeugt. Bei kivitendo übernimmt diese Aufgabe das Shell-Script
|
||
|
<command>scripts/build_doc.sh</command>.</para>
|
||
|
|
||
|
<para>Das Script benötigt zur Konvertierung verschiedene
|
||
|
Softwarekomponenten, die im normalen Lx-Office-Betrieb nicht benötigt
|
||
|
Softwarekomponenten, die im normalen kivitendo-Betrieb nicht benötigt
|
||
|
werden:</para>
|
||
|
|
||
|
<itemizedlist>
|
||
| ... | ... | |
|
|
||
|
<para>Die eigentliche Konvertierung erfolgt nach Installation der
|
||
|
benötigten Software mit einem einfachen Aufruf direkt aus dem
|
||
|
Lx-Office-Installationsverzeichnis heraus:</para>
|
||
|
kivitendo-Installationsverzeichnis heraus:</para>
|
||
|
|
||
|
<programlisting>./scripts/build_doc.sh</programlisting>
|
||
|
</sect2>
|
||
| doc/html/ch01.html | ||
|---|---|---|
|
<html><head>
|
||
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
|
<title>Kapitel 1. Aktuelle Hinweise</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="index.html" title="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="prev" href="index.html" title="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="next" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Kapitel 1. Aktuelle Hinweise</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Zurück</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch02.html">Weiter</a></td></tr></table><hr></div><div class="chapter" title="Kapitel 1. Aktuelle Hinweise"><div class="titlepage"><div><div><h2 class="title"><a name="Aktuelle-Hinweise"></a>Kapitel 1. Aktuelle Hinweise</h2></div></div></div><p>Aktuelle Installations- und Konfigurationshinweise gibt es:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>auf der Lx-Office-Homepage unter <a class="ulink" href="http://lx-office.org/index.php?id=dokumentation" target="_top">http://lx-office.org/index.php?id=dokumentation</a>
|
||
|
</p></li><li class="listitem"><p>im Lx-Office-Wiki unter Dokumentation (<a class="ulink" href="http://wiki.lx-office.org/index.php/Lx-Office_ERP" target="_top">http://wiki.lx-office.org/index.php/Lx-Office_ERP</a>)</p></li><li class="listitem"><p>im Lx-Office-Forum: <a class="ulink" href="http://www.lx-office.org/forum/" target="_top">http://www.lx-office.org/forum/</a>
|
||
|
</p></li></ul></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Zurück</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch02.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">Lx-Office: Installation, Konfiguration, Entwicklung </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> Kapitel 2. Installation und Grundkonfiguration</td></tr></table></div></body></html>
|
||
|
<title>Kapitel 1. Aktuelle Hinweise</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo: Installation, Konfiguration, Entwicklung"><link rel="up" href="index.html" title="kivitendo: Installation, Konfiguration, Entwicklung"><link rel="prev" href="index.html" title="kivitendo: Installation, Konfiguration, Entwicklung"><link rel="next" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Kapitel 1. Aktuelle Hinweise</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Zurück</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch02.html">Weiter</a></td></tr></table><hr></div><div class="chapter" title="Kapitel 1. Aktuelle Hinweise"><div class="titlepage"><div><div><h2 class="title"><a name="Aktuelle-Hinweise"></a>Kapitel 1. Aktuelle Hinweise</h2></div></div></div><p>Aktuelle Installations- und Konfigurationshinweise gibt es:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>im kivitendo-Forum: <a class="ulink" href="https://forum.kivitendo.org/" target="_top">https://forum.kivitendo.org/</a>
|
||
|
</p></li><li class="listitem"><p>im alten Lx-Office-Wiki unter Dokumentation (<a class="ulink" href="http://wiki.lx-office.org/index.php?title=Installation_Lx-Office_ERP" target="_top">http://wiki.lx-office.org/index.php?title=Installation_Lx-Office_ERP</a>)</p></li></ul></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Zurück</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch02.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">kivitendo: Installation, Konfiguration, Entwicklung </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> Kapitel 2. Installation und Grundkonfiguration</td></tr></table></div></body></html>
|
||
| doc/html/ch02.html | ||
|---|---|---|
|
<html><head>
|
||
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
|
<title>Kapitel 2. Installation und Grundkonfiguration</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="index.html" title="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="prev" href="ch01.html" title="Kapitel 1. Aktuelle Hinweise"><link rel="next" href="ch02s02.html" title="2.2. Manuelle Installation des Programmpaketes"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Kapitel 2. Installation und Grundkonfiguration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01.html">Zurück</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch02s02.html">Weiter</a></td></tr></table><hr></div><div class="chapter" title="Kapitel 2. Installation und Grundkonfiguration"><div class="titlepage"><div><div><h2 class="title"><a name="config"></a>Kapitel 2. Installation und Grundkonfiguration</h2></div></div></div><div class="sect1" title="2.1. Benötigte Software und Pakete"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Ben%C3%B6tigte-Software-und-Pakete"></a>2.1. Benötigte Software und Pakete</h2></div></div></div><div class="sect2" title="2.1.1. Betriebssystem"><div class="titlepage"><div><div><h3 class="title"><a name="Betriebssystem"></a>2.1.1. Betriebssystem</h3></div></div></div><p>Lx-Office ist für Linux konzipiert, und sollte auf jedem
|
||
|
<title>Kapitel 2. Installation und Grundkonfiguration</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo: Installation, Konfiguration, Entwicklung"><link rel="up" href="index.html" title="kivitendo: Installation, Konfiguration, Entwicklung"><link rel="prev" href="ch01.html" title="Kapitel 1. Aktuelle Hinweise"><link rel="next" href="ch02s02.html" title="2.2. Manuelle Installation des Programmpaketes"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Kapitel 2. Installation und Grundkonfiguration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01.html">Zurück</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch02s02.html">Weiter</a></td></tr></table><hr></div><div class="chapter" title="Kapitel 2. Installation und Grundkonfiguration"><div class="titlepage"><div><div><h2 class="title"><a name="config"></a>Kapitel 2. Installation und Grundkonfiguration</h2></div></div></div><div class="sect1" title="2.1. Benötigte Software und Pakete"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Ben%C3%B6tigte-Software-und-Pakete"></a>2.1. Benötigte Software und Pakete</h2></div></div></div><div class="sect2" title="2.1.1. Betriebssystem"><div class="titlepage"><div><div><h3 class="title"><a name="Betriebssystem"></a>2.1.1. Betriebssystem</h3></div></div></div><p>kivitendo 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.</p><p>Anfang 2012 sind das folgende Systeme, von denen bekannt ist,
|
||
|
dass Lx-Office auf ihnen läuft:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Ubuntu 8.04 LTS Hardy Heron, 10.04 LTS Lucid Lynx bis 11.10
|
||
|
Oneiric Ocelot</p></li><li class="listitem"><p>Debian 5.0 Lenny und 6.0 Squeeze</p></li><li class="listitem"><p>openSUSE 11.2 und 11.3</p></li><li class="listitem"><p>SuSE Linux Enterprice Server 11</p></li><li class="listitem"><p>Fedora 13 bis 15</p></li></ul></div><p>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.</p><p>Alternativ dazu kann die normale Installation durchgeführt
|
||
|
werden (siehe <a class="xref" href="ch02s02.html" title="2.2. Manuelle Installation des Programmpaketes">Manuelle Installation des Programmpaketes</a>), wenn vorher
|
||
|
ein Kompatibilitätspaket installiert wird, das die fehlenden Pakete
|
||
|
bereitstellt. Das Paket ist auf <a class="ulink" href="https://sourceforge.net/projects/lx-office/files/Lx-Office%20ERP/2.6.3/" target="_top">Sourceforge</a>
|
||
|
unter dem Namen <code class="filename">lx-erp-perl-libs-compat-v2.tar.gz</code>
|
||
|
hinterlegt.</p><p>Zur Installation das Paket in das entpackte Lx-Office
|
||
|
Verzeichnis entpacken:</p><pre class="programlisting">tar xzf lx-erp-perl-libs-compat-v2.tar.gz /path/to/lx-office/</pre><p>Zusätzlich müssen dann noch die folgenden Pakete installiert
|
||
|
weerden</p><pre class="programlisting">apt-get install libbit-vector-perl libsub-exporter-perl libclone-perl \
|
||
|
libclass-factory-util-perl</pre><p>Danach sollte der Installationscheck (siehe <a class="xref" href="ch02.html#Pakete" title="2.1.2. Pakete">Pakete</a>) die enthaltenen Pakete erkennen.</p></div><div class="sect2" title="2.1.2. Pakete"><div class="titlepage"><div><div><h3 class="title"><a name="Pakete"></a>2.1.2. Pakete</h3></div></div></div><p>Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist
|
||
|
Distributionen läuft.</p><p>Mitte 2012 sind das folgende Systeme, von denen bekannt ist,
|
||
|
dass kivitendo auf ihnen läuft:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Ubuntu 10.04 LTS Lucid Lynx bis 12.04 Precise Pangolin</p></li><li class="listitem"><p>Debian 5.0 Lenny und 6.0 Squeeze</p></li><li class="listitem"><p>openSUSE 11.2 und 11.3</p></li><li class="listitem"><p>SuSE Linux Enterprice Server 11</p></li><li class="listitem"><p>Fedora 13 bis 16</p></li></ul></div></div><div class="sect2" title="2.1.2. Pakete"><div class="titlepage"><div><div><h3 class="title"><a name="Pakete"></a>2.1.2. Pakete</h3></div></div></div><p>Zum Betrieb von kivitendo werden zwingend ein Webserver (meist
|
||
|
Apache) und ein Datenbankserver (PostgreSQL, mindestens v8.2)
|
||
|
benötigt.</p><p>Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die
|
||
|
benötigt.</p><p>Zusätzlich benötigt kivitendo die folgenden Perl-Pakete, die
|
||
|
nicht Bestandteil einer Standard-Perl-Installation sind:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>parent</p></li><li class="listitem"><p>Archive::Zip</p></li><li class="listitem"><p>Config::Std</p></li><li class="listitem"><p>DateTime</p></li><li class="listitem"><p>DBI</p></li><li class="listitem"><p>DBD::Pg</p></li><li class="listitem"><p>Email::Address</p></li><li class="listitem"><p>JSON</p></li><li class="listitem"><p>List::MoreUtils</p></li><li class="listitem"><p>Params::Validate</p></li><li class="listitem"><p>PDF::API2</p></li><li class="listitem"><p>Rose::Object</p></li><li class="listitem"><p>Rose::DB</p></li><li class="listitem"><p>Rose::DB::Object</p></li><li class="listitem"><p>Template</p></li><li class="listitem"><p>Text::CSV_XS</p></li><li class="listitem"><p>Text::Iconv</p></li><li class="listitem"><p>URI</p></li><li class="listitem"><p>XML::Writer</p></li><li class="listitem"><p>YAML</p></li></ul></div><p>Gegenüber Version 2.6.0 sind zu dieser Liste 2 Pakete
|
||
|
hinzugekommen, <code class="literal">URI</code> und
|
||
|
<code class="literal">XML::Writer</code> sind notwendig. Ohne startet Lx-Office
|
||
|
<code class="literal">XML::Writer</code> sind notwendig. Ohne startet kivitendo
|
||
|
nicht.</p><p>Gegenüber Version 2.6.1 sind <code class="literal">parent</code>,
|
||
|
<code class="literal">DateTime</code>, <code class="literal">Rose::Object</code>,
|
||
|
<code class="literal">Rose::DB</code> und <code class="literal">Rose::DB::Object</code>
|
||
| ... | ... | |
|
hinzugekommen.</p><p>
|
||
|
<code class="literal">Email::Address</code> und
|
||
|
<code class="literal">List::MoreUtils</code> sind schon länger feste
|
||
|
Abhängigkeiten, wurden aber bisher mit Lx-Office mitgeliefert. Beide
|
||
|
Abhängigkeiten, wurden aber bisher mit kivitendo 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
|
||
| ... | ... | |
|
perl-URI perl-XML-Writer perl-YAML</pre><p>Bei openSuSE 11 ist <code class="literal">parent</code> bereits enthalten,
|
||
|
und braucht nicht nachinstalliert werden. Die
|
||
|
<code class="literal">Rose::*</code> Pakete sind derzeit nicht für SuSE gepackt,
|
||
|
und müssen anderweitig nachinstalliert werden.</p><p>Lx-Office enthält ein Script, mit dem überprüft werden kann, ob
|
||
|
und müssen anderweitig nachinstalliert werden.</p><p>kivitendo enthält ein Script, mit dem überprüft werden kann, ob
|
||
|
alle benötigten Perl-Module installiert sind. Der Aufruf lautet wie
|
||
|
folgt:</p><pre class="programlisting">./scripts/installation_check.pl</pre></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch01.html">Zurück</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch02s02.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">Kapitel 1. Aktuelle Hinweise </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.2. Manuelle Installation des Programmpaketes</td></tr></table></div></body></html>
|
||
| doc/html/ch02s02.html | ||
|---|---|---|
|
<html><head>
|
||
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
|
<title>2.2. Manuelle Installation des Programmpaketes</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="next" href="ch02s03.html" title="2.3. Lx-Office-Konfigurationsdatei"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.2. Manuelle Installation des Programmpaketes</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s03.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.2. Manuelle Installation des Programmpaketes"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Manuelle-Installation-des-Programmpaketes"></a>2.2. Manuelle Installation des Programmpaketes</h2></div></div></div><p>Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.6.3.tgz) wird
|
||
|
<title>2.2. Manuelle Installation des Programmpaketes</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="next" href="ch02s03.html" title="2.3. kivitendo-Konfigurationsdatei"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.2. Manuelle Installation des Programmpaketes</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s03.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.2. Manuelle Installation des Programmpaketes"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Manuelle-Installation-des-Programmpaketes"></a>2.2. Manuelle Installation des Programmpaketes</h2></div></div></div><p>Die kivitendo ERP Installationsdatei (kivitendo-erp-2.6.3.tgz) wird
|
||
|
im Dokumentenverzeichnis des Webservers (z.B.
|
||
|
<code class="filename">/var/www/html/</code>,
|
||
|
<code class="filename">/srv/www/htdocs</code> oder
|
||
|
<code class="filename">/var/www/</code>) entpackt:</p><pre class="programlisting">cd /var/www tar xvzf
|
||
|
lxoffice-erp-2.6.3.tgz</pre><p>Verändern Sie evtl. noch den Namen des Verzeichnisses und wechseln Sie in es:</p><pre class="programlisting">mv lxoffice-erp/ lx-erp/
|
||
|
cd lx-erp</pre><p>Alternativ können Sie auch einen Alias in der
|
||
|
<code class="filename">/var/www/</code>) entpackt:</p><pre class="programlisting">cd /var/www
|
||
|
tar xvzf kivitendo-erp-2.6.3.tgz</pre><p>Wechseln Sie in das entpackte Verzeichnis:</p><pre class="programlisting">cd kivitendo-erp</pre><p>Alternativ können Sie auch einen Alias in der
|
||
|
Webserverkonfiguration benutzen, um auf das tatsächliche
|
||
|
Installationsverzeichnis zu verweisen.</p><p>Die Verzeichnisse <code class="filename">users</code>, <code class="filename">spool</code> und <code class="filename">webdav</code> 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. Die Benutzer- und
|
||
|
Gruppennamen sind bei verschiedenen Distributionen unterschiedlich (z.B. bei Debian/Ubuntu <code class="constant">www-data</code>, bei Fedora
|
||
|
core <code class="constant">apache</code> oder bei OpenSuSE <code class="constant">wwwrun</code>).</p><p>Der folgende Befehl ändert den Besitzer für die oben genannten
|
||
|
Verzeichnisse auf einem Debian/Ubuntu-System:</p><pre class="programlisting">chown -R www-data users spool webdav</pre><p>Weiterhin muss der Webserver-Benutzer in den Verzeichnissen <code class="filename">templates</code> und <code class="filename">users</code>
|
||
|
Unterverzeichnisse für jeden neuen Benutzer anlegen dürfen, der in Lx-Office angelegt wird:</p><pre class="programlisting">chown www-data templates users</pre></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s03.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">Kapitel 2. Installation und Grundkonfiguration </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.3. Lx-Office-Konfigurationsdatei</td></tr></table></div></body></html>
|
||
|
Unterverzeichnisse für jeden neuen Benutzer anlegen dürfen, der in kivitendo angelegt wird:</p><pre class="programlisting">chown www-data templates users</pre></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s03.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">Kapitel 2. Installation und Grundkonfiguration </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.3. kivitendo-Konfigurationsdatei</td></tr></table></div></body></html>
|
||
| doc/html/ch02s03.html | ||
|---|---|---|
|
<html><head>
|
||
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
|
<title>2.3. Lx-Office-Konfigurationsdatei</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s02.html" title="2.2. Manuelle Installation des Programmpaketes"><link rel="next" href="ch02s04.html" title="2.4. Anpassung der PostgreSQL-Konfiguration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.3. Lx-Office-Konfigurationsdatei</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s02.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s04.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.3. Lx-Office-Konfigurationsdatei"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.config-file"></a>2.3. Lx-Office-Konfigurationsdatei</h2></div></div></div><div class="sect2" title="2.3.1. Einführung"><div class="titlepage"><div><div><h3 class="title"><a name="config.config-file.introduction"></a>2.3.1. Einführung</h3></div></div></div><p>Seit Lx-Office 2.6.3. gibt es nur noch eine Konfigurationsdatei
|
||
|
die benötigt wird: <code class="filename">config/lx_office.conf</code> (kurz:
|
||
|
<title>2.3. kivitendo-Konfigurationsdatei</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s02.html" title="2.2. Manuelle Installation des Programmpaketes"><link rel="next" href="ch02s04.html" title="2.4. Anpassung der PostgreSQL-Konfiguration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.3. kivitendo-Konfigurationsdatei</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s02.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s04.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.3. kivitendo-Konfigurationsdatei"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.config-file"></a>2.3. kivitendo-Konfigurationsdatei</h2></div></div></div><div class="sect2" title="2.3.1. Einführung"><div class="titlepage"><div><div><h3 class="title"><a name="config.config-file.introduction"></a>2.3.1. Einführung</h3></div></div></div><p>In kivitendo gibt es nur noch eine Konfigurationsdatei,
|
||
|
die benötigt wird: <code class="filename">config/kivitendo.conf</code> (kurz:
|
||
|
"die Hauptkonfigurationsdatei"). Diese muss bei der Erstinstallation
|
||
|
von Lx-Office bzw. der Migration von älteren Versionen angelegt
|
||
|
von kivitendo bzw. der Migration von älteren Versionen angelegt
|
||
|
werden.</p><p>Als Vorlage dient die Datei
|
||
|
<code class="filename">config/lx_office.conf.default</code> (kurz: "die
|
||
|
Default-Datei"):</p><pre class="programlisting">$ cp config/lx_office.conf.default config/lx_office.conf</pre><p>Die Default-Datei wird immer zuerst eingelesen. Werte, die in
|
||
|
<code class="filename">config/kivitendo.conf.default</code> (kurz: "die
|
||
|
Default-Datei"):</p><pre class="programlisting">$ cp config/kivitendo.conf.default config/kivitendo.conf</pre><p>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
|
||
|
Abschnitte und Werte enthalten, die von denen der Default-Datei
|
||
|
abweichen.</p><p>Diese Hauptkonfigurationsdatei ist dann eine
|
||
|
abweichen.</p><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="../../../../system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>
|
||
|
Vor der Umbenennung in kivitendo hieß diese Datei noch <code class="filename">config/lx_office.conf</code>. Aus Gründen der Kompatibilität
|
||
|
wird diese Datei eingelesen, sofern die Datei <code class="filename">config/kivitendo.conf</code> nicht existiert.
|
||
|
</p></td></tr></table></div><p>Diese Hauptkonfigurationsdatei ist dann eine
|
||
|
installationsspezifische Datei, d.h. sie enthält bspw. lokale
|
||
|
Passwörter und wird auch nicht im Versionsmanagement (git)
|
||
|
verwaltet.</p><p>Die Konfiguration ist ferner serverabhängig, d.h. für alle
|
||
| ... | ... | |
|
[authentication/database]
|
||
|
host = localhost
|
||
|
port = 5432
|
||
|
db = lxerp_auth
|
||
|
db = kivitendo_auth
|
||
|
user = postgres
|
||
|
password =
|
||
|
|
||
| ... | ... | |
|
angeben, der nach Erstellung der Rechnungen eine entsprechende E-Mail
|
||
|
mit Informationen über die erstellten Rechnungen bekommt.</p><p>Nutzt man den <a class="link" href="ch02s06.html" title="2.6. Der Task-Server">Taskserver</a> für <a class="link" href="ch03.html#features.periodic-invoices" title="3.1. Wiederkehrende Rechnungen">wiederkehrende Rechnungen</a>,
|
||
|
muss unter <code class="varname">[task_server]</code> ein Login eines Benutzers
|
||
|
angegeben werden, mit dem sich der Taskserver an Lx-Office bei der
|
||
|
angegeben werden, mit dem sich der Taskserver an kivitendo bei der
|
||
|
Datenbank anmeldet, die dem Benutzer zugewiesen ist.</p><p>Für Entwickler finden sich unter <code class="varname">[debug]</code>
|
||
|
wichtige Funktionen, um die Fehlersuche zu erleichtern.</p></div><div class="sect2" title="2.3.3. Versionen vor 2.6.3"><div class="titlepage"><div><div><h3 class="title"><a name="config.config-file.prior-versions"></a>2.3.3. Versionen vor 2.6.3</h3></div></div></div><p>In älteren Lx-Office Versionen gab es im Verzeichnis
|
||
|
wichtige Funktionen, um die Fehlersuche zu erleichtern.</p></div><div class="sect2" title="2.3.3. Versionen vor 2.6.3"><div class="titlepage"><div><div><h3 class="title"><a name="config.config-file.prior-versions"></a>2.3.3. Versionen vor 2.6.3</h3></div></div></div><p>In älteren kivitendo Versionen gab es im Verzeichnis
|
||
|
<code class="filename">config</code> die Dateien
|
||
|
<code class="filename">authentication.pl</code> und
|
||
|
<code class="filename">lx-erp.conf</code>, die jeweils Perl-Dateien waren. Es
|
||
|
gab auch die Möglichkeit, eine lokale Version der Konfigurationsdatei
|
||
|
zu erstellen (<code class="filename">lx-erp-local.conf</code>). Dies ist ab
|
||
|
2.6.3 nicht mehr möglich, aber auch nicht mehr nötig.</p><p>Beim Update von einer Lx-Office-Version vor 2.6.3 auf 2.6.3 oder
|
||
|
2.6.3 nicht mehr möglich, aber auch nicht mehr nötig.</p><p>Beim Update von einer kivitendo-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
|
||
|
gelöscht oder verschoben werden. Ansonsten zeigt kivitendo eine
|
||
|
entsprechende Fehlermeldung an.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s02.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s04.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.2. Manuelle Installation des Programmpaketes </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.4. Anpassung der PostgreSQL-Konfiguration</td></tr></table></div></body></html>
|
||
| doc/html/ch02s04.html | ||
|---|---|---|
|
<html><head>
|
||
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
|
<title>2.4. Anpassung der PostgreSQL-Konfiguration</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s03.html" title="2.3. Lx-Office-Konfigurationsdatei"><link rel="next" href="ch02s05.html" title="2.5. Webserver-Konfiguration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.4. Anpassung der PostgreSQL-Konfiguration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s03.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s05.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.4. Anpassung der PostgreSQL-Konfiguration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Anpassung-der-PostgreSQL-Konfiguration"></a>2.4. Anpassung der PostgreSQL-Konfiguration</h2></div></div></div><p>PostgreSQL muss auf verschiedene Weisen angepasst werden.</p><div class="sect2" title="2.4.1. Zeichensätze/die Verwendung von UTF-8"><div class="titlepage"><div><div><h3 class="title"><a name="Zeichens%C3%A4tze-die-Verwendung-von-UTF-8"></a>2.4.1. Zeichensätze/die Verwendung von UTF-8</h3></div></div></div><p>Lx-Office kann komplett mit UTF-8 als Zeichensatz verwendet
|
||
|
<title>2.4. Anpassung der PostgreSQL-Konfiguration</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s03.html" title="2.3. kivitendo-Konfigurationsdatei"><link rel="next" href="ch02s05.html" title="2.5. Webserver-Konfiguration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.4. Anpassung der PostgreSQL-Konfiguration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s03.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s05.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.4. Anpassung der PostgreSQL-Konfiguration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Anpassung-der-PostgreSQL-Konfiguration"></a>2.4. Anpassung der PostgreSQL-Konfiguration</h2></div></div></div><p>PostgreSQL muss auf verschiedene Weisen angepasst werden.</p><div class="sect2" title="2.4.1. Zeichensätze/die Verwendung von UTF-8"><div class="titlepage"><div><div><h3 class="title"><a name="Zeichens%C3%A4tze-die-Verwendung-von-UTF-8"></a>2.4.1. Zeichensätze/die Verwendung von UTF-8</h3></div></div></div><p>kivitendo kann komplett mit UTF-8 als Zeichensatz verwendet
|
||
|
werden. Dabei gibt es zwei Punkte zu beachten: PostgreSQL muss in
|
||
|
Version 8.2 oder neuer benutzt werden, und der
|
||
|
PostgreSQL-Datenbankcluster muss ebenfalls mit UTF-8 als Locale
|
||
|
angelegt worden sein.</p><p>Dieses ist kann überprüft werden: ist das Encoding der Datenbank
|
||
|
“template1” “UTF8”, so kann auch Lx-Office mit UTF-8 betrieben werden.
|
||
|
“template1” “UTF8”, so kann auch kivitendo mit UTF-8 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:</p><pre class="programlisting">pg_createcluster --locale=de_DE.UTF-8 --encoding=UTF-8 8.2 clustername</pre><p>Die Datenbankversionsnummer muss an die tatsächlich verwendete
|
||
|
Versionsnummer angepasst werden.</p><p>Unter anderen Distributionen gibt es ähnliche Methoden.</p><p>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.</p><p>Das Encoding einer Datenbank kann in <span class="command"><strong>psql</strong></span> mit
|
||
|
kivitendo mit ISO-8859-15 als Encoding betrieben werden.</p><p>Das Encoding einer Datenbank kann in <span class="command"><strong>psql</strong></span> mit
|
||
|
<code class="literal">\l</code> geprüft werden.</p></div><div class="sect2" title="2.4.2. Änderungen an Konfigurationsdateien"><div class="titlepage"><div><div><h3 class="title"><a name="%C3%84nderungen-an-Konfigurationsdateien"></a>2.4.2. Änderungen an Konfigurationsdateien</h3></div></div></div><p>In der Datei <code class="filename">postgresql.conf</code>, die je nach
|
||
|
Distribution in verschiedenen Verzeichnissen liegen kann (z.B.
|
||
|
<code class="filename">/var/lib/pgsql/data/</code> oder
|
||
|
<code class="filename">/etc/postgresql/</code>, muss sichergestellt werden,
|
||
|
dass TCP/IP-Verbindungen aktiviert sind. Das Verhalten wird über den
|
||
|
Parameter <code class="varname">listen_address</code> gesteuert. Laufen
|
||
|
PostgreSQL und Lx-Office auf demselben Rechner, so kann dort der Wert
|
||
|
PostgreSQL und kivitendo auf demselben Rechner, so kann dort der Wert
|
||
|
<code class="literal">localhost</code> verwendet werden. Andernfalls müssen
|
||
|
Datenbankverbindungen auch von anderen Rechnern aus zugelassen werden,
|
||
|
was mit dem Wert <code class="literal">*</code> geschieht.</p><p>In der Datei <code class="filename">pg_hba.conf</code>, die im gleichen
|
||
| ... | ... | |
|
werden. Hier gibt es mehrere Möglichkeiten. Eine besteht darin, lokale
|
||
|
Verbindungen immer zuzulassen:</p><pre class="programlisting">local all all trust
|
||
|
host all all 127.0.0.1 255.0.0.0 trust</pre><p>Besser ist es, für eine bestimmte Datenbank Zugriff nur per
|
||
|
Passwort zuzulassen. Beispielsweise:</p><pre class="programlisting">local all lxoffice password
|
||
|
host all lxoffice 127.0.0.1 255.255.255.255 password</pre></div><div class="sect2" title="2.4.3. Erweiterung für servergespeicherte Prozeduren"><div class="titlepage"><div><div><h3 class="title"><a name="Erweiterung-f%C3%BCr-servergespeicherte-Prozeduren"></a>2.4.3. Erweiterung für servergespeicherte Prozeduren</h3></div></div></div><p>In der Datenbank <code class="literal">template1</code> muss die
|
||
|
Passwort zuzulassen. Beispielsweise:</p><pre class="programlisting">local all kivitendo password
|
||
|
host all kivitendo 127.0.0.1 255.255.255.255 password</pre></div><div class="sect2" title="2.4.3. Erweiterung für servergespeicherte Prozeduren"><div class="titlepage"><div><div><h3 class="title"><a name="Erweiterung-f%C3%BCr-servergespeicherte-Prozeduren"></a>2.4.3. Erweiterung für servergespeicherte Prozeduren</h3></div></div></div><p>In der Datenbank <code class="literal">template1</code> 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:</p><pre class="programlisting">create language 'plpgsql';</pre></div><div class="sect2" title="2.4.4. Datenbankbenutzer anlegen"><div class="titlepage"><div><div><h3 class="title"><a name="Datenbankbenutzer-anlegen"></a>2.4.4. Datenbankbenutzer anlegen</h3></div></div></div><p>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:</p><pre class="programlisting">su - postgres createuser -d -P lxoffice</pre><p>Wenn Sie später einen Datenbankzugriff konfigurieren, verändern
|
||
|
Sie den evtl. voreingestellten Benutzer “postgres” auf “lxoffice” bzw.
|
||
|
den hier gewählten Benutzernamen.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s03.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s05.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.3. Lx-Office-Konfigurationsdatei </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.5. Webserver-Konfiguration</td></tr></table></div></body></html>
|
||
|
können:</p><pre class="programlisting">su - postgres createuser -d -P kivitendo</pre><p>Wenn Sie später einen Datenbankzugriff konfigurieren, verändern
|
||
|
Sie den evtl. voreingestellten Benutzer “postgres” auf “kivitendo” bzw.
|
||
|
den hier gewählten Benutzernamen.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s03.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s05.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.3. kivitendo-Konfigurationsdatei </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.5. Webserver-Konfiguration</td></tr></table></div></body></html>
|
||
| doc/html/ch02s05.html | ||
|---|---|---|
|
<html><head>
|
||
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
|
<title>2.5. Webserver-Konfiguration</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s04.html" title="2.4. Anpassung der PostgreSQL-Konfiguration"><link rel="next" href="ch02s06.html" title="2.6. Der Task-Server"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.5. Webserver-Konfiguration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s04.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s06.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.5. Webserver-Konfiguration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Apache-Konfiguration"></a>2.5. Webserver-Konfiguration</h2></div></div></div><div class="sect2" title="2.5.1. Grundkonfiguration mittels CGI"><div class="titlepage"><div><div><h3 class="title"><a name="d0e511"></a>2.5.1. Grundkonfiguration mittels CGI</h3></div></div></div><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="../../../../system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>Für einen deutlichen Performanceschub sorgt die Ausführung
|
||
|
<title>2.5. Webserver-Konfiguration</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s04.html" title="2.4. Anpassung der PostgreSQL-Konfiguration"><link rel="next" href="ch02s06.html" title="2.6. Der Task-Server"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.5. Webserver-Konfiguration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s04.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s06.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.5. Webserver-Konfiguration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Apache-Konfiguration"></a>2.5. Webserver-Konfiguration</h2></div></div></div><div class="sect2" title="2.5.1. Grundkonfiguration mittels CGI"><div class="titlepage"><div><div><h3 class="title"><a name="d0e490"></a>2.5.1. Grundkonfiguration mittels CGI</h3></div></div></div><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="../../../../system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>Für einen deutlichen Performanceschub sorgt die Ausführung
|
||
|
mittels FastCGI/FCGI. Die Einrichtung wird ausführlich im Abschnitt
|
||
|
<a class="xref" href="ch02s05.html#Apache-Konfiguration.FCGI" title="2.5.2. Konfiguration für FastCGI/FCGI">Konfiguration für FastCGI/FCGI</a> beschrieben.</p></td></tr></table></div><p>Der Zugriff auf das Programmverzeichnis muss in der Apache
|
||
|
Webserverkonfigurationsdatei <code class="literal">httpd.conf</code> eingestellt
|
||
|
werden. Fügen Sie den folgenden Abschnitt dieser Datei oder einer
|
||
|
anderen Datei hinzu, die beim Starten des Webservers eingelesen
|
||
|
wird:</p><pre class="programlisting">AddHandler cgi-script .pl
|
||
|
Alias /lx-erp/ /var/www/lx-erp/
|
||
|
Alias /kivitendo-erp/ /var/www/kiviteno-erp/
|
||
|
|
||
|
<Directory /var/www/lx-erp>
|
||
|
<Directory /var/www/kivitendo-erp>
|
||
|
Options ExecCGI Includes FollowSymlinks
|
||
|
</Directory>
|
||
|
|
||
|
<Directory /var/www/lx-erp/users>
|
||
|
<Directory /var/www/kivitendo-erp/users>
|
||
|
Order Deny,Allow
|
||
|
Deny from All
|
||
|
</Directory></pre><p>Ersetzen Sie dabei die Pfade durch diejenigen, in die Sie vorher
|
||
|
das Lx-Office-Archiv entpacket haben.</p><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="../../../../system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>Vor den einzelnen Optionen muss bei einigen Distributionen ein
|
||
|
das kivitendo-Archiv entpacket haben.</p><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="../../../../system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>Vor den einzelnen Optionen muss bei einigen Distributionen ein
|
||
|
Plus ‘<code class="literal">+</code>’ gesetzt werden.</p></td></tr></table></div><p>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:</p><pre class="programlisting">EnableSendfile Off</pre></div><div class="sect2" title="2.5.2. Konfiguration für FastCGI/FCGI"><div class="titlepage"><div><div><h3 class="title"><a name="Apache-Konfiguration.FCGI"></a>2.5.2. Konfiguration für FastCGI/FCGI</h3></div></div></div><div class="sect3" title="2.5.2.1. Was ist FastCGI?"><div class="titlepage"><div><div><h4 class="title"><a name="Apache-Konfiguration.FCGI.WasIstEs"></a>2.5.2.1. Was ist FastCGI?</h4></div></div></div><p>Direkt aus <a class="ulink" href="http://de.wikipedia.org/wiki/FastCGI" target="_top">Wikipedia</a>
|
||
| ... | ... | |
|
Webserver. FastCGI ist vergleichbar zum Common Gateway Interface
|
||
|
(CGI), wurde jedoch entwickelt, um dessen Performance-Probleme zu
|
||
|
umgehen. </span>]
|
||
|
</p></div><div class="sect3" title="2.5.2.2. Warum FastCGI?"><div class="titlepage"><div><div><h4 class="title"><a name="Apache-Konfiguration.FCGI.Warum"></a>2.5.2.2. Warum FastCGI?</h4></div></div></div><p>Perl Programme (wie Lx-Office eines ist) werden nicht statisch
|
||
|
</p></div><div class="sect3" title="2.5.2.2. Warum FastCGI?"><div class="titlepage"><div><div><h4 class="title"><a name="Apache-Konfiguration.FCGI.Warum"></a>2.5.2.2. Warum FastCGI?</h4></div></div></div><p>Perl Programme (wie kivitendo 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
|
||
|
müssen, ist die Funktionalität von kivitendo 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
|
||
|
führt dazu dass ein kivitendo Aufruf der Kernmasken mittlerweile
|
||
|
deutlich länger dauert als früher, und dass davon 90% für das Laden
|
||
|
der Module verwendet wird.</p><p>Mit FastCGI werden nun die Module einmal geladen, und danach
|
||
|
wird nur die eigentliche Programmlogik ausgeführt.</p></div><div class="sect3" title="2.5.2.3. Getestete Kombinationen aus Webservern und Plugin"><div class="titlepage"><div><div><h4 class="title"><a name="Apache-Konfiguration.FCGI.WebserverUndPlugin"></a>2.5.2.3. Getestete Kombinationen aus Webservern und Plugin</h4></div></div></div><p>Folgende Kombinationen sind getestet:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Apache 2.2.11 (Ubuntu) und mod_fcgid.</p></li><li class="listitem"><p>Apache 2.2.11 (Ubuntu) und mod_fastcgi.</p></li></ul></div><p>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.</p><p>Als Perl Backend wird das Modul <code class="filename">FCGI.pm</code>
|
||
|
verwendet.</p><div class="warning" title="Warnung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warnung]" src="../../../../system/docbook-xsl/images/warning.png"></td><th align="left">Warnung</th></tr><tr><td align="left" valign="top"><p>FCGI 0.69 und höher ist extrem strict in der Behandlung von
|
||
|
Unicode, und verweigert bestimmte Eingaben von Lx-Office. Falls es
|
||
|
Unicode, und verweigert bestimmte Eingaben von kivitendo. Falls es
|
||
|
Probleme mit Umlauten in Ihrere Installation gibt, muss auf die
|
||
|
Vorgängerversion FCGI 0.68 ausgewichen werden.</p><p>Mit CPAN lässt sie sich die Vorgängerversion wie folgt
|
||
|
installieren:</p><pre class="programlisting">force install M/MS/MSTROUT/FCGI-0.68.tar.gz</pre></td></tr></table></div></div><div class="sect3" title="2.5.2.4. Konfiguration des Webservers"><div class="titlepage"><div><div><h4 class="title"><a name="Apache-Konfiguration.FCGI.Konfiguration"></a>2.5.2.4. Konfiguration des Webservers</h4></div></div></div><p>Bevor Sie versuchen, eine Lx-Office Installation unter FCGI
|
||
|
installieren:</p><pre class="programlisting">force install M/MS/MSTROUT/FCGI-0.68.tar.gz</pre></td></tr></table></div></div><div class="sect3" title="2.5.2.4. Konfiguration des Webservers"><div class="titlepage"><div><div><h4 class="title"><a name="Apache-Konfiguration.FCGI.Konfiguration"></a>2.5.2.4. Konfiguration des Webservers</h4></div></div></div><p>Bevor Sie versuchen, eine kivitendo 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.</p><p>Zuerst muss das FastCGI-Modul aktiviert werden. Dies kann
|
||
|
unter Debian/Ubuntu z.B. mit folgendem Befehl geschehen:</p><pre class="programlisting">a2enmod fcgid</pre><p>Die Konfiguration für die Verwendung von Lx-Office mit FastCGI
|
||
|
unter Debian/Ubuntu z.B. mit folgendem Befehl geschehen:</p><pre class="programlisting">a2enmod fcgid</pre><p>Die Konfiguration für die Verwendung von kivitendo mit FastCGI
|
||
|
erfolgt durch Anpassung der vorhandenen <code class="function">Alias</code>-
|
||
|
und <code class="function">Directory</code>-Direktiven. Dabei wird zwischen
|
||
|
dem Installationspfad von Lx-Office im Dateisystem
|
||
|
("<code class="filename">/path/to/lx-office-erp</code>") und der URL
|
||
|
unterschieden, unter der Lx-Office im Webbrowser erreichbar ist
|
||
|
("<code class="filename">/url/for/lx-office-erp</code>").</p><p>Folgender Konfigurationsschnipsel funktioniert mit
|
||
|
mod_fastcgi:</p><pre class="programlisting">AliasMatch ^/url/for/lx-office-erp/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fcgi
|
||
|
Alias /url/for/lx-office-erp/ /path/to/lx-office-erp/
|
||
|
dem Installationspfad von kivitendo im Dateisystem
|
||
|
("<code class="filename">/path/to/kivitendo-erp</code>") und der URL
|
||
|
unterschieden, unter der kivitendo im Webbrowser erreichbar ist
|
||
|
("<code class="filename">/url/for/kivitendo-erp</code>").</p><p>Folgender Konfigurationsschnipsel funktioniert mit
|
||
|
mod_fastcgi:</p><pre class="programlisting">AliasMatch ^/url/for/kivitendo-erp/[^/]+\.pl /path/to/kivitendo-erp/dispatcher.fcgi
|
||
|
Alias /url/for/kivitendo-erp/ /path/to/kivitendo-erp/
|
||
|
|
||
|
<Directory /path/to/lx-office-erp>
|
||
|
<Directory /path/to/kivitendo-erp>
|
||
|
AllowOverride All
|
||
|
Options ExecCGI Includes FollowSymlinks
|
||
|
Order Allow,Deny
|
||
|
Allow from All
|
||
|
</Directory>
|
||
|
|
||
|
<DirectoryMatch /path/to/lx-office-erp/users>
|
||
|
<DirectoryMatch /path/to/kivitendo-erp/users>
|
||
|
Order Deny,Allow
|
||
|
Deny from All
|
||
|
</DirectoryMatch></pre><p>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:</p><pre class="programlisting">FcgidMaxRequestLen 10485760</pre><p>Das ganze sollte dann so aussehen:</p><pre class="programlisting">AddHandler fcgid-script .fpl
|
||
|
AliasMatch ^/url/for/lx-office-erp/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fpl
|
||
|
Alias /url/for/lx-office-erp/ /path/to/lx-office-erp/
|
||
|
AliasMatch ^/url/for/kivitendo-erp/[^/]+\.pl /path/to/kivitendo-erp/dispatcher.fpl
|
||
|
Alias /url/for/kivitendo-erp/ /path/to/kivitendo-erp/
|
||
|
FcgidMaxRequestLen 10485760
|
||
|
|
||
|
<Directory /path/to/lx-office-erp>
|
||
|
<Directory /path/to/kivitendo-erp>
|
||
|
AllowOverride All
|
||
|
Options ExecCGI Includes FollowSymlinks
|
||
|
Order Allow,Deny
|
||
|
Allow from All
|
||
|
</Directory>
|
||
|
|
||
|
<DirectoryMatch /path/to/lx-office-erp/users>
|
||
|
<DirectoryMatch /path/to/kivitendo-erp/users>
|
||
|
Order Deny,Allow
|
||
|
Deny from All
|
||
|
</DirectoryMatch></pre><p>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.</p><p>Es ist möglich, die gleiche Lx-Office Version parallel unter
|
||
|
gibt es hier kleine Performance-Einbußen.</p><p>Es ist möglich, die gleiche kivitendo Version parallel unter
|
||
|
CGI und FastCGI zu betreiben. Dafür bleiben die Directorydirektiven
|
||
|
wie oben beschrieben, die URLs werden aber umgeleitet:</p><pre class="programlisting"># Zugriff über CGI
|
||
|
Alias /url/for/lx-office-erp /path/to/lx-office-erp
|
||
|
Alias /url/for/kivitendo-erp /path/to/kivitendo-erp
|
||
|
|
||
|
# Zugriff mit mod_fcgid:
|
||
|
AliasMatch ^/url/for/lx-office-erp-fcgid/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fpl
|
||
|
Alias /url/for/lx-office-erp-fcgid/ /path/to/lx-office-erp/</pre><p>Dann ist unter <code class="filename">/url/for/lx-office-erp/</code>
|
||
|
AliasMatch ^/url/for/kivitendo-erp-fcgid/[^/]+\.pl /path/to/kivitendo-erp/dispatcher.fpl
|
||
|
Alias /url/for/kivitendo-erp-fcgid/ /path/to/kivitendo-erp/</pre><p>Dann ist unter <code class="filename">/url/for/kivitendo-erp/</code>
|
||
|
die normale Version erreichbar, und unter
|
||
|
<code class="constant">/url/for/lx-office-erp-fcgid/</code> die
|
||
|
<code class="constant">/url/for/kivitendo-erp-fcgid/</code> die
|
||
|
FastCGI-Version.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s04.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s06.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.4. Anpassung der PostgreSQL-Konfiguration </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.6. Der Task-Server</td></tr></table></div></body></html>
|
||
| doc/html/ch02s06.html | ||
|---|---|---|
|
<html><head>
|
||
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
|
<title>2.6. Der Task-Server</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s05.html" title="2.5. Webserver-Konfiguration"><link rel="next" href="ch02s07.html" title="2.7. Benutzerauthentifizierung und Administratorpasswort"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.6. Der Task-Server</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s05.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s07.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.6. Der Task-Server"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.task-server"></a>2.6. Der Task-Server</h2></div></div></div><p>Der Task-Server ist ein Prozess, der im Hintergrund läuft, in
|
||
|
<title>2.6. Der Task-Server</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s05.html" title="2.5. Webserver-Konfiguration"><link rel="next" href="ch02s07.html" title="2.7. Benutzerauthentifizierung und Administratorpasswort"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.6. Der Task-Server</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s05.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s07.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.6. Der Task-Server"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.task-server"></a>2.6. Der Task-Server</h2></div></div></div><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.</p><div class="sect2" title="2.6.1. Verfügbare und notwendige Konfigurationsoptionen"><div class="titlepage"><div><div><h3 class="title"><a name="Konfiguration-des-Task-Servers"></a>2.6.1. Verfügbare und notwendige Konfigurationsoptionen</h3></div></div></div><p>Die Konfiguration erfolgt über den Abschnitt
|
||
|
<code class="literal">[task_server]</code> in der Datei
|
||
|
<code class="filename">config/lx_office.conf</code>. Die dort verfügbaren
|
||
|
<code class="filename">config/kivitendo.conf</code>. Die dort verfügbaren
|
||
|
Optionen sind:</p><div class="variablelist"><dl><dt><span class="term">
|
||
|
<code class="varname">login</code>
|
||
|
</span></dt><dd><p>gültiger Lx-Office-Benutzername, der benutzt wird, um die
|
||
|
</span></dt><dd><p>gültiger kivitendo-Benutzername, der benutzt wird, um die
|
||
|
zu verwendende Datenbankverbindung auszulesen. Der Benutzer muss
|
||
|
in der Administration angelegt werden. Diese Option muss
|
||
|
angegeben werden.</p></dd><dt><span class="term">
|
||
| ... | ... | |
|
<code class="varname">debug</code>
|
||
|
</span></dt><dd><p>Schaltet Debug-Informationen an und aus.</p></dd></dl></div></div><div class="sect2" title="2.6.2. Automatisches Starten des Task-Servers beim Booten"><div class="titlepage"><div><div><h3 class="title"><a name="Einbinden-in-den-Boot-Prozess"></a>2.6.2. Automatisches Starten des Task-Servers beim Booten</h3></div></div></div><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><p>Deshalb ist es möglich, ihn durch Setzen eines symbolischen
|
||
|
Starten automatisch in das kivitendo-Installationsverzeichnis.</p><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.</p><div class="sect3" title="2.6.2.1. SystemV-basierende Systeme (z.B. Debian, OpenSuSE, Fedora Core)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e695"></a>2.6.2.1. SystemV-basierende Systeme (z.B. Debian, OpenSuSE, Fedora
|
||
|
anstelle eines symbolischen Links verwendet werden können.</p><div class="sect3" title="2.6.2.1. SystemV-basierende Systeme (z.B. Debian, OpenSuSE, Fedora Core)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e674"></a>2.6.2.1. SystemV-basierende Systeme (z.B. Debian, OpenSuSE, Fedora
|
||
|
Core)</h4></div></div></div><p>Kopieren Sie die Datei
|
||
|
<code class="filename">scripts/boot/system-v/kivitendo-server</code>
|
||
|
nach <code class="filename">/etc/init.d/kivitendo-server</code>. Passen
|
||
| ... | ... | |
|
insserv kivitendo-task-server</pre></li><li class="listitem"><p>OpenSuSE und Fedora Core:</p><pre class="programlisting">chkconfig --add kivitendo-task-server</pre></li></ul></div><p>Danach kann der Task-Server mit dem folgenden Befehl gestartet
|
||
|
werden: <span class="command"><strong>/etc/init.d/kivitendo-task-server
|
||
|
start</strong></span>
|
||
|
</p></div><div class="sect3" title="2.6.2.2. Upstart-basierende Systeme (z.B. Ubuntu)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e725"></a>2.6.2.2. Upstart-basierende Systeme (z.B. Ubuntu)</h4></div></div></div><p>Kopieren Sie die Datei
|
||
|
</p></div><div class="sect3" title="2.6.2.2. Upstart-basierende Systeme (z.B. Ubuntu)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e704"></a>2.6.2.2. Upstart-basierende Systeme (z.B. Ubuntu)</h4></div></div></div><p>Kopieren Sie die Datei
|
||
|
<code class="filename">scripts/boot/upstart/kivitendo-task-server.conf</code>
|
||
|
nach <code class="filename">/etc/init/kivitendo-task-server.conf</code>.
|
||
|
Passen Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile
|
||
| ... | ... | |
|
neu.</p></li><li class="listitem"><p>
|
||
|
<code class="literal">status</code> berichtet, ob der Task-Server
|
||
|
läuft.</p></li></ul></div><p>Der Task-Server wechselt beim Starten automatisch in das
|
||
|
Lx-Office-Installationsverzeichnis.</p><p>Dieselben Optionen können auch für die SystemV-basierenden
|
||
|
kivitendo-Installationsverzeichnis.</p><p>Dieselben Optionen können auch für die SystemV-basierenden
|
||
|
Runlevel-Scripte benutzt werden (siehe oben).</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s05.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s07.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.5. Webserver-Konfiguration </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.7. Benutzerauthentifizierung und Administratorpasswort</td></tr></table></div></body></html>
|
||
| doc/html/ch02s07.html | ||
|---|---|---|
|
<html><head>
|
||
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
|
<title>2.7. Benutzerauthentifizierung und Administratorpasswort</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s06.html" title="2.6. Der Task-Server"><link rel="next" href="ch02s08.html" title="2.8. Benutzer- und Gruppenverwaltung"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.7. Benutzerauthentifizierung und Administratorpasswort</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s06.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s08.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.7. Benutzerauthentifizierung und Administratorpasswort"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Benutzerauthentifizierung-und-Administratorpasswort"></a>2.7. Benutzerauthentifizierung und Administratorpasswort</h2></div></div></div><p>Informationen über die Einrichtung der Benutzerauthentifizierung,
|
||
|
über die Verwaltung von Gruppen und weitere Einstellungen</p><div class="sect2" title="2.7.1. Grundlagen zur Benutzerauthentifizierung"><div class="titlepage"><div><div><h3 class="title"><a name="Grundlagen-zur-Benutzerauthentifizierung"></a>2.7.1. Grundlagen zur Benutzerauthentifizierung</h3></div></div></div><p>Lx-Office verwaltet die Benutzerinformationen in einer
|
||
|
<title>2.7. Benutzerauthentifizierung und Administratorpasswort</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s06.html" title="2.6. Der Task-Server"><link rel="next" href="ch02s08.html" title="2.8. Benutzer- und Gruppenverwaltung"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.7. Benutzerauthentifizierung und Administratorpasswort</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s06.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s08.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.7. Benutzerauthentifizierung und Administratorpasswort"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Benutzerauthentifizierung-und-Administratorpasswort"></a>2.7. Benutzerauthentifizierung und Administratorpasswort</h2></div></div></div><p>Informationen über die Einrichtung der Benutzerauthentifizierung,
|
||
|
über die Verwaltung von Gruppen und weitere Einstellungen</p><div class="sect2" title="2.7.1. Grundlagen zur Benutzerauthentifizierung"><div class="titlepage"><div><div><h3 class="title"><a name="Grundlagen-zur-Benutzerauthentifizierung"></a>2.7.1. Grundlagen zur Benutzerauthentifizierung</h3></div></div></div><p>kivitendo verwaltet die Benutzerinformationen in einer
|
||
|
Datenbank, die im folgenden “Authentifizierungsdatenbank” genannt
|
||
|
wird. Für jeden Benutzer kann dort eine eigene Datenbank für die
|
||
|
eigentlichen Finanzdaten hinterlegt sein. Diese beiden Datenbanken
|
||
|
können, müssen aber nicht unterschiedlich sein.</p><p>Im einfachsten Fall gibt es für Lx-Office nur eine einzige
|
||
|
können, müssen aber nicht unterschiedlich sein.</p><p>Im einfachsten Fall gibt es für kivitendo nur eine einzige
|
||
|
Datenbank, in der sowohl die Benutzerinformationen als auch die Daten
|
||
|
abgelegt werden.</p><p>Zusätzlich ermöglicht es Lx-Office, dass die Benutzerpasswörter
|
||
|
abgelegt werden.</p><p>Zusätzlich ermöglicht es kivitendo, dass die Benutzerpasswörter
|
||
|
entweder gegen die Authentifizierungsdatenbank oder gegen einen
|
||
|
LDAP-Server überprüft werden.</p><p>Welche Art der Passwortüberprüfung Lx-Office benutzt und wie
|
||
|
Lx-Office die Authentifizierungsdatenbank erreichen kann, wird in der
|
||
|
Konfigurationsdatei <code class="filename">config/lx_office.conf</code>
|
||
|
LDAP-Server überprüft werden.</p><p>Welche Art der Passwortüberprüfung kivitendo benutzt und wie
|
||
|
kivitendo die Authentifizierungsdatenbank erreichen kann, wird in der
|
||
|
Konfigurationsdatei <code class="filename">config/kivitendo.conf</code>
|
||
|
festgelegt. Diese muss bei der Installation und bei einem Upgrade von
|
||
|
einer Version vor v2.6.0 angelegt werden. Eine
|
||
|
Beispielkonfigurationsdatei
|
||
|
<code class="filename">config/lx_office.conf.default</code> existiert, die als
|
||
|
<code class="filename">config/kivitendo.conf.default</code> existiert, die als
|
||
|
Vorlage benutzt werden kann.</p></div><div class="sect2" title="2.7.2. Administratorpasswort"><div class="titlepage"><div><div><h3 class="title"><a name="Administratorpasswort"></a>2.7.2. Administratorpasswort</h3></div></div></div><p>Das Passwort, das zum Zugriff auf das Aministrationsinterface
|
||
|
benutzt wird, wird ebenfalls in dieser Datei gespeichert. Es kann auch
|
||
|
nur dort und nicht mehr im Administrationsinterface selber geändert
|
||
| ... | ... | |
|
<code class="literal">db</code>
|
||
|
</span></dt><dd><p>Der Name der Authentifizierungsdatenbank</p></dd><dt><span class="term">
|
||
|
<code class="literal">user</code>
|
||
|
</span></dt><dd><p>Der Benutzername, mit dem sich Lx-Office beim
|
||
|
</span></dt><dd><p>Der Benutzername, mit dem sich kivitendo beim
|
||
|
Datenbankserver anmeldet (z.B.
|
||
|
"<code class="literal">postgres</code>")</p></dd><dt><span class="term">
|
||
|
<code class="literal">password</code>
|
||
|
</span></dt><dd><p>Das Passwort für den Datenbankbenutzer</p></dd></dl></div><p>Die Datenbank muss noch nicht existieren. Lx-Office kann sie
|
||
|
automatisch anlegen (mehr dazu siehe unten).</p></div><div class="sect2" title="2.7.4. Passwortüberprüfung"><div class="titlepage"><div><div><h3 class="title"><a name="Passwort%C3%BCberpr%C3%BCfung"></a>2.7.4. Passwortüberprüfung</h3></div></div></div><p>Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen
|
||
|
</span></dt><dd><p>Das Passwort für den Datenbankbenutzer</p></dd></dl></div><p>Die Datenbank muss noch nicht existieren. kivitendo kann sie
|
||
Auch abrufbar als: Unified diff
Dokumentation: Lx-Office in kivitendo umbenennen