- 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.
+
+
+ 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.
- 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. + 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.
- 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. -
- 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 + 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-[authentication/database] -host = localhost -port = 5432 -db = lxerp_auth -user = postgres -password = + Der/die Hosts auf denen Kivitendo installiert werden soll wird dann in + dieser Datei ('inventory') eingefügt, bspw. die -[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.
-
- 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.
+
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.
- 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. -
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â"
+