Merge branch 'master' of git@lx-office.linet-services.de:lx-office-erp
[kivitendo-erp.git] / doc / konfigurationsdatei.txt
1 == Lx-Office Konfigurationsdatei ab Version 2.6.3 ==
2
3 Seit Lx-Office 2.6.3. gibt es nur noch eine Konfigurationsdatei die benötigt wird -  die: config/lx_office.conf.
4
5 Diese muß bei der Erstinstallation von Lx-Office (oder Migration von älteren Versionen) angelegt werden.
6 Als Vorlage dient die Datei config/lx_office.conf.default. 
7
8  $ cp config/lx_office.conf.default config/lx_office.conf
9
10 Diese Datei (lx_office.conf) ist dann eine installationsspezifische Datei, 
11 d.h. sie enthält bspw. lokale Passwörter und wird auch nicht im Versionsmanagement (git) verwaltet.
12
13 Die Konfiguration ist ferner serverabhängig, d.h. für alle Mandaten, bzw. Datenbanken gleich.
14
15
16 Die Konfigurationsdatei besteht aus mehreren Teilen, die entsprechend kommentiert sind:
17
18 * authentication
19 * authentication/database
20 * authentication/ldap
21 * system
22 * features
23 * paths
24 * applications
25 * environment
26 * print_templates
27 * task_server
28 * periodic_invoices
29 * console
30 * debug
31
32 Die üblicherweise wichtigsten Parameter, die am Anfang einzustellen oder zu 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.