projekt kivitendo

      <sect2>

        <title>Grundkonfiguration mittels CGI</title>

        <note>

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

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

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

        </note>

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

        Webserverkonfigurationsdatei <literal>000-default.conf</literal> eingestellt

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

        anderen Datei hinzu, die beim Starten des Webservers eingelesen

        wird:</para>

        <programlisting>AliasMatch ^/kivitendo-erp/[^/]+\.pl /var/www/kivitendo-erp/dispatcher.pl

Alias /kivitendo-erp/ /var/www/kivitendo-erp/

<Directory /var/www/kivitendo-erp>

 AddHandler cgi-script .pl

 Options ExecCGI Includes FollowSymlinks

</Directory>

<Directory /var/www/kivitendo-erp/users>

 Require all granted

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

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

        das kivitendo-Archiv entpacket haben.</para>

        <note>

          <para>Vor den einzelnen Optionen muss bei einigen Distributionen ein

          Plus ‘<literal>+</literal>’ gesetzt werden.</para>

          <para>Bei einigen Distribution (Ubuntu ab 14.04, Debian ab 8.2) muss

          noch explizit das cgi-Modul mittels <programlisting>a2enmod cgi</programlisting>

          aktiviert werden.</para>

        </note>

        <para>Auf einigen Webservern werden manchmal die Grafiken und

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

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

        <programlisting>EnableSendfile Off</programlisting>

      </sect2>

          <para>Bevor Sie versuchen, eine kivitendo Installation unter FCGI

          laufen zu lassen, empfiehlt es sich die Installation ersteinmal

          unter CGI aufzusetzen. FCGI macht es nicht einfach Fehler zu

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

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

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

          <para>Dann ist unter <filename>/url/for/kivitendo-erp/</filename>

          die normale Version erreichbar, und unter

          <constant>/url/for/kivitendo-erp-fcgid/</constant> die

          FastCGI-Version.</para>