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
   7 Als Vorlage dient die Datei config/lx_office.conf.default.
   8
   9  $ cp config/lx_office.conf.default config/lx_office.conf
  10
  11 Die Datei config/lx_office.conf.default wird immer eingelesen, Werte die in
  12 config/lx_office.conf stehen überschreiben die Werte aus
  13 config/lx_office.conf.default. Die Datei config/lx_office.conf muss also nur
  14 die Abschintte und Werte enthalten die von config/lx_office.conf.default abweichen.
  15
  16 Diese Datei (lx_office.conf) ist dann eine installationsspezifische Datei,
  17 d.h. sie enthält bspw. lokale Passwörter und wird auch nicht im Versionsmanagement (git) verwaltet.
  18
  19 Die Konfiguration ist ferner serverabhängig, d.h. für alle Mandaten, bzw. Datenbanken gleich.
  20
  21
  22 Die Konfigurationsdatei besteht aus mehreren Teilen, die entsprechend kommentiert sind:
  23
  24 * authentication
  25 * authentication/database
  26 * authentication/ldap
  27 * system
  28 * features
  29 * paths
  30 * applications
  31 * environment
  32 * print_templates
  33 * task_server
  34 * periodic_invoices
  35 * console
  36 * debug
  37
  38 Die üblicherweise wichtigsten Parameter, die am Anfang einzustellen oder zu kontrollieren sind, sind:
  39
  40 [authentication]
  41 admin_password = geheim
  42
  43 [authentication/database]
  44 host     = localhost
  45 port     = 5432
  46 db       = lxerp_auth
  47 user     = postgres
  48 password =
  49
  50 [system]:
  51 * eur
  52 * dbcharset
  53
  54 Nutzt man wiederkehrende Rechnungen kann man unter [periodic_invoices] den
  55 Login eines Benutzers angeben, der nach Erstellung der Rechnungen eine
  56 entsprechende E-Mail mit Informationen über die erstellten Rechnungen bekommt.
  57
  58 Nutzt man den Taskserver für wiederkehrende Rechnungen, muß unter [task_server]
  59 ein Login eines Benutzers angegeben werden, mit dem sich der Taskserver an
  60 Lx-Office bei der Datenbank anmeldet, die dem Benutzer zugewiesen ist.
  61
  62 Für Entwickler finden sich unter [debug] wichtige Funktionen, um die
  63 Fehlersuche zu erleichtern.
  64
  65
  66 == Versionen vor 2.6.3 ==
  67
  68 In älteren Lx-Office Versionen gab es im Verzeichnis config die Dateien
  69 authentication.pl und lx-erp.conf, die jeweils Perl-Dateien waren. Es gab auch
  70 die Möglichkeit, eine lokale Version der Konfigurationsdatei zu erstellen
  71 (lx-erp-local.conf), dies ist ab 2.6.3 auch nicht mehr möglich/nötig.
  72
  73 Beim Update von einer älteren Lx-Office Version auf 2.6.3 müssen die
  74 Einstellungen aus den alten Konfigurationsdateien manuell übertragen werden und
  75 die alten Konfigurationsdateien gelöscht oder verschoben werden, sonst kommt es
  76 zu einer Fehlermeldung.