X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2Fhtml%2Fch02s03.html;h=24953acd6f44bc8b4d1af6d56d4765bc90a42d10;hb=2e6998c4284851d5f0b905d43952765954ddc5af;hp=54aaec63cddf328e094fc996928ccc3e7f019025;hpb=f8309cb7bc2507c19e17ec59c6c66dd7f49ea351;p=kivitendo-erp.git diff --git a/doc/html/ch02s03.html b/doc/html/ch02s03.html index 54aaec63c..24953acd6 100644 --- a/doc/html/ch02s03.html +++ b/doc/html/ch02s03.html @@ -1,77 +1,68 @@
- -
- Seit Lx-Office 2.6.3. gibt es nur noch eine Konfigurationsdatei die benötigt wird: config/lx_office.conf
(kurz:
- "die Hauptkonfigurationsdatei"). Diese muss bei der Erstinstallation von Lx-Office bzw. der Migration von älteren Versionen angelegt
- werden.
-
- Als Vorlage dient die Datei config/lx_office.conf.default
(kurz: "die Default-Datei"):
-
$ cp config/lx_office.conf.default config/lx_office.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 Abschintte und Werte - enthalten, die von denen der Default-Datei abweichen. -
- 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
-
- 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.3. Manuelle Installation des Programmpaketes 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-*.tgzWechseln Sie in das entpackte Verzeichnis:
cd kivitendo-erpAlternativ 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 webdavDie Verzeichnisse
users
, +spool
undwebdav
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/Ubuntuwww-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 webdavWeiterhin muss der Webserver-Benutzer in den Verzeichnissen +
templates
undusers
+ 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 /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 = lxerp_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] -eur = 1 -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 Lx-Office bei der Datenbank anmeldet, die dem Benutzer zugewiesen ist. -- Für Entwickler finden sich unter
[debug]
wichtige Funktionen, um die Fehlersuche zu erleichtern. -\ 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! +- In älteren Lx-Office Versionen gab es im Verzeichnis
config
die Dateienauthentication.pl
- undlx-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 Lx-Office-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 Lx-Office eine - entsprechende Fehlermeldung an. -
+