X-Git-Url: http://wagnertech.de/gitweb/gitweb.cgi/mfinanz.git/blobdiff_plain/ec1eaba1c5123f37acf540db873d353dbac48e87..HEAD:/doc/html/ch02s03.html diff --git a/doc/html/ch02s03.html b/doc/html/ch02s03.html index 46ab04d47..3303927e2 100644 --- a/doc/html/ch02s03.html +++ b/doc/html/ch02s03.html @@ -1,36 +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 /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).

\ No newline at end of file + 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. + +

cd kivitendo-ansible
+vim inventory

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