Revision 9e62ee64
Von Niklas Schmidt vor etwa 23 Stunden hinzugefügt
doc/dokumentation.xml | ||
---|---|---|
1133 | 1133 |
<sect1 id="Apache-Konfiguration"> |
1134 | 1134 |
<title>Webserver-Konfiguration</title> |
1135 | 1135 |
|
1136 |
<sect2> |
|
1137 |
<title>Grundkonfiguration mittels CGI</title> |
|
1138 |
|
|
1139 |
<note> |
|
1140 |
<para>Für einen deutlichen Performanceschub sorgt die Ausführung |
|
1141 |
mittels FastCGI/FCGI. Die Einrichtung wird ausführlich im Abschnitt |
|
1142 |
<xref linkend="Apache-Konfiguration.FCGI"/> beschrieben.</para> |
|
1143 |
</note> |
|
1144 |
|
|
1145 |
<para>Der Zugriff auf das Programmverzeichnis muss in der Apache |
|
1146 |
Webserverkonfigurationsdatei <literal>000-default.conf</literal> eingestellt |
|
1147 |
werden. Fügen Sie den folgenden Abschnitt dieser Datei oder einer |
|
1148 |
anderen Datei hinzu, die beim Starten des Webservers eingelesen |
|
1149 |
wird:</para> |
|
1150 |
|
|
1151 |
<programlisting>AliasMatch ^/kivitendo-erp/[^/]+\.pl /var/www/kivitendo-erp/dispatcher.pl |
|
1152 |
Alias /kivitendo-erp/ /var/www/kivitendo-erp/ |
|
1136 |
<para>In diesem Abschnitt wird die Konfiguration des Apache-Webservers |
|
1137 |
beschrieben. kivitendo wird mittels FastCGI/FCGI ausgeführt.</para> |
|
1153 | 1138 |
|
1154 |
<Directory /var/www/kivitendo-erp> |
|
1155 |
AddHandler cgi-script .pl |
|
1156 |
Options ExecCGI Includes FollowSymlinks |
|
1157 |
</Directory> |
|
1158 |
|
|
1159 |
<Directory /var/www/kivitendo-erp/users> |
|
1160 |
Require all granted |
|
1161 |
</Directory></programlisting> |
|
1162 |
|
|
1163 |
<para>Ersetzen Sie dabei die Pfade durch diejenigen, in die Sie vorher |
|
1164 |
das kivitendo-Archiv entpacket haben.</para> |
|
1165 |
|
|
1166 |
<note> |
|
1167 |
<para>Vor den einzelnen Optionen muss bei einigen Distributionen ein |
|
1168 |
Plus ‘<literal>+</literal>’ gesetzt werden.</para> |
|
1169 |
|
|
1170 |
<para>Bei einigen Distribution (Ubuntu ab 14.04, Debian ab 8.2) muss |
|
1171 |
noch explizit das cgi-Modul mittels <programlisting>a2enmod cgi</programlisting> |
|
1172 |
aktiviert werden.</para> |
|
1173 |
</note> |
|
1174 |
|
|
1175 |
<para>Auf einigen Webservern werden manchmal die Grafiken und |
|
1176 |
Style-Sheets nicht ausgeliefert. In solchen Fällen hat es oft |
|
1177 |
geholfen, die folgende Option in die Konfiguration aufzunehmen:</para> |
|
1178 |
|
|
1179 |
<programlisting>EnableSendfile Off</programlisting> |
|
1180 |
</sect2> |
|
1139 |
<para>Der Zugriff auf den Installationspfad von kivitendo im Dateisystem |
|
1140 |
muss in der Apache Webserverkonfigurationsdatei eingestellt werden, |
|
1141 |
welche beim Starten des Webservers eingelesen wird. Oftmals ist dies die |
|
1142 |
Datei <literal>000-default.conf</literal>.</para> |
|
1181 | 1143 |
|
1182 | 1144 |
<sect2 id="Apache-Konfiguration.FCGI" |
1183 | 1145 |
xreflabel="Konfiguration für FastCGI/FCGI"> |
... | ... | |
1258 | 1220 |
<sect3 id="Apache-Konfiguration.FCGI.Konfiguration"> |
1259 | 1221 |
<title>Konfiguration des Webservers</title> |
1260 | 1222 |
|
1261 |
<para>Bevor Sie versuchen, eine kivitendo Installation unter FCGI |
|
1262 |
laufen zu lassen, empfiehlt es sich die Installation ersteinmal |
|
1263 |
unter CGI aufzusetzen. FCGI macht es nicht einfach Fehler zu |
|
1264 |
debuggen die beim ersten aufsetzen auftreten können. Sollte die |
|
1265 |
Installation schon funktionieren, lesen Sie weiter.</para> |
|
1266 |
|
|
1267 | 1223 |
<para>Zuerst muss das FastCGI-Modul aktiviert werden. Dies kann |
1268 | 1224 |
unter Debian/Ubuntu z.B. mit folgendem Befehl geschehen:</para> |
1269 | 1225 |
|
... | ... | |
1344 | 1300 |
Zugriffe auf die einzelnen Scripte werden auf diesen umgeleitet. |
1345 | 1301 |
Dadurch, dass zur Laufzeit öfter mal Scripte neu geladen werden, |
1346 | 1302 |
gibt es hier kleine Performance-Einbußen.</para> |
1347 |
|
|
1348 |
<para>Es ist möglich, die gleiche kivitendo Version parallel unter |
|
1349 |
CGI und FastCGI zu betreiben. Dafür bleiben die Directorydirektiven |
|
1350 |
wie oben beschrieben, die URLs werden aber umgeleitet:</para> |
|
1351 |
|
|
1352 |
<programlisting># Zugriff über CGI |
|
1353 |
Alias /url/for/kivitendo-erp /path/to/kivitendo-erp |
|
1354 |
|
|
1355 |
# Zugriff mit mod_fcgid: |
|
1356 |
AliasMatch ^/url/for/kivitendo-erp-fcgid/[^/]+\.pl /path/to/kivitendo-erp/dispatcher.fpl |
|
1357 |
Alias /url/for/kivitendo-erp-fcgid/ /path/to/kivitendo-erp/</programlisting> |
|
1358 |
|
|
1359 |
<para>Dann ist unter <filename>/url/for/kivitendo-erp/</filename> |
|
1360 |
die normale Version erreichbar, und unter |
|
1361 |
<constant>/url/for/kivitendo-erp-fcgid/</constant> die |
|
1362 |
FastCGI-Version.</para> |
|
1363 | 1303 |
</sect3> |
1364 | 1304 |
</sect2> |
1365 | 1305 |
|
Auch abrufbar als: Unified diff
Doku: Entferne CGI, empfohlen ist ausschließlich FastCGI