X-Git-Url: http://wagnertech.de/gitweb/gitweb.cgi/mfinanz.git/blobdiff_plain/8a1f99fd8bc7c8ee80eae18cc0ed052c48fb93aa..HEAD:/doc/html/ch02s03.html?ds=sidebyside diff --git a/doc/html/ch02s03.html b/doc/html/ch02s03.html index dcdc56156..3303927e2 100644 --- a/doc/html/ch02s03.html +++ b/doc/html/ch02s03.html @@ -1,64 +1,49 @@
-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 |
|---|---|
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 "(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 beta oder rc raus und - das tail gibt davon den obersten Treffer zurück). + + 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. - 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 +cd kivitendo-ansible +vim inventory - |
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â"
+