![[Anmerkung]](../../../../system/docbook-xsl/images/note.png) | Anmerkung |
|---|---|
Für einen deutlichen Performanceschub sorgt die Ausführung - mittels FastCGI/FCGI. Die Einrichtung wird ausführlich im Abschnitt - Konfiguration für FastCGI/FCGI beschrieben. |
Der Zugriff auf das Programmverzeichnis muss in der Apache
- Webserverkonfigurationsdatei httpd.conf eingestellt
- werden. Fügen Sie den folgenden Abschnitt dieser Datei oder einer
- anderen Datei hinzu, die beim Starten des Webservers eingelesen
- wird:
AddHandler cgi-script .pl -Alias /kivitendo-erp/ /var/www/kiviteno-erp/ +2.5. kivitendo-Konfigurationsdatei \ No newline at end of file +[system] +default_manager = germanIn kivitendo gibt es nur noch eine Konfigurationsdatei, die + benötigt wird:
config/kivitendo.conf(kurz: "die + Hauptkonfigurationsdatei"). Diese muss bei der Erstinstallation von + kivitendo bzw. der Migration von älteren Versionen angelegt + werden.Als Vorlage dient die Datei +
config/kivitendo.conf.default(kurz: "die + Default-Datei"):$ cp config/kivitendo.conf.default config/kivitendo.confDie 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.
Anmerkung Vor der Umbenennung in kivitendo hieà diese Datei noch +
config/lx_office.conf. Aus Gründen der + Kompatibilität wird diese Datei eingelesen, sofern die Datei +config/kivitendo.confnicht existiert.Diese Hauptkonfigurationsdatei ist dann eine + installationsspezifische Datei, d.h. sie enthält bspw. lokale + Passwörter und wird auch nicht im Versionsmanagement (git) + verwaltet.
Die Konfiguration ist ferner serverabhängig, d.h. für alle + Mandaten, bzw. Datenbanken gleich.
Die Konfigurationsdatei besteht aus mehreren Teilen, die + entsprechend kommentiert sind:
+
authentication(siehe Abschnitt "Abschnitt 2.10, âBenutzerauthentifizierung und Administratorpasswortâ" + in diesem Kapitel)+
authentication/database++
authentication/http_basic++
authentication/http_headers++
authentication/ldap++
system++
paths++
mail_delivery(siehe Abschnitt "E-Mail-Versand über einen SMTP-Server)+
imap_client(siehe Abschnitt "E-Mails in kivitendo importieren)+
sent_emails_in_imap(siehe Abschnitt "Versendete E-Mails über IMAP exportieren)+
applications++
environment++
print_templates++
task_server++
periodic_invoices++
self_tests++
console++
testing++
testing/database++
debug+Die üblicherweise wichtigsten Parameter, die am Anfang + einzustellen oder zu kontrollieren sind, sind:
[authentication] +admin_password = geheim -<Directory /var/www/kivitendo-erp> - Options ExecCGI Includes FollowSymlinks -</Directory> +[authentication/database] +host = localhost +port = 5432 +db = kivitendo_auth +user = postgres +password = -<Directory /var/www/kivitendo-erp/users> - Order Deny,Allow - Deny from All -</Directory>Ersetzen Sie dabei die Pfade durch diejenigen, in die Sie vorher - das kivitendo-Archiv entpacket haben.
Anmerkung Vor den einzelnen Optionen muss bei einigen Distributionen ein - Plus â
+â gesetzt werden.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:
EnableSendfile OffDirekt aus Wikipedia - kopiert:
- [ FastCGI ist ein Standard für die Einbindung - externer Software zur Generierung dynamischer Webseiten in einem - Webserver. FastCGI ist vergleichbar zum Common Gateway Interface - (CGI), wurde jedoch entwickelt, um dessen Performance-Probleme zu - umgehen. ] -
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 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 kivitendo Aufruf der Kernmasken mittlerweile - deutlich länger dauert als früher, und dass davon 90% für das Laden - der Module verwendet wird.
Mit FastCGI werden nun die Module einmal geladen, und danach - wird nur die eigentliche Programmlogik ausgeführt.
Folgende Kombinationen sind getestet:
Apache 2.2.11 (Ubuntu) und mod_fcgid.
Apache 2.2.11 (Ubuntu) und mod_fastcgi.
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.
Als Perl Backend wird das Modul
FCGI.pm- verwendet.
Warnung FCGI-Versionen ab 0.69 und bis zu 0.71 inklusive sind extrem strict in der Behandlung von Unicode, und verweigern - bestimmte Eingaben von kivitendo. Falls es Probleme mit Umlauten in Ihrere Installation gibt, muss zwingend Version 0.68 oder - aber Version 0.72 und neuer eingesetzt werden.
Mit CPAN lässt sie sich die Vorgängerversion wie folgt - installieren:
force install M/MS/MSTROUT/FCGI-0.68.tar.gzBevor 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.
Zuerst muss das FastCGI-Modul aktiviert werden. Dies kann - unter Debian/Ubuntu z.B. mit folgendem Befehl geschehen:
a2enmod fcgidDie Konfiguration für die Verwendung von kivitendo mit FastCGI - erfolgt durch Anpassung der vorhandenen
Alias- - undDirectory-Direktiven. Dabei wird zwischen - dem Installationspfad von kivitendo im Dateisystem - ("/path/to/kivitendo-erp") und der URL - unterschieden, unter der kivitendo im Webbrowser erreichbar ist - ("/url/for/kivitendo-erp").Folgender Konfigurationsschnipsel funktioniert mit - mod_fastcgi:
AliasMatch ^/url/for/kivitendo-erp/[^/]+\.pl /path/to/kivitendo-erp/dispatcher.fcgi -Alias /url/for/kivitendo-erp/ /path/to/kivitendo-erp/ - -<Directory /path/to/kivitendo-erp> - AllowOverride All - Options ExecCGI Includes FollowSymlinks - Order Allow,Deny - Allow from All -</Directory> - -<DirectoryMatch /path/to/kivitendo-erp/users> - Order Deny,Allow - Deny from All -</DirectoryMatch>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:
FcgidMaxRequestLen 10485760Das ganze sollte dann so aussehen:
AddHandler fcgid-script .fpl -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/kivitendo-erp> - AllowOverride All - Options ExecCGI Includes FollowSymlinks - Order Allow,Deny - Allow from All -</Directory> - -<DirectoryMatch /path/to/kivitendo-erp/users> - Order Deny,Allow - Deny from All -</DirectoryMatch>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.
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:
# Zugriff über CGI -Alias /url/for/kivitendo-erp /path/to/kivitendo-erp - -# Zugriff mit mod_fcgid: -AliasMatch ^/url/for/kivitendo-erp-fcgid/[^/]+\.pl /path/to/kivitendo-erp/dispatcher.fpl -Alias /url/for/kivitendo-erp-fcgid/ /path/to/kivitendo-erp/Dann ist unter
/url/for/kivitendo-erp/- die normale Version erreichbar, und unter -/url/for/kivitendo-erp-fcgid/die - FastCGI-Version.
![[Anmerkung]](system/docbook-xsl/images/note.png)
![[Warnung]](../../../../system/docbook-xsl/images/warning.png)
Für kivitendo Installationen in der Schweiz sollte hier
+ german durch swiss ersetzt
+ werden.
Die Einstellung default_manager = swiss
+ bewirkt:
Beim Erstellen einer neuen Datenbank in der kivitendo + Administration werden automatisch die Standard-Werte für die + Schweiz voreingestellt: Währung CHF, 5er-Rundung, Schweizer + KMU-Kontenplan, Sollversteuerung, Aufwandsmethode, Bilanzierung + (die Werte können aber manuell angepasst werden).
Einstellen der Standardkonten für Rundungserträge und + -aufwendungen (unter Mandantenkonfiguration â Standardkonten + veränderbar)
das verwendete Zahlenformat wird auf +
1'000.00eingestellt (unter Programm â + Benutzereinstellungen veränderbar)DATEV-Automatik und UStVA werden nicht angezeigt, + Erfolgsrechnung ersetzt GUV ( unter Mandantenkonfiguration â + Features veränderbar)
Nutzt man wiederkehrende Rechnungen, kann man unter
+ [periodic_invoices] den Login eines Benutzers
+ angeben, der nach Erstellung der Rechnungen eine entsprechende E-Mail
+ mit Informationen über die erstellten Rechnungen bekommt.
kivitendo bringt eine eigene Komponente zur zeitgesteuerten + Ausführung bestimmter Aufgaben mit, den Task-Server. Er wird u.a. für + Features wie die wiederkehrenden Rechnungen + benötigt, erledigt aber auch andere erforderliche Aufgaben und muss + daher in Betrieb genommen werden. Seine Einrichtung wird im Abschnitt + Task-Server genauer + beschrieben.
Für Entwickler finden sich unter [debug]
+ wichtige Funktionen, um die Fehlersuche zu erleichtern.
In älteren kivitendo Versionen gab es im Verzeichnis
+ config die Dateien
+ authentication.pl und
+ lx-erp.conf, die jeweils Perl-Dateien waren. Es
+ gab auch die Möglichkeit, eine lokale Version der Konfigurationsdatei
+ zu erstellen (lx-erp-local.conf). Dies ist ab
+ 2.6.3 nicht mehr möglich, aber auch nicht mehr nötig.
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 kivitendo eine + entsprechende Fehlermeldung an.