X-Git-Url: http://wagnertech.de/gitweb/gitweb.cgi/mfinanz.git/blobdiff_plain/a7121495cf3620bf1236a35675cfd1fecfb9820a..2c8e8f143645ac3ce6f69ca7aaee479cda75a6f7:/doc/html/ch02s03.html diff --git a/doc/html/ch02s03.html b/doc/html/ch02s03.html index 89152e72e..4eb2c0c3c 100644 --- a/doc/html/ch02s03.html +++ b/doc/html/ch02s03.html @@ -1,78 +1,36 @@
-In kivitendo gibt es nur noch eine Konfigurationsdatei,
-        die benötigt wird: config/kivitendo.conf (kurz:
-        "die Hauptkonfigurationsdatei"). Diese muss bei der Erstinstallation
-        von kivitendo bzw. der Migration von älteren Versionen angelegt
-        werden.
Als Vorlage dient die Datei
-        config/kivitendo.conf.default (kurz: "die
-        Default-Datei"):
$ cp config/kivitendo.conf.default config/kivitendo.conf
Die Default-Datei wird immer zuerst eingelesen. Werte, die in - der Hauptkonfigurationsdatei stehen, überschreiben die Werte aus der - Default-Datei. Die Hauptkonfigurationsdatei muss also nur die - Abschnitte und Werte enthalten, die von denen der Default-Datei - abweichen.
![]()  | Anmerkung | 
|---|---|
-          Vor der Umbenennung in kivitendo hieà diese Datei noch   | 
Diese Hauptkonfigurationsdatei ist dann eine - installationsspezifische Datei, d.h. sie enthält bspw. lokale - Passwörter und wird auch nicht im Versionsmanagement (git) - verwaltet.
Die Konfiguration ist ferner serverabhängig, d.h. für alle - Mandaten, bzw. Datenbanken gleich.
Die Konfigurationsdatei besteht aus mehreren Teilen, die - entsprechend kommentiert sind:
-                     authentication
-                  
-                     authentication/database
-                  
-                     authentication/ldap
-                  
-                     system
-                  
-                     features
-                  
-                     paths
-                  
-                     applications
-                  
-                     environment
-                  
-                     mail_delivery (siehe Abschnitt "E-Mail-Versand aus kivitendo
-            heraus")
-                     print_templates
-                  
-                     task_server
-                  
-                     periodic_invoices
-                  
-                     console
-                  
-                     debug
-                  
Die üblicherweise wichtigsten Parameter, die am Anfang - einzustellen oder zu kontrollieren sind, sind:
[authentication] -admin_password = geheim - -[authentication/database] -host = localhost -port = 5432 -db = kivitendo_auth -user = postgres -password = - -[system] -dbcharset = UTF-8
Nutzt man wiederkehrende Rechnungen, kann man unter
-        [periodic_invoices] den Login eines Benutzers
-        angeben, der nach Erstellung der Rechnungen eine entsprechende E-Mail
-        mit Informationen über die erstellten Rechnungen bekommt.
Nutzt man den Taskserver für wiederkehrende Rechnungen,
-        muss unter [task_server] ein Login eines Benutzers
-        angegeben werden, mit dem sich der Taskserver an kivitendo bei der
-        Datenbank anmeldet, die dem Benutzer zugewiesen ist.
Für Entwickler finden sich unter [debug]
-        wichtige Funktionen, um die Fehlersuche zu erleichtern.
In älteren kivitendo Versionen gab es im Verzeichnis
-        config die Dateien
-        authentication.pl und
-        lx-erp.conf, die jeweils Perl-Dateien waren. Es
-        gab auch die Möglichkeit, eine lokale Version der Konfigurationsdatei
-        zu erstellen (lx-erp-local.conf). Dies ist ab
-        2.6.3 nicht mehr möglich, aber auch nicht mehr nötig.
Beim Update von einer kivitendo-Version vor 2.6.3 auf 2.6.3 oder - jünger müssen die Einstellungen aus den alten Konfigurationsdateien - manuell übertragen und die alten Konfigurationsdateien anschlieÃend - gelöscht oder verschoben werden. Ansonsten zeigt kivitendo eine - entsprechende Fehlermeldung an.
Der aktuelle Stable-Release, bzw. beta Release wird bei github + gehostet und kann hier + heruntergeladen werden.
Die kivitendo ERP Installationsdatei
+      (kivitendo-erp-3.4.1.tgz) wird im
+      Dokumentenverzeichnis des Webservers (z.B.
+      /var/www/html/,
+      /srv/www/htdocs oder
+      /var/www/) entpackt:
cd /var/www +tar xvzf kivitendo-erp-3.4.1.tgz
Wechseln Sie in das entpackte Verzeichnis:
cd kivitendo-erp
Alternativ können Sie auch einen Alias in der + Webserverkonfiguration benutzen, um auf das tatsächliche + Installationsverzeichnis zu verweisen.
Bei einer Neuinstallation von Version 3.1.0 oder später muà das + WebDAV Verzeichnis derzeit manuell angelegt werden:
mkdir webdav
Die Verzeichnisse users,
+      spool und webdav müssen für
+      den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die
+      restlichen Dateien müssen für diesen Benutzer lesbar sein. Die Benutzer-
+      und Gruppennamen sind bei verschiedenen Distributionen unterschiedlich
+      (z.B. bei Debian/Ubuntu www-data, bei Fedora
+      apache oder bei OpenSUSE
+      wwwrun).
Der folgende Befehl ändert den Besitzer für die oben genannten + Verzeichnisse auf einem Debian/Ubuntu-System:
chown -R www-data users spool webdav
Weiterhin muss der Webserver-Benutzer in den Verzeichnissen
+      templates und users
+      Unterverzeichnisse für jeden neuen Benutzer anlegen dürfen, der in
+      kivitendo angelegt wird:
chown www-data templates users
![]()  | Anmerkung | 
|---|---|
Wir empfehlen eine Installation mittels des Versionsmanagager + git. Hierfür muss ein git-Client installiert sein. Damit ist man sehr + viel flexibler für zukünftige Upgrades. Installations-Anleitung (bitte + die Pfade anpassen) bspw. wie folgt: cd /usr/local/src/ +git clone https://github.com/kivitendo/kivitendo-erp.git +cd kivitendo-erp/ +git checkout `git tag -l | egrep -ve "(beta|rc)" | tail -1` + Sehr sinnvoll ist es, direkt im Anschluss einen eigenen Branch zu + erzeugen, um bspw. seine eigenen Druckvorlagen-Anpassungen damit zu + verwalten. Hierfür reicht ein simples git checkout -b meine_eigenen_änderungen + nach dem letzten Kommando (weiterführende Informationen getting + started with git).  |