PostgreSQL muss auf verschiedene Weisen angepasst werden.
kivitendo setzt zwingend voraus, dass die Datenbank Unicode/UTF-8 als Encoding einsetzt. Bei aktuellen Serverinstallationen - braucht man hier meist nicht einzugreifen.
Das Encoding des Datenbankservers kann überprüft werden. Ist das Encoding der Datenbank "template1" "Unicode" bzw. "UTF-8", so - braucht man nichts weiteres diesbezüglich unternehmen. Zum Testen:
su postgres -echo '\l' | psql -exit
Andernfalls ist es notwendig, einen neuen Datenbankcluster mit - Unicode-Encoding anzulegen und diesen zu verwenden. Unter Debian und - Ubuntu kann dies z.B. für PostgreSQL 9.3 mit dem folgenden Befehl - getan werden:
pg_createcluster --locale=de_DE.UTF-8 --encoding=UTF-8 9.3 clustername
Die Datenbankversionsnummer muss an die tatsächlich verwendete - Versionsnummer angepasst werden.
Unter anderen Distributionen gibt es ähnliche Methoden.
Das Encoding einer Datenbank kann in psql mit
- \l geprüft werden.
In der Datei postgresql.conf, die je nach
- Distribution in verschiedenen Verzeichnissen liegen kann (z.B.
- /var/lib/pgsql/data/ oder
- /etc/postgresql/), muss sichergestellt werden,
- dass TCP/IP-Verbindungen aktiviert sind. Das Verhalten wird über den
- Parameter listen_address gesteuert. Laufen
- PostgreSQL und kivitendo auf demselben Rechner, so kann dort der Wert
- localhost verwendet werden. Andernfalls müssen
- Datenbankverbindungen auch von anderen Rechnern aus zugelassen werden,
- was mit dem Wert * geschieht.
In der Datei pg_hba.conf, die im gleichen
- Verzeichnis wie die postgresql.conf zu finden
- sein sollte, müssen die Berechtigungen für den Zugriff geändert
- werden. Hier gibt es mehrere Möglichkeiten. Sinnvoll ist es nur die
- nötigen Verbindungen immer zuzulassen, für eine lokal laufende
- Datenbank zum Beispiel:
local all kivitendo password -host all kivitendo 127.0.0.1 255.255.255.255 password
In der Datenbank template1 muss die
- Unterstützung für servergespeicherte Prozeduren eingerichet werden.
- Melden Sie sich dafür als Benutzer âpostgresâ an der Datenbank an:
-
su - postgres -psql template1
+
In kivitendo gibt es nur noch eine Konfigurationsdatei, die
+ benötigt wird: config/kivitendo.conf (kurz: "die
+ Hauptkonfigurationsdatei"). Diese muss bei der Erstinstallation von
+ kivitendo bzw. der Migration von älteren Versionen angelegt
+ werden.
Als Vorlage dient die Datei
+ config/kivitendo.conf.default (kurz: "die
+ Default-Datei"):
$ cp config/kivitendo.conf.default config/kivitendo.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.
![[Anmerkung]](system/docbook-xsl/images/note.png) | Anmerkung |
|---|---|
Vor der Umbenennung in kivitendo hieà diese Datei noch
+ |
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(siehe Abschnitt "Abschnitt 2.10, âBenutzerauthentifizierung und Administratorpasswortâ" + in diesem Kapitel)+
authentication/database++
authentication/http_basic++
authentication/http_headers++
authentication/ldap++
system++
paths++
mail_delivery(siehe Abschnitt "E-Mail-Versand über einen SMTP-Server)+
imap_client(siehe Abschnitt "E-Mails in kivitendo importieren)+
sent_emails_in_imap(siehe Abschnitt "Versendete E-Mails über IMAP exportieren)+
applications++
environment++
print_templates++
task_server++
periodic_invoices++
self_tests++
console++
testing++
testing/database++
debug+
Die üblicherweise wichtigsten Parameter, die am Anfang + einzustellen oder zu kontrollieren sind, sind:
[authentication] +admin_password = geheim - führen Sie die folgenden Kommandos aus:CREATE EXTENSION IF NOT EXISTS plpgsql; -\q
Anmerkung -
CREATE EXTENSIONist seit Version 9.1 die bevorzugte Syntax um die Spracheplpgsqlanzulegen. In diesen Versionen ist die Extension meist auch schon vorhanden. Sollten Sie eine ältere Version von Postgres haben, benutzen Sie stattdessen den folgenden Befehl.CREATE LANGUAGE 'plpgsql'; -\q
Wenn Sie nicht den Datenbanksuperuser âpostgresâ zum Zugriff - benutzen wollen, so sollten Sie bei PostgreSQL einen neuen Benutzer - anlegen. Ein Beispiel, wie Sie einen neuen Benutzer anlegen - können:
Die Frage, ob der neue User Superuser sein soll, können Sie mit nein - beantworten, genauso ist die Berechtigung neue User (Roles) zu - generieren nicht nötig.
su - postgres -createuser -d -P kivitendo -exit
Wenn Sie später einen Datenbankzugriff konfigurieren, verändern - Sie den evtl. voreingestellten Benutzer âpostgresâ auf âkivitendoâ bzw. - den hier gewählten Benutzernamen.
Für kivitendo Installationen in der Schweiz sollte hier
+ german durch swiss ersetzt
+ werden.
Die Einstellung default_manager = swiss
+ bewirkt:
Beim Erstellen einer neuen Datenbank in der kivitendo + Administration werden automatisch die Standard-Werte für die + Schweiz voreingestellt: Währung CHF, 5er-Rundung, Schweizer + KMU-Kontenplan, Sollversteuerung, Aufwandsmethode, Bilanzierung + (die Werte können aber manuell angepasst werden).
Einstellen der Standardkonten für Rundungserträge und + -aufwendungen (unter Mandantenkonfiguration â Standardkonten + veränderbar)
das verwendete Zahlenformat wird auf +
1'000.00eingestellt (unter Programm â + Benutzereinstellungen veränderbar)DATEV-Automatik und UStVA werden nicht angezeigt, + Erfolgsrechnung ersetzt GUV ( unter Mandantenkonfiguration â + Features veränderbar)
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.
kivitendo bringt eine eigene Komponente zur zeitgesteuerten + Ausführung bestimmter Aufgaben mit, den Task-Server. Er wird u.a. für + Features wie die wiederkehrenden Rechnungen + benötigt, erledigt aber auch andere erforderliche Aufgaben und muss + daher in Betrieb genommen werden. Seine Einrichtung wird im Abschnitt + Task-Server genauer + beschrieben.
Für Entwickler finden sich unter [debug]
+ wichtige Funktionen, um die Fehlersuche zu erleichtern.
In älteren kivitendo 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.
Beim Update von einer kivitendo-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 kivitendo eine + entsprechende Fehlermeldung an.