Buchungsjournal: Spalte f. Bilanz im Bericht direkt hinter Umsatzsteuer
[kivitendo-erp.git] / 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.5.6.1: 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, die
4         benötigt wird: <code class="filename">config/kivitendo.conf</code> (kurz: "die
5         Hauptkonfigurationsdatei"). Diese muss bei der Erstinstallation von
6         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>Vor der Umbenennung in kivitendo hieß diese Datei noch
14           <code class="filename">config/lx_office.conf</code>. Aus Gründen der
15           Kompatibilität wird diese Datei eingelesen, sofern die Datei
16           <code class="filename">config/kivitendo.conf</code> nicht existiert.</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>"
23             in diesem Kapitel)</p></li><li class="listitem"><p>
24                      <code class="literal">authentication/database</code>
25                   </p></li><li class="listitem"><p>
26                      <code class="literal">authentication/ldap</code>
27                   </p></li><li class="listitem"><p>
28                      <code class="literal">system</code>
29                   </p></li><li class="listitem"><p>
30                      <code class="literal">paths</code>
31                   </p></li><li class="listitem"><p>
32                      <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>
33                      <code class="literal">applications</code>
34                   </p></li><li class="listitem"><p>
35                      <code class="literal">environment</code>
36                   </p></li><li class="listitem"><p>
37                      <code class="literal">print_templates</code>
38                   </p></li><li class="listitem"><p>
39                      <code class="literal">task_server</code>
40                   </p></li><li class="listitem"><p>
41                      <code class="literal">periodic_invoices</code>
42                   </p></li><li class="listitem"><p>
43                      <code class="literal">self_tests</code>
44                   </p></li><li class="listitem"><p>
45                      <code class="literal">console</code>
46                   </p></li><li class="listitem"><p>
47                      <code class="literal">testing</code>
48                   </p></li><li class="listitem"><p>
49                      <code class="literal">testing/database</code>
50                   </p></li><li class="listitem"><p>
51                      <code class="literal">debug</code>
52                   </p></li></ul></div><p>Die üblicherweise wichtigsten Parameter, die am Anfang
53         einzustellen oder zu kontrollieren sind, sind:</p><pre class="programlisting">[authentication]
54 admin_password = geheim
55
56 [authentication/database]
57 host     = localhost
58 port     = 5432
59 db       = kivitendo_auth
60 user     = postgres
61 password =
62
63 [system]
64 default_manager = german</pre><p>Für kivitendo Installationen in der Schweiz sollte hier
65         <code class="varname">german</code> durch <code class="varname">swiss</code> ersetzt
66         werden.</p><p>Die Einstellung <code class="varname">default_manager = swiss</code>
67         bewirkt:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Beim Erstellen einer neuen Datenbank in der kivitendo
68             Administration werden automatisch die Standard-Werte für die
69             Schweiz voreingestellt: Währung CHF, 5er-Rundung, Schweizer
70             KMU-Kontenplan, Sollversteuerung, Aufwandsmethode, Bilanzierung
71             (die Werte können aber manuell angepasst werden).</p></li><li class="listitem"><p>Einstellen der Standardkonten für Rundungserträge und
72             -aufwendungen (unter Mandantenkonfiguration → Standardkonten
73             veränderbar)</p></li><li class="listitem"><p>das verwendete Zahlenformat wird auf
74             <code class="varname">1'000.00</code> eingestellt (unter Programm →
75             Benutzereinstellungen veränderbar)</p></li><li class="listitem"><p>DATEV-Automatik und UStVA werden nicht angezeigt,
76             Erfolgsrechnung ersetzt GUV ( unter Mandantenkonfiguration →
77             Features veränderbar)</p></li></ul></div><p>Nutzt man wiederkehrende Rechnungen, kann man unter
78         <code class="varname">[periodic_invoices]</code> den Login eines Benutzers
79         angeben, der nach Erstellung der Rechnungen eine entsprechende E-Mail
80         mit Informationen über die erstellten Rechnungen bekommt.</p><p>kivitendo bringt eine eigene Komponente zur zeitgesteuerten
81         Ausführung bestimmter Aufgaben mit, den <a class="link" href="ch02s07.html" title="2.7. Der Task-Server">Task-Server</a>. Er wird u.a. für
82         Features wie die <a class="link" href="ch03.html#features.periodic-invoices" title="3.1. Wiederkehrende Rechnungen">wiederkehrenden Rechnungen</a>
83         benötigt, erledigt aber auch andere erforderliche Aufgaben und muss
84         daher in Betrieb genommen werden. Seine Einrichtung wird im Abschnitt
85         <a class="link" href="ch02s07.html" title="2.7. Der Task-Server">Task-Server</a> genauer
86         beschrieben.</p><p>Für Entwickler finden sich unter <code class="varname">[debug]</code>
87         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
88         <code class="filename">config</code> die Dateien
89         <code class="filename">authentication.pl</code> und
90         <code class="filename">lx-erp.conf</code>, die jeweils Perl-Dateien waren. Es
91         gab auch die Möglichkeit, eine lokale Version der Konfigurationsdatei
92         zu erstellen (<code class="filename">lx-erp-local.conf</code>). Dies ist ab
93         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
94         jünger müssen die Einstellungen aus den alten Konfigurationsdateien
95         manuell übertragen und die alten Konfigurationsdateien anschließend
96         gelöscht oder verschoben werden. Ansonsten zeigt kivitendo eine
97         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>