doc/html/ch02s03.html

   1 <html><head>
   2       <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
   3    <title>2.3. Lx-Office-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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s02.html" title="2.2. Manuelle Installation des Programmpaketes"><link rel="next" href="ch02s04.html" title="2.4. 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.3. Lx-Office-Konfigurationsdatei</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s02.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="ch02s04.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.3. Lx-Office-Konfigurationsdatei"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.config-file"></a>2.3. Lx-Office-Konfigurationsdatei</h2></div></div></div><div class="sect2" title="2.3.1. Einführung"><div class="titlepage"><div><div><h3 class="title"><a name="config.config-file.introduction"></a>2.3.1. Einführung</h3></div></div></div><p>Seit Lx-Office 2.6.3. gibt es nur noch eine Konfigurationsdatei
   4         die benötigt wird: <code class="filename">config/lx_office.conf</code> (kurz:
   5         "die Hauptkonfigurationsdatei"). Diese muss bei der Erstinstallation
   6         von Lx-Office bzw. der Migration von älteren Versionen angelegt
   7         werden.</p><p>Als Vorlage dient die Datei
   8         <code class="filename">config/lx_office.conf.default</code> (kurz: "die
   9         Default-Datei"):</p><pre class="programlisting">$ cp config/lx_office.conf.default config/lx_office.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         Abschintte und Werte enthalten, die von denen der Default-Datei
  13         abweichen.</p><p>Diese Hauptkonfigurationsdatei ist dann eine
  14         installationsspezifische Datei, d.h. sie enthält bspw. lokale
  15         Passwörter und wird auch nicht im Versionsmanagement (git)
  16         verwaltet.</p><p>Die Konfiguration ist ferner serverabhängig, d.h. für alle
  17         Mandaten, bzw. Datenbanken gleich.</p></div><div class="sect2" title="2.3.2. Abschnitte und Parameter"><div class="titlepage"><div><div><h3 class="title"><a name="config.config-file.sections-parameters"></a>2.3.2. Abschnitte und Parameter</h3></div></div></div><p>Die Konfigurationsdatei besteht aus mehreren Teilen, die
  18         entsprechend kommentiert sind:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
  19                      <code class="literal">authentication</code>
  20                   </p></li><li class="listitem"><p>
  21                      <code class="literal">authentication/database</code>
  22                   </p></li><li class="listitem"><p>
  23                      <code class="literal">authentication/ldap</code>
  24                   </p></li><li class="listitem"><p>
  25                      <code class="literal">system</code>
  26                   </p></li><li class="listitem"><p>
  27                      <code class="literal">features</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">applications</code>
  32                   </p></li><li class="listitem"><p>
  33                      <code class="literal">environment</code>
  34                   </p></li><li class="listitem"><p>
  35                      <code class="literal">print_templates</code>
  36                   </p></li><li class="listitem"><p>
  37                      <code class="literal">task_server</code>
  38                   </p></li><li class="listitem"><p>
  39                      <code class="literal">periodic_invoices</code>
  40                   </p></li><li class="listitem"><p>
  41                      <code class="literal">console</code>
  42                   </p></li><li class="listitem"><p>
  43                      <code class="literal">debug</code>
  44                   </p></li></ul></div><p>Die üblicherweise wichtigsten Parameter, die am Anfang
  45         einzustellen oder zu kontrollieren sind, sind:</p><pre class="programlisting">[authentication]
  46 admin_password = geheim
  47
  48 [authentication/database]
  49 host     = localhost
  50 port     = 5432
  51 db       = lxerp_auth
  52 user     = postgres
  53 password =
  54
  55 [system]
  56 eur = 1
  57 dbcharset = UTF-8</pre><p>Nutzt man wiederkehrende Rechnungen, kann man unter
  58         <code class="varname">[periodic_invoices]</code> den Login eines Benutzers
  59         angeben, der nach Erstellung der Rechnungen eine entsprechende E-Mail
  60         mit Informationen über die erstellten Rechnungen bekommt.</p><p>Nutzt man den <a class="link" href="ch02s06.html" title="2.6. Der Task-Server">Taskserver</a> für <a class="link" href="ch03.html#features.periodic-invoices" title="3.1. Wiederkehrende Rechnungen">wiederkehrende Rechnungen</a>,
  61         muss unter <code class="varname">[task_server]</code> ein Login eines Benutzers
  62         angegeben werden, mit dem sich der Taskserver an Lx-Office bei der
  63         Datenbank anmeldet, die dem Benutzer zugewiesen ist.</p><p>Für Entwickler finden sich unter <code class="varname">[debug]</code>
  64         wichtige Funktionen, um die Fehlersuche zu erleichtern.</p></div><div class="sect2" title="2.3.3. Versionen vor 2.6.3"><div class="titlepage"><div><div><h3 class="title"><a name="config.config-file.prior-versions"></a>2.3.3. Versionen vor 2.6.3</h3></div></div></div><p>In älteren Lx-Office Versionen gab es im Verzeichnis
  65         <code class="filename">config</code> die Dateien
  66         <code class="filename">authentication.pl</code> und
  67         <code class="filename">lx-erp.conf</code>, die jeweils Perl-Dateien waren. Es
  68         gab auch die Möglichkeit, eine lokale Version der Konfigurationsdatei
  69         zu erstellen (<code class="filename">lx-erp-local.conf</code>). Dies ist ab
  70         2.6.3 nicht mehr möglich, aber auch nicht mehr nötig.</p><p>Beim Update von einer Lx-Office-Version vor 2.6.3 auf 2.6.3 oder
  71         jünger müssen die Einstellungen aus den alten Konfigurationsdateien
  72         manuell übertragen und die alten Konfigurationsdateien anschließend
  73         gelöscht oder verschoben werden. Ansonsten zeigt Lx-Office eine
  74         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="ch02s02.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="ch02s04.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.2. 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.4. Anpassung der PostgreSQL-Konfiguration</td></tr></table></div></body></html>