X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2Fhtml%2Fch02s03.html;h=584a17a59d7831967937b2d37392f5f75bdf28f5;hb=c62a6cabffc11bdb2d3fda2025fef2f3d07c5ba9;hp=54aaec63cddf328e094fc996928ccc3e7f019025;hpb=15f021a67aa7e26458a3fbac8efe89ef9c0b0657;p=kivitendo-erp.git diff --git a/doc/html/ch02s03.html b/doc/html/ch02s03.html index 54aaec63c..584a17a59 100644 --- a/doc/html/ch02s03.html +++ b/doc/html/ch02s03.html @@ -1,77 +1,68 @@ - - 2.3. Lx-Office-Konfigurationsdatei
2.3. Lx-Office-Konfigurationsdatei
Zurück Kapitel 2. Installation und Grundkonfiguration Weiter

2.3. Lx-Office-Konfigurationsdatei

2.3.1. Einführung

- 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. -

2.3.2. Abschnitte und Parameter

- 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
2.3. Manuelle Installation des Programmpaketes
Zurück Kapitel 2. Installation und Grundkonfiguration Weiter
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-*.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]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.
-       
2.3.3. Versionen vor 2.6.3

-       In älteren Lx-Office 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 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.
-      
Zurück Nach oben Weiter
2.2. Manuelle Installation des Programmpaketes Zum Anfang 2.4. Anpassung der PostgreSQL-Konfiguration

\ 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!
+

+            
Zurück Nach oben Weiter
2.2. Benötigte Software und Pakete Zum Anfang 2.4. kivitendo-Konfigurationsdatei

\ No newline at end of file