Projekt

Allgemein

Profil

« Zurück | Weiter » 

Revision cddb2fd7

Von Enrique Morales vor mehr als 1 Jahr hinzugefügt

  • ID cddb2fd70edda3ea92cc6667224f995d0ff61b68
  • Vorgänger ccc063b7
  • Nachfolger bfc04a83

Anleitung für installation mit Ansible hinzugefüegt

Unterschiede anzeigen:

doc/html/ch02s04.html
1 1
<html><head>
2 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.8.0: 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
3
   <title>2.4. Manuelle Installation des Programmpaketes</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.8.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s03.html" title="2.3. Installation mittels Ansible"><link rel="next" href="ch02s05.html" title="2.5. kivitendo-Konfigurationsdatei"></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. Manuelle Installation des Programmpaketes</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. Manuelle Installation des Programmpaketes"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Manuelle-Installation-des-Programmpaketes"></a>2.4. Manuelle Installation des Programmpaketes</h2></div></div></div><p>Der aktuelle Stable-Release, bzw. beta Release wird bei github
4
      gehostet und kann <a class="ulink" href="https://github.com/kivitendo/kivitendo-erp/releases" target="_top">hier</a>
5
      heruntergeladen werden.</p><p>Das aktuelleste kivitendo ERP-Archiv
6
      (<code class="filename">kivitendo-erp-*.tgz</code>) wird dann im
7
      Dokumentenverzeichnis des Webservers (z.B.
8
      <code class="filename">/var/www/html/</code>,
9
      <code class="filename">/srv/www/htdocs</code> oder
10
      <code class="filename">/var/www/</code>) entpackt:</p><pre class="programlisting">cd /var/www
11
tar xvzf kivitendo-erp-*.tgz</pre><p>Wechseln Sie in das entpackte Verzeichnis:</p><pre class="programlisting">cd kivitendo-erp</pre><p>Alternativ können Sie auch einen Alias in der
12
      Webserverkonfiguration benutzen, um auf das tatsächliche
13
      Installationsverzeichnis zu verweisen.</p><p>Bei einer Neuinstallation von Version 3.1.0 oder später muß das
14
      WebDAV Verzeichnis derzeit manuell angelegt werden:</p><pre class="programlisting">mkdir webdav</pre><p>Die Verzeichnisse <code class="filename">users</code>,
15
      <code class="filename">spool</code> und <code class="filename">webdav</code> müssen für
16
      den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die
17
      restlichen Dateien müssen für diesen Benutzer lesbar sein. Die Benutzer-
18
      und Gruppennamen sind bei verschiedenen Distributionen unterschiedlich
19
      (z.B. bei Debian/Ubuntu <code class="constant">www-data</code>, bei Fedora
20
      <code class="constant">apache</code> oder bei openSUSE
21
      <code class="constant">wwwrun</code>).</p><p>Der folgende Befehl ändert den Besitzer für die oben genannten
22
      Verzeichnisse auf einem Debian/Ubuntu-System:</p><pre class="programlisting">chown -R www-data users spool webdav</pre><p>Weiterhin muss der Webserver-Benutzer in den Verzeichnissen
23
      <code class="filename">templates</code> und <code class="filename">users</code>
24
      Unterverzeichnisse für jeden neuen Benutzer anlegen dürfen, der in
25
      kivitendo angelegt wird:</p><pre class="programlisting">chown www-data templates users</pre><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>Wir empfehlen eine Installation mittels des Versionsmanagager
26
        git. Hierfür muss ein git-Client installiert sein. Damit ist man sehr
27
        viel flexibler für zukünftige Upgrades. Installations-Anleitung (bitte
28
        die Pfade anpassen) bspw. wie folgt: </p><pre class="programlisting">cd /var/www/
29
git clone https://github.com/kivitendo/kivitendo-erp.git
30
cd kivitendo-erp/
31
git checkout `git tag -l | egrep -ve "(alpha|beta|rc)" | tail -1`</pre><p>
32
        Erläuterung: Der Befehl wechselt zur letzten Stable-Version (git tag
33
        -l listet alle Tags auf, das egrep schmeisst alle Einträge mit alpha,
34
        beta oder rc raus und das tail gibt davon den obersten Treffer
35
        zurück). Sehr sinnvoll ist es, direkt im Anschluss einen eigenen
36
        Branch zu erzeugen, um bspw. seine eigenen Druckvorlagen-Anpassungen
37
        damit zu verwalten. Hierfür reicht ein simples </p><pre class="programlisting">  git checkout -b meine_eigenen_änderungen</pre><p>
38
        nach dem letzten Kommando (weiterführende Informationen <a class="ulink" href="http://www-cs-students.stanford.edu/~blynn/gitmagic/index.html" target="_top">
39
        Git Magic</a>).</p><p>Ein beispielhafter Workflow für Druckvorlagen-Anpassungen von
40
        3.4.1 nach 3.5: </p><pre class="programlisting">
41
$ git clone https://github.com/kivitendo/kivitendo-erp.git
42
$ cd kivitendo-erp/
43
$ git checkout release-3.4.1                # das ist ein alter release aus dem wir starten ...
44
$ git checkout -b meine_eigene_änderungen   # unser lokaler branch - unabhängig von allen anderen
45
$ git add templates/mein_druck              # das sind unsere druckvorlagen inkl. produktbilder
46
$ git commit -m "juhu tolle änderungen"
55 47

  
56
[authentication/database]
57
host     = localhost
58
port     = 5432
59
db       = kivitendo_auth
60
user     = postgres
61
password =
48
[meine_aenderungen 1d89e41] juhu tolle ändernungen
49
 4 files changed, 380 insertions(+)
50
 create mode 100644 templates/mein_druck/img/webdav/tesla.png
51
 create mode 100644 templates/mein_druck/mahnung.tex
52
 create mode 100644 templates/mein_druck/zahlungserinnerung_zwei.tex
53
 create mode 100644 templates/mein_druck/zahlungserinnerung_zwei_invoice.tex
62 54

  
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>
55
# 5 Jahre später ...
56
# webserver abschalten!
57

  
58
$ git checkout master
59
$ git pull                                  # oder git fetch und danach ein stable release tag auswählen (s.o.)
60
$ git checkout meine_eigenen_änderungen
61
$ git rebase master
62

  
63
Zunächst wird der Branch zurückgespult, um Ihre Änderungen
64
darauf neu anzuwenden ...
65
Wende an: juhu tolle änderungen
66
$ service apache2 restart                   # webserver starten!
67
</pre><p>
68
            </p></td></tr></table></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. Installation mittels Ansible&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. kivitendo-Konfigurationsdatei</td></tr></table></div></body></html>

Auch abrufbar als: Unified diff