X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2FINSTALL.fcgi;h=454be03961b822f53a9536dd9e6fe738a6b802f6;hb=45aeeb1343ff6dd6803fa24f04a38557e514910e;hp=4dbe994cc0893c58b6123c42deb8732d1c3919d0;hpb=6a8787147ad643549eb26cb4f9a373b5b354b8b9;p=kivitendo-erp.git diff --git a/doc/INSTALL.fcgi b/doc/INSTALL.fcgi index 4dbe994cc..454be0396 100644 --- a/doc/INSTALL.fcgi +++ b/doc/INSTALL.fcgi @@ -5,6 +5,8 @@ Diese Datei ist in Plain Old Documentation geschrieben. Mit ist sie deutlich leichter zu lesen. +=encoding utf8 + =head1 FastCGI für Lx-Office =head2 Was ist FastCGI? @@ -37,8 +39,8 @@ eigentliche Programmlogik ausgeführt. Folgende Kombinationen sind getestet: + * Apache 2.2.11 (Ubuntu) und mod_fcgid. * Apache 2.2.11 (Ubuntu) und mod_fastcgi. - * Apache 2.2.11 (Ubuntu) und mod_fcgid: Als Perl Backend wird das Modul FCGI.pm verwendet. Vorsicht: FCGI 0.69 und höher ist extrem strict in der Behandlung von Unicode, und verweigert bestimmte @@ -59,11 +61,11 @@ 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 fastcgi + a2enmod fcgid bzw. - a2enmod fcgid + a2enmod fastcgi Die Konfiguration für die Verwendung von Lx-Office mit FastCGI erfolgt durch Anpassung der vorhandenen Alias- und Directory-Direktiven. Dabei @@ -71,14 +73,13 @@ wird zwischen dem Installationspfad von Lx-Office im Dateisystem ("/path/to/lx-office-erp") und der URL unterschieden, unter der Lx-Office im Webbrowser erreichbar ist ("/web/path/to/lx-office-erp"). -Folgendes Template funktioniert mit mod_fastcgi: +Folgendes Template funktioniert mit mod_fcgid: - AliasMatch ^/web/path/to/lx-office-erp/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fpl + AliasMatch ^/web/path/to/lx-office-erp/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fcgi Alias /web/path/to/lx-office-erp/ /path/to/lx-office-erp/ AllowOverride All - AddHandler fastcgi-script .fpl Options ExecCGI Includes FollowSymlinks Order Allow,Deny Allow from All @@ -89,10 +90,28 @@ Folgendes Template funktioniert mit mod_fastcgi: Deny from All -...und für mod_fcgid muss die erste Zeile geändert werden in: +Für mod_fastcgi muss ein AddHandler ergänzt werden und die erste Zeile geändert werden: - AliasMatch ^/web/path/to/lx-office-erp/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fcgi + AddHandler fastcgi-script .fpl + AliasMatch ^/web/path/to/lx-office-erp/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fpl + +Das ganze sollte dann so aussehen: + AddHandler fastcgi-script .fpl + AliasMatch ^/web/path/to/lx-office-erp/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fpl + Alias /web/path/to/lx-office-erp/ /path/to/lx-office-erp/ + + + AllowOverride All + Options ExecCGI Includes FollowSymlinks + Order Allow,Deny + Allow from All + + + + Order Deny,Allow + Deny from All + Hierdurch wird nur ein zentraler Dispatcher gestartet. Alle Zugriffe auf die einzelnen Scripte werden auf diesen umgeleitet. Dadurch, dass @@ -102,18 +121,23 @@ Benutzung von "AddHandler fastcgi-script .pl" vorzuziehen. Es ist möglich die gleiche Lx-Office Version parallel unter cgi und fastcgi zu -betreiben. Dafür bleiben Directorydirektiven bleiben wie oben beschrieben, die -URLs werden aber umgeleitet: +betreiben. Dafür bleiben die Directorydirektiven wie oben beschrieben, die URLs +werden aber umgeleitet: - # Zugriff ohne FastCGI + # Zugriff über cgi Alias /web/path/to/lx-office-erp /path/to/lx-office-erp - # Zugriff mit FastCGI: - AliasMatch ^/web/path/to/lx-office-erp-fcgi/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fpl - Alias /web/path/to/lx-office-erp-fcgi/ /path/to/lx-office-erp/ + # Zugriff mit mod_fcgid: + AliasMatch ^/web/path/to/lx-office-erp-fcgid/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fcgi + Alias /web/path/to/lx-office-erp-fcgid/ /path/to/lx-office-erp/ + + # Zugriff mit mod_fastcgi: + AliasMatch ^/web/path/to/lx-office-erp-fastcgi/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fpl + Alias /web/path/to/lx-office-erp-fastcgi/ /path/to/lx-office-erp/ Dann ist unter C die normale Version erreichbar, -und unter C die FastCGI Version. +und unter C bzw. +C die FastCGI Version. Achtung: @@ -124,7 +148,7 @@ vhost. =head2 Entwicklungsaspekte Wenn Änderungen in der Konfiguration von Lx-Office gemacht werden, muss der -Server neu gestartet werden. +Webserver neu gestartet werden. Bei der Entwicklung für FastCGI ist auf ein paar Fallstricke zu achten. Dadurch dass das Programm in einer Endlosschleife läuft, müssen folgende Aspekte @@ -156,7 +180,7 @@ In C gibt es einen sauber abgetrennten Block der alle kanonischen globalen Variablen listet und erklärt. Bitte keine anderen einführen ohne das sauber zu dokumentieren. -Datenbankverbindungen wird noch ein Guide verfasst werden, wie man sichergeht, +Datenbankverbindungen wird noch ein Guide verfasst werden, wie man sicher geht, dass man die richtige erwischt. =head2 Performance und Statistiken