X-Git-Url: http://wagnertech.de/gitweb/gitweb.cgi/mfinanz.git/blobdiff_plain/b8a5c5916dd07fbe14156e6e4f688b1f7ca9ddb2..HEAD:/doc/html/ch02s03.html diff --git a/doc/html/ch02s03.html b/doc/html/ch02s03.html index 9bf08e810..3303927e2 100644 --- a/doc/html/ch02s03.html +++ b/doc/html/ch02s03.html @@ -1,62 +1,49 @@ - 2.3. Manuelle Installation des Programmpaketes

2.3. Manuelle Installation des Programmpaketes

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]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 der aktuelle release, den wir wollen
-$ git add templates/fullhouse    # das sind unsere druckvorlagen inkl. produktbilder
-$ git commit -m "juhu tolle ändernungen"
-[meine_aenderungen 1d89e41] juhu tolle ändernungen
- 4 files changed, 380 insertions(+)
- create mode 100644 templates/fullhouse/img/webdav/tesla.png
- create mode 100644 templates/fullhouse/mahnung.tex
- create mode 100644 templates/fullhouse/zahlungserinnerung_zwei.tex
- create mode 100644 templates/fullhouse/zahlungserinnerung_zwei_invoice.tex
+   2.3. Installation mittels Ansible auf Ubuntu 22.04

2.3. Installation mittels Ansible auf Ubuntu 22.04

+ Ansible ist ein Open-Source-Automatisierungstool, das verwendet + wird, um die Bereitstellung, Konfiguration und Verwaltung von + IT-Systemen zu automatisieren. Dabei führt es Aufgaben über SSH auf + entfernten Rechnern (Hosts) aus. Die Aufgaben werden dabei + deklarativ als YAML Dateien, den sogenannten Playbooks, übergeben. + Benötigt wird lediglich python und ansible ab Version 2.10. +

+ Alle benötigten Konfigurationsdateien und das Playbook sind auf dem kivitendo github Account + unter dem Repository namens kivitendo-ansible verfügbar. + Das Repo kann lokal mit folgendem git-Befehl "geklont" werden: +

git clone https://github.com/kivitendo/kivitendo-ansible

+ In diesem Repository befindet sich auch eine Readme.md, die aktuelle Installationshinweise auf englisch enthält. +

+ Um die Installation zu starten, wechseln Sie dann zunächst in den erstellten Ordner 'kivitendo-ansible' und + editieren die Datei inventory. -# 5 Jahre später ... +

cd kivitendo-ansible
+vim inventory

-$ git fetch -$ git rebase --onto release-3.5.0 release-3.4.1 meine_aenderungen -Zunächst wird der Branch zurückgespult, um Ihre Änderungen -darauf neu anzuwenden ... -Wende an: juhu tolle ändernungen -$ service apache2 restart -

-

\ No newline at end of file + Der/die Hosts auf denen Kivitendo installiert werden soll wird dann in + dieser Datei ('inventory') eingefügt, bspw. die + +

192.168.1.121

+ oder als Namen: +

kivi.meine-lokale-domaene.de

+ Zusätzliche Parameter könnten erforderlich sein, bspw. der Benutzer für den SSH-Login: +

kivi.meine-lokale-domaene.de ansible_user=myuser

+ +

+ Danach kann das Playbook mittels: +

ansible-playbook --ask-become main.yml

+ ausgeführt werden, je nach Konfiguration wird man noch + aufgefordert das BECOME password einzutragen, hierbei handelt es + sich um das Passwort des Benutzers, über den die Installation dann auf dem Ziel-Rechner ausgeführt wird. +

+ Nach erfolgreichen Ausführen des Playbooks ist Kivitendo dann über den Browser + erreichbar unter + http://<IP des rechners>/kivitendo-erp/ + +

+ Nun muss noch eine Datenbank für Benutzer und Mandanten angelegt + werden. Dies kann über die Weboberfläche getan werden, indem man + sich mit dem Passwort admin123 in der + Administrationsoberfläche anmeldet. + Weitere Details siehe Abschnitt "Abschnitt 2.10, „Benutzerauthentifizierung und Administratorpasswort“" +

\ No newline at end of file