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“"