Kommentare in config/lx_office.conf.default angepasst.
[kivitendo-erp.git] / doc / konfigurationsdatei.txt
1 == Lx-Office Konfigurationsdatei ab Version 2.6.3 ==
2
3 Seit Lx-Office 2.6.3. findet sich die Hauptconfigurationsdatei von Lx-Office in
4 der Datei config/lx_office.conf.
5
6 Diese muß bei der Erstinstallation von Lx-Office (oder Migration von älteren
7 Versionen) angelegt werden, als Vorlage dient die Datei
8 config/lx_office.conf.default. Die Datei lx_office.conf ist eine
9 installationsspezifische Datei, enthält z.B. die wichtigsten Passwörter der
10 lokalen Installation, und findet sich auch nicht im Git Repository.  Diese
11 Konfigurationsdatei ist unabhängig von den verschiedenen Mandanten, die auf der
12 Installation laufen.
13
14 Die Konfigurationsdatei besteht aus mehreren Teilen, die entsprechend
15 kommentiert sind:
16
17 * authentication
18 * authentication/database
19 * authentication/ldap
20 * system
21 * features
22 * paths
23 * applications
24 * environment
25 * print_templates
26 * task_server
27 * periodic_invoices
28 * console
29 * debug
30
31 Die üblicherweise wichtigsten Parameter, die am Anfang einzustellen oder zu
32 kontrollieren sind, sind:
33
34 [authentication]
35 admin_password = geheim
36
37 [authentication/database]
38 host     = localhost
39 port     = 5432
40 db       = lxerp_auth
41 user     = postgres
42 password =
43
44 [system]:
45 * eur
46 * dbcharset
47
48 Nutzt man wiederkehrende Rechnungen kann man unter [periodic_invoices] den
49 Login eines Benutzers angeben, der nach Erstellung der Rechnungen eine
50 entsprechende E-Mail mit Informationen über die erstellten Rechnungen bekommt.
51
52 Nutzt man den Taskserver für wiederkehrende Rechnungen, muß unter [task_server]
53 ein Login eines Benutzers angegeben werden, mit dem sich der Taskserver an
54 Lx-Office bei der Datenbank anmeldet, die dem Benutzer zugewiesen ist.
55
56 Für Entwickler finden sich unter [debug] wichtige Funktionen, um die
57 Fehlersuche zu erleichtern.
58
59
60 == Versionen vor 2.6.3 ==
61
62 In älteren Lx-Office Versionen gab es im Verzeichnis config die Dateien
63 authentication.pl und lx-erp.conf, die jeweils Perl-Dateien waren. Es gab auch
64 die Möglichkeit, eine lokale Version der Konfigurationsdatei zu erstellen
65 (lx-erp-local.conf), dies ist ab 2.6.3 auch nicht mehr möglich/nötig.
66
67 Beim Update von einer älteren Lx-Office Version auf 2.6.3 müssen die
68 Einstellungen aus den alten Konfigurationsdateien manuell übertragen werden und
69 die alten Konfigurationsdateien gelöscht oder verschoben werden, sonst kommt es
70 zu einer Fehlermeldung.