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]](system/docbook-xsl/images/note.png) | 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(siehe Abschnitt "Abschnitt 2.8, âBenutzerauthentifizierung und Administratorpasswortâ" in diesem Kapitel)-
authentication/database--
authentication/ldap--
system--
features(siehe Kapitel "Features und Funktionen")-
paths--
applications--
environment--
mail_delivery(siehe Abschnitt "E-Mail-Versand über einen SMTP-Server)-
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 +2.4. Manuelle Installation des Programmpaketes \ No newline at end of file +# 5 Jahre später ... +# webserver abschalten! + +$ git checkout master +$ git pull # oder git fetch und danach ein stable release tag auswählen (s.o.) +$ git checkout meine_eigenen_änderungen +$ git rebase master + +Zunächst wird der Branch zurückgespult, um Ihre Ãnderungen +darauf neu anzuwenden ... +Wende an: juhu tolle änderungen +$ service apache2 restart # webserver starten! +Wir empfehlen eine Installation mittels des Versionsmanager + 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 /var/www/ +git clone https://github.com/kivitendo/kivitendo-erp.git +cd kivitendo-erp/ +git checkout `git tag -l | egrep -ve "(alpha|beta|rc)" | tail -1`+ Erläuterung: Der Befehl wechselt zur letzten Stable-Version (git tag + -l listet alle Tags auf, das egrep schmeisst alle Einträge mit alpha, + beta oder rc raus und das tail gibt davon den obersten Treffer + zurück). 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 + Git Magic).
Ein beispielhafter Workflow für Druckvorlagen-Anpassungen von + 3.4.1 nach 3.5:
+$ git clone https://github.com/kivitendo/kivitendo-erp.git +$ cd kivitendo-erp/ +$ git checkout release-3.4.1 # das ist ein alter release aus dem wir starten ... +$ git checkout -b meine_eigene_änderungen # unser lokaler branch - unabhängig von allen anderen +$ git add templates/mein_druck # das sind unsere druckvorlagen inkl. produktbilder +$ git commit -m "juhu tolle änderungen" -[authentication/database] -host = localhost -port = 5432 -db = kivitendo_auth -user = postgres -password = +[meine_aenderungen 1d89e41] juhu tolle ändernungen + 4 files changed, 380 insertions(+) + create mode 100644 templates/mein_druck/img/webdav/tesla.png + create mode 100644 templates/mein_druck/mahnung.tex + create mode 100644 templates/mein_druck/zahlungserinnerung_zwei.tex + create mode 100644 templates/mein_druck/zahlungserinnerung_zwei_invoice.tex -[system] -dbcharset = UTF-8Nutzt 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 -
configdie Dateien -authentication.plund -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.
Das aktuelleste kivitendo ERP-Archiv
+ (kivitendo-erp-*.tgz) wird dann im
+ Dokumentenverzeichnis des Webservers (z.B.
+ /var/www/html/,
+ /srv/www/htdocs oder
+ /var/www/) entpackt:
cd /var/www +tar xvzf kivitendo-erp-*.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.
Die folgenden Schritte müssen nach der Installation mittels git + oder der Github Website angewendet werden.
Bei einer Neuinstallation von Version 3.1.0 oder später muss 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