doc/html/ch02s04.html

   1 <html><head>
   2       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   3    <title>2.4. kivitendo-Konfigurationsdatei</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s03.html" title="2.3. Manuelle Installation des Programmpaketes"><link rel="next" href="ch02s05.html" title="2.5. Anpassung der PostgreSQL-Konfiguration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.4. kivitendo-Konfigurationsdatei</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s03.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s05.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.4. kivitendo-Konfigurationsdatei"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.config-file"></a>2.4. kivitendo-Konfigurationsdatei</h2></div></div></div><div class="sect2" title="2.4.1. Einführung"><div class="titlepage"><div><div><h3 class="title"><a name="config.config-file.introduction"></a>2.4.1. Einführung</h3></div></div></div><p>In kivitendo gibt es nur noch eine Konfigurationsdatei,
   4         die benötigt wird: <code class="filename">config/kivitendo.conf</code> (kurz:
   5         "die Hauptkonfigurationsdatei"). Diese muss bei der Erstinstallation
   6         von kivitendo bzw. der Migration von älteren Versionen angelegt
   7         werden.</p><p>Als Vorlage dient die Datei
   8         <code class="filename">config/kivitendo.conf.default</code> (kurz: "die
   9         Default-Datei"):</p><pre class="programlisting">$ cp config/kivitendo.conf.default config/kivitendo.conf</pre><p>Die Default-Datei wird immer zuerst eingelesen. Werte, die in
  10         der Hauptkonfigurationsdatei stehen, überschreiben die Werte aus der
  11         Default-Datei. Die Hauptkonfigurationsdatei muss also nur die
  12         Abschnitte und Werte enthalten, die von denen der Default-Datei
  13         abweichen.</p><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>
  14           Vor der Umbenennung in kivitendo hieß diese Datei noch <code class="filename">config/lx_office.conf</code>. Aus Gründen der Kompatibilität
  15           wird diese Datei eingelesen, sofern die Datei <code class="filename">config/kivitendo.conf</code> nicht existiert.
  16          </p></td></tr></table></div><p>Diese Hauptkonfigurationsdatei ist dann eine
  17         installationsspezifische Datei, d.h. sie enthält bspw. lokale
  18         Passwörter und wird auch nicht im Versionsmanagement (git)
  19         verwaltet.</p><p>Die Konfiguration ist ferner serverabhängig, d.h. für alle
  20         Mandaten, bzw. Datenbanken gleich.</p></div><div class="sect2" title="2.4.2. Abschnitte und Parameter"><div class="titlepage"><div><div><h3 class="title"><a name="config.config-file.sections-parameters"></a>2.4.2. Abschnitte und Parameter</h3></div></div></div><p>Die Konfigurationsdatei besteht aus mehreren Teilen, die
  21         entsprechend kommentiert sind:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
  22                      <code class="literal">authentication</code> (siehe Abschnitt "<a class="xref" href="ch02s08.html" title="2.8. Benutzerauthentifizierung und Administratorpasswort">Abschnitt&nbsp;2.8, „Benutzerauthentifizierung und Administratorpasswort“</a>" in diesem Kapitel)</p></li><li class="listitem"><p>
  23                      <code class="literal">authentication/database</code>
  24                   </p></li><li class="listitem"><p>
  25                      <code class="literal">authentication/ldap</code>
  26                   </p></li><li class="listitem"><p>
  27                      <code class="literal">system</code>
  28                   </p></li><li class="listitem"><p>
  29                      <code class="literal">paths</code>
  30                   </p></li><li class="listitem"><p>
  31                      <code class="literal">mail_delivery</code> (siehe Abschnitt "<a class="xref" href="ch02s11.html#config.sending-email.smtp" title="2.11.2. Versand über einen SMTP-Server">E-Mail-Versand über einen SMTP-Server</a>)</p></li><li class="listitem"><p>
  32                      <code class="literal">applications</code>
  33                   </p></li><li class="listitem"><p>
  34                      <code class="literal">environment</code>
  35                   </p></li><li class="listitem"><p>
  36                      <code class="literal">print_templates</code>
  37                   </p></li><li class="listitem"><p>
  38                      <code class="literal">task_server</code>
  39                   </p></li><li class="listitem"><p>
  40                      <code class="literal">periodic_invoices</code>
  41                   </p></li><li class="listitem"><p>
  42                      <code class="literal">self_tests</code>
  43                   </p></li><li class="listitem"><p>
  44                      <code class="literal">console</code>
  45                   </p></li><li class="listitem"><p>
  46                      <code class="literal">testing</code>
  47                   </p></li><li class="listitem"><p>
  48                      <code class="literal">testing/database</code>
  49                   </p></li><li class="listitem"><p>
  50                      <code class="literal">debug</code>
  51                   </p></li></ul></div><p>Die üblicherweise wichtigsten Parameter, die am Anfang
  52         einzustellen oder zu kontrollieren sind, sind:</p><pre class="programlisting">[authentication]
  53 admin_password = geheim
  54
  55 [authentication/database]
  56 host     = localhost
  57 port     = 5432
  58 db       = kivitendo_auth
  59 user     = postgres
  60 password =</pre><p>Nutzt man wiederkehrende Rechnungen, kann man unter
  61         <code class="varname">[periodic_invoices]</code> den Login eines Benutzers
  62         angeben, der nach Erstellung der Rechnungen eine entsprechende E-Mail
  63         mit Informationen über die erstellten Rechnungen bekommt.</p><p>kivitendo bringt eine eigene Komponente zur zeitgesteuerten Ausführung bestimmter Aufgaben mit, den <a class="link" href="ch02s07.html" title="2.7. Der Task-Server">Taskserver</a>. Er wird u.a. für Features wie die <a class="link" href="ch03.html#features.periodic-invoices" title="3.1. Wiederkehrende Rechnungen">wiederkehrenden Rechnungen</a> benötigt, erledigt aber auch andere erforderliche Aufgaben
  64         und muss daher in Betrieb genommen werden. Der Taskserver benötigt zwei Konfigurationseinstellungen, die unter
  65         <code class="varname">[task_server]</code> anzugeben sind: ein Mandant (entweder der Mandantenname oder eine Datenbank-ID, Variable
  66         <code class="varname">client</code>), aus dem die Datenbankkonfiguration entnommen wird, sowie ein Login (Variable <code class="varname">login</code>)
  67         eines Benutzers, der für gewisse Dinge wie die Rechnungserstellung als Verkäufer eingetragen wird.</p><p>Für Entwickler finden sich unter <code class="varname">[debug]</code>
  68         wichtige Funktionen, um die Fehlersuche zu erleichtern.</p></div><div class="sect2" title="2.4.3. Versionen vor 2.6.3"><div class="titlepage"><div><div><h3 class="title"><a name="config.config-file.prior-versions"></a>2.4.3. Versionen vor 2.6.3</h3></div></div></div><p>In älteren kivitendo Versionen gab es im Verzeichnis
  69         <code class="filename">config</code> die Dateien
  70         <code class="filename">authentication.pl</code> und
  71         <code class="filename">lx-erp.conf</code>, die jeweils Perl-Dateien waren. Es
  72         gab auch die Möglichkeit, eine lokale Version der Konfigurationsdatei
  73         zu erstellen (<code class="filename">lx-erp-local.conf</code>). Dies ist ab
  74         2.6.3 nicht mehr möglich, aber auch nicht mehr nötig.</p><p>Beim Update von einer kivitendo-Version vor 2.6.3 auf 2.6.3 oder
  75         jünger müssen die Einstellungen aus den alten Konfigurationsdateien
  76         manuell übertragen und die alten Konfigurationsdateien anschließend
  77         gelöscht oder verschoben werden. Ansonsten zeigt kivitendo eine
  78         entsprechende Fehlermeldung an.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s03.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s05.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.3. Manuelle Installation des Programmpaketes&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.5. Anpassung der PostgreSQL-Konfiguration</td></tr></table></div></body></html>