projekt kivitendo

<book id="kivitendo-documentation" lang="de">

<title>kivitendo 3.4.0: Installation, Konfiguration, Entwicklung</title>

<para>im Community-Forum: <ulink

url="https://forum.kivitendo.de:32443">https://forum.kivitendo.de:32443</ulink></para>

</listitem>

<listitem>

<listitem>

<para>in der doc/UPGRADE Datei im doc-Verzeichnis der

</listitem>

<listitem>

<para>Im Schulungs- und Dienstleistungsangebot der entsprechenden

url="http://www.kivitendo.de/partner.html">http://www.kivitendo.de/partner.html</ulink></para>

</itemizedlist>

<chapter id="config">

<title>Installation und Grundkonfiguration</title>

<sect1 id="Installation-Übersicht">

<para>Die Installation von kivitendo umfasst mehrere Schritte. Die

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

</orderedlist>

<para>Alle weiteren Unterkapitel in diesem Kapitel sind ebenfalls

</sect1>

<sect1 id="Benötigte-Software-und-Pakete">

<para>kivitendo ist für Linux konzipiert, und sollte auf jedem

unixoiden Betriebssystem zum Laufen zu kriegen sein. Getestet ist

<para>Anfang 2016 sind das folgende Systeme, von denen bekannt ist,

dass kivitendo auf ihnen läuft:</para>

<para>Debian</para>

<itemizedlist>

<listitem>

</itemizedlist>

</listitem>

<para>Ubuntu 12.04 LTS "Precise Pangolin", 14.04 "Trusty Tahr"

</listitem>

<para>openSUSE LEAP 42.1</para>

</listitem>

<para>Fedora 22</para>

</listitem>

<title>Benötigte Perl-Pakete installieren</title>

<para>Zum Betrieb von kivitendo werden zwingend ein Webserver (meist

Apache) und ein Datenbankserver (PostgreSQL, mindestens v8.4)

benötigt.</para>

<para>Zusätzlich benötigt kivitendo einige Perl-Pakete, die nicht

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

</itemizedlist>

<para>Seit Version v3.4.0 sind die folgenden Pakete hinzugekommen:

<para>Seit Version v3.2.0 sind die folgenden Pakete hinzugekommen:

<literal>Net::SSLGlue</literal>.</para>

<para>Gegenüber Version 2.6.0 sind zu dieser Liste 2 Pakete

<literal>XML::Writer</literal> sind notwendig. Ohne startet kivitendo

nicht.</para>

Abhängigkeiten, wurden aber bisher mit kivitendo mitgeliefert. Beide

sind auch in 2.6.1 weiterhin mit ausgeliefert, wurden in einer

<sect3>

<para>Für Debian und Ubuntu stehen die meisten der benötigten

libimage-info-perl libgd-gd2-perl libapache2-mod-fcgid \

<para>Für das Paket HTML::Restrict gibt es kein Debian-Paket, dies

<programlisting>apt-get install build-essential

</sect3>

<sect3>

<title>Fedora</title>

<para>Für Fedora stehen die meisten der benötigten Perl-Pakete als

<programlisting>dnf install httpd mod_fcgid perl-Archive-Zip perl-Clone perl-DBD-Pg \

perl-DBI perl-DateTime perl-Email-Address perl-Email-MIME perl-FCGI \

perl-File-Copy-Recursive perl-JSON perl-List-MoreUtils perl-Net-SMTP-SSL perl-Net-SSLGlue \

perl-PDF-API2 perl-Params-Validate perl-Rose-DB perl-Rose-DB-Object \

perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv perl-URI \

perl-XML-Writer perl-YAML perl-parent postgresql-server perl-CPAN \

<para>Zusätzlich müssen einige Pakete aus dem CPAN installiert

<programlisting>cpan Config::Std HTML::Restrict</programlisting>

</sect3>

<sect3>

<para>Für openSUSE stehen die meisten der benötigten Perl-Pakete als

installiert werden:</para>

<programlisting>zypper install apache2 apache2-mod_fcgid perl-Archive-Zip perl-Clone \

perl-Config-Std perl-DBD-Pg perl-DBI perl-DateTime perl-Email-Address \

perl-Email-MIME perl-FastCGI perl-File-Copy-Recursive perl-JSON perl-List-MoreUtils \

perl-Net-SMTP-SSL perl-Net-SSLGlue perl-PDF-API2 perl-Params-Validate \

perl-URI perl-XML-Writer perl-YAML perl-CPAN \

