X-Git-Url: http://wagnertech.de/gitweb/gitweb.cgi/mfinanz.git/blobdiff_plain/8ded2eedc25dbec2e489f81f6355fc5f0998f46d..2ac999504a:/doc/dokumentation.xml diff --git a/doc/dokumentation.xml b/doc/dokumentation.xml index fef20ab03..a2abb6c54 100644 --- a/doc/dokumentation.xml +++ b/doc/dokumentation.xml @@ -2,7 +2,8 @@ - kivitendo 3.5.0: Installation, Konfiguration, Entwicklung + kivitendo 3.5.1: Installation, Konfiguration, + Entwicklung Aktuelle Hinweise @@ -522,13 +523,13 @@ tar xvzf kivitendo-erp-3.4.1.tgz 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` +git checkout `git tag -l | egrep -ve "(alpha|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). - 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 + -l listet alle Tags auf, das egrep schmeisst alle Einträge mit alpha, + beta oder rc raus und das tail gibt davon den obersten Treffer + zurück). 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). @@ -849,6 +850,35 @@ psql template1 führen Sie die folgenden Kommandos aus: + + Erweiterung für Trigram Prozeduren + + Ab Version 3.5.1 wird die Trigram-Index-Erweiterung benötigt. + Diese wird mit dem SQL-Updatescript + sql/Pg-upgrade2/trigram_extension.sql und Datenbank-Super-Benutzer + Rechten automatisch installiert. Dazu braucht der + DatenbankSuperbenutzer "postgres" ein Passwort. + + su - postgres +psql +\password postgres + +Eingabe Passwort +\q + + Benutzername Postgres und Passwort können jetzt beim Anlegen + einer Datenbank bzw. bei Updatescripten, die SuperuserRechte + benötigen, eingegeben werden. + + + pg_trgm ist je nach Distribution nicht im + Standard-Paket von Postgres enthalten. Ein select * from pg_available_extensions where name ='pg_trgm'; + in template1 sollte entsprechend erfolgreich sein. Andernfalls muss + das Paket nachinstalliert werden, bspw. bei debian/ubuntu + apt install postgresql-contrib + + + Datenbankbenutzer anlegen @@ -6855,44 +6885,6 @@ document_path = /var/local/kivi_documents Shopware. Weitere Connectoren können dazu programmiert und eingerichtet werden. - - Installationsempfehlung - - Optionale Postgreserweiterung pg_trgm(Trigram) - - Die Trigramerweiterung bietet eine Ähnlichkeitsuche. Diese - verwendet das Shopmodul, wenn installiert, beim Bestellimport um zu - entscheiden ob ein Kunde neu angelegt oder als Vorschlag angezeigt - wird. - - Die Erweiterung wird bisher nur beim Ableich der Straße genutzt, - da hier oft unterschiedliche Schreibweisen vorhanden sind. - - z.B Dorfstraße, Dorfstrasse, Dorfstr., Dorf Straße usw.. So wird - vermieden, dass Kunden eventuell doppelt angelegt werden. - - Um diese Erweiterung generell in kivitendo zu installieren, um - neuen Mandanten und der kivitendo-Test-Suite zugänglich zu - machen: - - su - postgres -psql template1 - - führen Sie die folgenden Kommandos aus: - - CREATE EXTENSION IF NOT EXISTS pg_trgm; -\q - - Für bestehende Mandanten-Datenbanken kann die Extension in der - Datenbank angelegt werden: - - su - postgres -psql DATENBANKNAME - - CREATE EXTENSION IF NOT EXISTS pg_trgm; -\q - - Rechte für die Webshopapi @@ -8378,6 +8370,15 @@ $self->{more_texts} = { testing/database Datenbankverbindungsparameter angegeben werden. Der hier angegebene Benutzer muss weiterhin das Recht haben, Datenbanken anzulegen und zu löschen. + + Der so angegebene Benutzer muss nicht zwingend über + Super-User-Rechte verfügen. Allerdings gibt es einige + Datenbank-Upgrades, die genau diese Rechte benötigen. Für den Fall + kann man in diesem Konfigurationsabschnitt einen weiteren + Benutzeraccount angeben, der dann über Super-User-Rechte verfügt, und + mit dem die betroffenen Upgrades durchgeführt werden. In der + Beispiel-Konfigurationsdatei finden Sie die benötigten + Parameter.