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.
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 - Abschnitte und Werte enthalten, die von denen der Default-Datei - abweichen.
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 +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. -[authentication/database] -host = localhost -port = 5432 -db = lxerp_auth -user = postgres -password = +
cd kivitendo-ansible +vim inventory-[system] -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 -
configdie Dateien -authentication.plund -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.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.
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â"
+