<para>Zusätzlich müssen einige Pakete aus dem CPAN installiert

<programlisting>cpan Rose::Db::Object</programlisting>

</sect3>

</sect2>

<programlisting>cd /var/www

tar xvzf kivitendo-erp-3.4.0.tgz</programlisting>

<para>Wechseln Sie in das entpackte Verzeichnis:</para>

<programlisting>cd kivitendo-erp</programlisting>

<para>Bei einer Neuinstallation von Version 3.1.0 oder später muß das

<para>Die Verzeichnisse <filename>users</filename>,

<programlisting>chown -R www-data users spool webdav</programlisting>

<para>Weiterhin muss der Webserver-Benutzer in den Verzeichnissen

<programlisting>chown www-data templates users</programlisting>

git clone https://github.com/kivitendo/kivitendo-erp.git

Sehr sinnvoll ist es, direkt im Anschluss einen eigenen Branch zu

</sect1>

<title>kivitendo-Konfigurationsdatei</title>

<sect2 id="config.config-file.introduction"

<para>In kivitendo gibt es nur noch eine Konfigurationsdatei, die

werden.</para>

<para>Als Vorlage dient die Datei

<filename>config/kivitendo.conf.default</filename> (kurz: "die

Default-Datei"):</para>

<programlisting>$ cp config/kivitendo.conf.default config/kivitendo.conf</programlisting>

<para>Die Default-Datei wird immer zuerst eingelesen. Werte, die in

Abschnitte und Werte enthalten, die von denen der Default-Datei

abweichen.</para>

<note>

<para>Vor der Umbenennung in kivitendo hieß diese Datei noch

</note>

<para>Diese Hauptkonfigurationsdatei ist dann eine

<para>Die Konfiguration ist ferner serverabhängig, d.h. für alle

<sect2 id="config.config-file.sections-parameters">

<para>Die Konfigurationsdatei besteht aus mehreren Teilen, die

<itemizedlist>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

<listitem>

</itemizedlist>

<para>Die üblicherweise wichtigsten Parameter, die am Anfang

admin_password = geheim

db = kivitendo_auth

user = postgres

password =</programlisting>

<para>Nutzt man wiederkehrende Rechnungen, kann man unter

<para>kivitendo bringt eine eigene Komponente zur zeitgesteuerten

<para>In älteren kivitendo Versionen gab es im Verzeichnis

<filename>config</filename> die Dateien

<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

gelöscht oder verschoben werden. Ansonsten zeigt kivitendo eine

entsprechende Fehlermeldung an.</para>

</sect1>

<title>Zeichensätze/die Verwendung von Unicode/UTF-8</title>

<para>kivitendo setzt zwingend voraus, dass die Datenbank

<para>Das Encoding des Datenbankservers kann überprüft werden. Ist das

<para>Andernfalls ist es notwendig, einen neuen Datenbankcluster mit

Ubuntu kann dies z.B. für PostgreSQL 9.3 mit dem folgenden Befehl

getan werden:</para>

<programlisting>pg_createcluster --locale=de_DE.UTF-8 --encoding=UTF-8 9.3 clustername</programlisting>

<para>Die Datenbankversionsnummer muss an die tatsächlich verwendete

<para>Das Encoding einer Datenbank kann in <command>psql</command> mit

</sect2>

<para>In der Datei <filename>postgresql.conf</filename>, die je nach

Distribution in verschiedenen Verzeichnissen liegen kann (z.B.

<filename>/var/lib/pgsql/data/</filename> oder

<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 kivitendo auf demselben Rechner, so kann dort der Wert

<literal>localhost</literal> verwendet werden. Andernfalls müssen

was mit dem Wert <literal>*</literal> geschieht.</para>

<para>In der Datei <filename>pg_hba.conf</filename>, die im gleichen

Verzeichnis wie die <filename>postgresql.conf</filename> zu finden

sein sollte, müssen die Berechtigungen für den Zugriff geändert

werden. Hier gibt es mehrere Möglichkeiten. Sinnvoll ist es nur die

<programlisting>local all kivitendo password

</sect2>

Melden Sie sich dafür als Benutzer “postgres” an der Datenbank an:

psql template1</programlisting> führen Sie die folgenden Kommandos aus:</para>

<programlisting>CREATE EXTENSION IF NOT EXISTS plpgsql;

\q</programlisting>

<note>

<programlisting>CREATE LANGUAGE 'plpgsql';

</sect2>

<para>Die Frage, ob der neue User Superuser sein soll, können Sie mit

createuser -d -P kivitendo